# damoko2004/devenir-orchestrateur-ia architecture

> Architecture diagram of the GitHub repository damoko2004/devenir-orchestrateur-ia, 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/damoko2004/devenir-orchestrateur-ia
- Repository: https://github.com/damoko2004/devenir-orchestrateur-ia
- Video tour (about a minute): https://gitdiagram.com/damoko2004/devenir-orchestrateur-ia/video

## Overview

This is a bilingual educational code repository: learners run standalone Python or R examples for business, data, and AI-orchestration tasks. Its principal end-to-end workflow is ReportOps: profile a dataset, assess quality, route the result, request human approval when needed, then publish or reject. The graph, contracts, quality rules, and profiling tool are evidenced in the sampled Python sources; other README-listed examples are represented as capability areas. R source details were not sampled, so its internal links are not expanded.

Main entry points: [`python/reportops/graph.py`](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/graph.py) (Orchestration graph), [`python/reportops/tools.py`](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/tools.py) (Dataset profiling), [`python/reportops/contracts.py`](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/contracts.py) (State contracts), [`python/reportops/run.py`](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/run.py) (Workflow entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reportops["ReportOps workflow"]
  node_run["Workflow entry point<br/>[run.py]"]
  node_graph["Orchestration graph<br/>[graph.py]"]
  node_contracts["State contracts<br/>[contracts.py]"]
  node_profiling["Dataset profiling<br/>[tools.py]"]
  node_quality["Quality rules<br/>[quality.py]"]
end

subgraph group_cases["Practical cases"]
  node_business["Business workflows"]
  node_data_risk["Data and risk"]
  node_compliance["Compliance and statistics"]
  node_research["Research example"]
end

subgraph group_learning["Workshops and exercises"]
  node_workshops["AI workshops"]
  node_exercises["Applied exercises"]
end

subgraph group_evaluation["Evaluation tools"]
  node_bench["Evaluation bench<br/>[banc_eval.py]"]
  node_calibration["Judge calibration"]
  node_confidence["Confidence intervals"]
end

node_learner(("Learner"))
node_approver(("Human approver"))
node_dataset[("Dataset source")]

node_learner -->|"starts workflow"| node_run
node_run -->|"invokes graph"| node_graph
node_graph -->|"profiles dataset"| node_profiling
node_graph -->|"evaluates quality"| node_quality
node_graph -->|"validates state"| node_contracts
node_profiling -->|"returns profile"| node_contracts
node_quality -->|"returns decision"| node_contracts
node_dataset -.->|"provides dataset"| node_profiling
node_graph -->|"requests approval"| node_approver
node_learner -->|"runs examples"| node_business
node_learner -->|"runs examples"| node_data_risk
node_learner -->|"runs examples"| node_compliance
node_learner -->|"runs example"| node_research
node_learner -->|"runs workshops"| node_workshops
node_learner -->|"runs exercises"| node_exercises
node_learner -->|"runs evaluation"| node_bench
node_learner -->|"runs evaluation"| node_calibration
node_learner -->|"runs evaluation"| node_confidence

click node_run "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/run.py"
click node_graph "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/graph.py"
click node_contracts "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/contracts.py"
click node_profiling "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/tools.py"
click node_quality "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/quality.py"
click node_business "https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/cas_pratiques"
click node_data_risk "https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/cas_pratiques"
click node_compliance "https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/cas_pratiques"
click node_research "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/cas_pratiques/exemple_sante_recherche.py"
click node_workshops "https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/ateliers"
click node_exercises "https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/exercices"
click node_bench "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/evaluation/banc_eval.py"
click node_calibration "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/evaluation/calibration_juge.py"
click node_confidence "https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/evaluation/intervalle_confiance.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_run,node_graph,node_contracts,node_profiling,node_quality toneBlue
class node_business,node_data_risk,node_compliance,node_research,node_dataset toneAmber
class node_workshops,node_exercises toneMint
class node_bench,node_calibration,node_confidence toneRose
class node_learner,node_approver toneIndigo
```

## Components

### ReportOps workflow

- [Workflow entry point](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/run.py): `python/reportops/run.py`
- [Orchestration graph](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/graph.py): `python/reportops/graph.py`
- [State contracts](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/contracts.py): `python/reportops/contracts.py`
- [Dataset profiling](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/tools.py): `python/reportops/tools.py`
- [Quality rules](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/reportops/quality.py): `python/reportops/quality.py`

### Practical cases

- [Business workflows](https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/cas_pratiques): `python/cas_pratiques`
- [Data and risk](https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/cas_pratiques): `python/cas_pratiques`
- [Compliance and statistics](https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/cas_pratiques): `python/cas_pratiques`
- [Research example](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/cas_pratiques/exemple_sante_recherche.py): `python/cas_pratiques/exemple_sante_recherche.py`

### Workshops and exercises

- [AI workshops](https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/ateliers): `python/ateliers`
- [Applied exercises](https://github.com/damoko2004/devenir-orchestrateur-ia/tree/main/python/exercices): `python/exercices`

### Evaluation tools

- [Evaluation bench](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/evaluation/banc_eval.py): `python/evaluation/banc_eval.py`
- [Judge calibration](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/evaluation/calibration_juge.py): `python/evaluation/calibration_juge.py`
- [Confidence intervals](https://github.com/damoko2004/devenir-orchestrateur-ia/blob/main/python/evaluation/intervalle_confiance.py): `python/evaluation/intervalle_confiance.py`

### Other components

- **Learner**
- **Human approver**
- **Dataset source**

## Connections

- Learner → Workflow entry point: starts workflow (evidence: `README.md`)
- Workflow entry point → Orchestration graph: invokes graph (evidence: `python/reportops/run.py`)
- Orchestration graph → Dataset profiling: profiles dataset (evidence: `python/reportops/graph.py`)
- Orchestration graph → Quality rules: evaluates quality (evidence: `python/reportops/graph.py`)
- Orchestration graph → State contracts: validates state (evidence: `python/reportops/graph.py`)
- Dataset profiling → State contracts: returns profile (evidence: `python/reportops/tools.py`)
- Quality rules → State contracts: returns decision (evidence: `python/reportops/quality.py`)
- Dataset source → Dataset profiling: provides dataset
- Orchestration graph → Human approver: requests approval (evidence: `python/reportops/graph.py`)
- Learner → Business workflows: runs examples (evidence: `README.md`)
- Learner → Data and risk: runs examples (evidence: `README.md`)
- Learner → Compliance and statistics: runs examples (evidence: `README.md`)
- Learner → Research example: runs example (evidence: `README.md`)
- Learner → AI workshops: runs workshops (evidence: `README.md`)
- Learner → Applied exercises: runs exercises (evidence: `README.md`)
- Learner → Evaluation bench: runs evaluation (evidence: `README.md`)
- Learner → Judge calibration: runs evaluation (evidence: `README.md`)
- Learner → Confidence intervals: runs evaluation (evidence: `README.md`)
