# Mission

Tu construis une visualisation 3D navigable d'un stock d'entrepôt, à partir du fichier `stock.csv` présent dans ce dossier.

Public : un responsable logistique, pas un développeur. Il ouvre la page le matin pour savoir ce qui manque.

# Contraintes non négociables

- **Un seul fichier de sortie : `entrepot.html`.** Tout dedans : HTML, CSS, JavaScript.
- **Three.js chargé depuis un CDN** via un import map. Aucune autre dépendance. Aucun build, aucun `npm install`, aucun serveur à lancer : la page doit s'ouvrir en double-cliquant dessus.
- Le CSV est **embarqué dans le fichier** sous forme de constante JavaScript, pour que la page fonctionne sans serveur. Isole-le en haut du fichier, entre deux commentaires `// === DONNEES ===` et `// === FIN DONNEES ===`, pour que je puisse le remplacer sans toucher au reste.
- Textes de l'interface en français.

# Avant d'écrire du code

1. Lis `stock.csv` et affiche-moi : le nombre de lignes, la liste des catégories avec leur nombre d'articles, et la répartition des statuts.
2. Propose-moi le plan de la scène en une dizaine de lignes : combien de rayonnages, leur disposition, l'échelle, ce que représente un carton.
3. **Attends ma validation.** N'écris pas une ligne de code avant.

# Les données

Colonnes : `id, nom, categorie, emplacement, quantite, besoin, statut`.

`statut` prend exactement quatre valeurs : `ok`, `a_commander`, `manquant`, `a_compter`.

Couverture d'un article = `quantite / besoin`, plafonnée à 100 %. Si `besoin` vaut 0, l'article est considéré comme couvert et son étiquette indique « pas de besoin ».

# La scène

- Sol en béton clair, murs bas, lumière du jour douce. Pas de ciel, pas de décor inutile.
- **Un rayonnage par catégorie**, disposés en allées parallèles avec un couloir central assez large pour y marcher.
- Chaque rayonnage porte son nom en grandes lettres sur son montant, lisible depuis la vue d'ensemble.
- Chaque article est représenté par un ou plusieurs cartons posés sur les étagères. Le nombre de cartons est proportionnel à `quantite`, plafonné à 12 par article pour rester lisible.
- Codage visuel, qui doit se comprendre sans lire la légende :
  - `ok` : carton plein, couleur neutre
  - `a_commander` : carton sous film translucide
  - `manquant` : contour filaire seul, pas de volume plein
  - `a_compter` : carton neutre avec une étiquette rouge sur la face avant
- Affiche la légende en permanence, en petit, en bas à gauche.

# Les deux modes de caméra

**Vue d'ensemble (par défaut)** : caméra en plongée, orbit à la souris, molette pour zoomer, clic droit pour déplacer. Un bouton « Tourner » lance une rotation lente automatique, un second clic l'arrête.

**Mode promenade** : bouton « Se promener ». Vue à la première personne à 1,70 m du sol, pointer lock. ZQSD et flèches pour avancer, souris pour regarder, Maj pour aller vite, Échap pour sortir. Collisions avec les rayonnages et les murs. Bandeau d'aide affiché en bas tant que le mode est actif, rappelant les touches.

# L'interface

**Panneau de gauche**, fond clair, lisible :
- titre « Stock, vue atelier » et la date de l'inventaire
- une phrase de synthèse : « X articles à commander »
- une jauge : « Besoin couvert, NN % », calculée sur l'ensemble des articles
- une barre de recherche « Chercher un article »
- trois filtres cliquables avec leur compte : Tout, À commander, À compter

Filtrer masque les articles non concernés **dans la scène 3D**, pas seulement dans une liste.

**Barre du bas** : une case par catégorie avec son pourcentage de couverture. En dessous de 50 %, la case passe en rouge.

**Au survol d'un article** : une étiquette suit le curseur et affiche le nom, la catégorie et le besoin. Au clic, l'étiquette se fige avec le détail complet et une croix pour la fermer.

# Performance, à traiter dès la première version

- Les cartons sont dessinés en **InstancedMesh**, un par type de statut. Jamais un mesh par carton.
- **Aucune texture, aucune image.** Uniquement des couleurs plates et des matériaux simples.
- Les ombres sont calculées **une seule fois** au chargement (`shadowMap.autoUpdate = false` après la première image). La scène est statique, elle n'a pas à les recalculer.
- Le survol utilise un raycast **limité aux objets instanciés**, déclenché au mouvement de souris et pas à chaque image.
- Objectif : 60 images par seconde sur un portable sans carte graphique dédiée, avec 1 000 cartons à l'écran.

# Qualité du code

- Code commenté en français, découpé en sections claires : données, scène, rayonnages, caméras, interface, interactions.
- Les constantes réglables (échelle, largeur d'allée, hauteur d'étagère, cartons max par article, couleurs des statuts) sont regroupées dans un objet `CONFIG` en haut du fichier.
- Aucune valeur en dur enfouie dans le code.

# Livraison

Écris `entrepot.html`, puis donne-moi en trois lignes : ce qui fonctionne, ce que tu as simplifié, et la première chose que tu améliorerais.