TaxActes/README.md

TaxActe — Documentation Projet

Calculateur de frais notariaux avec assistance IA et base documentaire RAG

---

📁 Structure du Projet

TaxActe/
├── taxactes/                    # Application Next.js (code source)
│   ├── src/                     # Code source
│   ├── scripts/documents/       # Documents RAG (Code commerce, CGI, BOFiP)
│   ├── ARCHITECTURE.md          # Architecture technique
│   ├── SPECIFICATIONS.md        # Spécifications fonctionnelles
│   ├── CLAUDE.md               # Guide pour Claude Code
│   └── README.md               # Documentation application
│
├── docs/                        # Documentation projet
│   ├── audits/                  # Audits Phase 0
│   │   ├── AUDIT-COMPLET.md
│   │   ├── SECURITY-AUDIT.md
│   │   ├── TECH-DEBT.md
│   │   ├── TEST-GAP-ANALYSIS.md
│   │   └── RISKS.md
│   ├── planning/                # Plans et stratégies
│   │   ├── PLAN-AGENTS-V1-RAG.md
│   │   ├── RAG-STRATEGY-DECISION.md
│   │   └── RGPD-REALITY-CHECK.md
│   ├── releases/                # Notes de version
│   │   └── RELEASE-NOTES-PHASE1.md
│   ├── agents/                  # Documentation agents
│   │   ├── README.md
│   │   ├── chef-de-projet.md
│   │   ├── securite.md
│   │   ├── architecture.md
│   │   └── tests.md
│   └── archive/                 # Archives (études marché, anciens sprints)
│
├── KANBAN.md                    # Suivi des tâches (actif)
├── DAILY-STANDUP.md            # Points quotidiens (actif)
├── DECISIONS.md                # Registre des décisions (actif)
├── DOCUMENTS-RAG-STATUS.md     # Statut documents RAG (actif)
└── README.md                   # Ce fichier

---

🎯 Documents Actifs (à la racine)

Suivi Quotidien

• KANBAN.md : Tableau des tâches (TODO, IN PROGRESS, DONE)
• DAILY-STANDUP.md : Points quotidiens des agents
• DECISIONS.md : Registre des décisions importantes
• DOCUMENTS-RAG-STATUS.md : Progression conversion documents RAG

Documentation Application

• taxactes/README.md : Guide développeur (build, test, déploiement)
• taxactes/CLAUDE.md : Instructions pour Claude Code
• taxactes/ARCHITECTURE.md : Architecture technique complète
• taxactes/SPECIFICATIONS.md : Spécifications fonctionnelles

---

📊 État du Projet

Phase actuelle : Phase 1 — Sécurisation + RAG Prep (Semaine 2)

Métrique	Valeur
Production-ready	65% → 85% (Phase 1 terminée)
Tests unitaires	138 ✅
Tests E2E	0 (Phase 3)
Documents RAG	7/8 (88%)
Sécurité	✅ 4 vulnérabilités critiques corrigées
Monitoring	✅ Sentry + Pino + Healthcheck

---

🚀 Quick Start

Développer

cd taxactes
npm install
npm run dev

Tester

npm run test      # Tests unitaires
npm run lint      # Linting

Déployer

Voir docs/releases/RELEASE-NOTES-PHASE1.md

---

📚 Documentation par Phase

Phase 0 : Audit (Semaine 1) ✅

• Audit complet
• Audit sécurité
• Dette technique
• Analyse tests
• Registre des risques

Phase 1 : Sécurisation + RAG Prep (Semaines 2-3) 🔄

• Plan agents v1 + RAG
• Décision stratégie RAG
• Corrections sécurité
• Release notes Phase 1
• Statut documents RAG

---

🤖 Agents

7 agents spécialisés : docs/agents/README.md

• Chef de Projet
• Sécurité
• Architecture
• Tests
• DevOps
• Features
• Documentation

---

📞 Support

Questions : Voir KANBAN.md ou DAILY-STANDUP.md

Bugs : Créer un fichier QUESTIONS.md à la racine

---

Version : Phase 1 (16 mai 2026) Délai MVP : 12 semaines (4 août 2026)