Nicolas Cantu
5143a79890
**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
155 lines
4.9 KiB
Markdown
155 lines
4.9 KiB
Markdown
# Spécifications : Inventaire des Animaux
|
|
|
|
## Structure
|
|
75 Animaux répartis sur les 15 Milieux (Couleurs) et 5 Niveaux de Rareté.
|
|
|
|
## Exemples (Extrait)
|
|
- **Prairie / Rareté 1** : Lapin
|
|
- **Prairie / Rareté 5** : Licorne
|
|
- **Océan / Rareté 1** : Poisson Clown
|
|
- **Océan / Rareté 5** : Kraken
|
|
- **Montagne / Rareté 1** : Chèvre
|
|
- **Montagne / Rareté 5** : Dragon
|
|
|
|
*(La liste complète des 75 animaux doit être définie dans un fichier de données ou une table de loot).*
|
|
|
|
# Annexes Techniques
|
|
|
|
## 1. Données et États
|
|
### Modèle de Données (JSON)
|
|
Table statique `animal_types`.
|
|
```json
|
|
{
|
|
"id": "string (ex: 'rabbit')",
|
|
"name": "string",
|
|
"rarity": "int",
|
|
"ideal_biome": "int",
|
|
"ideal_temp": "float",
|
|
"base_value": "int",
|
|
"iso_x": "integer",
|
|
"iso_y": "integer",
|
|
"z_index": "integer"
|
|
}
|
|
```
|
|
|
|
### Caractéristiques Initiales
|
|
**Compteur** : 0 animaux découverts.
|
|
**Filtre Défaut** : "Tous".
|
|
|
|
### Scores Initiaux
|
|
**Score Collectionneur** : 0% (Progression globale).
|
|
|
|
## 2. Cycles de Vie et Apparition
|
|
### Conditions d'Apparition
|
|
**Découverte** : Premier achat, naissance ou observation d'un animal.
|
|
|
|
### Conditions de Disparition
|
|
**Vente/Mort** : L'animal disparaît de l'inventaire actif mais reste dans le "Livre des Records" (grisé).
|
|
|
|
### Hérédité
|
|
**Bonus Famille** : Si le joueur possède le couple (Mâle/Femelle), l'icône de l'espèce est dorée.
|
|
|
|
## 3. Impacts Environnementaux
|
|
### Impact Température
|
|
**Indicateur** : L'inventaire affiche l'icône "Froid/Chaud" à côté des animaux qui souffrent actuellement.
|
|
|
|
### Impact Milieu (Biome)
|
|
**Tri** : Possibilité de trier par Biome d'origine.
|
|
|
|
### Impact Saisons
|
|
**Saisonnalité** : Met en avant les animaux "Tendance" de la saison actuelle.
|
|
|
|
### Impact Heure / Jour-Nuit
|
|
**Activité** : Affiche "Dort" si l'animal est nocturne et qu'il fait jour.
|
|
|
|
## 4. Impacts Biologiques et Sociaux
|
|
### Impact Reproduction
|
|
**Statut** : Affiche "Fertile" ou "Gestante" sur les fiches.
|
|
|
|
### Impact Mort
|
|
**Cimetière** : Les animaux morts apparaissent grisés avec la date de décès.
|
|
|
|
### Impact Nourriture
|
|
**Alerte** : Badge rouge sur l'icône si Faim > 80%.
|
|
|
|
### Impact Attractivité (Visiteurs/Animaux)
|
|
**Set Complet** : Avoir tous les animaux d'un Biome donne un bonus global +5% Attractivité.
|
|
|
|
### Impact Valeur
|
|
**Estimation** : Affiche la valeur totale théorique du cheptel.
|
|
|
|
## 5. Impacts Logistiques et Économiques
|
|
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
|
|
**Recherche Rapide** : Barre de recherche instantanée.
|
|
|
|
### Dépenses (Boutiques/Visiteurs)
|
|
**Coût Total** : Affiche le coût journalier total en nourriture.
|
|
|
|
### Trajet Visiteurs
|
|
**Popularité** : Trie les animaux par nombre de vues visiteurs.
|
|
|
|
## 6. Événements
|
|
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
|
|
* **Nouveau** : Badge "New" sur une espèce fraîchement acquise.
|
|
* **Record** : Badge "Record" si un animal bat un record d'âge/valeur.
|
|
|
|
## 7. Progression
|
|
### Tableau des Upgrades
|
|
*Note : Niveaux de Badge Collectionneur.*
|
|
| Niveau | Nom | Condition | Bonus |
|
|
| :--- | :--- | :--- | :--- |
|
|
| 1 | Amateur | 5 Espèces | +1% Attractivité |
|
|
| 2 | Passionné | 15 Espèces | +2% Attractivité |
|
|
| 3 | Expert | 30 Espèces | +5% Attractivité |
|
|
| 4 | Maître | 50 Espèces | +10% Attractivité |
|
|
| 5 | Légende | 75 Espèces | +20% Attractivité |
|
|
|
|
## 8. Logique et Interfaces
|
|
### Pseudo-code Impacts
|
|
```javascript
|
|
function getCollectionBonus(player):
|
|
count = countDistinctSpecies(player.animals)
|
|
if count >= 75: return 0.20
|
|
if count >= 50: return 0.10
|
|
if count >= 30: return 0.05
|
|
if count >= 15: return 0.02
|
|
if count >= 5: return 0.01
|
|
return 0
|
|
```
|
|
|
|
### Messages d'Infos / Alerte
|
|
| ID | Niveau | Message |
|
|
| :--- | :--- | :--- |
|
|
| `COLLECTION_LEVEL_UP` | Succès | "Nouveau rang de collectionneur atteint !" |
|
|
|
|
# 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.
|
|
|
|
|
|
## 1. Expérience Utilisateur (UX)
|
|
### Bestiaire / Encyclopédie (Consultation)
|
|
**Description UX** : Le joueur consulte les animaux découverts/possédés.
|
|
**Description UI** : Livre ou Grille d'icônes. Les animaux non découverts sont des silhouettes noires.
|
|
**Emplacement** : Menu Principal -> Bestiaire.
|
|
**Intégration** : Modal Plein Écran.
|
|
**Navigation** : Filtres (Biome, Rareté) -> Clic Animal -> Détail.
|
|
**Événements** : `OPEN_BESTIARY`.
|
|
|
|
#### Assets
|
|
- **Musiques** : Thème "Bibliothèque" (calme).
|
|
- **Sons** : `page_turn.mp3`.
|
|
- **Graphiques** : Fond Livre ancien.
|
|
- **Images** : 75 Icônes Animaux.
|
|
- **Vidéos** : Aperçu de l'animal en mouvement (survol).
|
|
- **Animations** : Tourne la page.
|
|
- **Couleurs** : Sépia/Papier.
|
|
- **Textes** : Lore/Description.
|
|
- **Formes** : Marque-page.
|