# younes-elmakoudi/craftlink architecture

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

- Interactive diagram: https://gitdiagram.com/younes-elmakoudi/craftlink
- Repository: https://github.com/younes-elmakoudi/craftlink

## Overview

CraftLink is a customer–craftsman marketplace. Customers discover tradespeople, send service requests, track the job through completion, and review the work; craftsmen publish services, manage availability, and respond to requests. The React app routes users into feature areas, while the NestJS API registers corresponding domain modules and uses Prisma for database access. The README documents search, uploads, administration, chat, friends, notifications, and moderation; their detailed runtime wiring is not shown in the sampled source, so those links are left unasserted.

Main entry points: [`backend/src/app.module.ts`](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/app.module.ts) (Application module), [`frontend/src/app/router.tsx`](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/app/router.tsx) (Feature router), [`backend/src/main.ts`](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/main.ts) (NestJS API bootstrap), [`frontend/src/lib/api.ts`](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/lib/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_frontend["React application<br/>[main.tsx]"]
  node_router["Feature router<br/>[router.tsx]"]
  node_craftsmen_ui["Craftsman search<br/>[routes.tsx]"]
  node_requests_ui["Request workflow<br/>[routes.tsx]"]
  node_reviews_ui["Reviews UI<br/>[routes.tsx]"]
  node_chat_ui["Chat UI<br/>[routes.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_marketplace["Marketplace domains"]
  node_auth["Accounts and roles<br/>[auth.module.ts]"]
  node_craftsmen["Craftsmen services"]
  node_requests["Service requests<br/>[requests.module.ts]"]
  node_users["User profiles"]
end

subgraph group_engagement["Communication and trust"]
  node_reviews["Ratings and reviews"]
  node_friends["Friends and presence"]
  node_chat["One-to-one chat"]
  node_notifications["Notifications"]
  node_realtime["Realtime gateway<br/>[realtime.module.ts]"]
  node_admin["Admin moderation"]
end

subgraph group_platform["API platform"]
  node_api["NestJS API bootstrap<br/>[main.ts]"]
  node_modules["Application module<br/>[app.module.ts]"]
  node_config["Environment validation<br/>[env.ts]"]
  node_errors["Exception handling"]
  node_validation["Request validation<br/>[validation.ts]"]
  node_health["Health endpoint"]
  node_prisma["Prisma database access<br/>[prisma.service.ts]"]
end

node_customer(("Customer"))
node_craftsman(("Craftsman"))
node_postgres[("PostgreSQL")]

node_customer -->|"uses marketplace"| node_frontend
node_craftsman -->|"manages jobs"| node_frontend
node_frontend -->|"renders routes"| node_router
node_router -->|"registers routes"| node_craftsmen_ui
node_router -->|"registers routes"| node_requests_ui
node_router -->|"registers routes"| node_reviews_ui
node_router -->|"registers routes"| node_chat_ui
node_craftsmen_ui -.->|"requests data"| node_api_client
node_requests_ui -.->|"requests data"| node_api_client
node_reviews_ui -.->|"requests data"| node_api_client
node_chat_ui -.->|"requests data"| node_api_client
node_api_client -.->|"calls REST API"| node_api
node_api -->|"creates application"| node_modules
node_api -->|"reads configuration"| node_config
node_api -->|"installs filter"| node_errors
node_api -->|"installs pipe"| node_validation
node_modules -->|"registers module"| node_auth
node_modules -->|"registers module"| node_craftsmen
node_modules -->|"registers module"| node_requests
node_modules -->|"registers module"| node_users
node_modules -->|"registers module"| node_reviews
node_modules -->|"registers module"| node_friends
node_modules -->|"registers module"| node_chat
node_modules -->|"registers module"| node_notifications
node_modules -->|"registers module"| node_realtime
node_modules -->|"registers module"| node_admin
node_health -->|"checks database"| node_prisma
node_prisma -.->|"queries"| node_postgres

click node_frontend "https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/main.tsx"
click node_router "https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/app/router.tsx"
click node_craftsmen_ui "https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/features/craftsmen/routes.tsx"
click node_requests_ui "https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/features/requests/routes.tsx"
click node_reviews_ui "https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/features/reviews/routes.tsx"
click node_chat_ui "https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/features/chat/routes.tsx"
click node_api_client "https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/lib/api.ts"
click node_auth "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/modules/auth/auth.module.ts"
click node_craftsmen "https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/craftsmen"
click node_requests "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/modules/requests/requests.module.ts"
click node_users "https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/users"
click node_reviews "https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/reviews"
click node_friends "https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/friends"
click node_chat "https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/chat"
click node_notifications "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/modules/notifications/notifications.module.ts"
click node_realtime "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/modules/realtime/realtime.module.ts"
click node_admin "https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/admin"
click node_api "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/main.ts"
click node_modules "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/app.module.ts"
click node_config "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/config/env.ts"
click node_errors "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/common/all-exceptions.filter.ts"
click node_validation "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/common/validation.ts"
click node_health "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/health/health.controller.ts"
click node_prisma "https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/prisma/prisma.service.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_frontend,node_router,node_craftsmen_ui,node_requests_ui,node_reviews_ui,node_chat_ui,node_api_client toneBlue
class node_auth,node_craftsmen,node_requests,node_users,node_postgres toneAmber
class node_reviews,node_friends,node_chat,node_notifications,node_realtime,node_admin toneMint
class node_api,node_modules,node_config,node_errors,node_validation,node_health,node_prisma toneRose
class node_customer,node_craftsman toneIndigo
```

## Components

### Web application

- [React application](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [Feature router](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/app/router.tsx): `frontend/src/app/router.tsx`
- [Craftsman search](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/features/craftsmen/routes.tsx): `frontend/src/features/craftsmen/routes.tsx`
- [Request workflow](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/features/requests/routes.tsx): `frontend/src/features/requests/routes.tsx`
- [Reviews UI](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/features/reviews/routes.tsx): `frontend/src/features/reviews/routes.tsx`
- [Chat UI](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/features/chat/routes.tsx): `frontend/src/features/chat/routes.tsx`
- [API client](https://github.com/younes-elmakoudi/craftlink/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### Marketplace domains

- [Accounts and roles](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/modules/auth/auth.module.ts): `backend/src/modules/auth/auth.module.ts`
- [Craftsmen services](https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/craftsmen): `backend/src/modules/craftsmen`
- [Service requests](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/modules/requests/requests.module.ts): `backend/src/modules/requests/requests.module.ts`
- [User profiles](https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/users): `backend/src/modules/users`

### Communication and trust

- [Ratings and reviews](https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/reviews): `backend/src/modules/reviews`
- [Friends and presence](https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/friends): `backend/src/modules/friends`
- [One-to-one chat](https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/chat): `backend/src/modules/chat`
- [Notifications](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/modules/notifications/notifications.module.ts): `backend/src/modules/notifications/notifications.module.ts`
- [Realtime gateway](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/modules/realtime/realtime.module.ts): `backend/src/modules/realtime/realtime.module.ts`
- [Admin moderation](https://github.com/younes-elmakoudi/craftlink/tree/main/backend/src/modules/admin): `backend/src/modules/admin`

### API platform

- [NestJS API bootstrap](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/main.ts): `backend/src/main.ts`
- [Application module](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/app.module.ts): `backend/src/app.module.ts`
- [Environment validation](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/config/env.ts): `backend/src/config/env.ts`
- [Exception handling](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/common/all-exceptions.filter.ts): `backend/src/common/all-exceptions.filter.ts`
- [Request validation](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/common/validation.ts): `backend/src/common/validation.ts`
- [Health endpoint](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/health/health.controller.ts): `backend/src/health/health.controller.ts`
- [Prisma database access](https://github.com/younes-elmakoudi/craftlink/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`

### Other components

- **Customer**
- **Craftsman**
- **PostgreSQL**

## Connections

- Customer → React application: uses marketplace (evidence: `README.md`)
- Craftsman → React application: manages jobs (evidence: `README.md`)
- React application → Feature router: renders routes (evidence: `frontend/src/main.tsx`)
- Feature router → Craftsman search: registers routes (evidence: `frontend/src/app/router.tsx`)
- Feature router → Request workflow: registers routes (evidence: `frontend/src/app/router.tsx`)
- Feature router → Reviews UI: registers routes (evidence: `frontend/src/app/router.tsx`)
- Feature router → Chat UI: registers routes (evidence: `frontend/src/app/router.tsx`)
- Craftsman search → API client: requests data
- Request workflow → API client: requests data
- Reviews UI → API client: requests data
- Chat UI → API client: requests data
- API client → NestJS API bootstrap: calls REST API
- NestJS API bootstrap → Application module: creates application (evidence: `backend/src/main.ts`)
- NestJS API bootstrap → Environment validation: reads configuration (evidence: `backend/src/main.ts`)
- NestJS API bootstrap → Exception handling: installs filter (evidence: `backend/src/main.ts`)
- NestJS API bootstrap → Request validation: installs pipe (evidence: `backend/src/main.ts`)
- Application module → Accounts and roles: registers module (evidence: `backend/src/app.module.ts`)
- Application module → Craftsmen services: registers module (evidence: `backend/src/app.module.ts`)
- Application module → Service requests: registers module (evidence: `backend/src/app.module.ts`)
- Application module → User profiles: registers module (evidence: `backend/src/app.module.ts`)
- Application module → Ratings and reviews: registers module (evidence: `backend/src/app.module.ts`)
- Application module → Friends and presence: registers module (evidence: `backend/src/app.module.ts`)
- Application module → One-to-one chat: registers module (evidence: `backend/src/app.module.ts`)
- Application module → Notifications: registers module (evidence: `backend/src/app.module.ts`)
- Application module → Realtime gateway: registers module (evidence: `backend/src/app.module.ts`)
- Application module → Admin moderation: registers module (evidence: `backend/src/app.module.ts`)
- Health endpoint → Prisma database access: checks database (evidence: `backend/src/health/health.controller.ts`)
- Prisma database access → PostgreSQL: queries
