User Stories
Modular documentation of end-to-end user journeys for each role in Syntropy Health.
Documents
| Doc | Role | Covers |
|---|---|---|
| Individual User Story | Individual (consumer) | Onboarding, dashboard, check-ins, AI chat, marketplace subscriptions, protocols, settings, Slack |
| Partner User Story | Partner (DTC brand) | Onboarding, portal, protocol CRUD, Shopify sync, adherence analytics, lounge |
| Shared User Stories | Cross-role | Store referral attribution, protocol discovery, data sharing opt-in |
Architecture Reference
For cross-cutting technical details (auth guards, page wrappers, state chain, background jobs), see:- State Management — Reflex state patterns
- Lifecycle — Startup sequence and service registry
- CI/CD — Pipeline and deployment
Demo Accounts
Both roles use real Clerk authentication. Seed data (make run seed) populates the local DB with sample check-ins, protocols, and an API key.
| Role | How to Demo | Clerk Metadata |
|---|---|---|
| Individual | Sign in at /sign-in with any Clerk dev user | Default (role absent or "individual") |
| Partner | Sign in at /partners/sign-in with a Clerk user that has partner metadata | {"role": "partner"} in public_metadata + Clerk org membership |
Seeded Demo Data
Runmake run seed to populate:
| Entity | Count | Description |
|---|---|---|
| Users | 2 | Individual (Alex Rivera) + Partner (Jordan Chen) |
| Check-ins | 8 | text(3), voice(2), chat(1), phone(1), pending(1) |
| Medications | 4 | Metformin, Vitamin D3, Magnesium, Ibuprofen |
| Food logs | 4 | Oatmeal, green tea, chicken salad, smoothie |
| Symptoms | 3 | Knee discomfort, insomnia, headache + fatigue |
| Protocol | 1 | Daily Vitamin D Protocol (30 days) |
| Protocol check-ins | 10 | 7 taken, 2 skipped, 1 missed |
| Notifications | 4 | ALERT, SUGGESTION, TIPS, PROTOCOL_REMINDER |
| Catalog items | 4 | D3+K2, Omega-3, Magnesium, Probiotic |
| Marketplace tables | 2 | ShopifyProtocolSync (bridge), UserProtocolSubscription (follow/subscribe) |
| Admin token | 1 | Clerk-issued token for API/Slack commands (legacy sh_* key also seeded for compat) |
| Store | 1 | Chen Wellness Co (referral code: store-chen-well-a1b2) |
| Store referrals | 3 | 2 clicked + 1 signed_up demo referral events |
syntropy_journals/app/data/seed/ and the entry point is syntropy_journals/app/scripts/seed_data.py.