PPP User Story Map
Method: Jeff Patton's User Story Mapping — read left-to-right as time, top-to-bottom as detail.
Status key:
- ✅ Works as expected
- ⚠️ Works but navigates to wrong screen (see #4393)
- ❌ Not implemented / missing
- 🔁 Duplicated in two places
- 🔜 Planned / in progress
BACKBONE (major activities in sequence)
| Sign Up | Set Up Account | First Use | Ongoing Use | Compliance |
|---|---|---|---|---|
| Register | Complete profile | Orientation wizard | Log activity | Export report |
| Choose plan | Upload CV | Getting Started checklist | Review progress | Share with body |
| Pay | Add registration |
CPD Home Persona (P3 Consultant · P4 GP)
Sign Up
| Task | Route | Status |
|---|---|---|
| Navigate to sign-up form | /signup-process | ✅ |
| Select CPD Home plan (pricing) | /signup-process step 2 | ✅ |
| Enter payment details | Stripe hosted | ✅ |
| Receive confirmation email | — | ✅ |
| Verify email | /signup-confirmation | ✅ |
Set Up Account
| Task | Route | Status |
|---|---|---|
| First login → land on CPD Dashboard | /cpd-dashboard | ✅ (fixed #4459) |
| Run Orientation Wizard | /onboarding | ⚠️ CPD users should skip wizard — see #4460 open question |
| Add regulatory body + registration number | /my-profile | ✅ |
| Upload CV / resume | /my-profile → file upload | ✅ (fixed #4457) |
| See "Still Outstanding" banner with missing chips | /cpd-dashboard | ✅ shown when fields missing |
| Dismiss banner by completing profile | /my-profile | ✅ |
First Use
| Task | Route | Status |
|---|---|---|
| Create first CPD plan | /cpd-plans?add=1 | ✅ (fixed #4466) |
| Log first CPD activity | /cpd-activities?add=1 | ✅ (fixed #4466) |
| View CPD Dashboard with progress | /cpd-dashboard | ✅ |
Ongoing Use
| Task | Route | Status |
|---|---|---|
| Log CPD activity | /cpd-activities?add=1 | ✅ |
| Review CPD plan progress | /cpd-plans | ✅ |
| View activity history | /cpd-activities | ✅ |
| Check CPD Dashboard totals | /cpd-dashboard | ✅ |
| Search activities | /search | ✅ |
Compliance
| Task | Route | Status |
|---|---|---|
| Generate CPD report | /cpd/user-activities-report | ✅ |
| Export for regulatory body | /cpd/user-activities-report | ✅ |
| View resource library | /cpd/resource-library | ✅ |
PPP Full Platform Persona (P1 FY2 Doctor · P2 Specialty Registrar)
Sign Up
| Task | Route | Status |
|---|---|---|
| Navigate to sign-up form | /signup-process | ✅ |
| Select PPP Full Platform plan (pricing) | /signup-process step 2 | ✅ |
| Enter payment details | Stripe hosted | ✅ |
| Receive confirmation email with deep link | /cpd-dashboard deep link in email | ✅ (fixed #4459) |
| Verify email | /signup-confirmation | ✅ |
Set Up Account
| Task | Route | Status |
|---|---|---|
| First login → land on PPP Dashboard | /ppp-dashboard | ✅ |
| Run Orientation Wizard | /onboarding | ✅ |
| — CV Upload step | /onboarding step 1 | ✅ (fixed #4457) |
| — Immunisations step | /onboarding step 2 | ✅ |
| — Connect Data step | /onboarding step 3 | ✅ |
| — Road Map step | /onboarding step 4 | ✅ |
| — Cadence Settings step | /onboarding step 5 | ✅ |
| Save wizard for later | returns to /cpd-dashboard | ✅ (fixed #4459) |
| Finish wizard | returns to /cpd-dashboard | ✅ (fixed #4459) |
| See "Still Outstanding" banner | /ppp-dashboard + /cpd-dashboard | ✅ |
First Use (Getting Started Checklist on /ppp-dashboard)
| Task | Route | Status |
|---|---|---|
| Complete your profile | /my-profile | ✅ (fixed #4466) |
| Create your first CPD plan | /cpd-plans?add=1 | ✅ (fixed #4466) |
| Log your first CPD activity | /cpd-activities?add=1 | ✅ (fixed #4466) |
| Complete a wellness questionnaire | /wellness?openQuestionnaire=true | ✅ (fixed #4466) |
| Set your appraisal date | /appraisals/upcoming?add=1 | ✅ (fixed #4466) |
Ongoing Use
| Task | Route | Status |
|---|---|---|
| Log CPD activity | /cpd-activities?add=1 | ✅ |
| Add logbook case | /logbook-case | ✅ |
| Request WBA | /wba | ✅ |
| Complete wellness check-in | /wellness | ✅ |
| Submit timesheet | /timesheet | ✅ |
| Track roadmap milestones | /retrospective | ✅ |
| Book appraisal | /appraisals/upcoming | ✅ |
| Complete 360° review | /appraisals/360 | ✅ |
| View PPP Dashboard overview | /ppp-dashboard | ✅ |
Compliance
| Task | Route | Status |
|---|---|---|
| Generate CPD report | /cpd/user-activities-report | ✅ |
| Share HR Passport | /hr-passport/share | ✅ |
| Export logbook | /logbook-case | ✅ |
| View revalidation readiness | /ppp-dashboard widgets | ✅ |
Hospital Admin Persona (P5)
Sign Up & Setup
| Task | Route | Status |
|---|---|---|
| Admin login | /login | ✅ |
| Land on Hospital Admin panel | /hospital-admin | ✅ |
| Manage doctor roster | /hospital-admin/roster | ✅ |
| Configure CPD meetings | /hospital-admin/meeting-cpd-config | ✅ |
| View insights dashboard | /hospital-admin/insights | ✅ |
| Manage pending accounts | /hospital-admin/pending-accounts | ✅ |
Known Gaps & Open Questions
Gaps fixed in this sprint
| Issue | What was wrong | Fix |
|---|---|---|
| #4459 | /dashboard was not semantically named | Renamed to /cpd-dashboard, backwards redirect added |
| #4466 | Getting Started checklist items navigated to list pages, not create forms | Added ?add=1 and ?openQuestionnaire=true deep links |
| #4457 | CV upload in wizard didn't persist to DB | Fixed — now saves cvFile to user profile |
| #4473 | Profile completion check used payrollId (never set for CPD users) | Changed to regulatoryBody + registrationNumber |
Open questions for product owner (Matt)
- [ ] Should CPD Home subscribers run the Orientation Wizard at all, or skip straight to
/cpd-dashboard? - [ ] Should wizard steps differ by plan? (CPD users likely don't need Cadence Settings — that's surgical logbook)
- [ ] Should CPD Home users ever see the Getting Started checklist? (currently they don't)
- [ ] When does the "Still Outstanding" banner permanently disappear — after wizard complete, after all chips resolved, or after a time limit?
- [ ] If a user upgrades from CPD → PPP mid-subscription, do they run the wizard again?