# sejpalvatsal456/goodbudget_backend architecture

> Architecture diagram of the GitHub repository sejpalvatsal456/goodbudget_backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sejpalvatsal456/goodbudget_backend
- Repository: https://github.com/sejpalvatsal456/goodbudget_backend

## Overview

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: [`src/index.ts`](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/index.ts) (Express app), [`src/lib/pgInit.ts`](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/lib/pgInit.ts) (PostgreSQL pool), [`src/middlewares/authMidddleware.ts`](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/middlewares/authMidddleware.ts) (Token middleware), [`src/lib/validations.ts`](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/lib/validations.ts) (Input validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_app["Express app<br/>[index.ts]"]
  node_users_route["User routes<br/>[usersRoute.ts]"]
  node_accounts_route["Account routes<br/>[accountsRoute.ts]"]
  node_transactions_route["Transaction routes"]
  node_category_route["Category routes<br/>[categoryRoute.ts]"]
  node_summary_route["Summary routes<br/>[summaryRoutes.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_route["Auth routes<br/>[authRoute.ts]"]
  node_users["User operations<br/>[usersController.ts]"]
  node_auth["Signup and login<br/>[authController.ts]"]
  node_auth_middleware["Token middleware<br/>[authMidddleware.ts]"]
end

subgraph group_budget["Budget operations"]
  node_accounts["Account operations"]
  node_transactions["Transaction operations"]
  node_categories["Category operations"]
  node_summaries["Transaction summaries"]
end

subgraph group_shared["Shared services"]
  node_validation["Input validation<br/>[validations.ts]"]
  node_pg_pool["PostgreSQL pool<br/>[pgInit.ts]"]
end

node_client(("API client"))
node_postgres[("PostgreSQL database")]

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_users_route
node_app -->|"mounts routes"| node_accounts_route
node_app -->|"mounts routes"| node_transactions_route
node_app -->|"mounts routes"| node_category_route
node_app -->|"mounts routes"| node_summary_route
node_app -->|"mounts routes"| node_auth_route
node_users_route -->|"dispatches to"| node_users
node_auth_route -->|"dispatches to"| node_auth
node_accounts_route -->|"dispatches to"| node_accounts
node_transactions_route -->|"dispatches to"| node_transactions
node_category_route -->|"dispatches to"| node_categories
node_summary_route -->|"dispatches to"| node_summaries
node_accounts_route -->|"guards routes"| node_auth_middleware
node_transactions_route -->|"guards routes"| node_auth_middleware
node_category_route -->|"guards routes"| node_auth_middleware
node_summary_route -->|"guards routes"| node_auth_middleware
node_auth -->|"queries"| node_pg_pool
node_users -->|"queries"| node_pg_pool
node_accounts -->|"queries"| node_pg_pool
node_transactions -->|"queries"| node_pg_pool
node_categories -->|"queries"| node_pg_pool
node_summaries -->|"queries"| node_pg_pool
node_auth_middleware -->|"checks user"| node_pg_pool
node_pg_pool -->|"queries database"| node_postgres
node_auth -->|"validates input"| node_validation
node_users -->|"validates input"| node_validation
node_accounts -->|"validates input"| node_validation
node_transactions -->|"validates input"| node_validation
node_summaries -->|"validates dates"| node_validation

click node_app "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/index.ts"
click node_users_route "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/usersRoute.ts"
click node_auth_route "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/authRoute.ts"
click node_users "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/usersController.ts"
click node_auth "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/authController.ts"
click node_auth_middleware "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/middlewares/authMidddleware.ts"
click node_accounts_route "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/accountsRoute.ts"
click node_transactions_route "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/transactionsRoute.ts"
click node_category_route "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/categoryRoute.ts"
click node_summary_route "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/summaryRoutes.ts"
click node_accounts "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/accountsController.ts"
click node_transactions "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/transactionsController.ts"
click node_categories "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/categoryController.ts"
click node_summaries "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/summaryController.ts"
click node_validation "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/lib/validations.ts"
click node_pg_pool "https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/lib/pgInit.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_users_route,node_accounts_route,node_transactions_route,node_category_route,node_summary_route,node_client toneBlue
class node_auth_route,node_users,node_auth,node_auth_middleware,node_postgres toneAmber
class node_accounts,node_transactions,node_categories,node_summaries toneMint
class node_validation,node_pg_pool toneRose
```

## Components

### API entry

- [Express app](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/index.ts): `src/index.ts`
- [User routes](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/usersRoute.ts): `src/routes/usersRoute.ts`
- [Account routes](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/accountsRoute.ts): `src/routes/accountsRoute.ts`
- [Transaction routes](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/transactionsRoute.ts): `src/routes/transactionsRoute.ts`
- [Category routes](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/categoryRoute.ts): `src/routes/categoryRoute.ts`
- [Summary routes](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/summaryRoutes.ts): `src/routes/summaryRoutes.ts`

### Identity and access

- [Auth routes](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/routes/authRoute.ts): `src/routes/authRoute.ts`
- [User operations](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/usersController.ts): `src/controllers/usersController.ts`
- [Signup and login](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/authController.ts): `src/controllers/authController.ts`
- [Token middleware](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/middlewares/authMidddleware.ts): `src/middlewares/authMidddleware.ts`

### Budget operations

- [Account operations](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/accountsController.ts): `src/controllers/accountsController.ts`
- [Transaction operations](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/transactionsController.ts): `src/controllers/transactionsController.ts`
- [Category operations](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/categoryController.ts): `src/controllers/categoryController.ts`
- [Transaction summaries](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/controllers/summaryController.ts): `src/controllers/summaryController.ts`

### Shared services

- [Input validation](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/lib/validations.ts): `src/lib/validations.ts`
- [PostgreSQL pool](https://github.com/sejpalvatsal456/goodbudget_backend/blob/main/src/lib/pgInit.ts): `src/lib/pgInit.ts`

### Other components

- **API client**
- **PostgreSQL database**

## Connections

- API client → Express app: sends requests
- Express app → User routes: mounts routes (evidence: `src/index.ts`)
- Express app → Account routes: mounts routes (evidence: `src/index.ts`)
- Express app → Transaction routes: mounts routes (evidence: `src/index.ts`)
- Express app → Category routes: mounts routes (evidence: `src/index.ts`)
- Express app → Summary routes: mounts routes (evidence: `src/index.ts`)
- Express app → Auth routes: mounts routes (evidence: `src/index.ts`)
- User routes → User operations: dispatches to (evidence: `src/routes/usersRoute.ts`)
- Auth routes → Signup and login: dispatches to (evidence: `src/routes/authRoute.ts`)
- Account routes → Account operations: dispatches to (evidence: `src/routes/accountsRoute.ts`)
- Transaction routes → Transaction operations: dispatches to (evidence: `src/routes/transactionsRoute.ts`)
- Category routes → Category operations: dispatches to (evidence: `src/routes/categoryRoute.ts`)
- Summary routes → Transaction summaries: dispatches to (evidence: `src/routes/summaryRoutes.ts`)
- Account routes → Token middleware: guards routes (evidence: `src/routes/accountsRoute.ts`)
- Transaction routes → Token middleware: guards routes (evidence: `src/routes/transactionsRoute.ts`)
- Category routes → Token middleware: guards routes (evidence: `src/routes/categoryRoute.ts`)
- Summary routes → Token middleware: guards routes (evidence: `src/routes/summaryRoutes.ts`)
- Signup and login → PostgreSQL pool: queries (evidence: `src/controllers/authController.ts`)
- User operations → PostgreSQL pool: queries (evidence: `src/controllers/usersController.ts`)
- Account operations → PostgreSQL pool: queries (evidence: `src/controllers/accountsController.ts`)
- Transaction operations → PostgreSQL pool: queries (evidence: `src/controllers/transactionsController.ts`)
- Category operations → PostgreSQL pool: queries (evidence: `src/controllers/categoryController.ts`)
- Transaction summaries → PostgreSQL pool: queries (evidence: `src/controllers/summaryController.ts`)
- Token middleware → PostgreSQL pool: checks user (evidence: `src/middlewares/authMidddleware.ts`)
- PostgreSQL pool → PostgreSQL database: queries database (evidence: `src/lib/pgInit.ts`)
- Signup and login → Input validation: validates input (evidence: `src/controllers/authController.ts`)
- User operations → Input validation: validates input (evidence: `src/controllers/usersController.ts`)
- Account operations → Input validation: validates input (evidence: `src/controllers/accountsController.ts`)
- Transaction operations → Input validation: validates input (evidence: `src/controllers/transactionsController.ts`)
- Transaction summaries → Input validation: validates dates (evidence: `src/controllers/summaryController.ts`)
