🏗️ Tech Stack & Architecture

Tech Stack

Architecture

Routing

Lazy-loaded routes. Guards: authGuard and role-based guards for admin vs. member access.

State Management

RxJS observables + Firestore as single source of truth. Services are providedIn: 'root' singletons.

Key Services

Project Structure

/dora-tma/
├── src/app/
│   ├── components/        # UI components (auth, assessment, dashboard, org)
│   ├── services/          # Core services (auth, assessment, org, AI, PDF)
│   ├── models/            # Data models
│   ├── guards/            # authGuard, role-based guards
│   └── app.routes.ts      # Lazy-loaded routes
├── functions/src/index.ts  # 4 AI Cloud Functions
├── .github/
│   ├── workflows/          # CI/CD workflows
│   └── agents/             # AI agent instruction files
├── firestore.rules         # Security rules
└── firebase.json           # Hosting targets (dial-app + docs)

DORA Capabilities

20 capabilities across 4 categories, each assessed at 3 maturity levels: Emerging, Advancing, and Leading.

Firestore Collections

Core Features

• DORA Assessment — 20 capabilities across 4 categories, 3 maturity levels, collaborative team scoring
• Radar Charts — Chart.js radar visualization of capability scores by category
• AI Assessment — Claude Sonnet generates capability assessments from team input
• AI Recommendations — Personalized improvement recommendations per capability
• AI Chat — 3-turn conversation per capability for deeper exploration (turn-budgeted)
• AI Insights — Org-level synthesis and strategic insights across all capabilities
• PDF Export — jsPDF assessment reports with autotable formatting
• Organization Management — Create orgs, invite codes, team management, member roles
• Role-Based Navigation — Admin vs. member views with separate dashboards

Firebase Configuration

Cloud Functions

All functions use claude-sonnet-4-6. ANTHROPIC_API_KEY set via gcloud run services update --update-env-vars (not firebase.json secrets).

CI/CD Pipeline

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

CI/CD Tooling Matrix

Workflow source: .github/workflows/deploy-and-release.yml

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).

Key settings: npm install (not npm ci), NODE_TLS_REJECT_UNAUTHORIZED=0, Firebase Tools pinned to v13.15.2, WIF authentication.

Local Development

npx ng serve --configuration production --port 4201
# App: http://localhost:4201

With Firebase Emulators

firebase emulators:start
# Emulator UI: http://localhost:4000

Key File Reference