How uep1x/todo-auth works
This is a FastAPI backend for account signup, login and logout, plus retrieval of a user’s items using an access cookie. Requests enter through the application router and endpoint handlers; authentication handlers coordinate user/item CRUD, credential encryption and cookie generation, while the item handler retrieves and maps item data. SQLAlchemy models represent users and items, backed by a PostgreSQL-configured engine. The graph follows shown calls and SOURCE INDEX references; it does not infer unshown database wiring beyond the session configuration.
Main entry points: auth.py Auth endpoints · item.py Item endpoint · main.py FastAPI app · mappers.py ORM mappers
Components 15
API entry
- FastAPI app
backend/app/main.py - API router
backend/app/api/api.py - DB dependency
backend/app/api/deps.py
Account and items
- Auth endpoints
backend/app/api/endpoints/auth.py - Item endpoint
backend/app/api/endpoints/item.py
Persistence
- User CRUD
backend/app/crud/user.py - Item CRUD
backend/app/crud/item.py - ORM models
backend/app/models/models.py - DB session
backend/app/db/session.py
Schemas and security
- Request schemas
backend/app/schemas/schemas.py - ORM mappers
backend/app/schemas/mappers.py - Credential crypto
backend/app/services/crypt.py - Cookie generator
backend/app/services/generation_cookie.py
Other components
- API client
- PostgreSQL
Connections 24
- API client → FastAPI app: sends requests
- FastAPI app → API router: mounts routes
backend/app/main.py - FastAPI app → DB session: creates tables
backend/app/main.py - FastAPI app → ORM models: creates tables
backend/app/main.py - API router → Auth endpoints: registers routes
backend/app/api/api.py - API router → Item endpoint: registers routes
backend/app/api/api.py - Auth endpoints → DB dependency: requests session
backend/app/api/endpoints/auth.py - Item endpoint → DB dependency: requests session
backend/app/api/endpoints/item.py - DB dependency → DB session: opens session
backend/app/api/deps.py - Auth endpoints → Request schemas: validates payload
backend/app/api/endpoints/auth.py - Item endpoint → Request schemas: validates payload
backend/app/api/endpoints/item.py - Auth endpoints → User CRUD: manages accounts
backend/app/api/endpoints/auth.py - Auth endpoints → Item CRUD: manages cookies
backend/app/api/endpoints/auth.py - Item endpoint → Item CRUD: fetches items
backend/app/api/endpoints/item.py - Auth endpoints → Credential crypto: checks passwords
backend/app/api/endpoints/auth.py - Auth endpoints → Cookie generator: generates cookie
backend/app/api/endpoints/auth.py - Cookie generator → Credential crypto: encrypts token
backend/app/services/generation_cookie.py - Auth endpoints → ORM mappers: maps user
backend/app/api/endpoints/auth.py - Item endpoint → ORM mappers: maps items
backend/app/api/endpoints/item.py - User CRUD → ORM models: queries users
backend/app/crud/user.py - Item CRUD → ORM models: queries items
backend/app/crud/item.py - ORM mappers → ORM models: reads ORM fields
backend/app/schemas/mappers.py - ORM mappers → Request schemas: builds models
backend/app/schemas/mappers.py - DB session → PostgreSQL: configures engine
backend/app/db/session.py