# h-4mza/plateforme-confiance-numerique architecture

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

- Interactive diagram: https://gitdiagram.com/h-4mza/plateforme-confiance-numerique
- Repository: https://github.com/h-4mza/plateforme-confiance-numerique

## Overview

Plateforme Flask de gestion d’investigations de fraude académique. Le parcours principal est : un professeur crée une investigation et téléverse des copies, la plateforme les transmet à n8n pour analyse OCR et détection, puis reçoit un résultat et un rapport consultable. L’analyse distingue détection de génération par IA, similarité/collusion et verdict forensique, avec gestion des comptes et modules. Les relations entre composants sont limitées aux appels visibles dans les extraits ou aux capacités et échanges explicitement décrits par le README ; le détail du workflow n8n n’a pas été inspecté.

Main entry points: [`web/app.py`](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py) (Application Flask), [`logic_crewai/tasks.py`](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tasks.py) (Tâches d’analyse), [`n8n/workflow_fraude.json`](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/n8n/workflow_fraude.json) (Workflow n8n), [`web/pipeline_runner.py`](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/pipeline_runner.py) (Envoi et callback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Plateforme web"]
  node_flask["Application Flask<br/>[app.py]"]
  node_accounts["Comptes et rôles<br/>[app.py]"]
  node_modules["Gestion des modules<br/>[app.py]"]
  node_investigations["Investigations et copies<br/>[app.py]"]
  node_records[("Modèles métier<br/>[models.py]")]
  node_runner["Envoi et callback<br/>[pipeline_runner.py]"]
end

subgraph group_analysis["Analyse forensique"]
  node_ocr["Extraction OCR<br/>[ocr_batch.py]"]
  node_crew["Pipeline CrewAI<br/>[crew_pipeline.py]"]
  node_agents["Agents spécialisés<br/>[agents.py]"]
  node_tasks["Tâches d’analyse<br/>[tasks.py]"]
  node_nlp["Détection IA<br/>[step1_nlp.py]"]
  node_detection_tool["Analyse stylométrique"]
  node_similarity["Similarité collaborative"]
  node_similarity_tool["Similarité et clustering<br/>[tool_similarite.py]"]
  node_judge["Verdict forensique<br/>[step3_juge.py]"]
end

subgraph group_workflow["Orchestration externe"]
  node_n8n["Workflow n8n"]
end

subgraph group_reports["Résultats"]
  node_report_tool["Génération de rapport<br/>[tool_rapport.py]"]
end

node_professor(("Professeur"))
node_storage[("Stockage des copies")]
node_gemini(("Google Gemini"))

node_professor -->|"utilise"| node_flask
node_flask -->|"gère"| node_accounts
node_flask -->|"gère"| node_modules
node_flask -->|"crée"| node_investigations
node_accounts -->|"lit et écrit"| node_records
node_modules -->|"lit et écrit"| node_records
node_investigations -->|"enregistre"| node_records
node_investigations -->|"sauvegarde"| node_storage
node_flask -->|"délègue"| node_runner
node_runner -->|"envoie copies"| node_n8n
node_n8n -.->|"rappelle"| node_runner
node_n8n -.->|"extrait le texte"| node_ocr
node_n8n -.->|"déclenche analyse"| node_crew
node_crew -->|"construit"| node_agents
node_crew -->|"construit"| node_tasks
node_tasks -->|"assigne tâches"| node_agents
node_tasks -->|"utilise"| node_detection_tool
node_tasks -->|"utilise"| node_similarity_tool
node_tasks -->|"utilise"| node_report_tool
node_nlp -->|"analyse"| node_detection_tool
node_similarity -.->|"calcule similarités"| node_similarity_tool
node_judge -->|"configure juge"| node_agents
node_judge -->|"génère rapport"| node_report_tool
node_detection_tool -->|"interroge"| node_gemini
node_runner -->|"met à jour"| node_records

click node_flask "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py"
click node_accounts "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py"
click node_modules "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py"
click node_investigations "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py"
click node_records "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/models.py"
click node_runner "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/pipeline_runner.py"
click node_n8n "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/n8n/workflow_fraude.json"
click node_ocr "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/ocr_batch.py"
click node_crew "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/crew_pipeline.py"
click node_agents "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/agents.py"
click node_tasks "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tasks.py"
click node_nlp "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/step1_nlp.py"
click node_detection_tool "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tools/tool_detection_ia.py"
click node_similarity "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/step2_similarite.py"
click node_similarity_tool "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tools/tool_similarite.py"
click node_judge "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/step3_juge.py"
click node_report_tool "https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tools/tool_rapport.py"

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_flask,node_accounts,node_modules,node_investigations,node_records,node_runner toneBlue
class node_ocr,node_crew,node_agents,node_tasks,node_nlp,node_detection_tool,node_similarity,node_similarity_tool,node_judge,node_storage toneAmber
class node_n8n toneMint
class node_report_tool toneRose
class node_professor,node_gemini toneIndigo
```

## Components

### Plateforme web

- [Application Flask](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py): `web/app.py`
- [Comptes et rôles](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py): `web/app.py`
- [Gestion des modules](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py): `web/app.py`
- [Investigations et copies](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/app.py): `web/app.py`
- [Modèles métier](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/models.py): `web/models.py`
- [Envoi et callback](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/web/pipeline_runner.py): `web/pipeline_runner.py`

### Analyse forensique

- [Extraction OCR](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/ocr_batch.py): `logic_crewai/ocr_batch.py`
- [Pipeline CrewAI](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/crew_pipeline.py): `logic_crewai/crew_pipeline.py`
- [Agents spécialisés](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/agents.py): `logic_crewai/agents.py`
- [Tâches d’analyse](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tasks.py): `logic_crewai/tasks.py`
- [Détection IA](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/step1_nlp.py): `logic_crewai/step1_nlp.py`
- [Analyse stylométrique](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tools/tool_detection_ia.py): `logic_crewai/tools/tool_detection_ia.py`
- [Similarité collaborative](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/step2_similarite.py): `logic_crewai/step2_similarite.py`
- [Similarité et clustering](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tools/tool_similarite.py): `logic_crewai/tools/tool_similarite.py`
- [Verdict forensique](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/step3_juge.py): `logic_crewai/step3_juge.py`

### Orchestration externe

- [Workflow n8n](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/n8n/workflow_fraude.json): `n8n/workflow_fraude.json`

### Résultats

- [Génération de rapport](https://github.com/h-4mza/plateforme-confiance-numerique/blob/main/logic_crewai/tools/tool_rapport.py): `logic_crewai/tools/tool_rapport.py`

### Other components

- **Professeur**
- **Stockage des copies**
- **Google Gemini**

## Connections

- Professeur → Application Flask: utilise (evidence: `README.md`)
- Application Flask → Comptes et rôles: gère (evidence: `web/app.py`)
- Application Flask → Gestion des modules: gère (evidence: `web/app.py`)
- Application Flask → Investigations et copies: crée (evidence: `web/app.py`)
- Comptes et rôles → Modèles métier: lit et écrit (evidence: `web/app.py`)
- Gestion des modules → Modèles métier: lit et écrit (evidence: `web/app.py`)
- Investigations et copies → Modèles métier: enregistre (evidence: `web/app.py`)
- Investigations et copies → Stockage des copies: sauvegarde (evidence: `web/app.py`)
- Application Flask → Envoi et callback: délègue (evidence: `web/app.py`)
- Envoi et callback → Workflow n8n: envoie copies (evidence: `web/pipeline_runner.py`)
- Workflow n8n → Envoi et callback: rappelle (evidence: `README.md`)
- Workflow n8n → Extraction OCR: extrait le texte (evidence: `README.md`)
- Workflow n8n → Pipeline CrewAI: déclenche analyse (evidence: `README.md`)
- Pipeline CrewAI → Agents spécialisés: construit (evidence: `logic_crewai/crew_pipeline.py`)
- Pipeline CrewAI → Tâches d’analyse: construit (evidence: `logic_crewai/crew_pipeline.py`)
- Tâches d’analyse → Agents spécialisés: assigne tâches (evidence: `logic_crewai/tasks.py`)
- Tâches d’analyse → Analyse stylométrique: utilise (evidence: `logic_crewai/tasks.py`)
- Tâches d’analyse → Similarité et clustering: utilise (evidence: `logic_crewai/tasks.py`)
- Tâches d’analyse → Génération de rapport: utilise (evidence: `logic_crewai/tasks.py`)
- Détection IA → Analyse stylométrique: analyse (evidence: `logic_crewai/step1_nlp.py`)
- Similarité collaborative → Similarité et clustering: calcule similarités
- Verdict forensique → Agents spécialisés: configure juge (evidence: `logic_crewai/step3_juge.py`)
- Verdict forensique → Génération de rapport: génère rapport (evidence: `logic_crewai/step3_juge.py`)
- Analyse stylométrique → Google Gemini: interroge (evidence: `logic_crewai/tools/tool_detection_ia.py`)
- Envoi et callback → Modèles métier: met à jour (evidence: `web/pipeline_runner.py`)
