# ajaysrinivasr/fintor_app architecture

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

- Interactive diagram: https://gitdiagram.com/ajaysrinivasr/fintor_app
- Repository: https://github.com/ajaysrinivasr/fintor_app

## Overview

Fintor is a personal-finance backend: authenticated clients manage expenses and profiles, import transaction data, and request budget and spending insights. The available tree contains backend code and native Flutter runners, but no Flutter application source, so the graph focuses on the evidenced API runtime rather than inventing a client workflow. Backend routes expose several product areas, though the sampled server excerpt mounts only a subset. Forecast internals and transaction handling are excerpted; other controller behavior is represented only where route references establish it.

Main entry points: [`backend/server.js`](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/server.js) (HTTP server), [`backend/middleware/auth.js`](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/middleware/auth.js) (Token protection), [`backend/services/forecastEngine.js`](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/services/forecastEngine.js) (Forecast engine), [`backend/routes/importRoutes.js`](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/importRoutes.js) (Import routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Auth controller<br/>[authController.js]"]
  node_auth_middleware["Token protection<br/>[auth.js]"]
  node_user_controller["User controller<br/>[userController.js]"]
end

subgraph group_transactions["Transaction capture"]
  node_expense_routes["Expense routes<br/>[expenseRoutes.js]"]
  node_expense_controller["Expense controller"]
  node_import_routes["Import routes<br/>[importRoutes.js]"]
  node_import_controller["CSV import"]
  node_categorizer["Category matcher<br/>[categorizer.js]"]
  node_upload["File upload<br/>[upload.js]"]
  node_sms_routes["SMS templates<br/>[smsRoutes.js]"]
end

subgraph group_planning["Budgets and insights"]
  node_budget_routes["Budget routes<br/>[budgetRoutes.js]"]
  node_budget_controller["Budget controller"]
  node_forecast_routes["Forecast routes<br/>[forecastRoutes.js]"]
  node_forecast_controller["Forecast controller"]
  node_forecast_engine["Forecast engine<br/>[forecastEngine.js]"]
  node_math_utils["Forecast math<br/>[mathUtils.js]"]
  node_category_routes["Category routes<br/>[categoryRoutes.js]"]
  node_category_controller["Category controller"]
  node_insight_routes["Insight routes<br/>[insightRoutes.js]"]
  node_insight_controller["Insight controller"]
end

subgraph group_data["Finance data"]
  node_user_model[("User records<br/>[User.js]")]
  node_expense_model[("Expense records<br/>[Expense.js]")]
  node_category_model[("Category records<br/>[Category.js]")]
  node_budget_model[("Budget records<br/>[Budget.js]")]
  node_db_config["Database setup<br/>[db.js]"]
end

node_client(("Finance client"))

node_client -->|"sends API requests"| node_server
node_server -->|"mounts auth API"| node_auth_routes
node_server -->|"mounts expense API"| node_expense_routes
node_server -->|"mounts budget API"| node_budget_routes
node_server -->|"mounts category API"| node_category_routes
node_server -->|"mounts insight API"| node_insight_routes
node_server -->|"mounts SMS API"| node_sms_routes
node_server -->|"connects database"| node_db_config
node_server -.->|"route wiring unclear"| node_import_routes
node_server -.->|"route wiring unclear"| node_forecast_routes
node_auth_routes -->|"routes requests"| node_auth_controller
node_auth_routes -->|"uses protection"| node_auth_middleware
node_auth_controller -->|"reads and creates users"| node_user_model
node_auth_controller -->|"returns token and profile"| node_client
node_user_controller -->|"accesses users"| node_user_model
node_expense_routes -->|"routes requests"| node_expense_controller
node_expense_routes -->|"protects endpoints"| node_auth_middleware
node_expense_controller -->|"reads and writes expenses"| node_expense_model
node_expense_controller -->|"resolves categories"| node_category_model
node_import_routes -->|"routes uploads"| node_import_controller
node_import_routes -->|"protects endpoints"| node_auth_middleware
node_import_routes -->|"accepts files"| node_upload
node_import_controller -->|"guesses categories"| node_categorizer
node_import_controller -->|"inserts imported expenses"| node_expense_model
node_import_controller -->|"loads user categories"| node_category_model
node_forecast_routes -->|"routes requests"| node_forecast_controller
node_forecast_routes -->|"protects endpoints"| node_auth_middleware
node_forecast_controller -->|"requests forecasts"| node_forecast_engine
node_forecast_controller -->|"validates category"| node_category_model
node_forecast_engine -->|"aggregates spending"| node_expense_model
node_forecast_engine -->|"reads budget limit"| node_budget_model
node_forecast_engine -->|"loads category details"| node_category_model
node_forecast_engine -->|"computes projections"| node_math_utils
node_budget_routes -->|"routes requests"| node_budget_controller
node_budget_routes -->|"protects endpoints"| node_auth_middleware
node_category_routes -->|"routes requests"| node_category_controller
node_category_routes -->|"protects endpoints"| node_auth_middleware
node_insight_routes -->|"routes requests"| node_insight_controller
node_insight_routes -->|"protects endpoints"| node_auth_middleware

click node_server "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/server.js"
click node_auth_routes "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/authController.js"
click node_auth_middleware "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/middleware/auth.js"
click node_user_controller "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/userController.js"
click node_user_model "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/models/User.js"
click node_expense_routes "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/expenseRoutes.js"
click node_expense_controller "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/expenseController.js"
click node_import_routes "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/importRoutes.js"
click node_import_controller "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/importController.js"
click node_categorizer "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/middleware/categorizer.js"
click node_upload "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/middleware/upload.js"
click node_sms_routes "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/smsRoutes.js"
click node_expense_model "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/models/Expense.js"
click node_category_model "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/models/Category.js"
click node_budget_routes "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/budgetRoutes.js"
click node_budget_controller "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/budgetController.js"
click node_forecast_routes "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/forecastRoutes.js"
click node_forecast_controller "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/forecastController.js"
click node_forecast_engine "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/services/forecastEngine.js"
click node_math_utils "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/services/mathUtils.js"
click node_category_routes "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/categoryRoutes.js"
click node_category_controller "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/categoryController.js"
click node_insight_routes "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/insightRoutes.js"
click node_insight_controller "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/insightController.js"
click node_budget_model "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/models/Budget.js"
click node_db_config "https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/config/db.js"

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_server,node_auth_routes,node_auth_controller,node_auth_middleware,node_user_controller,node_client toneBlue
class node_expense_routes,node_expense_controller,node_import_routes,node_import_controller,node_categorizer,node_upload,node_sms_routes toneAmber
class node_budget_routes,node_budget_controller,node_forecast_routes,node_forecast_controller,node_forecast_engine,node_math_utils,node_category_routes,node_category_controller,node_insight_routes,node_insight_controller toneMint
class node_user_model,node_expense_model,node_category_model,node_budget_model,node_db_config toneRose
```

## Components

### API and identity

- [HTTP server](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Auth controller](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Token protection](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [User controller](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`

### Transaction capture

- [Expense routes](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/expenseRoutes.js): `backend/routes/expenseRoutes.js`
- [Expense controller](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/expenseController.js): `backend/controllers/expenseController.js`
- [Import routes](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/importRoutes.js): `backend/routes/importRoutes.js`
- [CSV import](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/importController.js): `backend/controllers/importController.js`
- [Category matcher](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/middleware/categorizer.js): `backend/middleware/categorizer.js`
- [File upload](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/middleware/upload.js): `backend/middleware/upload.js`
- [SMS templates](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/smsRoutes.js): `backend/routes/smsRoutes.js`

### Budgets and insights

- [Budget routes](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/budgetRoutes.js): `backend/routes/budgetRoutes.js`
- [Budget controller](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/budgetController.js): `backend/controllers/budgetController.js`
- [Forecast routes](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/forecastRoutes.js): `backend/routes/forecastRoutes.js`
- [Forecast controller](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/forecastController.js): `backend/controllers/forecastController.js`
- [Forecast engine](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/services/forecastEngine.js): `backend/services/forecastEngine.js`
- [Forecast math](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/services/mathUtils.js): `backend/services/mathUtils.js`
- [Category routes](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/categoryRoutes.js): `backend/routes/categoryRoutes.js`
- [Category controller](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/categoryController.js): `backend/controllers/categoryController.js`
- [Insight routes](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/routes/insightRoutes.js): `backend/routes/insightRoutes.js`
- [Insight controller](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/controllers/insightController.js): `backend/controllers/insightController.js`

### Finance data

- [User records](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/models/User.js): `backend/models/User.js`
- [Expense records](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/models/Expense.js): `backend/models/Expense.js`
- [Category records](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/models/Category.js): `backend/models/Category.js`
- [Budget records](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/models/Budget.js): `backend/models/Budget.js`
- [Database setup](https://github.com/ajaysrinivasr/fintor_app/blob/main/backend/config/db.js): `backend/config/db.js`

### Other components

- **Finance client**

## Connections

- Finance client → HTTP server: sends API requests (evidence: `backend/server.js`)
- HTTP server → Auth routes: mounts auth API (evidence: `backend/server.js`)
- HTTP server → Expense routes: mounts expense API (evidence: `backend/server.js`)
- HTTP server → Budget routes: mounts budget API (evidence: `backend/server.js`)
- HTTP server → Category routes: mounts category API (evidence: `backend/server.js`)
- HTTP server → Insight routes: mounts insight API (evidence: `backend/server.js`)
- HTTP server → SMS templates: mounts SMS API (evidence: `backend/server.js`)
- HTTP server → Database setup: connects database (evidence: `backend/server.js`)
- HTTP server → Import routes: route wiring unclear
- HTTP server → Forecast routes: route wiring unclear
- Auth routes → Auth controller: routes requests (evidence: `backend/routes/authRoutes.js`)
- Auth routes → Token protection: uses protection (evidence: `backend/routes/authRoutes.js`)
- Auth controller → User records: reads and creates users (evidence: `backend/controllers/authController.js`)
- Auth controller → Finance client: returns token and profile (evidence: `backend/controllers/authController.js`)
- User controller → User records: accesses users (evidence: `backend/controllers/userController.js`)
- Expense routes → Expense controller: routes requests (evidence: `backend/routes/expenseRoutes.js`)
- Expense routes → Token protection: protects endpoints (evidence: `backend/routes/expenseRoutes.js`)
- Expense controller → Expense records: reads and writes expenses (evidence: `backend/controllers/expenseController.js`)
- Expense controller → Category records: resolves categories (evidence: `backend/controllers/expenseController.js`)
- Import routes → CSV import: routes uploads (evidence: `backend/routes/importRoutes.js`)
- Import routes → Token protection: protects endpoints (evidence: `backend/routes/importRoutes.js`)
- Import routes → File upload: accepts files (evidence: `backend/routes/importRoutes.js`)
- CSV import → Category matcher: guesses categories (evidence: `backend/controllers/importController.js`)
- CSV import → Expense records: inserts imported expenses (evidence: `backend/controllers/importController.js`)
- CSV import → Category records: loads user categories (evidence: `backend/controllers/importController.js`)
- Forecast routes → Forecast controller: routes requests (evidence: `backend/routes/forecastRoutes.js`)
- Forecast routes → Token protection: protects endpoints (evidence: `backend/routes/forecastRoutes.js`)
- Forecast controller → Forecast engine: requests forecasts (evidence: `backend/controllers/forecastController.js`)
- Forecast controller → Category records: validates category (evidence: `backend/controllers/forecastController.js`)
- Forecast engine → Expense records: aggregates spending (evidence: `backend/services/forecastEngine.js`)
- Forecast engine → Budget records: reads budget limit (evidence: `backend/services/forecastEngine.js`)
- Forecast engine → Category records: loads category details (evidence: `backend/services/forecastEngine.js`)
- Forecast engine → Forecast math: computes projections (evidence: `backend/services/forecastEngine.js`)
- Budget routes → Budget controller: routes requests (evidence: `backend/routes/budgetRoutes.js`)
- Budget routes → Token protection: protects endpoints (evidence: `backend/routes/budgetRoutes.js`)
- Category routes → Category controller: routes requests (evidence: `backend/routes/categoryRoutes.js`)
- Category routes → Token protection: protects endpoints (evidence: `backend/routes/categoryRoutes.js`)
- Insight routes → Insight controller: routes requests (evidence: `backend/routes/insightRoutes.js`)
- Insight routes → Token protection: protects endpoints (evidence: `backend/routes/insightRoutes.js`)
