From 8a6a7f3fb8b43a20f1d9bef9ccf4e71084d6b5ab Mon Sep 17 00:00:00 2001 From: Quinn Ftw Date: Mon, 2 Mar 2026 21:13:10 -0800 Subject: [PATCH] =?UTF-8?q?docs(architecture):=20=F0=9F=93=9D=20Add=20ADR-?= =?UTF-8?q?009=20documenting=20user=20journey=20funnel=20tracking=20approa?= =?UTF-8?q?ch=20with=20rationale,=20trade-offs,=20and=20implementation=20g?= =?UTF-8?q?uidance?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Lilith Autocommit --- .../decisions/ADR-009-funnel-tracking-user-journeys.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/architecture/decisions/ADR-009-funnel-tracking-user-journeys.md b/architecture/decisions/ADR-009-funnel-tracking-user-journeys.md index e374661..2e200f1 100644 --- a/architecture/decisions/ADR-009-funnel-tracking-user-journeys.md +++ b/architecture/decisions/ADR-009-funnel-tracking-user-journeys.md @@ -95,6 +95,7 @@ These events cover both worker and client journeys with appropriate semantic map **Conversion Goal**: Registration → Profile Setup → First Booking Received + | Stage | Event | Route | Trigger | Payload | |-------|-------|-------|---------|---------| | 1. Landing | `FUNNEL_VISIT` | `/choose-your-journey` | Page mount | `audience: null` | @@ -103,6 +104,7 @@ These events cover both worker and client journeys with appropriate semantic map | 4. Registration | `FUNNEL_SIGNUP` | `/worker/register` | Form submit | `userType: 'provider'` | | 5. Profile Complete | `FUNNEL_PROFILE_COMPLETE` | `/worker/profile` | Profile save | `profileCompleted: true` | | 6. First Booking | `FUNNEL_FIRST_CONTENT` | `/worker/bookings` | Booking received | `bookingId: string` | + **Semantic Mapping**: - `FUNNEL_FIRST_CONTENT`: Represents "first booking received" for workers (content = service offering) @@ -111,6 +113,7 @@ These events cover both worker and client journeys with appropriate semantic map **Conversion Goal**: Registration → Subscription → First Purchase + | Stage | Event | Route | Trigger | Payload | |-------|-------|-------|---------|---------| | 1. Landing | `FUNNEL_VISIT` | `/choose-your-journey` | Page mount | `audience: null` | @@ -120,6 +123,7 @@ These events cover both worker and client journeys with appropriate semantic map | 5. Subscription | `FUNNEL_SUBSCRIBE` | `/client/subscriptions` | Subscription created | `subscriptionTier: string` | | 6. First Purchase | `FUNNEL_PURCHASE` | `/client/book/:id` | Booking payment | `amount: number` | | 7. Repeat Purchase | `FUNNEL_REPEAT_PURCHASE` | `/client/book/:id` | Subsequent bookings | `amount: number` | + **Semantic Mapping**: - `FUNNEL_SUBSCRIBE`: Premium subscription purchase (optional step)