# suriyabalaji-007/finaimt architecture

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

- Interactive diagram: https://gitdiagram.com/suriyabalaji-007/finaimt
- Repository: https://github.com/suriyabalaji-007/finaimt

## Overview

FinAIMT is a Flutter personal-finance app backed by an Express API. Its user-facing areas cover account access, money transfers and bill payments, financial dashboards and taxes, loans, investments, and AI chat. The backend authenticates and validates requests, applies finance and investment operations, persists account and activity data in SQLite, and supports payment processing and real-time notifications. The README provides no product detail, and sampled source is mostly server-side; client-to-API connections and several Flutter subsystem interactions are therefore shown only as unverified, dashed links.

Main entry points: [`server/index.js`](https://github.com/suriyabalaji-007/finaimt/blob/main/server/index.js) (HTTP server), [`lib/main.dart`](https://github.com/suriyabalaji-007/finaimt/blob/main/lib/main.dart) (App entry), [`server/models/index.js`](https://github.com/suriyabalaji-007/finaimt/blob/main/server/models/index.js) (Finance models), [`server/routes/auth.js`](https://github.com/suriyabalaji-007/finaimt/blob/main/server/routes/auth.js) (Authentication routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Flutter app"]
  node_app["App entry<br/>[main.dart]"]
  node_auth_ui["Sign in"]
  node_dashboard["Finance dashboard"]
  node_payments_ui["Payments and transfers"]
  node_expenses_ui["Expenses and taxes"]
  node_investments_ui["Investments and markets"]
  node_loans_ui["Loans"]
  node_ai_ui["AI assistant<br/>[ai_bot_view.dart]"]
end

subgraph group_client_services["Client services"]
  node_client_auth["Auth client<br/>[auth_service.dart]"]
  node_client_api["API client<br/>[api_service.dart]"]
  node_client_finance["Finance client"]
  node_client_invest["Investment client"]
  node_ai_services["AI and voice"]
end

subgraph group_api["API and security"]
  node_server["HTTP server<br/>[index.js]"]
  node_auth_routes["Authentication routes<br/>[auth.js]"]
  node_stripe_routes["Stripe routes<br/>[stripe.js]"]
  node_auth_guard["Session guard<br/>[authMiddleware.js]"]
  node_pin_guard["PIN verification<br/>[pinAuth.js]"]
  node_validation["Request validation<br/>[validator.js]"]
  node_auth_service["Auth service<br/>[authService.js]"]
  node_mail_service["Email service<br/>[mailService.js]"]
end

subgraph group_finance["Finance operations"]
  node_payment_service["Transfers<br/>[paymentService.js]"]
  node_finance_service["Loans and tax<br/>[financeService.js]"]
  node_investment_service["Investment trading"]
end

subgraph group_storage["Persistence and events"]
  node_models["Finance models<br/>[index.js]"]
  node_sqlite[("SQLite database<br/>[database.sqlite]")]
  node_notifications["Socket notifications"]
end

node_user(("User"))
node_email_provider(("SMTP provider"))
node_stripe(("Stripe"))

node_user -.->|"uses"| node_app
node_app -.->|"presents"| node_auth_ui
node_app -.->|"presents"| node_dashboard
node_app -.->|"presents"| node_payments_ui
node_app -.->|"presents"| node_expenses_ui
node_app -.->|"presents"| node_investments_ui
node_app -.->|"presents"| node_loans_ui
node_app -.->|"presents"| node_ai_ui
node_auth_ui -.->|"uses"| node_client_auth
node_client_auth -.->|"requests"| node_server
node_dashboard -.->|"uses"| node_client_finance
node_payments_ui -.->|"requests"| node_client_api
node_payments_ui -.->|"uses"| node_client_finance
node_expenses_ui -.->|"uses"| node_client_finance
node_investments_ui -.->|"uses"| node_client_invest
node_loans_ui -.->|"uses"| node_client_finance
node_ai_ui -.->|"uses"| node_ai_services
node_client_api -.->|"requests"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_stripe_routes
node_server -->|"uses"| node_auth_guard
node_server -->|"uses"| node_pin_guard
node_server -->|"uses"| node_validation
node_server -->|"calls"| node_payment_service
node_server -->|"calls"| node_finance_service
node_server -->|"calls"| node_investment_service
node_server -->|"queries"| node_models
node_server -->|"initializes"| node_notifications
node_auth_routes -->|"calls"| node_auth_service
node_auth_routes -->|"calls"| node_mail_service
node_auth_routes -->|"queries"| node_models
node_auth_routes -->|"uses"| node_auth_guard
node_auth_routes -->|"uses"| node_validation
node_stripe_routes -->|"updates"| node_models
node_stripe_routes -->|"uses"| node_auth_guard
node_stripe_routes -->|"uses"| node_validation
node_mail_service -->|"sends email"| node_email_provider
node_stripe_routes -->|"creates intents"| node_stripe
node_auth_guard -->|"loads user"| node_models
node_pin_guard -->|"loads user"| node_models
node_auth_service -->|"imports"| node_models
node_finance_service -->|"reads and writes"| node_models
node_investment_service -->|"reads and writes"| node_models
node_models -->|"stores records"| node_sqlite

click node_app "https://github.com/suriyabalaji-007/finaimt/blob/main/lib/main.dart"
click node_auth_ui "https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/auth"
click node_dashboard "https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/home"
click node_payments_ui "https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/upi"
click node_expenses_ui "https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/expenses"
click node_investments_ui "https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/investments"
click node_loans_ui "https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/loans"
click node_ai_ui "https://github.com/suriyabalaji-007/finaimt/blob/main/lib/screens/ai_bot/ai_bot_view.dart"
click node_client_auth "https://github.com/suriyabalaji-007/finaimt/blob/main/lib/data/services/auth_service.dart"
click node_client_api "https://github.com/suriyabalaji-007/finaimt/blob/main/lib/data/services/api_service.dart"
click node_client_finance "https://github.com/suriyabalaji-007/finaimt/blob/main/lib/data/services/finance_service.dart"
click node_client_invest "https://github.com/suriyabalaji-007/finaimt/blob/main/lib/data/services/investment_service.dart"
click node_ai_services "https://github.com/suriyabalaji-007/finaimt/tree/main/lib/core/services"
click node_server "https://github.com/suriyabalaji-007/finaimt/blob/main/server/index.js"
click node_auth_routes "https://github.com/suriyabalaji-007/finaimt/blob/main/server/routes/auth.js"
click node_stripe_routes "https://github.com/suriyabalaji-007/finaimt/blob/main/server/routes/stripe.js"
click node_auth_guard "https://github.com/suriyabalaji-007/finaimt/blob/main/server/middleware/authMiddleware.js"
click node_pin_guard "https://github.com/suriyabalaji-007/finaimt/blob/main/server/middleware/pinAuth.js"
click node_validation "https://github.com/suriyabalaji-007/finaimt/blob/main/server/middleware/validator.js"
click node_auth_service "https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/authService.js"
click node_mail_service "https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/mailService.js"
click node_payment_service "https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/paymentService.js"
click node_finance_service "https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/financeService.js"
click node_investment_service "https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/investmentService.js"
click node_models "https://github.com/suriyabalaji-007/finaimt/blob/main/server/models/index.js"
click node_sqlite "https://github.com/suriyabalaji-007/finaimt/blob/main/server/database.sqlite"
click node_notifications "https://github.com/suriyabalaji-007/finaimt/blob/main/server/socket/notificationHandler.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_app,node_auth_ui,node_dashboard,node_payments_ui,node_expenses_ui,node_investments_ui,node_loans_ui,node_ai_ui,node_user toneBlue
class node_client_auth,node_client_api,node_client_finance,node_client_invest,node_ai_services toneAmber
class node_server,node_auth_routes,node_stripe_routes,node_auth_guard,node_pin_guard,node_validation,node_auth_service,node_mail_service toneMint
class node_payment_service,node_finance_service,node_investment_service toneRose
class node_models,node_sqlite,node_notifications,node_email_provider,node_stripe toneIndigo
```

## Components

### Flutter app

- [App entry](https://github.com/suriyabalaji-007/finaimt/blob/main/lib/main.dart): `lib/main.dart`
- [Sign in](https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/auth): `lib/screens/auth`
- [Finance dashboard](https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/home): `lib/screens/home`
- [Payments and transfers](https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/upi): `lib/screens/upi`
- [Expenses and taxes](https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/expenses): `lib/screens/expenses`
- [Investments and markets](https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/investments): `lib/screens/investments`
- [Loans](https://github.com/suriyabalaji-007/finaimt/tree/main/lib/screens/loans): `lib/screens/loans`
- [AI assistant](https://github.com/suriyabalaji-007/finaimt/blob/main/lib/screens/ai_bot/ai_bot_view.dart): `lib/screens/ai_bot/ai_bot_view.dart`

### Client services

- [Auth client](https://github.com/suriyabalaji-007/finaimt/blob/main/lib/data/services/auth_service.dart): `lib/data/services/auth_service.dart`
- [API client](https://github.com/suriyabalaji-007/finaimt/blob/main/lib/data/services/api_service.dart): `lib/data/services/api_service.dart`
- [Finance client](https://github.com/suriyabalaji-007/finaimt/blob/main/lib/data/services/finance_service.dart): `lib/data/services/finance_service.dart`
- [Investment client](https://github.com/suriyabalaji-007/finaimt/blob/main/lib/data/services/investment_service.dart): `lib/data/services/investment_service.dart`
- [AI and voice](https://github.com/suriyabalaji-007/finaimt/tree/main/lib/core/services): `lib/core/services`

### API and security

- [HTTP server](https://github.com/suriyabalaji-007/finaimt/blob/main/server/index.js): `server/index.js`
- [Authentication routes](https://github.com/suriyabalaji-007/finaimt/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Stripe routes](https://github.com/suriyabalaji-007/finaimt/blob/main/server/routes/stripe.js): `server/routes/stripe.js`
- [Session guard](https://github.com/suriyabalaji-007/finaimt/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [PIN verification](https://github.com/suriyabalaji-007/finaimt/blob/main/server/middleware/pinAuth.js): `server/middleware/pinAuth.js`
- [Request validation](https://github.com/suriyabalaji-007/finaimt/blob/main/server/middleware/validator.js): `server/middleware/validator.js`
- [Auth service](https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/authService.js): `server/services/authService.js`
- [Email service](https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/mailService.js): `server/services/mailService.js`

### Finance operations

- [Transfers](https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/paymentService.js): `server/services/paymentService.js`
- [Loans and tax](https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/financeService.js): `server/services/financeService.js`
- [Investment trading](https://github.com/suriyabalaji-007/finaimt/blob/main/server/services/investmentService.js): `server/services/investmentService.js`

### Persistence and events

- [Finance models](https://github.com/suriyabalaji-007/finaimt/blob/main/server/models/index.js): `server/models/index.js`
- [SQLite database](https://github.com/suriyabalaji-007/finaimt/blob/main/server/database.sqlite): `server/database.sqlite`
- [Socket notifications](https://github.com/suriyabalaji-007/finaimt/blob/main/server/socket/notificationHandler.js): `server/socket/notificationHandler.js`

### Other components

- **User**
- **SMTP provider**
- **Stripe**

## Connections

- User → App entry: uses
- App entry → Sign in: presents
- App entry → Finance dashboard: presents
- App entry → Payments and transfers: presents
- App entry → Expenses and taxes: presents
- App entry → Investments and markets: presents
- App entry → Loans: presents
- App entry → AI assistant: presents
- Sign in → Auth client: uses
- Auth client → HTTP server: requests
- Finance dashboard → Finance client: uses
- Payments and transfers → API client: requests
- Payments and transfers → Finance client: uses
- Expenses and taxes → Finance client: uses
- Investments and markets → Investment client: uses
- Loans → Finance client: uses
- AI assistant → AI and voice: uses
- API client → HTTP server: requests
- HTTP server → Authentication routes: mounts (evidence: `server/index.js`)
- HTTP server → Stripe routes: mounts (evidence: `server/index.js`)
- HTTP server → Session guard: uses (evidence: `server/index.js`)
- HTTP server → PIN verification: uses (evidence: `server/index.js`)
- HTTP server → Request validation: uses (evidence: `server/index.js`)
- HTTP server → Transfers: calls (evidence: `server/index.js`)
- HTTP server → Loans and tax: calls (evidence: `server/index.js`)
- HTTP server → Investment trading: calls (evidence: `server/index.js`)
- HTTP server → Finance models: queries (evidence: `server/index.js`)
- HTTP server → Socket notifications: initializes (evidence: `server/index.js`)
- Authentication routes → Auth service: calls (evidence: `server/routes/auth.js`)
- Authentication routes → Email service: calls (evidence: `server/routes/auth.js`)
- Authentication routes → Finance models: queries (evidence: `server/routes/auth.js`)
- Authentication routes → Session guard: uses (evidence: `server/routes/auth.js`)
- Authentication routes → Request validation: uses (evidence: `server/routes/auth.js`)
- Stripe routes → Finance models: updates (evidence: `server/routes/stripe.js`)
- Stripe routes → Session guard: uses (evidence: `server/routes/stripe.js`)
- Stripe routes → Request validation: uses (evidence: `server/routes/stripe.js`)
- Email service → SMTP provider: sends email (evidence: `server/services/mailService.js`)
- Stripe routes → Stripe: creates intents (evidence: `server/routes/stripe.js`)
- Session guard → Finance models: loads user (evidence: `server/middleware/authMiddleware.js`)
- PIN verification → Finance models: loads user (evidence: `server/middleware/pinAuth.js`)
- Auth service → Finance models: imports (evidence: `server/services/authService.js`)
- Loans and tax → Finance models: reads and writes (evidence: `server/services/financeService.js`)
- Investment trading → Finance models: reads and writes (evidence: `server/services/investmentService.js`)
- Finance models → SQLite database: stores records (evidence: `server/models/index.js`)
