# CAHIER DES CHARGES — ARAN IA
## Plateforme d'Intelligence Artificielle de DSD Renov

> Version 1.0 — 11 mars 2026
> Document de reference pour tout developpement futur.
> Rien ne se code sans etre dans ce document.

---

## 1. L'ENTREPRISE

| Info | Detail |
|------|--------|
| **Nom** | DSD Renov |
| **Activite** | Renovation batiment patrimonial ancien |
| **Specialite** | Bati patrimonial (pierre, moulures, voutes, pans de bois) |
| **CA actuel** | 5 M EUR |
| **Objectif CA** | 100 M EUR |
| **Effectif** | 20 employes (hors techniciens terrain) |
| **Zones** | Ile-de-France, Normandie, PACA, Suisse (Geneve) |

### Postes et effectifs

| Poste | Nombre estim. | Service |
|-------|--------------|---------|
| Architecte | 2-3 | Conception |
| Ingenieur structure | 1-2 | Conception |
| Economiste de la construction | 1-2 | Conception |
| Conducteur de travaux | 3-4 | Execution |
| Referent technique | 1-2 | Execution |
| Technicien | (hors scope) | Execution |
| Commercial / Business dev | 3-4 | Commercial |
| Charge d'affaire | 2-3 | Commercial |
| Responsable marketing SEO | 1 | Marketing |
| Secretaire | 1-2 | Admin |
| Responsable administratif | 1 | Admin |
| Direction (Daniel) | 1 | Direction |

### Outils actuels

