Architecture Diagrams¶

10 PlantUML diagrams covering the full Movie Finder architecture. Source files (*.puml) are in docs/architecture/plantuml/.

# Full docs build: prepares content, renders PlantUML PNGs, serves MkDocs
make mkdocs
# → http://localhost:8001

make plantuml
# → http://localhost:18088

Open any .puml file and press Option+D (macOS) / Alt+D (Windows/Linux) for a live preview panel. The jebbs.plantuml extension is pre-configured in .vscode/settings.json.

01 — Domain Model¶

Core data structures: identity, sessions, messaging, and AI pipeline state.

02 — System Architecture Overview¶

All runtime components, external services, and CI/CD pipeline in one view.

03 — Backend Internal Architecture¶

FastAPI layer decomposition: routers, JWT middleware, session store, and configuration.

04 — LangGraph Pipeline (Class View)¶

The chain module: all 8 LangGraph nodes, their services, and the shared MovieFinderState.

05 — LangGraph Phase State Machine¶

Phase lifecycle (discovery → confirmation → qa), next_action routing signals, and refinement cycles.

06 — Frontend Architecture (Angular 21)¶

Component tree, core services, guards, interceptors, and feature modules.

07 — Authentication Flow (Sequence)¶

Register, login, token refresh, and logout end-to-end.

08 — Chat & SSE Streaming Flow (Sequence)¶

Full lifecycle from EventSource fetch through JWT validation, session persistence, LangGraph streaming, and SSE event handling.

09 — LangGraph Pipeline Execution (Sequence)¶

All 8 nodes firing in sequence with conditional branching: discovery, confirmation, Q&A phase, and refinement cycles.

10 — Azure Production Deployment¶

Container Apps environment, PostgreSQL Flexible Server, ACR, Key Vault, Qdrant Cloud, Jenkins CI/CD, and local docker compose reference.

Known Issues cross-reference¶

Diagrams include inline ⚠ Issue #N annotations for the issues that are still open in the current architecture docs. Quick reference: