# ahmedalbadry1/saraha-app architecture

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

- Interactive diagram: https://gitdiagram.com/ahmedalbadry1/saraha-app
- Repository: https://github.com/ahmedalbadry1/saraha-app

## Overview

This is an Express API for account authentication and user profiles. Clients sign up, verify email through an OTP, and log in with credentials or Google; authenticated requests can rotate tokens or access and update profiles. The sampled code shows controllers delegating to services, which use shared security utilities and repositories. The README is empty, so capabilities are based on the sampled source; database and mail transport details are not fully shown.

Main entry points: [`src/modules/auth/auth.service.js`](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/auth/auth.service.js) (Auth service), [`src/main.js`](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/main.js) (Express app), [`src/DB/repo/user.repo.js`](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/repo/user.repo.js) (User repository), [`src/modules/auth/auth.controller.js`](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/auth/auth.controller.js) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API runtime"]
  node_server["Express app<br/>[main.js]"]
end

subgraph group_identity["Identity flows"]
  node_auth_routes["Auth routes<br/>[auth.controller.js]"]
  node_auth_validation["Auth validation<br/>[auth.validation.js]"]
  node_auth_service["Auth service<br/>[auth.service.js]"]
end

subgraph group_accounts["User profiles"]
  node_user_routes["User routes<br/>[user.controller.js]"]
  node_user_service["User service<br/>[user.service.js]"]
end

subgraph group_shared["Shared services"]
  node_auth_middleware["Authentication<br/>[authntication.js]"]
  node_authorization["Role authorization<br/>[authorization.js]"]
  node_middleware["Request middleware"]
  node_security["Tokens and crypto"]
  node_errors["Errors and responses"]
  node_email["Email sender<br/>[nodemailer.js]"]
  node_config["Configuration<br/>[config.service.js]"]
end

subgraph group_persistence["Persistence"]
  node_db_connection["DB connection<br/>[connection.js]"]
  node_user_repo["User repository<br/>[user.repo.js]"]
  node_message_repo["Message repository<br/>[message.repo.js]"]
  node_base_repo["Repository operations<br/>[base.repo.js]"]
  node_user_model[("User model<br/>[user.model.js]")]
  node_message_model[("OTP message model<br/>[message.model.js]")]
end

node_client(("API client"))
node_google(("Google identity"))

node_client -->|"sends requests"| node_server
node_server -->|"connects database"| node_db_connection
node_server -->|"mounts /auth"| node_auth_routes
node_server -->|"mounts /user"| node_user_routes
node_server -->|"handles errors"| node_middleware
node_auth_routes -->|"validates input"| node_auth_validation
node_auth_routes -->|"dispatches auth"| node_auth_service
node_auth_routes -->|"guards token routes"| node_auth_middleware
node_user_routes -->|"dispatches profile"| node_user_service
node_user_routes -->|"authenticates requests"| node_auth_middleware
node_user_routes -->|"checks role"| node_authorization
node_auth_service -->|"reads and writes users"| node_user_repo
node_auth_service -->|"manages OTP records"| node_message_repo
node_auth_service -->|"hashes and issues tokens"| node_security
node_auth_service -->|"sends verification email"| node_email
node_auth_service -->|"reads auth settings"| node_config
node_auth_service -->|"verifies Google identity"| node_google
node_user_service -->|"reads and updates users"| node_user_repo
node_user_service -->|"encrypts profile phone"| node_security
node_auth_middleware -->|"loads authenticated user"| node_user_repo
node_auth_middleware -->|"verifies token"| node_security
node_user_repo -->|"uses repository operations"| node_base_repo
node_message_repo -->|"uses repository operations"| node_base_repo
node_user_repo -->|"queries model"| node_user_model
node_message_repo -->|"queries model"| node_message_model
node_db_connection -->|"reads DB settings"| node_config
node_email -->|"reads mail settings"| node_config

