# opula1234/celery_redis_fastapi_demo architecture

> Architecture diagram of the GitHub repository opula1234/celery_redis_fastapi_demo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/opula1234/celery_redis_fastapi_demo
- Repository: https://github.com/opula1234/celery_redis_fastapi_demo

## Overview

Celery Demo exposes a FastAPI workflow for starting report generation and polling its status. The create route dispatches a Celery task and returns its task ID; a worker runs the task and returns a simulated report result, while the status route reads task state and any completed result from Redis. The README also documents Flower as a task monitor. The worker-to-broker consumption and Flower’s connection to the task system are not shown in the sampled source, so those links are marked unverified.

Main entry points: [`src/celery_demo/main.py`](https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/src/celery_demo/main.py) (Report API), [`src/celery_demo/tasks.py`](https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/src/celery_demo/tasks.py) (Report Task), [`compose.yaml`](https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/compose.yaml) (Flower Monitor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_api["Report API<br/>[main.py]"]
end

subgraph group_processing["Task Processing"]
  node_task["Report Task<br/>[tasks.py]"]
end

subgraph group_services["Runtime Services"]
  node_broker["Celery Queue"]
  node_redis[("Redis")]
  node_flower["Flower Monitor<br/>[compose.yaml]"]
end

node_client(("API Client"))

node_client -->|"requests reports"| node_api
node_api -->|"dispatches task"| node_task
node_api -->|"returns task ID"| node_client
node_api -->|"enqueues task"| node_broker
node_broker -.->|"dispatches task"| node_task
node_task -->|"stores result"| node_redis
node_api -->|"reads task status"| node_redis
node_client -->|"polls status"| node_api
node_client -->|"views tasks"| node_flower
node_flower -.->|"monitors tasks"| node_broker

click node_api "https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/src/celery_demo/main.py"
click node_task "https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/src/celery_demo/tasks.py"
click node_flower "https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/compose.yaml"

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_api,node_client toneBlue
class node_task toneAmber
class node_broker,node_redis,node_flower toneMint
```

## Components

### HTTP API

- [Report API](https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/src/celery_demo/main.py): `src/celery_demo/main.py`

### Task Processing

- [Report Task](https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/src/celery_demo/tasks.py): `src/celery_demo/tasks.py`

### Runtime Services

- **Celery Queue**
- **Redis**
- [Flower Monitor](https://github.com/opula1234/celery_redis_fastapi_demo/blob/main/compose.yaml): `compose.yaml`

### Other components

- **API Client**

## Connections

- API Client → Report API: requests reports (evidence: `README.md`)
- Report API → Report Task: dispatches task (evidence: `src/celery_demo/main.py`)
- Report API → API Client: returns task ID (evidence: `src/celery_demo/main.py`)
- Report API → Celery Queue: enqueues task (evidence: `README.md`)
- Celery Queue → Report Task: dispatches task
- Report Task → Redis: stores result (evidence: `README.md`)
- Report API → Redis: reads task status (evidence: `src/celery_demo/main.py`)
- API Client → Report API: polls status (evidence: `README.md`)
- API Client → Flower Monitor: views tasks (evidence: `README.md`)
- Flower Monitor → Celery Queue: monitors tasks
