# damoko2004/ce-que-vos-donn-es-savent-de-vos-clients architecture

> Architecture diagram of the GitHub repository damoko2004/ce-que-vos-donn-es-savent-de-vos-clients, 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/ce-que-vos-donn-es-savent-de-vos-clients
- Repository: https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients

## Overview

This is a companion code repository for a book on customer analytics, machine learning, generative AI, and decision-making—not a single deployed application. A reader regenerates synthetic datasets, then runs ordered Python or R chapter blocks to explore data preparation, analysis, modeling, evaluation, and AI applications. The map groups the Python examples by capability and includes the minimal runtime support in `socle.py`. Many branches are represented by chapter directories because their individual implementations were not sampled; the documented chapter coverage should not be read as a verified runtime call graph.

Main entry points: [`data/generer.py`](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/data/generer.py) (Dataset generator), [`python/annexes/PY-AXA-02_generation_du_jeu_de_donnees_fil_rouge.py`](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/annexes/PY-AXA-02_generation_du_jeu_de_donnees_fil_rouge.py) (Red-thread generator), [`python/chapitre_03/PY-C03-07_orchestration_du_flux_complet.py`](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_03/PY-C03-07_orchestration_du_flux_complet.py) (ETL orchestration), [`python/chapitre_04/PY-C04-01_fiche_de_sante.py`](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_04/PY-C04-01_fiche_de_sante.py) (Client health)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Synthetic data"]
  node_generator["Dataset generator<br/>[generer.py]"]
  node_red_data["Red-thread generator"]
end

subgraph group_etl["Data preparation"]
  node_etl_flow["ETL orchestration"]
  node_etl_contracts["Source contracts"]
  node_etl_quality["Quality barrier"]
end

subgraph group_analytics["Customer analytics"]
  node_client_health["Client health"]
  node_rfm["RFM segments"]
  node_pca["Customer PCA"]
  node_clustering["Customer clusters"]
  node_segments["Segment profiles"]
end

subgraph group_models["Prediction and decisions"]
  node_supervised["Supervised models"]
  node_validation["Temporal validation"]
  node_churn["Churn scoring"]
  node_recommend["Recommendations"]
  node_model_eval["Model evaluation"]
end

subgraph group_ai["Text, media, agents"]
  node_text["Text analytics"]
  node_sessions["Web sessions"]
  node_vision["Image models"]
  node_retrieval["Document retrieval"]
  node_bandit["Contextual bandit"]
  node_agent_workflow["Guarded agent workflow"]
  node_service["Assistant service"]
end

subgraph group_support["Runtime support"]
  node_socle["Minimal runtime support<br/>[socle.py]"]
end

node_reader(("Reader"))

node_reader -->|"runs to generate"| node_generator
node_reader -->|"runs chapter blocks"| node_red_data
node_reader -->|"runs chapter blocks"| node_etl_flow
node_reader -->|"runs chapter blocks"| node_client_health
node_reader -->|"runs chapter blocks"| node_rfm
node_reader -->|"runs chapter blocks"| node_pca
node_reader -->|"runs chapter blocks"| node_clustering
node_reader -->|"runs chapter blocks"| node_segments
node_reader -->|"runs chapter blocks"| node_supervised
node_reader -->|"runs chapter blocks"| node_validation
node_reader -->|"runs chapter blocks"| node_churn
node_reader -->|"runs chapter blocks"| node_recommend
node_reader -->|"runs chapter blocks"| node_model_eval
node_reader -->|"runs chapter blocks"| node_text
node_reader -->|"runs chapter blocks"| node_sessions
node_reader -->|"runs chapter blocks"| node_vision
node_reader -->|"runs chapter blocks"| node_retrieval
node_reader -->|"runs chapter blocks"| node_bandit
node_reader -->|"runs chapter blocks"| node_agent_workflow
node_reader -->|"runs chapter blocks"| node_service
node_reader -->|"uses runtime support"| node_socle