click node_server "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/main.js"
click node_auth_routes "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/auth/auth.controller.js"
click node_auth_validation "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/auth/auth.validation.js"
click node_auth_service "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/auth/auth.service.js"
click node_user_routes "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/user/user.controller.js"
click node_user_service "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/user/user.service.js"
click node_auth_middleware "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/common/middleware/authntication.js"
click node_authorization "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/common/middleware/authorization.js"
click node_middleware "https://github.com/ahmedalbadry1/saraha-app/tree/main/src/common/middleware"
click node_security "https://github.com/ahmedalbadry1/saraha-app/tree/main/src/common/security"
click node_errors "https://github.com/ahmedalbadry1/saraha-app/tree/main/src/common/utils"
click node_email "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/common/email/nodemailer.js"
click node_config "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/config/config.service.js"
click node_db_connection "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/connection.js"
click node_user_repo "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/repo/user.repo.js"
click node_message_repo "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/repo/message.repo.js"
click node_base_repo "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/repo/base.repo.js"
click node_user_model "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/model/user.model.js"
click node_message_model "https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/model/message.model.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_client toneBlue
class node_auth_routes,node_auth_validation,node_auth_service toneAmber
class node_user_routes,node_user_service toneMint
class node_auth_middleware,node_authorization,node_middleware,node_security,node_errors,node_email,node_config toneRose
class node_db_connection,node_user_repo,node_message_repo,node_base_repo,node_user_model,node_message_model,node_google toneIndigo
```

## Components

### API runtime

- [Express app](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/main.js): `src/main.js`

### Identity flows

- [Auth routes](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/auth/auth.controller.js): `src/modules/auth/auth.controller.js`
- [Auth validation](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/auth/auth.validation.js): `src/modules/auth/auth.validation.js`
- [Auth service](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/auth/auth.service.js): `src/modules/auth/auth.service.js`

### User profiles

- [User routes](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/user/user.controller.js): `src/modules/user/user.controller.js`
- [User service](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/modules/user/user.service.js): `src/modules/user/user.service.js`

### Shared services

- [Authentication](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/common/middleware/authntication.js): `src/common/middleware/authntication.js`
- [Role authorization](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/common/middleware/authorization.js): `src/common/middleware/authorization.js`
- [Request middleware](https://github.com/ahmedalbadry1/saraha-app/tree/main/src/common/middleware): `src/common/middleware`
- [Tokens and crypto](https://github.com/ahmedalbadry1/saraha-app/tree/main/src/common/security): `src/common/security`
- [Errors and responses](https://github.com/ahmedalbadry1/saraha-app/tree/main/src/common/utils): `src/common/utils`
- [Email sender](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/common/email/nodemailer.js): `src/common/email/nodemailer.js`
- [Configuration](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/config/config.service.js): `src/config/config.service.js`

### Persistence

- [DB connection](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/connection.js): `src/DB/connection.js`
- [User repository](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/repo/user.repo.js): `src/DB/repo/user.repo.js`
- [Message repository](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/repo/message.repo.js): `src/DB/repo/message.repo.js`
- [Repository operations](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/repo/base.repo.js): `src/DB/repo/base.repo.js`
- [User model](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/model/user.model.js): `src/DB/model/user.model.js`
- [OTP message model](https://github.com/ahmedalbadry1/saraha-app/blob/main/src/DB/model/message.model.js): `src/DB/model/message.model.js`

### Other components

- **API client**
- **Google identity**

## Connections

- API client → Express app: sends requests (evidence: `src/main.js`)
- Express app → DB connection: connects database (evidence: `src/main.js`)
- Express app → Auth routes: mounts /auth (evidence: `src/main.js`)
- Express app → User routes: mounts /user (evidence: `src/main.js`)
- Express app → Request middleware: handles errors (evidence: `src/main.js`)
- Auth routes → Auth validation: validates input (evidence: `src/modules/auth/auth.controller.js`)
- Auth routes → Auth service: dispatches auth (evidence: `src/modules/auth/auth.controller.js`)
- Auth routes → Authentication: guards token routes (evidence: `src/modules/auth/auth.controller.js`)
- User routes → User service: dispatches profile (evidence: `src/modules/user/user.controller.js`)
- User routes → Authentication: authenticates requests (evidence: `src/modules/user/user.controller.js`)
- User routes → Role authorization: checks role (evidence: `src/modules/user/user.controller.js`)
- Auth service → User repository: reads and writes users (evidence: `src/modules/auth/auth.service.js`)
- Auth service → Message repository: manages OTP records (evidence: `src/modules/auth/auth.service.js`)
- Auth service → Tokens and crypto: hashes and issues tokens (evidence: `src/modules/auth/auth.service.js`)
- Auth service → Email sender: sends verification email (evidence: `src/modules/auth/auth.service.js`)
- Auth service → Configuration: reads auth settings (evidence: `src/modules/auth/auth.service.js`)
- Auth service → Google identity: verifies Google identity (evidence: `src/modules/auth/auth.service.js`)
- User service → User repository: reads and updates users (evidence: `src/modules/user/user.service.js`)
- User service → Tokens and crypto: encrypts profile phone (evidence: `src/modules/user/user.service.js`)
- Authentication → User repository: loads authenticated user (evidence: `src/common/middleware/authntication.js`)
- Authentication → Tokens and crypto: verifies token (evidence: `src/common/middleware/authntication.js`)
- User repository → Repository operations: uses repository operations (evidence: `src/DB/repo/user.repo.js`)
- Message repository → Repository operations: uses repository operations (evidence: `src/DB/repo/message.repo.js`)
- User repository → User model: queries model (evidence: `src/DB/repo/user.repo.js`)
- Message repository → OTP message model: queries model (evidence: `src/DB/repo/message.repo.js`)
- DB connection → Configuration: reads DB settings (evidence: `src/DB/connection.js`)
- Email sender → Configuration: reads mail settings (evidence: `src/common/email/nodemailer.js`)
