How keval2609/expense-splitter works
Expense Splitter is a REST API for shared group expenses. Its principal flow is user authentication, group setup, expense entry with split rules, balance calculation, debt-simplification suggestions, and settlement recording. The graph includes the API entry point, authentication and domain handlers, split and balance logic, and persistence. Some endpoint and schema details are represented from the README and source index; unsampled implementation links are omitted where the evidence does not establish them.
Main entry points: deps.py Auth Dependencies · main.py FastAPI App · expenses.py Expense Routes · models Domain Models
Components 18
API Layer
- FastAPI App
app/main.py - User Routes
app/api/endpoints/users.py - Group Routes
app/api/endpoints/groups.py - Expense Routes
app/api/endpoints/expenses.py - Settlement Routes
app/api/endpoints/settlements.py - Balance Routes
app/api/endpoints/balances.py - Simplify Routes
app/api/endpoints/simplify.py - Request Schemas
app/schemas
Calculation Logic
- Split Engine
app/split_engine/core.py - Balance Ledger
app/services/balance.py - Exact Simplifier
app/simplify/exact.py - Greedy Simplifier
app/simplify/greedy.py
Identity
- Auth Dependencies
app/api/deps.py - Token Service
app/services/auth.py
Persistence
- Domain Models
app/models - DB Sessions
app/db.py
Other components
- API Client
- PostgreSQL
Connections 36
- API Client → FastAPI App: sends requests
README.md - FastAPI App → User Routes: registers router
app/main.py - FastAPI App → Group Routes: registers router
app/main.py - FastAPI App → Expense Routes: registers router
app/main.py - FastAPI App → Settlement Routes: registers router
app/main.py - FastAPI App → Balance Routes: registers router
app/main.py - FastAPI App → Simplify Routes: registers router
app/main.py - User Routes → Token Service: uses tokens
app/api/endpoints/users.py - Auth Dependencies → Token Service: decodes token
app/api/deps.py - User Routes → Auth Dependencies: uses dependency
app/api/endpoints/users.py - Group Routes → Auth Dependencies: uses dependency
app/api/endpoints/groups.py - Expense Routes → Auth Dependencies: uses dependency
app/api/endpoints/expenses.py - Settlement Routes → Auth Dependencies: uses dependency
app/api/endpoints/settlements.py - Balance Routes → Auth Dependencies: uses dependency
app/api/endpoints/balances.py - Simplify Routes → Auth Dependencies: uses dependency
app/api/endpoints/simplify.py - Expense Routes → Split Engine: calculates splits
app/api/endpoints/expenses.py - Expense Routes → Request Schemas: validates input
app/api/endpoints/expenses.py - Group Routes → Request Schemas: uses schemas
app/api/endpoints/groups.py - User Routes → Request Schemas: uses schemas
app/api/endpoints/users.py - Settlement Routes → Request Schemas: uses schemas
app/api/endpoints/settlements.py - Balance Routes → Balance Ledger: reads balances
app/api/endpoints/balances.py - Simplify Routes → Balance Ledger: computes balances
app/api/endpoints/simplify.py - Simplify Routes → Exact Simplifier: requests simplification
app/api/endpoints/simplify.py - Simplify Routes → Greedy Simplifier: requests simplification
app/api/endpoints/simplify.py - Exact Simplifier → Greedy Simplifier: solves subsets
app/simplify/exact.py - Auth Dependencies → Domain Models: queries users
app/api/deps.py - Expense Routes → Domain Models: reads and writes
app/api/endpoints/expenses.py - Group Routes → Domain Models: reads and writes
app/api/endpoints/groups.py - Settlement Routes → Domain Models: reads and writes
app/api/endpoints/settlements.py - Balance Ledger → Domain Models: aggregates ledger
app/services/balance.py - User Routes → Domain Models: reads and writes
app/api/endpoints/users.py - Auth Dependencies → DB Sessions: gets session
app/api/deps.py - FastAPI App → DB Sessions: checks readiness
app/main.py - DB Sessions → PostgreSQL: opens sessions
app/db.py - Expense Routes → PostgreSQL: commits records
README.md - Settlement Routes → PostgreSQL: records payments
README.md