# divsh54321/task-tracker-api architecture

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

- Interactive diagram: https://gitdiagram.com/divsh54321/task-tracker-api
- Repository: https://github.com/divsh54321/task-tracker-api

## Overview

Task Tracker is a FastAPI REST service for health checks and task CRUD, backed by SQLAlchemy and SQLite. Requests enter through the API handlers, which validate task input/output with Pydantic schemas and use SQLAlchemy models and database sessions for persistence. The README also presents automated Docker Hub and EC2 deployment as a major project capability. The source excerpts show the API and persistence calls; deployment relationships below are documented in the README, not verified from workflow or container source.

Main entry points: [`main.py`](https://github.com/divsh54321/task-tracker-api/blob/main/main.py) (FastAPI app), [`models.py`](https://github.com/divsh54321/task-tracker-api/blob/main/models.py) (Task model), [`.github/workflows/deploy.yml`](https://github.com/divsh54321/task-tracker-api/blob/main/.github/workflows/deploy.yml) (Deploy workflow), [`database.py`](https://github.com/divsh54321/task-tracker-api/blob/main/database.py) (DB engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Task API"]
  node_app["FastAPI app<br/>[main.py]"]
  node_health["Health check<br/>[main.py]"]
  node_create["Create task<br/>[main.py]"]
  node_list["List tasks<br/>[main.py]"]
  node_get["Get task<br/>[main.py]"]
  node_update["Update task<br/>[main.py]"]
  node_delete["Delete task<br/>[main.py]"]
  node_schemas["Task schemas<br/>[schemas.py]"]
end

subgraph group_data["Persistence"]
  node_session["DB sessions<br/>[main.py]"]
  node_taskmodel["Task model<br/>[models.py]"]
  node_dbconfig["DB engine<br/>[database.py]"]
  node_sqlite[("SQLite database")]
end

subgraph group_delivery["Deployment"]
  node_workflow["Deploy workflow<br/>[deploy.yml]"]
  node_dockerfile["Docker image"]
  node_hub["Docker Hub"]
  node_ec2["EC2 host"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"routes health"| node_health
node_app -->|"routes create"| node_create
node_app -->|"routes list"| node_list
node_app -->|"routes lookup"| node_get
node_app -->|"routes update"| node_update
node_app -->|"routes delete"| node_delete
node_create -->|"validates input"| node_schemas
node_update -->|"validates input"| node_schemas
node_create -->|"creates model"| node_taskmodel
node_list -->|"queries model"| node_taskmodel
node_get -->|"queries model"| node_taskmodel
node_update -->|"queries and updates"| node_taskmodel
node_delete -->|"queries and deletes"| node_taskmodel
node_create -->|"uses session"| node_session
node_list -->|"uses session"| node_session
node_get -->|"uses session"| node_session
node_update -->|"uses session"| node_session
node_delete -->|"uses session"| node_session
node_session -->|"opens sessions"| node_dbconfig
node_dbconfig -->|"connects to"| node_sqlite
node_taskmodel -->|"uses base"| node_dbconfig
node_workflow -->|"builds image"| node_dockerfile
node_workflow -->|"pushes image"| node_hub
node_workflow -->|"deploys container"| node_ec2

click node_app "https://github.com/divsh54321/task-tracker-api/blob/main/main.py"
click node_health "https://github.com/divsh54321/task-tracker-api/blob/main/main.py"
click node_create "https://github.com/divsh54321/task-tracker-api/blob/main/main.py"
click node_list "https://github.com/divsh54321/task-tracker-api/blob/main/main.py"
click node_get "https://github.com/divsh54321/task-tracker-api/blob/main/main.py"
click node_update "https://github.com/divsh54321/task-tracker-api/blob/main/main.py"
click node_delete "https://github.com/divsh54321/task-tracker-api/blob/main/main.py"
click node_schemas "https://github.com/divsh54321/task-tracker-api/blob/main/schemas.py"
click node_session "https://github.com/divsh54321/task-tracker-api/blob/main/main.py"
click node_taskmodel "https://github.com/divsh54321/task-tracker-api/blob/main/models.py"
click node_dbconfig "https://github.com/divsh54321/task-tracker-api/blob/main/database.py"
click node_workflow "https://github.com/divsh54321/task-tracker-api/blob/main/.github/workflows/deploy.yml"
click node_dockerfile "https://github.com/divsh54321/task-tracker-api/blob/main/Dockerfile"

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_health,node_create,node_list,node_get,node_update,node_delete,node_schemas,node_client toneBlue
class node_session,node_taskmodel,node_dbconfig,node_sqlite toneAmber
class node_workflow,node_dockerfile,node_hub,node_ec2 toneMint
```

## Components

### Task API

- [FastAPI app](https://github.com/divsh54321/task-tracker-api/blob/main/main.py): `main.py`
- [Health check](https://github.com/divsh54321/task-tracker-api/blob/main/main.py): `main.py`
- [Create task](https://github.com/divsh54321/task-tracker-api/blob/main/main.py): `main.py`
- [List tasks](https://github.com/divsh54321/task-tracker-api/blob/main/main.py): `main.py`
- [Get task](https://github.com/divsh54321/task-tracker-api/blob/main/main.py): `main.py`
- [Update task](https://github.com/divsh54321/task-tracker-api/blob/main/main.py): `main.py`
- [Delete task](https://github.com/divsh54321/task-tracker-api/blob/main/main.py): `main.py`
- [Task schemas](https://github.com/divsh54321/task-tracker-api/blob/main/schemas.py): `schemas.py`

### Persistence

- [DB sessions](https://github.com/divsh54321/task-tracker-api/blob/main/main.py): `main.py`
- [Task model](https://github.com/divsh54321/task-tracker-api/blob/main/models.py): `models.py`
- [DB engine](https://github.com/divsh54321/task-tracker-api/blob/main/database.py): `database.py`
- **SQLite database**

### Deployment

- [Deploy workflow](https://github.com/divsh54321/task-tracker-api/blob/main/.github/workflows/deploy.yml): `.github/workflows/deploy.yml`
- [Docker image](https://github.com/divsh54321/task-tracker-api/blob/main/Dockerfile): `Dockerfile`
- **Docker Hub**
- **EC2 host**

### Other components

- **API client**

## Connections

- API client → FastAPI app: sends requests (evidence: `README.md`)
- FastAPI app → Health check: routes health (evidence: `README.md`)
- FastAPI app → Create task: routes create (evidence: `README.md`)
- FastAPI app → List tasks: routes list (evidence: `README.md`)
- FastAPI app → Get task: routes lookup (evidence: `README.md`)
- FastAPI app → Update task: routes update (evidence: `README.md`)
- FastAPI app → Delete task: routes delete (evidence: `README.md`)
- Create task → Task schemas: validates input (evidence: `main.py`)
- Update task → Task schemas: validates input (evidence: `main.py`)
- Create task → Task model: creates model (evidence: `main.py`)
- List tasks → Task model: queries model (evidence: `main.py`)
- Get task → Task model: queries model (evidence: `main.py`)
- Update task → Task model: queries and updates (evidence: `main.py`)
- Delete task → Task model: queries and deletes (evidence: `main.py`)
- Create task → DB sessions: uses session (evidence: `main.py`)
- List tasks → DB sessions: uses session (evidence: `main.py`)
- Get task → DB sessions: uses session (evidence: `main.py`)
- Update task → DB sessions: uses session (evidence: `main.py`)
- Delete task → DB sessions: uses session (evidence: `main.py`)
- DB sessions → DB engine: opens sessions (evidence: `main.py`)
- DB engine → SQLite database: connects to (evidence: `database.py`)
- Task model → DB engine: uses base (evidence: `models.py`)
- Deploy workflow → Docker image: builds image (evidence: `README.md`)
- Deploy workflow → Docker Hub: pushes image (evidence: `README.md`)
- Deploy workflow → EC2 host: deploys container (evidence: `README.md`)
