Upload files to "/"

architecture_readme.md

@@ -0,0 +1,91 @@
+# 📄 Structure du Projet et Diagrammes Mermaid
+
+Fichier `architecture.md` contenant une description complète de l'application avec **6 diagrammes Mermaid** :
+
+## 📁 Structure du Dossier
+
+```
+Point-Cloud-Classifier-HTMX/
+├── agents.md
+├── docker-compose.yml          # Configuration Docker (2 services)
+├── Dockerfile.builder
+├── Dockerfile.entwine          # Backend avec Entwine
+├── Dockerfile.frontend         # Frontend avec HTMX
+├── pyproject.toml
+├── requirements.txt
+├── Roo.md                      # Contexte du projet
+├── architecture.md             # 📄 NOUVEAU - Documentation complète
+├── backend/
+│   ├── __init__.py
+│   ├── config.py               # Configuration backend
+│   ├── main.py                 # FastAPI backend
+│   ├── data/
+│   │   ├── uploads/            # Fichiers LAS bruts
+│   │   └── ept/                # Nuages convertis
+│   ├── routes/
+│   │   ├── upload.py           # Routes upload
+│   │   ├── viewer.py           # Routes visualisation
+│   │   └── admin.py            # Routes admin
+│   ├── services/
+│   │   ├── converter.py        # Conversion Entwine
+│   │   ├── manifest.py         # Gestion manifest.json
+│   │   └── html_generator.py   # Génération HTML Potree
+│   └── static/
+│       └── potree/             # Assets Potree
+└── frontend/
+    ├── api_client.py           # Client HTTP async
+    ├── config.py               # Configuration frontend
+    ├── main.py                 # FastAPI frontend
+    ├── components/             # Composants HTMX
+    ├── routes/
+    │   ├── upload.py
+    │   ├── viewer.py
+    │   ├── admin.py
+    │   └── crop.py
+    ├── static/
+    │   └── potree/
+    └── templates/
+        ├── index.html
+        └── partials/
+            ├── cloud_list.html
+            ├── viewer.html
+            ├── crop.html
+            ├── backend_config.html
+            ├── debug_panel.html
+            ├── health_status.html
+            └── upload_result.html
+```
+
+## 🔄 Diagrammes Mermaid
+
+### 1. Vue d'ensemble de l'architecture
+Architecture globale avec Frontend (8091), Backend (8000), Outils externes (Potree, PDAL, Entwine) et Stockage.
+
+### 2. Flux principal d'upload et conversion
+SequenceDiagram montrant les 14 étapes : Upload → Vérification → Conversion Entwine → Manifeste → Visualisation.
+
+### 3. Flux de visualisation
+Flowchart LR de la liste des nuages → sélection → embed Potree → chargement EPT → visualisation 3D.
+
+### 4. Flux de crop (réduction du nuage)
+SequenceDiagram du traitement PDAL : Sélection box 3D → Filtre LAS → Conversion EPT → Nouveau nuage.
+
+### 5. Architecture des routes
+Mindmap détaillant toutes les routes Frontend et Backend avec leurs endpoints.
+
+### 6. Diagramme complet des interactions
+Flowchart TB complet avec 26 étapes numérotées, classes colorées par type (utilisateur, frontend, backend, outils, stockage, externe).
+
+### 7. Structure des dossiers EPT
+Graph TD montrant la structure interne d'un dossier EPT (manifest, ept.json, tuiles, hiérarchie, sources).
+
+## 🎯 Fonctionnalités Documentées
+
+1. **Upload et Conversion** - LAS/LAZ/PLY → EPT
+2. **Visualisation 3D** - Potree Viewer WebGL
+3. **Administration** - Liste, Debug, Suppression
+4. **Traitement PDAL** - Crop 3D
+5. **Configuration Dynamique** - URLs configurables
+6. **Monitoring** - Health check, espace disque
+
+Le fichier `architecture.md` est prêt à être utilisé comme contexte pour un agent AI et pour la revue des fonctionnalités.