How sejpalvatsal456/goodbudget_backend works
Good Budget Backends is an Express API for account, transaction, category, user, authentication, and spending-summary operations backed by PostgreSQL. A client request enters the app in src/index.ts, is dispatched to a mounted router, and reaches a controller; protected routes first verify the bearer token and confirm the user exists. Controllers validate inputs, query or update the database, and return JSON results. The README gives no further capability detail; controller excerpts and the source index support the principal operations, but some controller behavior is unsampled.
Main entry points: index.ts Express app · pgInit.ts PostgreSQL pool · authMidddleware.ts Token middleware · validations.ts Input validation
Components 18
API entry
- Express app
src/index.ts - User routes
src/routes/usersRoute.ts - Account routes
src/routes/accountsRoute.ts - Transaction routes
src/routes/transactionsRoute.ts - Category routes
src/routes/categoryRoute.ts - Summary routes
src/routes/summaryRoutes.ts
Identity and access
- Auth routes
src/routes/authRoute.ts - User operations
src/controllers/usersController.ts - Signup and login
src/controllers/authController.ts - Token middleware
src/middlewares/authMidddleware.ts
Budget operations
- Account operations
src/controllers/accountsController.ts - Transaction operations
src/controllers/transactionsController.ts - Category operations
src/controllers/categoryController.ts - Transaction summaries
src/controllers/summaryController.ts
Shared services
- Input validation
src/lib/validations.ts - PostgreSQL pool
src/lib/pgInit.ts
Other components
- API client
- PostgreSQL database
Connections 30
- API client → Express app: sends requests
- Express app → User routes: mounts routes
src/index.ts - Express app → Account routes: mounts routes
src/index.ts - Express app → Transaction routes: mounts routes
src/index.ts - Express app → Category routes: mounts routes
src/index.ts - Express app → Summary routes: mounts routes
src/index.ts - Express app → Auth routes: mounts routes
src/index.ts - User routes → User operations: dispatches to
src/routes/usersRoute.ts - Auth routes → Signup and login: dispatches to
src/routes/authRoute.ts - Account routes → Account operations: dispatches to
src/routes/accountsRoute.ts - Transaction routes → Transaction operations: dispatches to
src/routes/transactionsRoute.ts - Category routes → Category operations: dispatches to
src/routes/categoryRoute.ts - Summary routes → Transaction summaries: dispatches to
src/routes/summaryRoutes.ts - Account routes → Token middleware: guards routes
src/routes/accountsRoute.ts - Transaction routes → Token middleware: guards routes
src/routes/transactionsRoute.ts - Category routes → Token middleware: guards routes
src/routes/categoryRoute.ts - Summary routes → Token middleware: guards routes
src/routes/summaryRoutes.ts - Signup and login → PostgreSQL pool: queries
src/controllers/authController.ts - User operations → PostgreSQL pool: queries
src/controllers/usersController.ts - Account operations → PostgreSQL pool: queries
src/controllers/accountsController.ts - Transaction operations → PostgreSQL pool: queries
src/controllers/transactionsController.ts - Category operations → PostgreSQL pool: queries
src/controllers/categoryController.ts - Transaction summaries → PostgreSQL pool: queries
src/controllers/summaryController.ts - Token middleware → PostgreSQL pool: checks user
src/middlewares/authMidddleware.ts - PostgreSQL pool → PostgreSQL database: queries database
src/lib/pgInit.ts - Signup and login → Input validation: validates input
src/controllers/authController.ts - User operations → Input validation: validates input
src/controllers/usersController.ts - Account operations → Input validation: validates input
src/controllers/accountsController.ts - Transaction operations → Input validation: validates input
src/controllers/transactionsController.ts - Transaction summaries → Input validation: validates dates
src/controllers/summaryController.ts