| Outil | Usage | Integration ARAN |
|-------|-------|-----------------|
| **ProgBat** | Fiches clients, devis, factures | A remplacer (pas d'API) |
| **Pennylane** | Comptabilite, facturation | Lecture donnees + classement factures |
| **Google Workspace** | Gmail, Drive, Calendar, Sheets, Chat | Integration complete |
| **Autocad** | Plans architecturaux | ARAN genere des DXF compatibles |
| **Google Earth** | Visualisation terrain | Reference externe |

---

## 2. QU'EST-CE QU'ARAN

### Definition

ARAN est le **cerveau IA central** de DSD Renov. Ce n'est pas un chatbot. C'est un collaborateur numerique qui :
- **Assiste** chaque employe dans son metier
- **Produit** des documents professionnels (devis, plans, courriers, presentations)
- **Apprend** des decisions humaines pour devenir progressivement autonome
- **Pilote** a terme les operations de l'entreprise

### Principe fondamental

```
HUMAIN decide  →  ARAN execute  →  HUMAIN valide  →  ARAN apprend
     ↑                                                      |
     └──────── ARAN devient autonome sur ce sujet ──────────┘
```

A terme, ARAN fait seul ce qu'il a appris a faire correctement.

### Canaux d'acces

| Canal | Usage | Utilisateurs |
|-------|-------|-------------|
| **Google Chat** | Terrain, mobile, rapide | Tous les employes |
| **Interface web** | Bureau, documents, dashboards | Tous les employes |
| **Telephone (futur)** | Appels clients, prospection | ARAN autonome |
| **API** | Integrations externes | Systemes DSD |

---

## 3. CE QU'ARAN FAIT PAR METIER

### 3.1 Service Commercial (priorite haute)

**Utilisateurs** : commerciaux, charges d'affaire

| Fonctionnalite | Description | Priorite |
|----------------|-------------|----------|
| **Devis rapide particulier** | A partir d'un brief oral/ecrit, generer un devis complet avec prix Batiprix + historique DSD | V1 |
| **DCE/DPGF auto-remplissage** | Upload DCE (PDF) → ARAN lit, extrait lots/quantites/exigences → pre-remplit DPGF avec prix | V1 |
| **Rapport audit/prescription** | Generer un rapport d'audit apres visite client | V1 |
| **Presentation DSD Renov** | Presentation commerciale professionnelle (PPTX) | V1 |
| **Memoire technique** | Document technique accompagnant l'offre | V1 |
| **Prospection automatique** | ARAN contacte des prospects (email, tel a terme) | V2 |
| **Argumentaires commerciaux** | Fiches argumentaires par type de projet | V1 |
| **Suivi pipeline** | Vision pipeline commercial, relances auto | V2 |

**Workflow devis actuel (a optimiser) :**
```
1. RDV client (particulier) ou reception DCE (pro/copro)
2. Etude des besoins / lecture CCTP
3. Conception du projet
4. Recherche prix (Batiprix + historique)
5. Chiffrage dans ProgBat
6. Redaction documents accompagnement
7. Presentation + negociation
8. Signature
```

**Workflow cible avec ARAN :**
```
1. RDV client → commercial dicte/ecrit le brief a ARAN
2. ARAN analyse, propose un projet, chiffre automatiquement
3. ARAN genere : devis + audit + presentation + memoire technique
4. Commercial review et ajuste
5. ARAN finalise les documents
6. Presentation client
7. Signature
   Temps : 3 jours → quelques heures
```

### 3.2 Service Conception (Architecture + Structure)

**Utilisateurs** : architectes, ingenieurs structure, economistes

| Fonctionnalite | Description | Priorite |
|----------------|-------------|----------|
| **Esquisses/plans DXF** | Generer des plans 2D compatibles Autocad | V1 |
| **Montages photo** | Integration visuelle du projet dans l'existant | V1 |
| **Verification PLU** | Consulter le PLU de la parcelle (cadastre + reglementation) | V1 |
| **Descriptifs techniques** | Rediger CCTP, descriptifs lots | V1 |
| **Permis de construire** | Aider a monter le dossier PC / DP | V2 |
| **Notes de calcul** | Dimensionnement structure (Eurocodes) | V2 |
| **Plans d'EXE** | Plans d'execution detailles | V2 |
| **BIM** | Integration maquette numerique | V3 |
| **Metres** | Calcul des quantites a partir des plans | V1 |
| **Estimations** | Chiffrage rapide par poste | V1 |

### 3.3 Service Execution (Travaux)

**Utilisateurs** : conducteurs de travaux, referents techniques

| Fonctionnalite | Description | Priorite |
|----------------|-------------|----------|
| **Planning chantier** | Gantt interactif par chantier | V1 |
| **Comptes-rendus chantier** | Generer CR a partir de notes vocales/ecrites | V1 |
| **Suivi avancement** | Tableau de bord avancement par lot | V2 |
| **Fiches techniques** | Fiches materiaux avec preconisations | V1 |
| **Conformite DTU** | Verification des regles par lot | V2 |

### 3.4 Service Marketing

**Utilisateurs** : responsable marketing SEO

| Fonctionnalite | Description | Priorite |
|----------------|-------------|----------|
| **Articles SEO** | Rediger des articles optimises pour le referencement | V1 |
| **Audits SEO** | Analyser le site dsd-renov.fr et recommander | V1 |
| **Posts reseaux sociaux** | Generer posts Instagram/Facebook/LinkedIn | V1 |
| **Entretien sites web** | Suggestions de contenu, mises a jour | V2 |

### 3.5 Service Administratif

**Utilisateurs** : secretaire, responsable admin

| Fonctionnalite | Description | Priorite |
|----------------|-------------|----------|
| **Courriers** | Generer courriers types (relances, convocations, notifications) | V1 |
| **Relances impayees** | Relances automatiques clients | V2 |
| **Conformite** | Verifier la conformite des documents (assurances, qualifications) | V2 |
| **Aides financieres** | Calculer MaPrimeRenov, CEE, eco-PTZ, TVA reduite | V1 |
| **Contrats** | Generer contrats sous-traitance, avenants | V2 |
| **Juridique** | Conseil droit BTP (Code Civil 1792, garanties, assurances) | V1 |
| **RH** | Convention BTP, grilles salariales, CIBTP, contrats | V2 |
| **Factures** | Facturation (quand ProgBat remplace) | V2 |

### 3.6 Direction (Daniel)

| Fonctionnalite | Description | Priorite |
|----------------|-------------|----------|
| **Dashboard pilotage** | CA, marges, pipeline, chantiers, tresorerie | V1 |
| **Predictif** | Previsions CA, tresorerie, charge | V2 |
| **Coaching employes** | ARAN forme et evalue les employes | V2 |
| **Auto-amelioration** | ARAN evolue son propre cerveau | V2 |
| **Pilotage autonome** | ARAN prend des decisions operationnelles | V3 |

### 3.7 Fonctions transversales

| Fonctionnalite | Description | Priorite |
|----------------|-------------|----------|
| **Formation bati patrimonial** | Quiz, fiches, parcours de formation pour les employes | V2 |
| **Service client ARAN** | ARAN repond au telephone aux clients | V3 |
| **Communication vocale** | ARAN parle vocalement avec les employes | V3 |
| **Classement factures** | Lecture + classement auto des factures d'achat (Pennylane) | V2 |
| **Memoire entreprise** | ARAN connait tout de DSD Renov et capitalise le savoir | V1→V3 |

---

## 4. DOCUMENTS QU'ARAN GENERE

| Document | Format | Service | Priorite |
|----------|--------|---------|----------|
| Devis | PDF (format pro) | Commercial | V1 |
| DPGF (pre-remplie) | XLSX | Commercial | V1 |
| Rapport audit/prescription | PDF/DOCX | Commercial | V1 |
| Presentation DSD Renov | PPTX | Commercial | V1 |
| Memoire technique | PDF/DOCX | Commercial | V1 |
| Argumentaire commercial | PDF | Commercial | V1 |
| CCTP | DOCX | Conception | V1 |
| Plans/esquisses | DXF | Conception | V1 |
| Montages photo | PNG/JPG | Conception | V1 |
| Planning Gantt | Webapp interactive | Execution | V1 |
| Compte-rendu chantier | PDF/DOCX | Execution | V1 |
| Fiches techniques | PDF | Execution | V1 |
| Articles SEO | HTML/Markdown | Marketing | V1 |
| Posts reseaux sociaux | Texte + images | Marketing | V1 |
| Courriers administratifs | DOCX/PDF | Admin | V1 |
| Notes de calcul | PDF | Structure | V2 |
| Dossier permis construire | PDF compile | Conception | V2 |
| Contrats/avenants | DOCX | Admin | V2 |
| Factures | PDF | Admin | V2 |
| Quiz formation | Webapp | Transversal | V2 |

---

## 5. DONNEES ET SOURCES

### Base de prix
- **Batiprix 2026** : 48 000 articles (en base, avec certaines incoherences sur le bati patrimonial)
- **Historique devis DSD** : devis passes dans ProgBat (reference reelle des prix pratiques)
- **Recherche web** : pour les prix non couverts ou a actualiser
- **Enrichissement descriptifs** : les descriptifs Batiprix doivent etre enrichis (trop generiques pour le bati ancien)

### Memoire ARAN
- **Memoire projet** : chaque projet/chantier = un dossier avec tous les documents, decisions, historique
- **Memoire utilisateur** : preferences, style, habitudes de chaque employe
- **Memoire entreprise** : processus DSD, savoir-faire bati patrimonial, decisions passees
- **Apprentissage** : chaque validation/correction humaine enrichit la memoire

### Integrations

| Systeme | Direction | Donnees | Priorite |
|---------|-----------|---------|----------|
| Google Chat | Bidirectionnel | Messages employes | V1 |
| Gmail | Bidirectionnel | Emails clients/fournisseurs | V1 |
| Google Drive | Bidirectionnel | Documents projet | V1 |
| Google Calendar | Bidirectionnel | RDV, planning | V1 |
| Google Sheets | Lecture + ecriture | Tableaux de suivi | V1 |
| Pennylane | Lecture + classement | Comptabilite, factures achat | V2 |
| ProgBat | Lecture (puis remplacement) | Clients, devis, factures | V1 lecture, V2 remplacement |
| Autocad | Export DXF | Plans generes | V1 |
| Sites web DSD | Ecriture | Articles, contenu SEO | V1 |

---

## 6. SECURITE ET ROLES

### Niveaux d'acces

| Role | Voit | Ne voit pas |
|------|------|-------------|
| **Direction** | Tout (CA, marges, RH, finances, performances) | - |
| **Responsable admin** | Facturation, juridique, RH, aides | Marges, strategie |
| **Commercial / Charge affaire** | Ses clients, ses devis, catalogue, pipeline | Donnees autres commerciaux, finances |
| **Architecte / Ingenieur** | Projets assigns, PLU, catalogue technique | Donnees commerciales, finances |
| **Conducteur / Referent technique** | Chantiers assigns, fiches techniques, planning | Donnees commerciales, finances |
| **Marketing** | Contenu, analytics SEO, reseaux sociaux | Donnees clients, finances |
| **Secretaire** | Courriers, relances, agenda | Marges, strategie |

### Validation humaine obligatoire (V1)

Ces actions ne partent JAMAIS sans validation humaine en V1 :
- Envoyer un devis a un client
- Envoyer une facture
- Signer un contrat / avenant
- Modifier des donnees comptables (Pennylane)
- Publier du contenu sur les sites web
- Envoyer un email a un client au nom de DSD

### Prospection autonome (exception)

ARAN PEUT contacter des prospects sans validation pour :
- Emails de prospection (templates valides par Daniel)
- Prise de contact initiale
- Relances de prospection

---

## 7. INTERFACE WEB

### URL : aran.dsdlabsia.net

### Pages principales

| Page | Contenu | Utilisateurs |
|------|---------|-------------|
| **Chat** | Conversation avec ARAN (comme Google Chat mais en mieux) | Tous |
| **Projets** | Liste des projets/chantiers avec documents, historique, statut | Tous (filtre par role) |
| **Fiche client** | Infos client + documents + historique + espace stockage | Commercial, admin |
| **Devis** | Outil de creation/edition de devis avec catalogue | Commercial |
| **Planning** | Planning chantiers (Gantt) | Conducteurs, direction |
| **Dashboard** | KPIs, CA, pipeline, chantiers en cours | Direction |
| **Documents** | Bibliotheque des documents generes (artifacts) | Tous |
| **Formation** | Parcours de formation + quiz | Tous |
| **Parametres** | Profil, preferences, notifications | Tous |

### Specificites interface web vs Google Chat
- **Artifacts en grand format** : plans, tableaux, presentations visualisables
- **Historique par projet** (pas juste un fil de conversation)
- **Outils interactifs** : editeur de devis, planning drag & drop
- **Stockage documents** par client/projet
- **Dashboards visuels**

---

## 8. BUDGET ET CONTRAINTES

### Budget LLM
- **Maximum** : 500 EUR / mois pour les appels IA (OpenRouter)
- **20 employes** = ~25 EUR / employe / mois
- **Strategie** : routage intelligent (Grok pour le simple, GPT/Gemini pour le complexe)
- **Optimisations** : cache des reponses frequentes, prompts concis, batch quand possible

### Infrastructure
- **Serveur actuel** : 1 VPS (197 Go disque, ~3 Go RAM)
- **Containers cibles** : 4 a 6 maximum (pas 24)
- **Base de donnees** : PostgreSQL unique (aran_db)
- **Cache** : Redis
- **Reverse proxy** : Caddy
- **Domaine** : aran.dsdlabsia.net

### Contraintes
- Pas de nouveau SaaS externe (tout dans ARAN)
- Pas de framework frontend lourd (legeret, rapidite)
- Code Python maintenable (pas 200K lignes)
- Deploiement simple (docker compose up)

---

## 9. PHASES DE DEVELOPPEMENT

### PHASE 1 — Fondations (2 semaines)

**Objectif** : les commerciaux font leurs devis 5x plus vite, tous les employes ont acces a ARAN.

| # | Tache | Effort | Detail |
|---|-------|--------|--------|
| 1.1 | Nettoyer le serveur | 1h | Supprimer 20 containers parasites, liberer 120 Go |
| 1.2 | Corriger Google Chat | 1j | Fixer les messages dupliques, definir le comportement |
| 1.3 | Prompt ARAN v3 | 1j | Recrire le prompt avec les metiers, les regles, le comportement attendu |
| 1.4 | Interface web basique | 3j | Chat + projets + documents + dashboard — sur aran.dsdlabsia.net |
| 1.5 | Module devis | 3j | Upload DCE → extraction → chiffrage auto Batiprix + historique → DPGF |
| 1.6 | Generation documents | 2j | Devis PDF, rapport audit, presentation PPTX, memoire technique, CCTP |
| 1.7 | Roles et acces | 1j | 7 niveaux par poste, comptes pour les 20 employes |
| 1.8 | Correction Batiprix | 1j | Enrichir les descriptifs bati patrimonial, croiser avec historique DSD |

**Critere de succes V1** : un commercial recoit un DCE, l'upload dans ARAN, et recoit un devis pre-rempli + documents d'accompagnement en quelques heures au lieu de 3 jours.

### PHASE 2 — Extension (mois 2-3)

| # | Tache |
|---|-------|
| 2.1 | Remplacement ProgBat (devis + factures + fiches clients dans ARAN) |
| 2.2 | Integration Pennylane (lecture comptable + classement factures) |
| 2.3 | Prospection automatique (emails, pipeline) |
| 2.4 | Formation / quiz bati patrimonial |
| 2.5 | Auto-amelioration cerveau (versionnement prompts, apprentissage) |
| 2.6 | Planning chantier interactif |
| 2.7 | Coaching employes (feedback, formation personnalisee) |
| 2.8 | Notes de calcul structure |
| 2.9 | Permis de construire / DP |
| 2.10 | Contrats, avenants, juridique |
| 2.11 | RH (convention BTP, grilles salariales) |

### PHASE 3 — Autonomie (mois 4-6)

| # | Tache |
|---|-------|
| 3.1 | ARAN telephone (appels clients, service client vocal) |
| 3.2 | Communication vocale employes |
| 3.3 | BIM / maquette numerique |
| 3.4 | Plans d'EXE detailles |
| 3.5 | Pilotage autonome (ARAN prend des decisions operationnelles) |
| 3.6 | Auto-developpement complet (ARAN ameliore son infra sans casser) |
| 3.7 | Predictif avance (CA, tresorerie, charge, risques) |

---

## 10. ARCHITECTURE CIBLE

```
                    ┌─────────────────────────────────────┐
                    │         ARAN (cerveau central)       │
                    │                                     │
                    │  Cortex v3                          │
                    │  ├── GPT-5.4 (complexe)             │
                    │  ├── Gemini (calcul/science)        │
                    │  └── Grok 3 (rapide/simple)         │
                    │                                     │
                    │  41+ outils metier                  │
                    │  Memoire (projets, users, entreprise)│
                    │  Moteur artifacts (20+ types docs)  │
                    │  Apprentissage continu              │
                    │                                     │
                    └──────────────┬──────────────────────┘
                                   │
               ┌───────────────────┼───────────────────┐
               │                   │                   │
        ┌──────▼──────┐    ┌──────▼──────┐    ┌──────▼──────┐
        │ Google Chat  │    │ Interface   │    │   API REST  │
        │ (terrain)    │    │ web (bureau)│    │ (systemes)  │
        └─────────────┘    └─────────────┘    └─────────────┘

    Integrations :
    ├── Google Workspace (Gmail, Drive, Calendar, Sheets)
    ├── Pennylane (comptabilite)
    ├── Autocad (export DXF)
    └── Sites web DSD (SEO)
```

### Infrastructure serveur (cible)

| Container | Role |
|-----------|------|
| **aran-api** | API FastAPI (cerveau, outils, agents) |
| **aran-web** | Interface web (frontend leger) |
| **aran-postgres** | Base de donnees unique (aran_db) |
| **aran-redis** | Cache et sessions |
| **Caddy** | Reverse proxy HTTPS |

**5 containers. C'est tout.**

---

## 11. CE QUI CHANGE PAR RAPPORT A AVANT

| Avant | Apres |
|-------|-------|
| 24 containers | 5 containers |
| LobeChat comme interface | Interface web custom legere |
| Logto SSO | Auth simple integree (JWT) |
| MinIO S3 | Stockage fichier direct (volume Docker) |
| RAGFlow, Appsmith, monitoring lourd | Supprime |
| Plan Game Changer (MCP, marketplace, KB LobeChat) | Annule — hors sujet |
| Prompt generaliste vague | Prompt metier precis par poste |
| ARAN = chatbot | ARAN = collaborateur qui apprend |
| Pas de workflow devis | Devis automatise (killer feature) |

---

## 12. REGLES ABSOLUES

1. **Rien ne se code sans etre dans ce cahier des charges**
2. **On nettoie AVANT de construire**
3. **Google Chat fonctionne parfaitement AVANT de construire l'interface web**
4. **Le devis automatise est LA priorite V1**
5. **500 EUR/mois max pour les LLM — optimiser le routage**
6. **5 containers max sur le serveur**
7. **Code Python lisible et maintenable — pas d'usine a gaz**
8. **ARAN apprend de chaque interaction — memoire = capital**
9. **Validation humaine obligatoire sur les actions critiques (V1)**
10. **Prospection autonome autorisee (templates valides)**

---

*Document valide par Daniel Sirene — DSD Renov — 11 mars 2026*
*Prochaine etape : nettoyage serveur puis Phase 1*