# rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria architecture

> Architecture diagram of the GitHub repository rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria
- Repository: https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria

## Overview

This repository is a FastAPI cafeteria inventory service. Clients can order coffee, decrementing stock, or reload stock; both operations use SQLAlchemy sessions and the Product model backed by PostgreSQL. The app also initializes coffee at startup, exposes readiness and root endpoints, and configures metrics, tracing, and application logging. The README names NGINX and a Prometheus/Grafana/Loki/Promtail observability stack, but their runtime wiring is not shown in the excerpts, so those connections are omitted or marked unverified.

Main entry points: [`main.py`](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py) (FastAPI app), [`models.py`](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/models.py) (Product model), [`database.py`](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/database.py) (DB sessions), [`promtail-config.yaml`](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/promtail-config.yaml) (Promtail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Inventory API"]
  node_app["FastAPI app<br/>[main.py]"]
  node_order["Order coffee<br/>[main.py]"]
  node_reload["Reload stock<br/>[main.py]"]
  node_startup["Stock initialization<br/>[main.py]"]
  node_readiness["Readiness check<br/>[main.py]"]
end

subgraph group_storage["Persistence"]
  node_product["Product model<br/>[models.py]"]
  node_sessions["DB sessions<br/>[database.py]"]
  node_postgres[("PostgreSQL")]
end

subgraph group_observe["Observability"]
  node_metrics["Metrics instrumentation<br/>[main.py]"]
  node_tracing["Trace exporter<br/>[main.py]"]
  node_tempo["Tempo"]
  node_logging["Application logging<br/>[main.py]"]
  node_prometheus["Prometheus<br/>[prometheus.yml]"]
  node_grafana["Grafana"]
  node_promtail["Promtail"]
  node_loki["Loki"]
end

subgraph group_infra["Traffic"]
  node_nginx["NGINX<br/>[nginx.conf]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"routes to"| node_order
node_app -->|"routes to"| node_reload
node_app -->|"runs at startup"| node_startup
node_app -->|"routes to"| node_readiness
node_order -->|"queries and updates"| node_product
node_reload -->|"queries and updates"| node_product
node_startup -->|"queries and seeds"| node_product
node_readiness -->|"checks connection"| node_postgres
node_app -->|"uses sessions"| node_sessions
node_sessions -->|"connects to"| node_postgres
node_product -->|"maps product table"| node_postgres
node_app -->|"creates tables"| node_postgres
node_app -->|"instruments routes"| node_metrics
node_metrics -.->|"scrapes metrics"| node_prometheus
node_app -->|"configures tracing"| node_tracing
node_tracing -->|"exports spans"| node_tempo
node_app -->|"writes logs"| node_logging
node_promtail -.->|"ships logs"| node_loki
node_nginx -.->|"balances traffic"| node_app

click node_app "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py"
click node_order "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py"
click node_reload "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py"
click node_startup "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py"
click node_readiness "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py"
click node_product "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/models.py"
click node_sessions "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/database.py"
click node_metrics "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py"
click node_tracing "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py"
click node_logging "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py"
click node_prometheus "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/prometheus.yml"
click node_promtail "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/promtail-config.yaml"
click node_nginx "https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/nginx.conf"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_order,node_reload,node_startup,node_readiness,node_client toneBlue
class node_product,node_sessions,node_postgres toneAmber
class node_metrics,node_tracing,node_tempo,node_logging,node_prometheus,node_grafana,node_promtail,node_loki toneMint
class node_nginx toneRose
```

## Components

### Inventory API

- [FastAPI app](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py): `main.py`
- [Order coffee](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py): `main.py`
- [Reload stock](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py): `main.py`
- [Stock initialization](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py): `main.py`
- [Readiness check](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py): `main.py`

### Persistence

- [Product model](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/models.py): `models.py`
- [DB sessions](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/database.py): `database.py`
- **PostgreSQL**

### Observability

- [Metrics instrumentation](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py): `main.py`
- [Trace exporter](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py): `main.py`
- **Tempo**
- [Application logging](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/main.py): `main.py`
- [Prometheus](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/prometheus.yml): `prometheus.yml`
- **Grafana**
- [Promtail](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/promtail-config.yaml): `promtail-config.yaml`
- **Loki**

### Traffic

- [NGINX](https://github.com/rocio-ramirez2020/observabilidad-disponibilidad-caso_cafeteria/blob/main/nginx.conf): `nginx.conf`

### Other components

- **API client**

## Connections

- API client → FastAPI app: sends requests (evidence: `main.py`)
- FastAPI app → Order coffee: routes to (evidence: `main.py`)
- FastAPI app → Reload stock: routes to (evidence: `main.py`)
- FastAPI app → Stock initialization: runs at startup (evidence: `main.py`)
- FastAPI app → Readiness check: routes to (evidence: `main.py`)
- Order coffee → Product model: queries and updates (evidence: `main.py`)
- Reload stock → Product model: queries and updates (evidence: `main.py`)
- Stock initialization → Product model: queries and seeds (evidence: `main.py`)
- Readiness check → PostgreSQL: checks connection (evidence: `main.py`)
- FastAPI app → DB sessions: uses sessions (evidence: `main.py`)
- DB sessions → PostgreSQL: connects to (evidence: `database.py`)
- Product model → PostgreSQL: maps product table (evidence: `models.py`)
- FastAPI app → PostgreSQL: creates tables (evidence: `main.py`)
- FastAPI app → Metrics instrumentation: instruments routes (evidence: `main.py`)
- Metrics instrumentation → Prometheus: scrapes metrics
- FastAPI app → Trace exporter: configures tracing (evidence: `main.py`)
- Trace exporter → Tempo: exports spans (evidence: `main.py`)
- FastAPI app → Application logging: writes logs (evidence: `main.py`)
- Promtail → Loki: ships logs
- NGINX → FastAPI app: balances traffic
