# arnabwithab/wealth-advisor architecture

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

- Interactive diagram: https://gitdiagram.com/arnabwithab/wealth-advisor
- Repository: https://github.com/arnabwithab/wealth-advisor

## Overview

The checked-in product is an authentication-focused web application: users sign up or log in, the browser calls authentication endpoints, and the backend issues and manages tokens and sessions. The README describes DEWA wealth-advisory capabilities as a project concept and roadmap, but the supplied tree contains no implementation for those capabilities; they are therefore not represented as runtime components. The graph follows shown source references and route calls; frontend-to-backend transport wiring is not shown in the excerpts.

Main entry points: [`frontend/src/lib/api-client.ts`](https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/lib/api-client.ts) (API client), [`backend/src/modules/auth/application/use-cases/login.use-case.ts`](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/application/use-cases/login.use-case.ts) (Auth use cases), [`backend/src/modules/auth/infrastructure/persistence/mongo-user.repository.ts`](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/infrastructure/persistence/mongo-user.repository.ts) (User repository), [`backend/src/modules/auth/infrastructure/persistence/mongo-session.repository.ts`](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/infrastructure/persistence/mongo-session.repository.ts) (Session repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_webapp["Web application<br/>[app.tsx]"]
  node_router["Page routing<br/>[router.tsx]"]
  node_pages["Login and signup<br/>[login-page.tsx]"]
  node_authui["Auth forms<br/>[login-form.tsx]"]
  node_authapi["Auth API hooks<br/>[auth-api.ts]"]
  node_session["Session state<br/>[session-store.ts]"]
  node_apiclient["API client<br/>[api-client.ts]"]
end

subgraph group_auth["Backend authentication"]
  node_authroutes["Auth routes<br/>[auth.routes.ts]"]
  node_usecases["Auth use cases<br/>[login.use-case.ts]"]
  node_userdomain["User domain<br/>[user.entity.ts]"]
  node_sessiondomain["Session domain<br/>[session.entity.ts]"]
  node_userrepo["User repository"]
  node_sessionrepo["Session repository"]
end

subgraph group_shared["Shared validation"]
  node_contracts["Request contracts<br/>[login.contract.ts]"]
  node_rules["Validation rules<br/>[email.rule.ts]"]
end

subgraph group_core["Backend core"]
  node_errorhandler["HTTP error handling<br/>[error-handler.ts]"]
end

node_person(("User"))
node_mongodb[("MongoDB")]

node_person -->|"uses"| node_webapp
node_webapp -->|"renders"| node_router
node_router -->|"routes to"| node_pages
node_pages -.->|"renders"| node_authui
node_authui -.->|"submits to"| node_authapi
node_authapi -->|"calls"| node_apiclient
node_apiclient -.->|"sends HTTP"| node_authroutes
node_apiclient -.->|"uses auth handlers"| node_session
node_contracts -->|"validates with"| node_rules
node_authroutes -->|"dispatches to"| node_usecases
node_usecases -.->|"uses"| node_userrepo
node_usecases -.->|"uses"| node_sessionrepo
node_userrepo -.->|"reads and writes"| node_mongodb
node_sessionrepo -->|"reads and writes"| node_mongodb
node_userrepo -->|"maps entities"| node_userdomain
node_sessionrepo -->|"maps entities"| node_sessiondomain

click node_webapp "https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/app/app.tsx"
click node_router "https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/app/router.tsx"
click node_pages "https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/app/routes/login-page.tsx"
click node_authui "https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/features/auth/components/login-form.tsx"
click node_authapi "https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/features/auth/api/auth-api.ts"
click node_session "https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/features/auth/session/session-store.ts"
click node_apiclient "https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/lib/api-client.ts"
click node_contracts "https://github.com/arnabwithab/wealth-advisor/blob/main/contracts/src/auth/login.contract.ts"
click node_rules "https://github.com/arnabwithab/wealth-advisor/blob/main/rules/src/email.rule.ts"
click node_authroutes "https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/presentation/routes/auth.routes.ts"
click node_usecases "https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/application/use-cases/login.use-case.ts"
click node_userdomain "https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/domain/entities/user.entity.ts"
click node_sessiondomain "https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/domain/entities/session.entity.ts"
click node_userrepo "https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/infrastructure/persistence/mongo-user.repository.ts"
click node_sessionrepo "https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/infrastructure/persistence/mongo-session.repository.ts"
click node_errorhandler "https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/core/http/error-handler.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_webapp,node_router,node_pages,node_authui,node_authapi,node_session,node_apiclient,node_person toneBlue
class node_authroutes,node_usecases,node_userdomain,node_sessiondomain,node_userrepo,node_sessionrepo,node_mongodb toneAmber
class node_contracts,node_rules toneMint
class node_errorhandler toneRose
```

## Components

### Web client

- [Web application](https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/app/app.tsx): `frontend/src/app/app.tsx`
- [Page routing](https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/app/router.tsx): `frontend/src/app/router.tsx`
- [Login and signup](https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/app/routes/login-page.tsx): `frontend/src/app/routes/login-page.tsx`
- [Auth forms](https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/features/auth/components/login-form.tsx): `frontend/src/features/auth/components/login-form.tsx`
- [Auth API hooks](https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/features/auth/api/auth-api.ts): `frontend/src/features/auth/api/auth-api.ts`
- [Session state](https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/features/auth/session/session-store.ts): `frontend/src/features/auth/session/session-store.ts`
- [API client](https://github.com/arnabwithab/wealth-advisor/blob/main/frontend/src/lib/api-client.ts): `frontend/src/lib/api-client.ts`

### Backend authentication

- [Auth routes](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/presentation/routes/auth.routes.ts): `backend/src/modules/auth/presentation/routes/auth.routes.ts`
- [Auth use cases](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/application/use-cases/login.use-case.ts): `backend/src/modules/auth/application/use-cases/login.use-case.ts`
- [User domain](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/domain/entities/user.entity.ts): `backend/src/modules/auth/domain/entities/user.entity.ts`
- [Session domain](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/domain/entities/session.entity.ts): `backend/src/modules/auth/domain/entities/session.entity.ts`
- [User repository](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/infrastructure/persistence/mongo-user.repository.ts): `backend/src/modules/auth/infrastructure/persistence/mongo-user.repository.ts`
- [Session repository](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/modules/auth/infrastructure/persistence/mongo-session.repository.ts): `backend/src/modules/auth/infrastructure/persistence/mongo-session.repository.ts`

### Shared validation

- [Request contracts](https://github.com/arnabwithab/wealth-advisor/blob/main/contracts/src/auth/login.contract.ts): `contracts/src/auth/login.contract.ts`
- [Validation rules](https://github.com/arnabwithab/wealth-advisor/blob/main/rules/src/email.rule.ts): `rules/src/email.rule.ts`

### Backend core

- [HTTP error handling](https://github.com/arnabwithab/wealth-advisor/blob/main/backend/src/core/http/error-handler.ts): `backend/src/core/http/error-handler.ts`

### Other components

- **User**
- **MongoDB**

## Connections

- User → Web application: uses
- Web application → Page routing: renders (evidence: `frontend/src/app/app.tsx`)
- Page routing → Login and signup: routes to (evidence: `frontend/src/app/router.tsx`)
- Login and signup → Auth forms: renders
- Auth forms → Auth API hooks: submits to
- Auth API hooks → API client: calls (evidence: `frontend/src/features/auth/api/auth-api.ts`)
- API client → Auth routes: sends HTTP
- API client → Session state: uses auth handlers
- Request contracts → Validation rules: validates with
- Auth routes → Auth use cases: dispatches to (evidence: `backend/src/modules/auth/presentation/routes/auth.routes.ts`)
- Auth use cases → User repository: uses
- Auth use cases → Session repository: uses
- User repository → MongoDB: reads and writes
- Session repository → MongoDB: reads and writes (evidence: `backend/src/modules/auth/infrastructure/persistence/mongo-session.repository.ts`)
- User repository → User domain: maps entities (evidence: `backend/src/modules/auth/infrastructure/persistence/mongo-user.repository.ts`)
- Session repository → Session domain: maps entities (evidence: `backend/src/modules/auth/infrastructure/persistence/mongo-session.repository.ts`)
