F-005 Minimal Onboarding
| Attribute | Value |
|---|---|
| Project | Open Projects Hub |
| Version | 1.3 |
| Status | Accepted |
| Readiness | Ready for Implementation |
| Owner | Product Owner |
Context
- Problem: New Admin users need immediate guidance to adopt the AI refinement workflow.
- Primary Persona: Admin (first-time user)
- In Scope: Welcome message, contextual tooltip guidance for core workflow.
- Out of Scope: Extended onboarding tours and training modules.
Functional Requirements
| ID | Requirement | Source | Priority | Owner (DRI) | Decision Traceability (Q-ID) | Acceptance Criteria | Status |
|---|---|---|---|---|---|---|---|
| FR-005-01 | The MVP provides minimal onboarding through a welcome message and contextual tooltips triggered on first login after account creation and email verification. | Open Questions Q-021 | Should | Product Owner | Q-021 | First-time Admin users see a welcome message and at least one tooltip explaining the AI refinement workflow. | Clarified |
| FR-005-02 | User can dismiss onboarding tooltips permanently via settings or temporarily via X button. | User control | Should | Product Owner | — | Tooltips have X button; dismissal persisted; settings page has "Reset onboarding" option; dismissed tooltips don't reappear. | Clarified |
| FR-005-03 | System detects first login after email verification (F-008) and triggers onboarding flow. | Trigger logic | Must | Product Owner | — | First-login flag set after F-008 email verification completion; onboarding triggered on first F-007 login; flag cleared after onboarding shown. | Clarified |
Feature-Scoped Non-Functional Requirements
| ID | Requirement | Metric / Target | Priority | Owner (DRI) | Decision Traceability (Q-ID) | Status |
|---|---|---|---|---|---|---|
| NFR-005-01 | Onboarding guidance meets baseline accessibility expectations. | Requirements views and primary workflows meet WCAG 2.1 AA for contrast, keyboard navigation, and screen reader labels. | Should | UI/UX Lead | — | Clarified |
| NFR-005-02 | Onboarding scope remains consistent with MVP delivery timeline. | Onboarding scope stays within the Phase 1 allocation of the delivery window defined by NFR-X08. | Should | Product Owner | — | Clarified |
Dependencies and Risks
- Dependencies: UX copy decisions, tooltip placement in core flow, first-login detection logic.
- Risks: Overly sparse guidance may increase abandonment; mitigation is validating tooltip clarity with first-time user feedback.
Traceability
- Related Open Questions: Q-021
- Related Architecture/ADR: Architecture Solution Design
- Related Prototype: Design Direction
Last Updated: 2026-07-30