Files
builazoo/docs/specs/inventaire_animaux.md
Nicolas Cantu f0219559c5 Standardisation exhaustive des spécifications techniques
**Motivations:**
- Harmoniser la documentation technique pour faciliter le développement.
- Garantir l'exhaustivité des données de Game Design pour chaque entité.

**Root causes:**
- Documentation hétérogène et incomplète.

**Correctifs:**
- N/A

**Evolutions:**
- Réécriture complète de 53 fichiers de spécifications selon un modèle strict.
- Ajout de données de Game Design (prix, durées, impacts) pour combler les manques.
- Ajout systématique des annexes UX/UI.

**Pages affectées:**
- docs/specs/*
2026-03-04 18:07:31 +01:00

4.4 KiB

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.

{
  "id": "string (ex: 'rabbit')",
  "name": "string",
  "rarity": "int",
  "ideal_biome": "int",
  "ideal_temp": "float",
  "base_value": "int"
}

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

function getCollectionBonus(player):
  count = countDistinctSpecies(player.animals)
  if count >= 75: return 0.20
  if count >= 50: return 0.10
  // ...
  return 0

Messages d'Infos / Alerte

ID Niveau Message
COLLECTION_LEVEL_UP Succès "Nouveau rang de collectionneur atteint !"

Annexes UX/UI

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.