# yousskadi/app-todos architecture

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

- Interactive diagram: https://gitdiagram.com/yousskadi/app-todos
- Repository: https://github.com/yousskadi/app-todos

## Overview

App-todos is a French-language daily-planning application: users authenticate, manage tasks and appointments, and see today’s due items and upcoming appointments. The React UI calls a FastAPI API; backend routes delegate domain operations to services and repositories backed by PostgreSQL. The README also documents calendar views, categories, reminders, themes, and three-signal observability. Connections are limited to calls shown in excerpts or relationships explicitly documented by the README; unshown feature wiring is omitted.

Main entry points: [`frontend/src/App.tsx`](https://github.com/yousskadi/app-todos/blob/main/frontend/src/App.tsx) (App and routes), [`backend/app/api/v1/router.py`](https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/router.py) (API router), [`backend/app/main.py`](https://github.com/yousskadi/app-todos/blob/main/backend/app/main.py) (FastAPI runtime), [`backend/app/api/v1/auth.py`](https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/auth.py) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_webapp["App and routes<br/>[App.tsx]"]
  node_authui["Auth context<br/>[AuthContext.tsx]"]
  node_authpages["Login and register<br/>[LoginPage.tsx]"]
  node_tasksui["Task workflows<br/>[TasksPage.tsx]"]
  node_appointmentsui["Appointment calendar"]
  node_todayui["Today dashboard<br/>[TodayPage.tsx]"]
  node_reminders["Reminder notifications<br/>[useReminders.ts]"]
  node_httpclient["API client<br/>[api.ts]"]
end

subgraph group_api["API and security"]
  node_approuter["API router<br/>[router.py]"]
  node_authapi["Authentication API<br/>[auth.py]"]
  node_taskapi["Task API<br/>[tasks.py]"]
  node_appointmentapi["Appointment API<br/>[appointments.py]"]
  node_identity["Token identity<br/>[tokens.py]"]
  node_runtime["FastAPI runtime<br/>[main.py]"]
end

subgraph group_domain["Planning domains"]
  node_authservice["Auth service<br/>[auth.py]"]
  node_taskservice["Task service<br/>[tasks.py]"]
  node_appointmentservice["Appointment service<br/>[appointments.py]"]
end

subgraph group_persistence["Persistence"]
  node_taskrepo["Task repository<br/>[tasks.py]"]
  node_userrepo["User repository<br/>[users.py]"]
  node_sessionrepo["Refresh sessions"]
  node_taskmodel["Task records<br/>[task.py]"]
  node_database[("PostgreSQL<br/>[session.py]")]
end

subgraph group_operations["Observability"]
  node_telemetry["Telemetry setup<br/>[telemetry.py]"]
  node_metrics["Prometheus metrics<br/>[metrics.py]"]
  node_logging["Structured logging<br/>[logging_config.py]"]
end

node_user(("User"))

node_user -->|"uses"| node_webapp
node_webapp -.->|"routes"| node_authpages
node_webapp -.->|"routes"| node_tasksui
node_webapp -.->|"routes"| node_appointmentsui
node_webapp -.->|"routes"| node_todayui
node_authpages -.->|"uses"| node_authui
node_tasksui -.->|"requests"| node_httpclient
node_appointmentsui -.->|"requests"| node_httpclient
node_todayui -.->|"requests"| node_httpclient
node_appointmentsui -.->|"uses"| node_reminders
node_httpclient -.->|"HTTP requests"| node_approuter
node_approuter -->|"dispatches"| node_authapi
node_approuter -->|"dispatches"| node_taskapi
node_approuter -->|"dispatches"| node_appointmentapi
node_runtime -->|"mounts"| node_approuter
node_authapi -->|"calls"| node_authservice
node_authapi -->|"creates tokens"| node_identity
node_taskapi -->|"calls"| node_taskservice
node_appointmentapi -->|"calls"| node_appointmentservice
node_authservice -->|"uses"| node_userrepo
node_authservice -->|"uses"| node_sessionrepo
node_authservice -->|"uses"| node_identity
node_taskservice -->|"delegates"| node_taskrepo
node_taskrepo -->|"queries"| node_taskmodel
node_taskapi -->|"injects session"| node_database
node_authapi -->|"injects session"| node_database
node_appointmentapi -->|"injects session"| node_database
node_runtime -->|"configures"| node_metrics
node_runtime -->|"configures"| node_telemetry
node_runtime -->|"configures"| node_logging

click node_webapp "https://github.com/yousskadi/app-todos/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/yousskadi/app-todos/blob/main/frontend/src/context/AuthContext.tsx"
click node_authpages "https://github.com/yousskadi/app-todos/blob/main/frontend/src/pages/LoginPage.tsx"
click node_tasksui "https://github.com/yousskadi/app-todos/blob/main/frontend/src/pages/TasksPage.tsx"
click node_appointmentsui "https://github.com/yousskadi/app-todos/blob/main/frontend/src/pages/AppointmentsPage.tsx"
click node_todayui "https://github.com/yousskadi/app-todos/blob/main/frontend/src/pages/TodayPage.tsx"
click node_reminders "https://github.com/yousskadi/app-todos/blob/main/frontend/src/features/appointments/useReminders.ts"
click node_httpclient "https://github.com/yousskadi/app-todos/blob/main/frontend/src/lib/api.ts"
click node_approuter "https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/router.py"
click node_authapi "https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/auth.py"
click node_taskapi "https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/tasks.py"
click node_appointmentapi "https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/appointments.py"
click node_identity "https://github.com/yousskadi/app-todos/blob/main/backend/app/security/tokens.py"
click node_authservice "https://github.com/yousskadi/app-todos/blob/main/backend/app/services/auth.py"
click node_taskservice "https://github.com/yousskadi/app-todos/blob/main/backend/app/services/tasks.py"
click node_appointmentservice "https://github.com/yousskadi/app-todos/blob/main/backend/app/services/appointments.py"
click node_taskrepo "https://github.com/yousskadi/app-todos/blob/main/backend/app/repositories/tasks.py"
click node_userrepo "https://github.com/yousskadi/app-todos/blob/main/backend/app/repositories/users.py"
click node_sessionrepo "https://github.com/yousskadi/app-todos/blob/main/backend/app/repositories/refresh_sessions.py"
click node_taskmodel "https://github.com/yousskadi/app-todos/blob/main/backend/app/models/task.py"
click node_database "https://github.com/yousskadi/app-todos/blob/main/backend/app/db/session.py"
click node_runtime "https://github.com/yousskadi/app-todos/blob/main/backend/app/main.py"
click node_telemetry "https://github.com/yousskadi/app-todos/blob/main/backend/app/telemetry.py"
click node_metrics "https://github.com/yousskadi/app-todos/blob/main/backend/app/metrics.py"
click node_logging "https://github.com/yousskadi/app-todos/blob/main/backend/app/logging_config.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_webapp,node_authui,node_authpages,node_tasksui,node_appointmentsui,node_todayui,node_reminders,node_httpclient,node_user toneBlue
class node_approuter,node_authapi,node_taskapi,node_appointmentapi,node_identity,node_runtime toneAmber
class node_authservice,node_taskservice,node_appointmentservice toneMint
class node_taskrepo,node_userrepo,node_sessionrepo,node_taskmodel,node_database toneRose
class node_telemetry,node_metrics,node_logging toneIndigo
```

## Components

### Web application

- [App and routes](https://github.com/yousskadi/app-todos/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth context](https://github.com/yousskadi/app-todos/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Login and register](https://github.com/yousskadi/app-todos/blob/main/frontend/src/pages/LoginPage.tsx): `frontend/src/pages/LoginPage.tsx`
- [Task workflows](https://github.com/yousskadi/app-todos/blob/main/frontend/src/pages/TasksPage.tsx): `frontend/src/pages/TasksPage.tsx`
- [Appointment calendar](https://github.com/yousskadi/app-todos/blob/main/frontend/src/pages/AppointmentsPage.tsx): `frontend/src/pages/AppointmentsPage.tsx`
- [Today dashboard](https://github.com/yousskadi/app-todos/blob/main/frontend/src/pages/TodayPage.tsx): `frontend/src/pages/TodayPage.tsx`
- [Reminder notifications](https://github.com/yousskadi/app-todos/blob/main/frontend/src/features/appointments/useReminders.ts): `frontend/src/features/appointments/useReminders.ts`
- [API client](https://github.com/yousskadi/app-todos/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### API and security

- [API router](https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/router.py): `backend/app/api/v1/router.py`
- [Authentication API](https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/auth.py): `backend/app/api/v1/auth.py`
- [Task API](https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/tasks.py): `backend/app/api/v1/tasks.py`
- [Appointment API](https://github.com/yousskadi/app-todos/blob/main/backend/app/api/v1/appointments.py): `backend/app/api/v1/appointments.py`
- [Token identity](https://github.com/yousskadi/app-todos/blob/main/backend/app/security/tokens.py): `backend/app/security/tokens.py`
- [FastAPI runtime](https://github.com/yousskadi/app-todos/blob/main/backend/app/main.py): `backend/app/main.py`

### Planning domains

- [Auth service](https://github.com/yousskadi/app-todos/blob/main/backend/app/services/auth.py): `backend/app/services/auth.py`
- [Task service](https://github.com/yousskadi/app-todos/blob/main/backend/app/services/tasks.py): `backend/app/services/tasks.py`
- [Appointment service](https://github.com/yousskadi/app-todos/blob/main/backend/app/services/appointments.py): `backend/app/services/appointments.py`

### Persistence

- [Task repository](https://github.com/yousskadi/app-todos/blob/main/backend/app/repositories/tasks.py): `backend/app/repositories/tasks.py`
- [User repository](https://github.com/yousskadi/app-todos/blob/main/backend/app/repositories/users.py): `backend/app/repositories/users.py`
- [Refresh sessions](https://github.com/yousskadi/app-todos/blob/main/backend/app/repositories/refresh_sessions.py): `backend/app/repositories/refresh_sessions.py`
- [Task records](https://github.com/yousskadi/app-todos/blob/main/backend/app/models/task.py): `backend/app/models/task.py`
- [PostgreSQL](https://github.com/yousskadi/app-todos/blob/main/backend/app/db/session.py): `backend/app/db/session.py`

### Observability

- [Telemetry setup](https://github.com/yousskadi/app-todos/blob/main/backend/app/telemetry.py): `backend/app/telemetry.py`
- [Prometheus metrics](https://github.com/yousskadi/app-todos/blob/main/backend/app/metrics.py): `backend/app/metrics.py`
- [Structured logging](https://github.com/yousskadi/app-todos/blob/main/backend/app/logging_config.py): `backend/app/logging_config.py`

### Other components

- **User**

## Connections

- User → App and routes: uses (evidence: `README.md`)
- App and routes → Login and register: routes
- App and routes → Task workflows: routes
- App and routes → Appointment calendar: routes
- App and routes → Today dashboard: routes
- Login and register → Auth context: uses
- Task workflows → API client: requests
- Appointment calendar → API client: requests
- Today dashboard → API client: requests
- Appointment calendar → Reminder notifications: uses
- API client → API router: HTTP requests
- API router → Authentication API: dispatches (evidence: `backend/app/api/v1/router.py`)
- API router → Task API: dispatches (evidence: `backend/app/api/v1/router.py`)
- API router → Appointment API: dispatches (evidence: `backend/app/api/v1/router.py`)
- FastAPI runtime → API router: mounts (evidence: `backend/app/main.py`)
- Authentication API → Auth service: calls (evidence: `backend/app/api/v1/auth.py`)
- Authentication API → Token identity: creates tokens (evidence: `backend/app/api/v1/auth.py`)
- Task API → Task service: calls (evidence: `backend/app/api/v1/tasks.py`)
- Appointment API → Appointment service: calls (evidence: `backend/app/api/v1/appointments.py`)
- Auth service → User repository: uses (evidence: `backend/app/services/auth.py`)
- Auth service → Refresh sessions: uses (evidence: `backend/app/services/auth.py`)
- Auth service → Token identity: uses (evidence: `backend/app/services/auth.py`)
- Task service → Task repository: delegates (evidence: `backend/app/services/tasks.py`)
- Task repository → Task records: queries (evidence: `backend/app/repositories/tasks.py`)
- Task API → PostgreSQL: injects session (evidence: `backend/app/api/v1/tasks.py`)
- Authentication API → PostgreSQL: injects session (evidence: `backend/app/api/v1/auth.py`)
- Appointment API → PostgreSQL: injects session (evidence: `backend/app/api/v1/appointments.py`)
- FastAPI runtime → Prometheus metrics: configures (evidence: `backend/app/main.py`)
- FastAPI runtime → Telemetry setup: configures (evidence: `backend/app/main.py`)
- FastAPI runtime → Structured logging: configures (evidence: `backend/app/main.py`)
