AVARC — System Atlas
The original prompt, shown in full as plain text.
Prompt
# Architecture diagram
Source of truth for the system diagram required by
[SPEC-architecture-diagram.md](SPEC-architecture-diagram.md). Dashed borders
mark undecided components; dotted, muted borders mark components planned for
after the MVP. Dotted arrows are connections that belong to post-MVP components. The browser
calls the frontend pages and `/api` through the ingress; login is a backend
OIDC flow, with the session in a cookie. Each sub-application (frontend, backend, Keycloak
setup, ingress) may have its own, more detailed architecture diagram next to
its code.
```mermaid
flowchart TB
Browser[Browser]
AIClient["AI assistant<br/>MCP client (post-MVP)"]
subgraph Server["avarc-server"]
Ingress["Web server / ingress<br/>nginx"]
Frontend["Frontend<br/>Next.js"]
Backend["Backend API<br/>Spring Boot + Modulith"]
Keycloak["Keycloak<br/>realm avarc"]
MapServer["Public read-only map server<br/>(post-MVP)"]
MCP["MCP server<br/>(post-MVP)"]
DB[("Database<br/>PostgreSQL + PostGIS<br/>(schema avarc, Keycloak's own database)")]
DBTool["Database tool<br/>(optional, dev and stage only)"]
end
subgraph Monitoring["Monitoring stack (own Compose project, optional on dev)"]
Alloy["Alloy<br/>log collector"]
Loki["Loki"]
Prometheus["Prometheus"]
Grafana["Grafana"]
end
Browser -- "HTTPS" --> Ingress
Ingress -- "pages" --> Frontend
Ingress -- "/api" --> Backend
Ingress -- "/auth/realms/avarc (login, logout)" --> Keycloak
Backend -- "OIDC client: code exchange, signing keys" --> Keycloak
Backend -- "JPA, Flyway" --> DB
Keycloak --> DB
DBTool -- "read-only" --> DB
Alloy -- "container log files" --> Loki
Prometheus -- "scrape metrics (management ports)" --> Backend
Prometheus -- "scrape metrics" --> Keycloak
Prometheus -- "scrape metrics" --> Ingress
Grafana --> Loki
Grafana --> Prometheus
Anonymous["Anonymous public<br/>(post-MVP)"]
Anonymous -. "HTTPS" .-> Ingress
Ingress -. "map" .-> MapServer
MapServer -. "public data" .-> DB
AIClient -. "MCP" .-> Ingress
Ingress -. "MCP" .-> MCP
MCP -. "API" .-> Backend
MCP -. "validate token" .-> Keycloak
classDef undecided stroke-dasharray: 5 5;
classDef postmvp stroke-dasharray: 2 4,fill:#f4f4f4,stroke:#999,color:#666;
class AIClient,MCP,MapServer,Anonymous postmvp;
```