click node_generator "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/data/generer.py"
click node_red_data "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/annexes/PY-AXA-02_generation_du_jeu_de_donnees_fil_rouge.py"
click node_etl_flow "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_03/PY-C03-07_orchestration_du_flux_complet.py"
click node_etl_contracts "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/tree/main/python/chapitre_03"
click node_etl_quality "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_03/PY-C03-06_la_barriere_et_sa_trace.py"
click node_client_health "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_04/PY-C04-01_fiche_de_sante.py"
click node_rfm "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_07/PY-C07-01_segmentation_rfm_par_seuils_metier.py"
click node_pca "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_08/PY-C08-01_acp_normee_sur_clients_360.py"
click node_clustering "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_09/PY-C09-01_k_means_avec_choix_de_k.py"
click node_segments "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_11/PY-C11-01_caracterisation_des_segments.py"
click node_supervised "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/tree/main/python/chapitre_14"
click node_validation "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_16/PY-C16-01_validation_temporelle.py"
click node_churn "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_18/PY-C18-01_indice_de_desengagement.py"
click node_recommend "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_22/PY-C22-01_filtrage_collaboratif_centre_objet.py"
click node_model_eval "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_24/PY-C24-01_le_tableau_de_bord_d_evaluation.py"
click node_text "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/tree/main/python/chapitre_32"
click node_sessions "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_33/PY-C33-01_nettoyage_et_sessionnisation.py"
click node_vision "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_34/PY-C34-01_extraire_une_representation_entrainer_une_tete_leger.py"
click node_retrieval "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/tree/main/python/chapitre_36"
click node_bandit "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_37/PY-C37-01_bandit_contextuel_par_echantillonnage_de_thompson.py"
click node_agent_workflow "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_40/PY-C40-01_orchestration_en_graphe_d_etats_avec_garde_fous.py"
click node_service "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_39/PY-C39-02_service_expose_instrumente_des_la_premiere_ligne.py"
click node_socle "https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/socle.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_generator,node_red_data toneBlue
class node_etl_flow,node_etl_contracts,node_etl_quality toneAmber
class node_client_health,node_rfm,node_pca,node_clustering,node_segments toneMint
class node_supervised,node_validation,node_churn,node_recommend,node_model_eval toneRose
class node_text,node_sessions,node_vision,node_retrieval,node_bandit,node_agent_workflow,node_service,node_reader toneIndigo
class node_socle toneTeal
```

## Components

### Synthetic data

- [Dataset generator](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/data/generer.py): `data/generer.py`
- [Red-thread generator](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/annexes/PY-AXA-02_generation_du_jeu_de_donnees_fil_rouge.py): `python/annexes/PY-AXA-02_generation_du_jeu_de_donnees_fil_rouge.py`

### Data preparation

- [ETL orchestration](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_03/PY-C03-07_orchestration_du_flux_complet.py): `python/chapitre_03/PY-C03-07_orchestration_du_flux_complet.py`
- [Source contracts](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/tree/main/python/chapitre_03): `python/chapitre_03`
- [Quality barrier](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_03/PY-C03-06_la_barriere_et_sa_trace.py): `python/chapitre_03/PY-C03-06_la_barriere_et_sa_trace.py`

### Customer analytics

- [Client health](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_04/PY-C04-01_fiche_de_sante.py): `python/chapitre_04/PY-C04-01_fiche_de_sante.py`
- [RFM segments](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_07/PY-C07-01_segmentation_rfm_par_seuils_metier.py): `python/chapitre_07/PY-C07-01_segmentation_rfm_par_seuils_metier.py`
- [Customer PCA](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_08/PY-C08-01_acp_normee_sur_clients_360.py): `python/chapitre_08/PY-C08-01_acp_normee_sur_clients_360.py`
- [Customer clusters](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_09/PY-C09-01_k_means_avec_choix_de_k.py): `python/chapitre_09/PY-C09-01_k_means_avec_choix_de_k.py`
- [Segment profiles](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_11/PY-C11-01_caracterisation_des_segments.py): `python/chapitre_11/PY-C11-01_caracterisation_des_segments.py`

### Prediction and decisions

- [Supervised models](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/tree/main/python/chapitre_14): `python/chapitre_14`
- [Temporal validation](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_16/PY-C16-01_validation_temporelle.py): `python/chapitre_16/PY-C16-01_validation_temporelle.py`
- [Churn scoring](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_18/PY-C18-01_indice_de_desengagement.py): `python/chapitre_18/PY-C18-01_indice_de_desengagement.py`
- [Recommendations](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_22/PY-C22-01_filtrage_collaboratif_centre_objet.py): `python/chapitre_22/PY-C22-01_filtrage_collaboratif_centre_objet.py`
- [Model evaluation](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_24/PY-C24-01_le_tableau_de_bord_d_evaluation.py): `python/chapitre_24/PY-C24-01_le_tableau_de_bord_d_evaluation.py`

### Text, media, agents

- [Text analytics](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/tree/main/python/chapitre_32): `python/chapitre_32`
- [Web sessions](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_33/PY-C33-01_nettoyage_et_sessionnisation.py): `python/chapitre_33/PY-C33-01_nettoyage_et_sessionnisation.py`
- [Image models](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_34/PY-C34-01_extraire_une_representation_entrainer_une_tete_leger.py): `python/chapitre_34/PY-C34-01_extraire_une_representation_entrainer_une_tete_leger.py`
- [Document retrieval](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/tree/main/python/chapitre_36): `python/chapitre_36`
- [Contextual bandit](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_37/PY-C37-01_bandit_contextuel_par_echantillonnage_de_thompson.py): `python/chapitre_37/PY-C37-01_bandit_contextuel_par_echantillonnage_de_thompson.py`
- [Guarded agent workflow](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_40/PY-C40-01_orchestration_en_graphe_d_etats_avec_garde_fous.py): `python/chapitre_40/PY-C40-01_orchestration_en_graphe_d_etats_avec_garde_fous.py`
- [Assistant service](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/python/chapitre_39/PY-C39-02_service_expose_instrumente_des_la_premiere_ligne.py): `python/chapitre_39/PY-C39-02_service_expose_instrumente_des_la_premiere_ligne.py`

### Runtime support

- [Minimal runtime support](https://github.com/damoko2004/ce-que-vos-donn-es-savent-de-vos-clients/blob/main/socle.py): `socle.py`

### Other components

- **Reader**

## Connections

- Reader → Dataset generator: runs to generate (evidence: `README.md`)
- Reader → Red-thread generator: runs chapter blocks (evidence: `README.md`)
- Reader → ETL orchestration: runs chapter blocks (evidence: `README.md`)
- Reader → Client health: runs chapter blocks (evidence: `README.md`)
- Reader → RFM segments: runs chapter blocks (evidence: `README.md`)
- Reader → Customer PCA: runs chapter blocks (evidence: `README.md`)
- Reader → Customer clusters: runs chapter blocks (evidence: `README.md`)
- Reader → Segment profiles: runs chapter blocks (evidence: `README.md`)
- Reader → Supervised models: runs chapter blocks (evidence: `README.md`)
- Reader → Temporal validation: runs chapter blocks (evidence: `README.md`)
- Reader → Churn scoring: runs chapter blocks (evidence: `README.md`)
- Reader → Recommendations: runs chapter blocks (evidence: `README.md`)
- Reader → Model evaluation: runs chapter blocks (evidence: `README.md`)
- Reader → Text analytics: runs chapter blocks (evidence: `README.md`)
- Reader → Web sessions: runs chapter blocks (evidence: `README.md`)
- Reader → Image models: runs chapter blocks (evidence: `README.md`)
- Reader → Document retrieval: runs chapter blocks (evidence: `README.md`)
- Reader → Contextual bandit: runs chapter blocks (evidence: `README.md`)
- Reader → Guarded agent workflow: runs chapter blocks (evidence: `README.md`)
- Reader → Assistant service: runs chapter blocks (evidence: `README.md`)
- Reader → Minimal runtime support: uses runtime support (evidence: `README.md`)
