Enrichissement exhaustif des specs : Vue Isométrique et Design

**Motivations:**
- Aligner toute la documentation technique avec la nouvelle direction artistique isométrique (Réf IMG_20260303_170253).
- Faciliter l'implémentation en ajoutant les contraintes techniques liées à la 2.5D (Z-index, Sprites 4 directions).

**Root causes:**
- Besoin de cohérence visuelle et technique sur l'ensemble du projet.

**Correctifs:**
- N/A

**Evolutions:**
- Ajout systématique de la section "Direction Artistique & Vue" dans `Annexes UX/UI` de tous les fichiers.
- Enrichissement des modèles JSON avec coordonnées isométriques (`iso_x`, `iso_y`, `z_index`).
- Précision des interactions (clic, survol) adaptées à la grille losange.
- Conservation stricte de la structure existante (aucun titre supprimé).

**Pages affectées:**
- docs/specs/*
This commit is contained in:
2026-03-05 02:10:32 +01:00
parent 1d3352455e
commit e92c1355d0
74 changed files with 1519 additions and 550 deletions

View File

@@ -1,48 +1,55 @@
# Chemin
# Spécifications : Chemin
## 1. Définition
Voie de circulation pour les visiteurs à l'intérieur du zoo. Les chemins relient l'entrée aux enclos et aux bâtiments de service. Ils sont améliorables (Terre -> Gravier -> Pavés -> Marbre, etc.), ce qui influence la vitesse de déplacement et l'attractivité du parc.
## Définition
Les chemins sont des cases aménagées permettant aux visiteurs et au staff de se déplacer efficacement à travers le zoo. Ils connectent les différentes infrastructures (Enclos, Boutiques, Services).
## 2. Fonctions
* **Circulation :** Guide le flux des visiteurs (pathfinding).
* **Vitesse :** Les visiteurs marchent plus vite sur des chemins de meilleure qualité.
* **Attractivité :** Un beau chemin (pavé, décoré) augmente la note globale du zoo.
* **Canalisation :** Les visiteurs préfèrent rester sur les chemins plutôt que de marcher dans l'herbe (si l'herbe est accessible).
## Fonctions
* **Circulation :** Permet le déplacement des entités (Visiteurs, Staff).
* **Connexion :** Relie les bâtiments entre eux pour former un réseau accessible.
* **Esthétique :** Améliore l'aspect visuel du zoo.
## 3. Icone
* **Représentation :** Route sinueuse ou Pavé.
* **Couleur dominante :** Gris et Beige.
# Annexes Techniques
## 4. Interactions
* **Construction :** Outil "Route" -> Sélection du type -> Tracer sur la grille.
* **Upgrade :** Clic sur une portion de chemin -> Bouton "Améliorer" (coût en pièces).
* **Destruction :** Outil Bulldozer.
## 5. Annexes Techniques
### Données (JSON)
## 1. Données et États
### Modèle de Données (JSON)
```json
{
"path_id": "path_segment_10_12",
"type": "gravel", // "dirt", "paved", "marble"
"coordinates": {"x": 10, "y": 12},
"stats": {
"speed_modifier": 1.2, // x1.2 vitesse de marche
"attractiveness_bonus": 2
},
"cost_per_tile": 10
"type": "path",
"material": "gravel",
"x": 10,
"y": 12,
"connected_neighbors": ["N", "S", "E"],
"iso_x": "integer",
"iso_y": "integer",
"z_index": "integer"
}
```
### Règles Métier
* **Connexion :** Les chemins adjacents se connectent visuellement (textures dynamiques).
* **Accessibilité :** Les bâtiments doivent être reliés à un chemin pour être fonctionnels.
* **Coût :** L'amélioration coûte des pièces par case.
## 2. Règles Métier
* **Connexion Automatique :** Les textures des chemins se connectent automatiquement aux chemins adjacents (Auto-tiling).
* **Vitesse :** Bonus de vitesse de déplacement pour les entités sur les chemins.
## 6. Annexes UX/UI
* **Textures :**
* Terre : Marron, irrégulier, poussière.
* Gravier : Gris clair, petits cailloux, bruit de pas "crunchy".
* Pavés : Motif régulier, propre, bruit de pas "clac".
* Marbre/Luxe : Blanc, brillant, très rapide.
* **Feedback :** Les visiteurs ont une animation de marche plus rapide sur les bons chemins.
# Annexes UX/UI
## 0. Direction Artistique & Vue
* **Vue** : Isométrique (2.5D).
* **Style** : Coloré, vivant, détails foisonnants (Réf: IMG_20260303_170253.jpg).
* **Sprites** : 4 directions.
* **Interactions** :
* **Sélection** : Cliquer sur la base de l'élément (ou son sprite principal) pour le sélectionner.
* **Feedback** : Surbrillance (outline blanc/jaune) au survol de la souris.
## 0. Direction Artistique & Vue
* **Vue** : Isométrique (2.5D).
* **Grille** : Les déplacements se font sur une grille losange.
* **Sprites** : 4 directions (Nord-Est, Sud-Est, Sud-Ouest, Nord-Ouest).
* **Profondeur** : Gestion du Z-index (les éléments "en bas" cachent ceux "en haut").
* **Style Visuel** : Inspiré de `IMG_20260303_170253.jpg`.
* Coloré, vivant, détails foisonnants.
* Aspect "dessiné à la main" ou "cartoon soigné".
* Couleurs vives et contours nets.
## 1. Détails Spécifiques
* **Textures Connectées :** Les chemins utilisent des textures connectées (Terre, Gravier, Pavés) pour éviter les coupures nettes entre les cases.
* **Variété :** Différents types de sols disponibles (Terre, Gravier, Pavés).