# jotapekk/todo-list-api architecture

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

- Interactive diagram: https://gitdiagram.com/jotapekk/todo-list-api
- Repository: https://github.com/jotapekk/todo-list-api

## Overview

This is a small FastAPI task-list API. Clients can list, retrieve, create, update, and delete tasks; task records live in a process-local list, so the code shows no durable database. The shared lookup helper supports retrieval, update, and deletion, while the Pydantic model defines and validates task fields. The map reflects the routes and state operations visible in main.py; no separate persistence or service layer is present.

Main entry points: [`main.py`](https://github.com/jotapekk/todo-list-api/blob/main/main.py) (Task lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Task API"]
  node_list["List tasks<br/>[main.py]"]
  node_get["Get task<br/>[main.py]"]
  node_create["Create task<br/>[main.py]"]
  node_update["Update task<br/>[main.py]"]
  node_delete["Delete task<br/>[main.py]"]
  node_lookup["Task lookup<br/>[main.py]"]
  node_schema["Task schema<br/>[main.py]"]
  node_tasks[("In-memory tasks<br/>[main.py]")]
end

node_client(("API client"))

node_client -->|"requests"| node_list
node_client -->|"requests"| node_get
node_client -->|"requests"| node_create
node_client -->|"requests"| node_update
node_client -->|"requests"| node_delete
node_list -->|"reads"| node_tasks
node_get -->|"calls"| node_lookup
node_create -->|"accepts"| node_schema
node_create -->|"appends"| node_tasks
node_update -->|"accepts"| node_schema
node_update -->|"calls"| node_lookup
node_delete -->|"calls"| node_lookup
node_delete -->|"removes"| node_tasks
node_lookup -->|"searches"| node_tasks

click node_list "https://github.com/jotapekk/todo-list-api/blob/main/main.py"
click node_get "https://github.com/jotapekk/todo-list-api/blob/main/main.py"
click node_create "https://github.com/jotapekk/todo-list-api/blob/main/main.py"
click node_update "https://github.com/jotapekk/todo-list-api/blob/main/main.py"
click node_delete "https://github.com/jotapekk/todo-list-api/blob/main/main.py"
click node_lookup "https://github.com/jotapekk/todo-list-api/blob/main/main.py"
click node_schema "https://github.com/jotapekk/todo-list-api/blob/main/main.py"
click node_tasks "https://github.com/jotapekk/todo-list-api/blob/main/main.py"

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_list,node_get,node_create,node_update,node_delete,node_lookup,node_schema,node_tasks,node_client toneBlue
```

## Components

### Task API

- [List tasks](https://github.com/jotapekk/todo-list-api/blob/main/main.py): `main.py`
- [Get task](https://github.com/jotapekk/todo-list-api/blob/main/main.py): `main.py`
- [Create task](https://github.com/jotapekk/todo-list-api/blob/main/main.py): `main.py`
- [Update task](https://github.com/jotapekk/todo-list-api/blob/main/main.py): `main.py`
- [Delete task](https://github.com/jotapekk/todo-list-api/blob/main/main.py): `main.py`
- [Task lookup](https://github.com/jotapekk/todo-list-api/blob/main/main.py): `main.py`
- [Task schema](https://github.com/jotapekk/todo-list-api/blob/main/main.py): `main.py`
- [In-memory tasks](https://github.com/jotapekk/todo-list-api/blob/main/main.py): `main.py`

### Other components

- **API client**

## Connections

- API client → List tasks: requests (evidence: `main.py`)
- API client → Get task: requests (evidence: `main.py`)
- API client → Create task: requests (evidence: `main.py`)
- API client → Update task: requests (evidence: `main.py`)
- API client → Delete task: requests (evidence: `main.py`)
- List tasks → In-memory tasks: reads (evidence: `main.py`)
- Get task → Task lookup: calls (evidence: `main.py`)
- Create task → Task schema: accepts (evidence: `main.py`)
- Create task → In-memory tasks: appends (evidence: `main.py`)
- Update task → Task schema: accepts (evidence: `main.py`)
- Update task → Task lookup: calls (evidence: `main.py`)
- Delete task → Task lookup: calls (evidence: `main.py`)
- Delete task → In-memory tasks: removes (evidence: `main.py`)
- Task lookup → In-memory tasks: searches (evidence: `main.py`)
