# duskfrag-lis/confiance architecture

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

- Interactive diagram: https://gitdiagram.com/duskfrag-lis/confiance
- Repository: https://github.com/duskfrag-lis/confiance

## Overview

Confiance is an in-development platform intended to connect customers securely with local service providers. Its documented workflow is a web client using a NestJS API for authentication and service-related domains, with PostgreSQL, file storage, email, and chat integrations. The sampled backend currently wires shared infrastructure, but its domain directories contain only placeholders and are not registered in the application; those capabilities are shown as documented, not as verified runtime call paths. The frontend is also not implemented in this tree.

Main entry points: [`backend/src/app.module.ts`](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/app.module.ts) (App composition), [`backend/src/main.ts`](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/main.ts) (NestJS API), [`backend/src/prisma/prisma.service.ts`](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/prisma/prisma.service.ts) (Prisma access), [`backend/src/storage/storage.service.ts`](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/storage/storage.service.ts) (File storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_api["NestJS API<br/>[main.ts]"]
  node_app["App composition<br/>[app.module.ts]"]
end

subgraph group_shared["Shared infrastructure"]
  node_config["Environment validation<br/>[env.validation.ts]"]
  node_http_errors["HTTP errors"]
  node_response_transform["Response transform"]
  node_roles["Role authorization<br/>[roles.guard.ts]"]
  node_database_access["Prisma access<br/>[prisma.service.ts]"]
  node_storage["File storage<br/>[storage.service.ts]"]
  node_mail["Email service<br/>[mail.service.ts]"]
end

subgraph group_domains["Product domains"]
  node_auth["Authentication"]
  node_profiles["Profiles"]
  node_publications["Service publications"]
  node_search["Service search"]
  node_contracting["Contracting"]
  node_execution["Service execution"]
  node_agenda["Scheduling"]
  node_cancellations["Cancellations"]
  node_claims["Claims"]
  node_verification["Verification"]
  node_reputation["Reputation"]
  node_notifications["Notifications"]
  node_chat["Realtime chat"]
end

subgraph group_integrations["External services"]
  node_postgres[("PostgreSQL")]
  node_seaweed["SeaweedFS"]
  node_resend["Resend"]
  node_socketio["Socket.IO"]
end

node_customer(("Customer"))
node_provider(("Service provider"))

node_customer -->|"uses API"| node_api
node_provider -->|"uses API"| node_api
node_api -->|"creates app"| node_app
node_app -->|"validates config"| node_config
node_app -->|"registers filter"| node_http_errors
node_app -->|"registers interceptor"| node_response_transform
node_app -->|"imports Prisma"| node_database_access
node_app -->|"imports storage"| node_storage
node_app -->|"imports mail"| node_mail
node_database_access -->|"connects to"| node_postgres
node_storage -->|"stores files"| node_seaweed
node_mail -->|"sends email"| node_resend
node_chat -->|"uses realtime"| node_socketio
node_auth -.->|"stores refresh tokens"| node_postgres

click node_api "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/main.ts"
click node_app "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/app.module.ts"
click node_config "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/config/env.validation.ts"
click node_http_errors "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/common/filters/http-exception.filter.ts"
click node_response_transform "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/common/interceptors/transform.interceptor.ts"
click node_roles "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/common/guards/roles.guard.ts"
click node_database_access "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/prisma/prisma.service.ts"
click node_storage "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/storage/storage.service.ts"
click node_mail "https://github.com/duskfrag-lis/confiance/blob/main/backend/src/mail/mail.service.ts"
click node_auth "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/auth"
click node_profiles "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/profiles"
click node_publications "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/publications"
click node_search "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/search"
click node_contracting "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/contracting"
click node_execution "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/execution"
click node_agenda "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/agenda"
click node_cancellations "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/cancellations"
click node_claims "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/claims"
click node_verification "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/verification"
click node_reputation "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/reputation"
click node_notifications "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/notifications"
click node_chat "https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/chat"

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_api,node_app toneBlue
class node_config,node_http_errors,node_response_transform,node_roles,node_database_access,node_storage,node_mail toneAmber
class node_auth,node_profiles,node_publications,node_search,node_contracting,node_execution,node_agenda,node_cancellations,node_claims,node_verification,node_reputation,node_notifications,node_chat toneMint
class node_postgres,node_seaweed,node_resend,node_socketio toneRose
class node_customer,node_provider toneIndigo
```

## Components

### API runtime

- [NestJS API](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/main.ts): `backend/src/main.ts`
- [App composition](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/app.module.ts): `backend/src/app.module.ts`

### Shared infrastructure

- [Environment validation](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/config/env.validation.ts): `backend/src/config/env.validation.ts`
- [HTTP errors](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/common/filters/http-exception.filter.ts): `backend/src/common/filters/http-exception.filter.ts`
- [Response transform](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/common/interceptors/transform.interceptor.ts): `backend/src/common/interceptors/transform.interceptor.ts`
- [Role authorization](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/common/guards/roles.guard.ts): `backend/src/common/guards/roles.guard.ts`
- [Prisma access](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`
- [File storage](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/storage/storage.service.ts): `backend/src/storage/storage.service.ts`
- [Email service](https://github.com/duskfrag-lis/confiance/blob/main/backend/src/mail/mail.service.ts): `backend/src/mail/mail.service.ts`

### Product domains

- [Authentication](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/auth): `backend/src/modules/auth`
- [Profiles](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/profiles): `backend/src/modules/profiles`
- [Service publications](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/publications): `backend/src/modules/publications`
- [Service search](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/search): `backend/src/modules/search`
- [Contracting](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/contracting): `backend/src/modules/contracting`
- [Service execution](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/execution): `backend/src/modules/execution`
- [Scheduling](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/agenda): `backend/src/modules/agenda`
- [Cancellations](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/cancellations): `backend/src/modules/cancellations`
- [Claims](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/claims): `backend/src/modules/claims`
- [Verification](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/verification): `backend/src/modules/verification`
- [Reputation](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/reputation): `backend/src/modules/reputation`
- [Notifications](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/notifications): `backend/src/modules/notifications`
- [Realtime chat](https://github.com/duskfrag-lis/confiance/tree/main/backend/src/modules/chat): `backend/src/modules/chat`

### External services

- **PostgreSQL**
- **SeaweedFS**
- **Resend**
- **Socket.IO**

### Other components

- **Customer**
- **Service provider**

## Connections

- Customer → NestJS API: uses API (evidence: `README.md`)
- Service provider → NestJS API: uses API (evidence: `README.md`)
- NestJS API → App composition: creates app (evidence: `backend/src/main.ts`)
- App composition → Environment validation: validates config (evidence: `backend/src/app.module.ts`)
- App composition → HTTP errors: registers filter (evidence: `backend/src/app.module.ts`)
- App composition → Response transform: registers interceptor (evidence: `backend/src/app.module.ts`)
- App composition → Prisma access: imports Prisma (evidence: `backend/src/app.module.ts`)
- App composition → File storage: imports storage (evidence: `backend/src/app.module.ts`)
- App composition → Email service: imports mail (evidence: `backend/src/app.module.ts`)
- Prisma access → PostgreSQL: connects to (evidence: `README.md`)
- File storage → SeaweedFS: stores files (evidence: `README.md`)
- Email service → Resend: sends email (evidence: `README.md`)
- Realtime chat → Socket.IO: uses realtime (evidence: `README.md`)
- Authentication → PostgreSQL: stores refresh tokens (evidence: `README.md`)
