How gitjoao/my-finance works
This is an Express personal-finance API. Clients authenticate, then use protected endpoints to manage transactions and categories, inspect budgets and reports, and access dashboard routes. Transaction handling covers filtering, summaries, fixed-expense presets, and credit-card bill payment. Controllers delegate to services and, where evidenced, repositories backed by Prisma and PostgreSQL. The README is empty; feature scope comes from the route and module names. Some connections rely on SOURCE INDEX references rather than full source excerpts, so uncertain runtime wiring is omitted.
Main entry points: index.ts Route registry · controller.ts Transaction controller · repository.ts Transaction repository · categories Category management
Components 22
API and security
- Route registry
src/routes/index.ts - Express app
src/app.ts - Auth middleware
src/middlewares/auth.ts - Login limiter
src/middlewares/rateLimit.ts - Request validation
src/middlewares/validate.ts
Identity
- Auth routes
src/modules/auth/routes.ts - Auth controller
src/modules/auth/controller.ts - Auth service
src/modules/auth/service.ts - User management
src/modules/users
Finance operations
- Transaction routes
src/modules/transactions/routes.ts - Transaction controller
src/modules/transactions/controller.ts - Transaction service
src/modules/transactions/service.ts - Transaction repository
src/modules/transactions/repository.ts - Fixed-expense presets
src/modules/transactions/preset/fixedExpenses.ts - Category management
src/modules/categories - Text normalization
src/utils/string.ts
Finance insights
- Budget views
src/modules/budgets - Reports
src/modules/reports - Dashboard routes
src/modules/dashboard/routes.ts
Persistence
- Prisma client
src/lib/prisma.ts - PostgreSQL
Other components
- API client
Connections 29
- API client → Express app: sends requests
- Express app → Route registry: mounts routes
src/app.ts - Route registry → Auth middleware: protects endpoints
src/routes/index.ts - Route registry → Login limiter: limits login
src/routes/index.ts - Route registry → Auth routes: mounts auth
src/routes/index.ts - Route registry → Transaction routes: mounts transactions
src/routes/index.ts - Route registry → Category management: mounts categories
src/routes/index.ts - Route registry → Budget views: mounts budgets
src/routes/index.ts - Route registry → Reports: mounts reports
src/routes/index.ts - Route registry → User management: mounts users
src/routes/index.ts - Route registry → Dashboard routes: mounts dashboard
src/routes/index.ts - Auth routes → Request validation: uses validation
src/modules/auth/routes.ts - Auth routes → Auth controller: dispatches to
src/modules/auth/routes.ts - Auth controller → Auth service: calls
src/modules/auth/controller.ts - Auth service → User management: looks up users
src/modules/auth/service.ts - Transaction routes → Request validation: uses validation
src/modules/transactions/routes.ts - Transaction routes → Transaction controller: dispatches to
src/modules/transactions/routes.ts - Transaction controller → Transaction service: calls
src/modules/transactions/controller.ts - Transaction controller → Text normalization: normalizes text
src/modules/transactions/controller.ts - Transaction service → Transaction repository: uses repository
src/modules/transactions/service.ts - Transaction service → Fixed-expense presets: uses presets
src/modules/transactions/service.ts - Transaction repository → Prisma client: queries through
src/modules/transactions/repository.ts - Category management → Prisma client: persists categories
src/modules/categories/repository.ts - Budget views → Category management: reads category data
src/modules/budgets/service.ts - Budget views → Transaction repository: reads transactions
src/modules/budgets/service.ts - Reports → Category management: reads category data
src/modules/reports/service.ts - Reports → Transaction repository: reads transactions
src/modules/reports/service.ts - Prisma client → PostgreSQL: connects to
src/lib/prisma.ts - Dashboard routes → Transaction controller: references controller
src/modules/dashboard/routes.ts