📄 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

Upload et Conversion - LAS/LAZ/PLY → EPT
Visualisation 3D - Potree Viewer WebGL
Administration - Liste, Debug, Suppression
Traitement PDAL - Crop 3D
Configuration Dynamique - URLs configurables
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.

3.7 KiB Raw Blame History