# marouane-quaisse/leaks-survey architecture

> Architecture diagram of the GitHub repository marouane-quaisse/leaks-survey, 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/marouane-quaisse/leaks-survey
- Repository: https://github.com/marouane-quaisse/leaks-survey

## Overview

Leaks Survey supports industrial steam-leak inspections: technicians record leaks and media, track repair, and review financial and CO₂ impacts. The README identifies mobile and web clients backed by a Spring REST API; the supplied tree exposes only mobile platform shells, so mobile internals are not mapped. Web routing and selected project, photo, reporting, and media interactions are evidenced in excerpts or the source index; other product capabilities are retained at subsystem level from the README, without asserting unsampled call paths.

Main entry points: [`backend/src/main/java/com/backend/backend/web`](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/web) (REST controllers), [`backend/src/main/java/com/backend/backend/dao/repositories`](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/dao/repositories) (Data repositories), [`web/src/App.tsx`](https://github.com/marouane-quaisse/leaks-survey/blob/main/web/src/App.tsx) (Web routes), [`web/src/api`](https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src/api) (Web API clients)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Inspection clients"]
  node_web["Web dashboard"]
  node_mobile["Mobile app"]
  node_web_routes["Web routes<br/>[App.tsx]"]
  node_web_pages["Inspection pages"]
  node_web_contexts["Project and media state"]
  node_web_api["Web API clients"]
end

subgraph group_backend["API and domain services"]
  node_auth["Authentication"]
  node_projects_campaigns["Projects and campaigns"]
  node_leak_inspection["Leak inspection"]
  node_media_service["Media handling"]
  node_api_controllers["REST controllers"]
end

subgraph group_data["Persistence and media"]
  node_domain_entities["Inspection records"]
  node_repositories["Data repositories"]
  node_h2[("H2 database")]
  node_file_storage[("Uploaded media")]
end

subgraph group_insights["Analysis and reporting"]
  node_ai_analysis["Photo AI analysis"]
  node_reports["Impact reports"]
  node_pdf_export["PDF export"]
end

node_technician(("Technician"))
node_gemini{{"Gemini API"}}

node_technician -->|"uses"| node_web
node_technician -->|"uses"| node_mobile
node_web -->|"starts"| node_web_routes
node_web_routes -->|"provides state"| node_web_contexts
node_web_routes -->|"routes to"| node_web_pages
node_web_pages -->|"requests data"| node_web_api
node_web_contexts -->|"loads projects"| node_web_api
node_web_api -->|"calls REST API"| node_api_controllers
node_mobile -->|"uses REST API"| node_api_controllers
node_api_controllers -->|"delegates project work"| node_projects_campaigns
node_api_controllers -->|"requests reports"| node_reports
node_api_controllers -->|"stores and serves media"| node_media_service
node_media_service -->|"writes files"| node_file_storage
node_api_controllers -.->|"handles authentication"| node_auth
node_api_controllers -.->|"handles leak records"| node_leak_inspection
node_api_controllers -.->|"requests analysis"| node_ai_analysis
node_auth -.->|"checks users"| node_repositories
node_projects_campaigns -.->|"persists project data"| node_repositories
node_leak_inspection -.->|"persists inspections"| node_repositories
node_repositories -->|"maps records"| node_domain_entities
node_repositories -->|"reads and writes"| node_h2
node_ai_analysis -.->|"analyzes photos"| node_gemini
node_reports -->|"exports report"| node_pdf_export

click node_web "https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src"
click node_mobile "https://github.com/marouane-quaisse/leaks-survey/tree/main/frontend"
click node_web_routes "https://github.com/marouane-quaisse/leaks-survey/blob/main/web/src/App.tsx"
click node_web_pages "https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src/pages"
click node_web_contexts "https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src/context"
click node_web_api "https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src/api"
click node_auth "https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/service"
click node_projects_campaigns "https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/service"
click node_leak_inspection "https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/service"
click node_media_service "https://github.com/marouane-quaisse/leaks-survey/blob/main/backend/src/main/java/com/backend/backend/service/FileStorageService.java"
click node_api_controllers "https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/web"
click node_domain_entities "https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/dao/entities"
click node_repositories "https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/dao/repositories"
click node_ai_analysis "https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/service"
click node_reports "https://github.com/marouane-quaisse/leaks-survey/blob/main/backend/src/main/java/com/backend/backend/service/RapportService.java"
click node_pdf_export "https://github.com/marouane-quaisse/leaks-survey/blob/main/backend/src/main/java/com/backend/backend/service/PdfExportService.java"

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_web,node_mobile,node_web_routes,node_web_pages,node_web_contexts,node_web_api toneBlue
class node_auth,node_projects_campaigns,node_leak_inspection,node_media_service,node_api_controllers toneAmber
class node_domain_entities,node_repositories,node_h2,node_file_storage,node_gemini toneMint
class node_ai_analysis,node_reports,node_pdf_export toneRose
class node_technician toneIndigo
```

## Components

### Inspection clients

- [Web dashboard](https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src): `web/src`
- [Mobile app](https://github.com/marouane-quaisse/leaks-survey/tree/main/frontend): `frontend`
- [Web routes](https://github.com/marouane-quaisse/leaks-survey/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [Inspection pages](https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src/pages): `web/src/pages`
- [Project and media state](https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src/context): `web/src/context`
- [Web API clients](https://github.com/marouane-quaisse/leaks-survey/tree/main/web/src/api): `web/src/api`

### API and domain services

- [Authentication](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/service): `backend/src/main/java/com/backend/backend/service`
- [Projects and campaigns](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/service): `backend/src/main/java/com/backend/backend/service`
- [Leak inspection](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/service): `backend/src/main/java/com/backend/backend/service`
- [Media handling](https://github.com/marouane-quaisse/leaks-survey/blob/main/backend/src/main/java/com/backend/backend/service/FileStorageService.java): `backend/src/main/java/com/backend/backend/service/FileStorageService.java`
- [REST controllers](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/web): `backend/src/main/java/com/backend/backend/web`

### Persistence and media

- [Inspection records](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/dao/entities): `backend/src/main/java/com/backend/backend/dao/entities`
- [Data repositories](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/dao/repositories): `backend/src/main/java/com/backend/backend/dao/repositories`
- **H2 database**
- **Uploaded media**

### Analysis and reporting

- [Photo AI analysis](https://github.com/marouane-quaisse/leaks-survey/tree/main/backend/src/main/java/com/backend/backend/service): `backend/src/main/java/com/backend/backend/service`
- [Impact reports](https://github.com/marouane-quaisse/leaks-survey/blob/main/backend/src/main/java/com/backend/backend/service/RapportService.java): `backend/src/main/java/com/backend/backend/service/RapportService.java`
- [PDF export](https://github.com/marouane-quaisse/leaks-survey/blob/main/backend/src/main/java/com/backend/backend/service/PdfExportService.java): `backend/src/main/java/com/backend/backend/service/PdfExportService.java`

### Other components

- **Technician**
- **Gemini API**

## Connections

- Technician → Web dashboard: uses (evidence: `README.md`)
- Technician → Mobile app: uses (evidence: `README.md`)
- Web dashboard → Web routes: starts (evidence: `web/src/main.tsx`)
- Web routes → Project and media state: provides state (evidence: `web/src/App.tsx`)
- Web routes → Inspection pages: routes to (evidence: `web/src/App.tsx`)
- Inspection pages → Web API clients: requests data (evidence: `web/src/pages/DetailFuitePage.tsx`)
- Project and media state → Web API clients: loads projects (evidence: `web/src/context/ProjetActifContext.tsx`)
- Web API clients → REST controllers: calls REST API (evidence: `README.md`)
- Mobile app → REST controllers: uses REST API (evidence: `README.md`)
- REST controllers → Projects and campaigns: delegates project work (evidence: `backend/src/main/java/com/backend/backend/web/ProjetController.java`)
- REST controllers → Impact reports: requests reports (evidence: `backend/src/main/java/com/backend/backend/web/RapportController.java`)
- REST controllers → Media handling: stores and serves media (evidence: `backend/src/main/java/com/backend/backend/web/PhotoController.java`)
- Media handling → Uploaded media: writes files (evidence: `backend/src/main/java/com/backend/backend/service/FileStorageService.java`)
- REST controllers → Authentication: handles authentication (evidence: `backend/src/main/java/com/backend/backend/web/PhotoController.java`)
- REST controllers → Leak inspection: handles leak records (evidence: `backend/src/main/java/com/backend/backend/web/PhotoController.java`)
- REST controllers → Photo AI analysis: requests analysis (evidence: `backend/src/main/java/com/backend/backend/web/PhotoController.java`)
- Authentication → Data repositories: checks users (evidence: `backend/src/main/java/com/backend/backend/service/UtilisateurService.java`)
- Projects and campaigns → Data repositories: persists project data (evidence: `backend/src/main/java/com/backend/backend/service/UtilisateurService.java`)
- Leak inspection → Data repositories: persists inspections (evidence: `backend/src/main/java/com/backend/backend/service/UtilisateurService.java`)
- Data repositories → Inspection records: maps records (evidence: `backend/src/main/java/com/backend/backend/dao/repositories/FuiteRepository.java`)
- Data repositories → H2 database: reads and writes (evidence: `README.md`)
- Photo AI analysis → Gemini API: analyzes photos (evidence: `README.md`)
- Impact reports → PDF export: exports report (evidence: `backend/src/main/java/com/backend/backend/web/RapportController.java`)
