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/*
This commit is contained in:
2026-03-04 18:07:31 +01:00
parent c7d389ecbb
commit f0219559c5
43 changed files with 1832 additions and 1071 deletions

View File

@@ -13,77 +13,99 @@
## 1. Données et États
### Modèle de Données (JSON)
N/A
**Transaction** : `{ "id": "uuid", "type": "BUY/UPGRADE", "item": "string", "cost": "int", "timestamp": "date" }`.
### Caractéristiques Initiales
N/A
**Solde Joueur** : Voir `joueur.md`.
### Scores Initiaux
N/A
**Dépenses Totales** : 0.
## 2. Cycles de Vie et Apparition
### Conditions d'Apparition
N/A
**Menu Achat** : Accessible via le HUD.
### Conditions de Disparition
N/A
**Fermeture Menu**.
### Hérédité
N/A
**Historique** : Les transactions sont loggées pour les stats.
## 3. Impacts Environnementaux
### Impact Température
N/A
**Isolation** : Les bâtiments de haut niveau résistent mieux aux coûts énergétiques (Chauffage/Clim -10% par niveau).
### Impact Milieu (Biome)
N/A
**Adaptation** : Construire sur un biome "difficile" (Toundra, Désert) coûte +20% à l'achat initial.
### Impact Saisons
N/A
**Soldes** : Certains items moins chers en Hiver (-15% sur les chauffages).
**Surcharge** : En Été, les stands de glaces coûtent +10% à l'achat (demande forte).
### Impact Heure / Jour-Nuit
N/A
**Tarif de Nuit** : Les travaux (Upgrades) lancés la nuit (22h-06h) sont 5% moins chers (main d'œuvre nocturne).
## 4. Impacts Biologiques et Sociaux
### Impact Reproduction
N/A
**Couveuses** : L'achat d'upgrades "Confort" pour les enclos augmente la fertilité de +2%.
### Impact Mort
N/A
**Sécurité** : Les clôtures de haut niveau réduisent le risque de fuite et d'accident mortel de 99%.
### Impact Nourriture
N/A
**Stockage** : Les upgrades de "Réserve" permettent d'acheter la nourriture en gros (-5% prix unitaire).
### Impact Attractivité (Visiteurs/Animaux)
N/A
**Nouveauté** : Chaque nouvel achat génère un boost temporaire d'attractivité ("C'est tout neuf !" +10% pendant 2 jours).
### Impact Valeur
N/A
**Inflation** : Les prix augmentent légèrement si le joueur est très riche (équilibrage dynamique).
**Revente** : Un bâtiment peut être revendu pour 50% de son coût total (base + upgrades).
## 5. Impacts Logistiques et Économiques
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
N/A
**Livraison** : Instantanée pour les bâtiments, temps de trajet pour les animaux.
**Construction** : Les gros bâtiments (Laboratoire, Centre Recherche) prennent 24h in-game à être opérationnels.
### Dépenses (Boutiques/Visiteurs)
N/A
**Investissement** : Dépense principale du joueur.
**Maintenance** : Chaque niveau d'upgrade augmente les frais d'entretien quotidiens de +5%.
### Trajet Visiteurs
N/A
**Obstacle** : Un bâtiment en construction bloque le passage, forçant les visiteurs à faire un détour.
## 6. Événements
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
N/A
* **Promo** : Offre limitée dans le temps (-20%).
## 7. Progression
### Tableau des Upgrades
N/A
| Niveau | Multiplicateur Coût | Effet Général | Apparence |
| :--- | :--- | :--- | :--- |
| 1 | x1.0 | Fonctionnalité de base | Standard |
| 2 | x1.5 | +10% Efficacité | +Détails |
| 3 | x2.2 | +25% Efficacité | +Couleurs |
| 4 | x3.3 | +45% Efficacité | +Éclairage |
| 5 | x5.0 | +70% Efficacité | +Enseigne |
| 6 | x7.5 | +100% Efficacité | +Moderne |
| 7 | x11.0 | +150% Efficacité | Futuriste (Or/Platine) |
## 8. Logique et Interfaces
### Pseudo-code Impacts
N/A
```javascript
function processPurchase(player, item):
if player.coins >= item.cost:
player.coins -= item.cost
player.inventory.add(item)
emitEvent("BUY_SUCCESS")
else:
emitEvent("BUY_FAIL", "Fonds insuffisants")
```
### Messages d'Infos / Alerte
N/A
| ID | Niveau | Message |
| :--- | :--- | :--- |
| `FUNDS_LOW` | Alerte | "Pas assez de pièces !" |
# Annexes UX/UI
@@ -97,15 +119,15 @@ N/A
**Événements** : `OPEN_SHOP_MENU`.
#### Assets
- **Musiques** : N/A
- **Musiques** : Jingle "Caisse Enregistreuse" (court).
- **Sons** : `ui_hover.mp3`.
- **Graphiques** : Icônes Bâtiments.
- **Images** : N/A
- **Vidéos** : N/A
- **Animations** : N/A
- **Images** : Sprites des bâtiments dans le menu (2D isométrique).
- **Vidéos** : Mini-clip "Construction en cours" (optionnel).
- **Animations** : Bouton rebondit au survol.
- **Couleurs** : Fond sombre, Texte clair.
- **Textes** : Prix, Nom.
- **Formes** : Cartes carrées.
- **Formes** : Cartes carrées avec coins arrondis.
### Confirmation Achat (Action)
**Description UX** : Le joueur clique pour acheter.
@@ -116,12 +138,12 @@ N/A
**Événements** : `BUY_ITEM`.
#### Assets
- **Musiques** : N/A
- **Musiques** : Jingle "Succès" (trompettes légères).
- **Sons** : `buy_success.mp3`.
- **Graphiques** : N/A
- **Images** : N/A
- **Vidéos** : N/A
- **Graphiques** : Particules de pièces d'or.
- **Images** : Icône "Vendu" tamponnée.
- **Vidéos** : Transition de fermeture de menu (wipe).
- **Animations** : Compteur pièces descend.
- **Couleurs** : Rouge (déduction).
- **Textes** : "-500".
- **Formes** : N/A
- **Formes** : Effet d'onde de choc circulaire au clic.