# zuhairahmed0/admin-dashboard architecture

> Architecture diagram of the GitHub repository zuhairahmed0/admin-dashboard, 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/zuhairahmed0/admin-dashboard
- Repository: https://github.com/zuhairahmed0/admin-dashboard

## Overview

Admin Dashboard API is a NestJS backend for authentication, administrative user management, avatar/file handling, and activity logs. The main workflow is an authenticated administrator request: controllers invoke application use cases, which operate on domain repositories and persist through Prisma/PostgreSQL. Authentication also supports token refresh and logout; uploads validate files before processing. The README documents centralized response/error handling, pagination/filtering, soft deletion, security controls, and Swagger. Some implementation files were not sampled, so uncertain internal wiring is omitted or marked unverified.

Main entry points: [`src/app.module.ts`](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/app.module.ts) (Nest application), [`src/auth/presentation/controller/auth.controller.ts`](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/auth/presentation/controller/auth.controller.ts) (Auth endpoints), [`src/users/presentation/controllers/user.controller.ts`](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/users/presentation/controllers/user.controller.ts) (User administration endpoints), [`src/upload/presentation/controllers/upload.controller.ts`](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/upload/presentation/controllers/upload.controller.ts) (Upload endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry and shared controls"]
  node_app["Nest application<br/>[app.module.ts]"]
  node_shared["Global response and errors"]
  node_db[("Prisma PostgreSQL access")]
end

subgraph group_identity["Authentication and security"]
  node_auth_api["Auth endpoints<br/>[auth.controller.ts]"]
  node_auth_cases["Token and user auth flows"]
  node_jwt["JWT guard and strategy"]
  node_security["Token and hash providers"]
end

subgraph group_users["User administration"]
  node_user_api["User administration endpoints<br/>[user.controller.ts]"]
  node_user_cases["User management use cases"]
  node_user_domain["User model and repository contract"]
  node_user_repo["Prisma user repository"]
end

subgraph group_files["File management"]
  node_upload_api["Upload endpoints"]
  node_upload_cases["Upload and file listing"]
  node_file_storage["File storage provider"]
  node_file_repo["Prisma file repository"]
end

subgraph group_activity["Activity logging"]
  node_logs_api["Activity log endpoints<br/>[logs.controller.ts]"]
  node_logs_cases["Log creation and retrieval"]
  node_log_listener["Event log listener<br/>[log.listener.ts]"]
  node_log_repo["Prisma log repository"]
end

node_client(("API client"))

node_client -->|"sends auth requests"| node_auth_api
node_client -->|"sends admin requests"| node_user_api
node_client -->|"sends file requests"| node_upload_api
node_app -->|"registers globally"| node_shared
node_app -->|"loads module"| node_auth_api
node_app -->|"loads module"| node_user_api
node_app -->|"loads module"| node_upload_api
node_app -->|"loads module"| node_logs_api
node_auth_api -->|"invokes use cases"| node_auth_cases
node_auth_api -->|"guards protected routes"| node_jwt
node_auth_cases -->|"uses user repository"| node_user_domain
node_auth_cases -->|"uses token and hash contracts"| node_security
node_user_api -->|"invokes use cases"| node_user_cases
node_user_api -->|"guards routes"| node_jwt
node_user_cases -->|"uses repository contract"| node_user_domain
node_user_repo -->|"queries database"| node_db
node_upload_api -->|"invokes use cases"| node_upload_cases
node_upload_api -->|"guards uploads"| node_jwt
node_upload_cases -.->|"uses storage"| node_file_storage
node_upload_cases -.->|"uses file repository"| node_file_repo
node_file_repo -->|"queries database"| node_db
node_user_api -->|"emits activity event"| node_log_listener
node_auth_api -->|"emits activity event"| node_log_listener
node_upload_api -->|"emits activity event"| node_log_listener
node_logs_api -->|"invokes retrieval"| node_logs_cases
node_log_listener -.->|"creates logs"| node_logs_cases
node_logs_cases -->|"persists logs"| node_log_repo
node_log_repo -->|"queries database"| node_db

click node_app "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/app.module.ts"
click node_shared "https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/shared"
click node_db "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/database/database.service.ts"
click node_auth_api "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/auth/presentation/controller/auth.controller.ts"
click node_auth_cases "https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/auth/application/use-cases"
click node_jwt "https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/auth/infrastructure/auth"
click node_security "https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/shared/security"
click node_user_api "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/users/presentation/controllers/user.controller.ts"
click node_user_cases "https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/users/application/use-cases"
click node_user_domain "https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/users/domain"
click node_user_repo "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/users/infrastructure/repositories/prisma-user.repository.ts"
click node_upload_api "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/upload/presentation/controllers/upload.controller.ts"
click node_upload_cases "https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/upload/application/use-cases"
click node_file_storage "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/upload/infrastructure/providers/local-storage.provider.ts"
click node_file_repo "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/upload/infrastructure/repositories/prisma-file.repository.ts"
click node_logs_api "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/logs/presentation/controllers/logs.controller.ts"
click node_logs_cases "https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/logs/application/use-cases"
click node_log_listener "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/logs/application/listeners/log.listener.ts"
click node_log_repo "https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/logs/infrastructure/repositories/prisma-log.repository.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_app,node_shared,node_db,node_client toneBlue
class node_auth_api,node_auth_cases,node_jwt,node_security toneAmber
class node_user_api,node_user_cases,node_user_domain,node_user_repo toneMint
class node_upload_api,node_upload_cases,node_file_storage,node_file_repo toneRose
class node_logs_api,node_logs_cases,node_log_listener,node_log_repo toneIndigo
```

## Components

### API entry and shared controls

- [Nest application](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/app.module.ts): `src/app.module.ts`
- [Global response and errors](https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/shared): `src/shared`
- [Prisma PostgreSQL access](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/database/database.service.ts): `src/database/database.service.ts`

### Authentication and security

- [Auth endpoints](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/auth/presentation/controller/auth.controller.ts): `src/auth/presentation/controller/auth.controller.ts`
- [Token and user auth flows](https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/auth/application/use-cases): `src/auth/application/use-cases`
- [JWT guard and strategy](https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/auth/infrastructure/auth): `src/auth/infrastructure/auth`
- [Token and hash providers](https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/shared/security): `src/shared/security`

### User administration

- [User administration endpoints](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/users/presentation/controllers/user.controller.ts): `src/users/presentation/controllers/user.controller.ts`
- [User management use cases](https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/users/application/use-cases): `src/users/application/use-cases`
- [User model and repository contract](https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/users/domain): `src/users/domain`
- [Prisma user repository](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/users/infrastructure/repositories/prisma-user.repository.ts): `src/users/infrastructure/repositories/prisma-user.repository.ts`

### File management

- [Upload endpoints](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/upload/presentation/controllers/upload.controller.ts): `src/upload/presentation/controllers/upload.controller.ts`
- [Upload and file listing](https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/upload/application/use-cases): `src/upload/application/use-cases`
- [File storage provider](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/upload/infrastructure/providers/local-storage.provider.ts): `src/upload/infrastructure/providers/local-storage.provider.ts`
- [Prisma file repository](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/upload/infrastructure/repositories/prisma-file.repository.ts): `src/upload/infrastructure/repositories/prisma-file.repository.ts`

### Activity logging

- [Activity log endpoints](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/logs/presentation/controllers/logs.controller.ts): `src/logs/presentation/controllers/logs.controller.ts`
- [Log creation and retrieval](https://github.com/zuhairahmed0/admin-dashboard/tree/master/src/logs/application/use-cases): `src/logs/application/use-cases`
- [Event log listener](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/logs/application/listeners/log.listener.ts): `src/logs/application/listeners/log.listener.ts`
- [Prisma log repository](https://github.com/zuhairahmed0/admin-dashboard/blob/master/src/logs/infrastructure/repositories/prisma-log.repository.ts): `src/logs/infrastructure/repositories/prisma-log.repository.ts`

### Other components

- **API client**

## Connections

- API client → Auth endpoints: sends auth requests (evidence: `src/auth/presentation/controller/auth.controller.ts`)
- API client → User administration endpoints: sends admin requests (evidence: `src/users/presentation/controllers/user.controller.ts`)
- API client → Upload endpoints: sends file requests (evidence: `src/upload/presentation/controllers/upload.controller.ts`)
- Nest application → Global response and errors: registers globally (evidence: `src/app.module.ts`)
- Nest application → Auth endpoints: loads module (evidence: `src/app.module.ts`)
- Nest application → User administration endpoints: loads module (evidence: `src/app.module.ts`)
- Nest application → Upload endpoints: loads module (evidence: `src/app.module.ts`)
- Nest application → Activity log endpoints: loads module (evidence: `src/app.module.ts`)
- Auth endpoints → Token and user auth flows: invokes use cases (evidence: `src/auth/presentation/controller/auth.controller.ts`)
- Auth endpoints → JWT guard and strategy: guards protected routes (evidence: `src/auth/presentation/controller/auth.controller.ts`)
- Token and user auth flows → User model and repository contract: uses user repository (evidence: `src/auth/application/use-cases/login.use-case.ts`)
- Token and user auth flows → Token and hash providers: uses token and hash contracts (evidence: `src/auth/application/use-cases/login.use-case.ts`)
- User administration endpoints → User management use cases: invokes use cases (evidence: `src/users/presentation/controllers/user.controller.ts`)
- User administration endpoints → JWT guard and strategy: guards routes (evidence: `src/users/presentation/controllers/user.controller.ts`)
- User management use cases → User model and repository contract: uses repository contract (evidence: `src/users/domain/interfaces/user.repository.ts`)
- Prisma user repository → Prisma PostgreSQL access: queries database (evidence: `src/users/infrastructure/repositories/prisma-user.repository.ts`)
- Upload endpoints → Upload and file listing: invokes use cases (evidence: `src/upload/presentation/controllers/upload.controller.ts`)
- Upload endpoints → JWT guard and strategy: guards uploads (evidence: `src/upload/presentation/controllers/upload.controller.ts`)
- Upload and file listing → File storage provider: uses storage
- Upload and file listing → Prisma file repository: uses file repository
- Prisma file repository → Prisma PostgreSQL access: queries database (evidence: `src/upload/infrastructure/repositories/prisma-file.repository.ts`)
- User administration endpoints → Event log listener: emits activity event (evidence: `src/users/presentation/controllers/user.controller.ts`)
- Auth endpoints → Event log listener: emits activity event (evidence: `src/auth/presentation/controller/auth.controller.ts`)
- Upload endpoints → Event log listener: emits activity event (evidence: `src/upload/presentation/controllers/upload.controller.ts`)
- Activity log endpoints → Log creation and retrieval: invokes retrieval (evidence: `src/logs/presentation/controllers/logs.controller.ts`)
- Event log listener → Log creation and retrieval: creates logs
- Log creation and retrieval → Prisma log repository: persists logs (evidence: `src/logs/infrastructure/repositories/prisma-log.repository.ts`)
- Prisma log repository → Prisma PostgreSQL access: queries database (evidence: `src/logs/infrastructure/repositories/prisma-log.repository.ts`)
