How kirillkaszycki/fastapi-course works
Finance tracker is a FastAPI application for managing users, currency-denominated wallets, income and expenses, transfers, and balances. The principal workflow is an HTTP request through a versioned API route, with database-session and user dependencies, into a service that applies domain rules and coordinates repository access; responses use Pydantic schemas. Wallet balances can be converted using an external exchange-rate service, with fallback rates. The README documents the API/service/repository layers; some user and startup connections are supported only by the SOURCE INDEX, and the frontend’s runtime wiring was not sampled.
Main entry points: dependency.py Request dependencies · main.py FastAPI app · users.py User routes · wallets.py Wallet routes
Components 20
HTTP and UI
- FastAPI app
main.py - User routes
app/api/v1/users.py - Wallet routes
app/api/v1/wallets.py - Operation routes
app/api/v1/operations.py - Static web UI
app/static
Finance services
- User service
app/services/users.py - Wallet service
app/services/wallets.py - Operation service
app/services/operations.py - Exchange rates
app/services/exchange_service.py
Persistence
- User repository
app/repository/users.py - Wallet repository
app/repository/wallets.py - Operation repository
app/repository/operations.py - Finance database
Shared infrastructure
- Request dependencies
app/dependency.py - DB session setup
app/database.py - Request and response schemas
app/schemas.py - ORM models
app/models.py - Currency and operation types
app/enum.py
Other components
- API client
- Exchange-rate API
Connections 28
- API client → FastAPI app: sends requests
README.md - FastAPI app → User routes: registers routes
main.py - FastAPI app → Wallet routes: registers routes
main.py - FastAPI app → Operation routes: registers routes
main.py - User routes → User service: delegates to
app/api/v1/users.py - Wallet routes → Wallet service: delegates to
app/api/v1/wallets.py - Operation routes → Operation service: delegates to
app/api/v1/operations.py - User routes → Request dependencies: uses auth and DB
app/api/v1/users.py - Wallet routes → Request dependencies: uses DB session
app/api/v1/wallets.py - Operation routes → Request dependencies: uses auth and DB
app/api/v1/operations.py - User service → User repository: uses
app/services/users.py - Wallet service → Wallet repository: uses
app/services/wallets.py - Operation service → Wallet repository: uses
app/services/operations.py - Operation service → Operation repository: records operations
app/services/operations.py - Wallet service → Exchange rates: converts balances
app/services/wallets.py - Operation service → Exchange rates: converts transfers
app/services/operations.py - Exchange rates → Exchange-rate API: requests rates
app/services/exchange_service.py - Request dependencies → DB session setup: opens sessions
app/dependency.py - Request dependencies → User repository: looks up user
app/dependency.py - DB session setup → Finance database: configures connection
README.md - User repository → Finance database: accesses records
README.md - Wallet repository → Finance database: accesses records
README.md - Operation repository → Finance database: accesses records
README.md - ORM models → DB session setup: uses declarative base
app/models.py - User routes → Request and response schemas: validates and shapes
app/api/v1/users.py - Wallet routes → Request and response schemas: validates and shapes
app/api/v1/wallets.py - Operation routes → Request and response schemas: validates and shapes
app/api/v1/operations.py - Static web UI → API client: serves interface