Onboarding

Users and Onboarding

See also Identity and Access and Product Scope.

Users

• One adult account per real person; email is the unique identifier.
• Church association is optional at signup (Integrations when ChMS ships).
• Minors: subprofiles under linked guardians; guardian chooses account type (controls what PII is collected). Younger minors: no independent login (is_minor, full impersonation for child use). Older teens: may log in on their own (guardian_minor_links, is_minor false) while guardians retain oversight until adulthood; see Identity and Access and storage semantics.

User creation

1. Identify person (email) — or create household flow for dependents later.
2. Identify church (optional).
3. Create account (password or Google / Apple).

Onboarding flow (v1)

Part 1 — Spiritual phase and birth month/year

1. Spiritual phase tree (fixed order; no direct Milk / Transition / Meat picker)
   • How long have you been saved? (with optional What does “saved” mean?” help linking to the plan of salvation for those not yet saved)
   • Short-circuit to Milk for I just did! or Less than 1 year
   • How long have you been around Bible teaching? (when saved 1+ years)
   • Drill-down questions for maturity signals (Hebrews 5 / 1 Cor 3 style); extended set when lifelong church exposure or 20+ years saved
   • Birth month and year (no day collected); stored as last day of month for conservative 18+ validation
   • Gender (Male / Female), required for mentorship pairing rules
2. Follow-up and drill-down answers are not persisted — only inferred spiritual_phase, gender, and normalized date_of_birth.

Part 2 — Study profile (three steps)

1. Personality focus — DISC-oriented task vs people (with I’m not sure)
2. Learning style — VARK-inspired preferences (with I’m not sure)
3. Study motivation — extrinsic vs intrinsic (Motivation) (with I’m not sure)

Part 3 — Clarification (when needed)

• If the user chose I’m not sure on any Part 2 field, show 4 random questions per unsure field from larger pools (personality 10, learning 11, motivation 8), shuffled together.
• If no clear plurality after the initial sample, ask up to 2 more questions per field (6 max per field), then apply deterministic tie-breakers.
• Clarification answers are not stored; only inferred enum values are submitted via completeOnboarding.
• Question pools adapt published DISC / VARK / SDT patterns using general-life scenarios (not Bible-study jargon).

Part 4 — Review and submit

• Show inferred spiritual phase, birth month/year, gender, and any clarified profile fields.
• Submit completeOnboarding with dateOfBirth, gender, spiritual phase, and study profile enums.

Implementation: ui/src/lib/onboarding/, ui/src/components/onboarding/, ui/src/pages/onboarding/index.vue.

Verification timing

• v1: No identity verification in onboarding.
• Planned: Identity verification runs after onboarding, immediately before first use of gated features (mentorship invite send/accept, messaging, groups).
• Optional soft prompt (“Verify to unlock mentorship”) without blocking personal study.

Doctrine acceptance

• Not at signup.
• Required (versioned checkbox) on first use of forum features when those ship (Groups and Community).

Church linking (when applicable)

• Invite code and/or ChMS OAuth (later).
• Church never required for personal study.