How yousskadi/app-todos works
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: App.tsx App and routes · router.py API router · main.py FastAPI runtime · auth.py Authentication API
Components 26
Web application
- App and routes
frontend/src/App.tsx - Auth context
frontend/src/context/AuthContext.tsx - Login and register
frontend/src/pages/LoginPage.tsx - Task workflows
frontend/src/pages/TasksPage.tsx - Appointment calendar
frontend/src/pages/AppointmentsPage.tsx - Today dashboard
frontend/src/pages/TodayPage.tsx - Reminder notifications
frontend/src/features/appointments/useReminders.ts - API client
frontend/src/lib/api.ts
API and security
- API router
backend/app/api/v1/router.py - Authentication API
backend/app/api/v1/auth.py - Task API
backend/app/api/v1/tasks.py - Appointment API
backend/app/api/v1/appointments.py - Token identity
backend/app/security/tokens.py - FastAPI runtime
backend/app/main.py
Planning domains
- Auth service
backend/app/services/auth.py - Task service
backend/app/services/tasks.py - Appointment service
backend/app/services/appointments.py
Persistence
- Task repository
backend/app/repositories/tasks.py - User repository
backend/app/repositories/users.py - Refresh sessions
backend/app/repositories/refresh_sessions.py - Task records
backend/app/models/task.py - PostgreSQL
backend/app/db/session.py
Observability
- Telemetry setup
backend/app/telemetry.py - Prometheus metrics
backend/app/metrics.py - Structured logging
backend/app/logging_config.py
Other components
- User
Connections 30
- User → App and routes: uses
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
backend/app/api/v1/router.py - API router → Task API: dispatches
backend/app/api/v1/router.py - API router → Appointment API: dispatches
backend/app/api/v1/router.py - FastAPI runtime → API router: mounts
backend/app/main.py - Authentication API → Auth service: calls
backend/app/api/v1/auth.py - Authentication API → Token identity: creates tokens
backend/app/api/v1/auth.py - Task API → Task service: calls
backend/app/api/v1/tasks.py - Appointment API → Appointment service: calls
backend/app/api/v1/appointments.py - Auth service → User repository: uses
backend/app/services/auth.py - Auth service → Refresh sessions: uses
backend/app/services/auth.py - Auth service → Token identity: uses
backend/app/services/auth.py - Task service → Task repository: delegates
backend/app/services/tasks.py - Task repository → Task records: queries
backend/app/repositories/tasks.py - Task API → PostgreSQL: injects session
backend/app/api/v1/tasks.py - Authentication API → PostgreSQL: injects session
backend/app/api/v1/auth.py - Appointment API → PostgreSQL: injects session
backend/app/api/v1/appointments.py - FastAPI runtime → Prometheus metrics: configures
backend/app/main.py - FastAPI runtime → Telemetry setup: configures
backend/app/main.py - FastAPI runtime → Structured logging: configures
backend/app/main.py