# kawsaramin101/tms architecture

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

- Interactive diagram: https://gitdiagram.com/kawsaramin101/tms
- Repository: https://github.com/kawsaramin101/tms

## Overview

Vault is an inventory and treasury management system for managing accounts, transactions, vouchers, members and fees, financial calculations, reports, and notifications. The user-facing workflow runs through the Next.js dashboard and its API client to the Express API, whose feature controllers delegate domain operations to backend services and persistent storage. Authentication and shared contracts support that application flow. The README documents the feature set and database choice; relationships below are limited to its statements and the sampled source references, so unsampled frontend and service internals are not inferred.

Main entry points: [`apps/backend/src/app.ts`](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/app.ts) (Express API router), [`apps/backend/src/lib/prisma.ts`](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/lib/prisma.ts) (Prisma adapter), [`apps/backend/src/modules/auth/auth.service.ts`](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/auth/auth.service.ts) (Authentication), [`apps/backend/src/middleware/auth.middleware.ts`](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/middleware/auth.middleware.ts) (Access middleware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_dashboard["Dashboard pages"]
  node_api_client["API client<br/>[api-client.ts]"]
  node_feature_apis["Feature API clients"]
end

subgraph group_backend["Backend API"]
  node_router["Express API router<br/>[app.ts]"]
  node_auth_middleware["Access middleware<br/>[auth.middleware.ts]"]
  node_jwt["JWT utilities<br/>[jwt.ts]"]
end

subgraph group_domain["Treasury domains"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_accounts["Account management<br/>[account.service.ts]"]
  node_transactions["Transaction tracking"]
  node_vouchers["Voucher management<br/>[voucher.service.ts]"]
  node_calculations["Financial calculations"]
  node_members_fees["Members and fees<br/>[member.service.ts]"]
  node_reports["Reporting<br/>[report.service.ts]"]
  node_notifications["Notifications"]
end

subgraph group_shared["Persistence and contracts"]
  node_prisma["Prisma adapter<br/>[prisma.ts]"]
  node_database[("MariaDB/MySQL")]
  node_contracts["Shared contracts"]
end

node_user(("Staff user"))

node_user -->|"uses"| node_dashboard
node_dashboard -->|"requests via"| node_api_client
node_api_client -->|"calls API"| node_router
node_router -->|"routes to"| node_auth
node_router -->|"routes to"| node_accounts
node_router -->|"routes to"| node_transactions
node_router -->|"routes to"| node_vouchers
node_router -->|"routes to"| node_calculations
node_router -->|"routes to"| node_members_fees
node_router -->|"routes to"| node_reports
node_router -->|"routes to"| node_notifications
node_auth_middleware -->|"verifies tokens"| node_jwt
node_auth_middleware -->|"checks users"| node_prisma
node_auth -->|"queries"| node_prisma
node_auth -->|"signs tokens"| node_jwt
node_accounts -->|"queries"| node_prisma
node_transactions -->|"queries"| node_prisma
node_vouchers -->|"queries"| node_prisma
node_calculations -->|"queries"| node_prisma
node_members_fees -.->|"uses"| node_prisma
node_reports -.->|"uses"| node_prisma
node_notifications -.->|"uses"| node_prisma
node_prisma -->|"persists data"| node_database
node_auth -->|"uses types"| node_contracts

click node_dashboard "https://github.com/kawsaramin101/tms/tree/main/apps/frontend/src/app/(dashboard)"
click node_api_client "https://github.com/kawsaramin101/tms/blob/main/apps/frontend/src/lib/api-client.ts"
click node_feature_apis "https://github.com/kawsaramin101/tms/tree/main/apps/frontend/src/modules"
click node_router "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/app.ts"
click node_auth "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/auth/auth.service.ts"
click node_accounts "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/accounts/account.service.ts"
click node_transactions "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/transactions/transaction.service.ts"
click node_vouchers "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/vouchers/voucher.service.ts"
click node_calculations "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/calculations/calculation.service.ts"
click node_members_fees "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/members-fees/member.service.ts"
click node_reports "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/reports/report.service.ts"
click node_notifications "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/notifications/notification.service.ts"
click node_auth_middleware "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/middleware/auth.middleware.ts"
click node_jwt "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/lib/jwt.ts"
click node_prisma "https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/lib/prisma.ts"
click node_contracts "https://github.com/kawsaramin101/tms/tree/main/packages/contracts/src"

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_dashboard,node_api_client,node_feature_apis,node_user toneBlue
class node_router,node_auth_middleware,node_jwt toneAmber
class node_auth,node_accounts,node_transactions,node_vouchers,node_calculations,node_members_fees,node_reports,node_notifications toneMint
class node_prisma,node_database,node_contracts toneRose
```

## Components

### Frontend

- [Dashboard pages](https://github.com/kawsaramin101/tms/tree/main/apps/frontend/src/app/(dashboard)): `apps/frontend/src/app/(dashboard)`
- [API client](https://github.com/kawsaramin101/tms/blob/main/apps/frontend/src/lib/api-client.ts): `apps/frontend/src/lib/api-client.ts`
- [Feature API clients](https://github.com/kawsaramin101/tms/tree/main/apps/frontend/src/modules): `apps/frontend/src/modules`

### Backend API

- [Express API router](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/app.ts): `apps/backend/src/app.ts`
- [Access middleware](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/middleware/auth.middleware.ts): `apps/backend/src/middleware/auth.middleware.ts`
- [JWT utilities](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/lib/jwt.ts): `apps/backend/src/lib/jwt.ts`

### Treasury domains

- [Authentication](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/auth/auth.service.ts): `apps/backend/src/modules/auth/auth.service.ts`
- [Account management](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/accounts/account.service.ts): `apps/backend/src/modules/accounts/account.service.ts`
- [Transaction tracking](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/transactions/transaction.service.ts): `apps/backend/src/modules/transactions/transaction.service.ts`
- [Voucher management](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/vouchers/voucher.service.ts): `apps/backend/src/modules/vouchers/voucher.service.ts`
- [Financial calculations](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/calculations/calculation.service.ts): `apps/backend/src/modules/calculations/calculation.service.ts`
- [Members and fees](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/members-fees/member.service.ts): `apps/backend/src/modules/members-fees/member.service.ts`
- [Reporting](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/reports/report.service.ts): `apps/backend/src/modules/reports/report.service.ts`
- [Notifications](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/modules/notifications/notification.service.ts): `apps/backend/src/modules/notifications/notification.service.ts`

### Persistence and contracts

- [Prisma adapter](https://github.com/kawsaramin101/tms/blob/main/apps/backend/src/lib/prisma.ts): `apps/backend/src/lib/prisma.ts`
- **MariaDB/MySQL**
- [Shared contracts](https://github.com/kawsaramin101/tms/tree/main/packages/contracts/src): `packages/contracts/src`

### Other components

- **Staff user**

## Connections

- Staff user → Dashboard pages: uses
- Dashboard pages → API client: requests via
- API client → Express API router: calls API
- Express API router → Authentication: routes to (evidence: `apps/backend/src/app.ts`)
- Express API router → Account management: routes to (evidence: `apps/backend/src/app.ts`)
- Express API router → Transaction tracking: routes to (evidence: `apps/backend/src/app.ts`)
- Express API router → Voucher management: routes to (evidence: `apps/backend/src/app.ts`)
- Express API router → Financial calculations: routes to (evidence: `apps/backend/src/app.ts`)
- Express API router → Members and fees: routes to (evidence: `apps/backend/src/app.ts`)
- Express API router → Reporting: routes to (evidence: `apps/backend/src/app.ts`)
- Express API router → Notifications: routes to (evidence: `apps/backend/src/app.ts`)
- Access middleware → JWT utilities: verifies tokens (evidence: `apps/backend/src/middleware/auth.middleware.ts`)
- Access middleware → Prisma adapter: checks users (evidence: `apps/backend/src/middleware/auth.middleware.ts`)
- Authentication → Prisma adapter: queries (evidence: `apps/backend/src/modules/auth/auth.service.ts`)
- Authentication → JWT utilities: signs tokens (evidence: `apps/backend/src/modules/auth/auth.service.ts`)
- Account management → Prisma adapter: queries (evidence: `apps/backend/src/modules/accounts/account.service.ts`)
- Transaction tracking → Prisma adapter: queries
- Voucher management → Prisma adapter: queries
- Financial calculations → Prisma adapter: queries (evidence: `apps/backend/src/modules/calculations/calculation.service.ts`)
- Members and fees → Prisma adapter: uses
- Reporting → Prisma adapter: uses
- Notifications → Prisma adapter: uses
- Prisma adapter → MariaDB/MySQL: persists data
- Authentication → Shared contracts: uses types (evidence: `apps/backend/src/modules/auth/auth.service.ts`)
