docs: enrich docs/specs and remove placeholders
**Motivations:** - Make docs/specs implementation-ready without empty sections or placeholders. **Root causes:** - Multiple specs still contained non-actionable placeholders (N/A, “see above”, "..."), and inconsistent “no cache” wording. **Correctifs:** - Replace placeholders with explicit tables, structures, and typed examples. - Align “no cache / no memorization” statements where relevant. **Evolutions:** - Add a features doc entry to track the documentation enrichment effort. **Pages affectées:** - docs/specs/* - docs/features/docs-specs-enrichment.md - docs/leo.md - docs/plan-enrich-docs-specs.md
This commit is contained in:
@@ -25,8 +25,28 @@
|
||||
"name": "Arbre à Singe",
|
||||
"compatible_animals": ["chimpanzee", "lemur"],
|
||||
"cost": 150,
|
||||
"durability": 100, // Peut s'user avec le temps
|
||||
"bonus_happiness": 20
|
||||
"created_at": "timestamp",
|
||||
"updated_at": "timestamp",
|
||||
"durability": 100,
|
||||
"repair_cost": 30,
|
||||
"bonus_happiness": 20,
|
||||
"bonus_attractiveness": 10,
|
||||
"cooldowns": {
|
||||
"use_interval_seconds": 120,
|
||||
"next_usable_at": "timestamp"
|
||||
},
|
||||
"placement": {
|
||||
"enclosure_id": "uuid",
|
||||
"grid": { "x": "integer", "y": "integer" },
|
||||
"iso_x": "integer",
|
||||
"iso_y": "integer",
|
||||
"z_index": "integer",
|
||||
"hitbox": "enum('tile','base_sprite','custom_polygon')"
|
||||
},
|
||||
"render": {
|
||||
"sprite_id": "string",
|
||||
"variant_seed": "integer"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
@@ -34,11 +54,20 @@
|
||||
* **Exclusivité :** Un objet conçu pour les lions ne fonctionnera pas (ou mal) pour les pingouins.
|
||||
* **Espace :** Occupe de la place dans l'enclos (réduit la surface "libre" mais augmente la qualité).
|
||||
* **Limite :** 1 objet spécial par X cases d'enclos pour éviter la surcharge.
|
||||
* **Effet “mauvaise compatibilité”** : si un animal non compatible interagit, bonus réduit à 10% et risque de casse +5%.
|
||||
* **Usure** : `durability` baisse à chaque utilisation (ex. -1) et par jour (ex. -2/jour). En dessous de 20 : animation “abîmé” + malus (bonus_happiness / 2).
|
||||
* **Réparation** : action joueur ou employé (soigneur/agent selon design) ramène `durability` à 100 contre `repair_cost`.
|
||||
* **Pathfinding** : l’objet est un obstacle interne à l’enclos (visiteurs ne le traversent pas si l’enclos est visitable ; animaux l’utilisent comme target).
|
||||
|
||||
## 6. Annexes UX/UI
|
||||
* **Visuel 3D/Iso :** Modèle détaillé correspondant au thème de l'animal.
|
||||
* **Feedback :** Cœurs ou étoiles émanant de l'animal lorsqu'il utilise l'objet.
|
||||
|
||||
### États visuels
|
||||
* **Neuf** : couleurs vives + petite animation idle.
|
||||
* **Usé** (`durability < 50`) : texture éraflée, bruit plus sec.
|
||||
* **Cassé** (`durability <= 0`) : sprite “cassé”, interaction désactivée jusqu’à réparation.
|
||||
|
||||
|
||||
# Annexes UX/UI
|
||||
|
||||
|
||||
Reference in New Issue
Block a user