🏗️ Tech Stack & Architecture

Tech Stack

Architecture

Routing

20+ lazy-loaded routes. Guards: authGuard, noAuthGuard, superAdminGuard, maintenanceGuard.

State Management

RxJS observables + Firestore as single source of truth. Services are providedIn: 'root' singletons. Firebase Remote Config drives maintenance mode.

Key Services

Project Structure

/Prophet-Priest-King/
├── src/app/
│   ├── components/        # 40+ UI components (auth, survey, org, dashboard)
│   ├── services/          # 14 core services
│   ├── models/            # 12 data models
│   ├── guards/            # authGuard, superAdminGuard, maintenanceGuard
│   ├── content/           # Leadership profiles, insights, scripture constants
│   └── app.routes.ts      # 20+ lazy-loaded routes
├── functions/src/index.ts  # AI reflection Cloud Function
├── Requirements/           # 12 markdown business requirements
├── .github/
│   ├── workflows/          # 6 CI/CD workflows
│   └── agents/             # 8 specialized AI agent instruction files
├── firestore.rules         # Security rules (163 lines, 8 collections)
└── firebase.json           # Hosting targets (app + requirements + docs)

Firestore Collections

Security rules: 163 lines across 8 collections. Survey access: owner always; org members if visibility ≠ private; system admins always. isSystemAdmin() reads userProfiles.isAdmin. Membership checks enforced at app layer.

Core Features

• Leadership Assessment — 30 questions across Prophet/Priest/King dimensions, 1–5 Likert scale, instant scoring
• Leadership Profiles — 10 profiles with biblical figure examples, PDF export
• AI Reflection — 5-turn Claude Sonnet conversations per question, turn-aware guidance, persisted to Firestore
• Organization Management — Create orgs, invite codes (/join/{code}), member roles, visibility settings
• Team Comparisons — Aggregate org survey data, visual comparison charts
• Help Center — Markdown-based, searchable, no auth required
• Maintenance Mode — Remote Config toggle, admin-only bypass, banner notification

Firebase Configuration

Cloud Function: reflectOnQuestion

• Callable HTTP function invoked from the Angular app
• Input: questionId, questionText, questionCategory, conversationHistory, userMessage, userId, turnNumber
• Uses claude-sonnet-4-6 with category-specific system prompts (prophet/priest/king)
• Turn-aware: early exploration → turn 3 suggests score range → turn 5 final affirmation
• Persists conversation history to reflectionConversations
• ANTHROPIC_API_KEY set via gcloud run services update --update-env-vars

CI/CD Pipeline

5-job workflow on push to main (skipped if [skip ci] in commit message):

AI-Powered Release Notes

The release-notes job calls the Anthropic API directly via curl to generate human-readable release notes from the commit log:

The final release notes are written to release-notes.md and passed to gh release create in the create-release job.

Claude Code as Development Assistant

Beyond CI automation, Claude Code (Anthropic's AI coding assistant) is used interactively throughout development:

• Commit messages — authored by Claude Code following conventional commit format (feat:, fix:, docs:, etc.), ensuring consistent style and accurate version bumping
• Code changes — features, bug fixes, and refactors implemented with Claude Code in paired sessions
• Documentation — architecture docs, AGENTS.md, and this docs site maintained by Claude Code alongside code changes
• Agent instructions — .github/agents/*.agent.md files written and updated by Claude Code

Claude Code is configured via CLAUDE.md (Claude Code-specific instructions) and AGENTS.md (universal AI assistant instructions shared with other tools like Copilot and Cursor).

Post-deploy: doc-update.yml triggers after every successful deploy. Calls 8 AI agents to auto-update Requirements, Help docs, SDLC diagrams, and Implementation Summaries — commits back with [skip ci].

Design System

• SCSS tokens: colors, typography, spacing in src/styles/_tokens.scss
• Mixins: src/styles/_mixins.scss
• Component styles: src/styles/_components.scss
• Rule: never hardcode colors, spacing, or fonts — always use tokens/mixins
• Budget limits: 1.5mb warning / 3mb error initial bundle

Local Development

Recommended (Docker)

docker-compose up
# App:                http://localhost:4200
# Requirements site:  http://localhost:4201
# Firebase Emulator:  http://localhost:4000

Without Docker

npm install
npm start                     # Angular dev server (port 4200)
npm run start:requirements    # Express requirements server (port 4201)

E2E Tests

source set-test-creds.sh
npm run test:e2e              # Headed
npm run test:e2e:headless     # CI mode

E2E tests run against production (not emulators). Requires TEST_USER_EMAIL, TEST_USER_PASSWORD, TEST_ORG_ID.

Key File Reference