Sequence Diagrams¶

Message-order sequences between participants for each major interaction. Diagrams reflect the target implementation.

01 — Authentication Flow¶

Register, login (rate-limited), JWT signing, refresh token storage, Angular interceptor 401 handling, token refresh, and logout with DB revocation.

02 — Chat & SSE Streaming Flow¶

EventSource fetch → JWT validation → session load → LangGraph streaming → token-by-token SSE → DB persistence. Shows the persistent checkpointer state load and LLMProvider singleton invocation.

03 — LangGraph Pipeline Execution¶

All 8 nodes in sequence with conditional edges, external API calls, state checkpointing after each node, and final SSE event emission.

04 — RAG Ingestion Pipeline (Target Architecture — Issues #14, #21, #29, #31, #33, #42)¶

GitHub Actions parameterized trigger → factory setup (ADR-0008) → environment-scoped collection (Issue #14) → pluggable chunking (Issue #31) → batch embedding per provider → vector store upsert → IngestionMetrics exported as step summary + JSON artifact (Issue #29).