Charlie Roffe

How This Site Is Built

A live engineering case study: a system-context diagram, the full set of Architecture Decision Records, and a live OpenAPI 3.1 API contract.

Architecture Decision Records

• ADR-001: Cloud Provider & Container Hosting Choice
• ADR-002: Containerization Strategy
• ADR-003: Frontend Architecture Approach
• ADR-004: Backend Application Architecture
• ADR-005: AI Framework & Model Selection
• ADR-006: AI Conversation State Management
• ADR-007: Retrieval Store & Two-Tier Caching (In-Memory + Firestore)
• ADR-008: CI/CD Pipeline & Delivery Workflow
• ADR-009: Runtime Configuration & Secrets Management
• ADR-010: SSL/TLS Certificate Assistant Architecture
• ADR-011: Telemetry and Observability Approach
• ADR-012: CI/CD Pipeline Performance & Security Optimization
• ADR-013: EU AI Act & AI Governance Compliance Framework
• ADR-018: Public API Contract — Versioning, Error Model & Rate-Limit Semantics
• ADR-019: Layered API Abuse Protection — Rate Limits, App Check & Turnstile
• ADR-017: Shareable Demo Results
• ADR-014: Bilingual Localization Strategy (EN/ES)
• ADR-015: Streaming Transport — Server-Sent Events & the Transport/Logic Split
• ADR-016: Feature Flag Lifecycle & Two-Sided Rollouts
• ADR-020: Dual-Engine Security Pipeline — SAST, SCA, Secrets & DAST
• ADR-021: Immutable Artifact Promotion — Build Once, Verify, Promote by Digest
• ADR-022: Distroless Runtime Image
• ADR-023: Live Certificate Fetch & Deterministic Security Grading
• ADR-024: Stateful Multi-Agent Architecture Copilot
• ADR-025: Corrective RAG — Retrieval Grading & Web-Search Routing
• ADR-026: Terraform as the Infrastructure-as-Code Layer
• ADR-027: Edge Hosting Topology — Firebase Hosting in Front of Cloud Run
• ADR-028: AI-Assisted Engineering — Agents as Contributors, the Pipeline as the Trust Boundary

Live API reference (OpenAPI 3.1)