๐Ÿ“– User Journeys

Complete workflows for all personas in the Prophet-Priest-King application

Overview

The Prophet-Priest-King application supports three distinct user personas, each with their own journey through the application. These journeys serve as both documentation and the source of truth for end-to-end testing.

๐Ÿ‘ค
Personal Survey User
Individual users taking the assessment for personal spiritual leadership development
  • Not part of any organization
  • Has only a personal survey
  • Cannot view organization features
  • Can delete own survey anytime
๐Ÿ›๏ธ
Organization Member
Users who belong to a church or ministry organization and participate in team assessments
  • Member of one organization
  • Can take organizational surveys
  • Can view organization dashboard
  • Can invite other members
  • Has equal permissions with other members
๐Ÿ”‘
Super Administrator
System administrators with elevated privileges across the entire application
  • Has isAdmin flag in Firebase
  • Can view all organizations
  • Can delete user accounts
  • Can delete organizations
  • Can move personal surveys to organizations
๐Ÿ“‹ Note: For detailed step-by-step instructions for each persona, download the markdown version or JSON data file. The JSON file is the canonical source for E2E test automation.

๐Ÿšถ Journey Summaries

๐Ÿ‘ค

Personal Survey User Journey

8 Steps: Sign-Up โ†’ Sign-In โ†’ Create Personal Survey โ†’ View Profile โ†’ Edit Survey โ†’ Retake Survey โ†’ Verify Updates โ†’ Sign-Out

Focus: Individual spiritual leadership assessment and growth tracking

๐Ÿ›๏ธ

Organization Member Journey

10 Steps: Sign-Up/In โ†’ Join Organization โ†’ View Dashboard โ†’ Take Org Survey โ†’ View Survey Matrix โ†’ Compare Members โ†’ View Member Survey โ†’ Invite Members โ†’ Edit Settings โ†’ Switch Context

Focus: Team collaboration, collective insights, and organizational leadership development

๐Ÿ”‘

Super Administrator Journey

8 Steps: Admin Sign-In โ†’ View All Organizations โ†’ Access Member Management โ†’ Delete User Account โ†’ Delete Organization โ†’ Move Personal Survey โ†’ View All Personal Surveys โ†’ Monitor System Health

Focus: System administration, user management, and organizational oversight

๐Ÿ”‘ Business Rules

Survey Management

  • One Survey Per Context: Each user can have only one survey per context (personal OR organizational)
  • Survey Scoring: 30 questions total: 10 Prophet, 10 Priest, 10 King. Each rated 1-5. Maximum score per category: 50
  • Profile Calculation: Biblical leadership profile is determined by the highest score among Prophet, Priest, and King categories

Organization Management

  • Single Organization: Users can belong to only ONE organization at a time
  • Equal Permissions: All organization members have equal permissions (no admin/moderator roles within organizations)
  • Invitation Codes: Unique 8-character codes that are permanent

Administration

  • Super Admin Flag: Set manually in Firebase (isAdmin: true in userProfiles)
  • Self-Protection: Admins cannot delete their own accounts
  • Last Admin Protection: Cannot delete users who are sole administrators of any organization
  • Permanent Deletion: All user data deletions are permanent with no recovery option

๐Ÿงช Test Configuration

Environment

  • Testing Environment: Firebase Emulators (Auth, Firestore, UI)
  • Application URL: http://localhost:4200
  • Test Framework: Playwright
  • Browser Support: Chromium, Firefox, WebKit

Emulator Ports

  • Auth Emulator: 9099
  • Firestore Emulator: 8080
  • Emulator UI: 4000

๐Ÿ“š Related Documentation

โ†‘