Initial commit
**Motivations:** - Initialisation du versionning git pour le projet **Root causes:** - N/A (Nouveau projet) **Correctifs:** - N/A **Evolutions:** - Structure initiale du projet - Ajout du .gitignore **Pages affectées:** - Tous les fichiers
This commit is contained in:
189
docs/specs/accueil_animaux.md
Normal file
189
docs/specs/accueil_animaux.md
Normal file
@@ -0,0 +1,189 @@
|
||||
# Spécifications : Accueil des Animaux
|
||||
|
||||
## Définition
|
||||
Zone tampon pour les nouveaux animaux arrivant dans le zoo (achats adultes ou transferts).
|
||||
|
||||
## Fonctionnalités
|
||||
- **Acclimatation** : Période obligatoire avant de pouvoir placer l'animal sur la grille active.
|
||||
- **Stockage temporaire** : Évite de devoir placer immédiatement un animal acheté si le terrain n'est pas prêt.
|
||||
|
||||
## Niveaux d'Amélioration (7 niveaux)
|
||||
- **Coût** : Progressif par palier.
|
||||
- **Effet** : Réduit le temps d'acclimatation. Améliore le potentiel reproducteur de l'animal entrant.
|
||||
- **Ratio** : 1 unité couvre 1 animal en cours d'accueil.
|
||||
|
||||
# Annexes Techniques
|
||||
|
||||
## 1. Données et États
|
||||
### Modèle de Données (JSON)
|
||||
```json
|
||||
{
|
||||
"id": "uuid",
|
||||
"type": "animal_reception",
|
||||
"level": "integer (1-7)",
|
||||
"slots": [
|
||||
{ "animal_id": "uuid", "arrival_time": "timestamp", "ready_time": "timestamp" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Caractéristiques Initiales
|
||||
| Caractéristique | Valeur Initiale (Niv 1) |
|
||||
| :--- | :--- |
|
||||
| Temps Acclimatation | 10 minutes |
|
||||
| Capacité | 1 animal |
|
||||
|
||||
### Scores Initiaux
|
||||
N/A
|
||||
|
||||
## 2. Cycles de Vie et Apparition
|
||||
### Conditions d'Apparition
|
||||
Présent au démarrage.
|
||||
|
||||
### Conditions de Disparition
|
||||
Indestructible.
|
||||
|
||||
### Hérédité
|
||||
N/A
|
||||
|
||||
## 3. Impacts Environnementaux
|
||||
### Impact Température
|
||||
Zone neutre (T° idéale simulée).
|
||||
|
||||
### Impact Milieu (Biome)
|
||||
Zone neutre.
|
||||
|
||||
### Impact Saisons
|
||||
Protégé.
|
||||
|
||||
### Impact Heure / Jour-Nuit
|
||||
N/A
|
||||
|
||||
## 4. Impacts Biologiques et Sociaux
|
||||
### Impact Reproduction
|
||||
**Bonus Repro** : Un animal passant par un accueil de haut niveau gagne un bonus temporaire de fertilité (+10% à +50%).
|
||||
|
||||
### Impact Mort
|
||||
Pas de mort possible en zone d'accueil (Stase).
|
||||
|
||||
### Impact Nourriture
|
||||
Nourri automatiquement.
|
||||
|
||||
### Impact Attractivité (Visiteurs/Animaux)
|
||||
N/A
|
||||
|
||||
### Impact Valeur
|
||||
N/A
|
||||
|
||||
## 5. Impacts Logistiques et Économiques
|
||||
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
|
||||
**Réduction Temps Acclimatation** :
|
||||
| Niveau | Temps Base |
|
||||
| :--- | :--- |
|
||||
| 1 | 10 min |
|
||||
| 2 | 8 min |
|
||||
| 3 | 6 min |
|
||||
| 4 | 4 min |
|
||||
| 5 | 2 min |
|
||||
| 6 | 1 min |
|
||||
| 7 | Instantané |
|
||||
|
||||
### Dépenses (Boutiques/Visiteurs)
|
||||
N/A
|
||||
|
||||
### Trajet Visiteurs
|
||||
N/A
|
||||
|
||||
## 6. Événements
|
||||
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
|
||||
* **Arrivée** : Animal livré par camion.
|
||||
* **Prêt** : Animal prêt à être placé.
|
||||
|
||||
## 7. Progression
|
||||
### Tableau des Upgrades
|
||||
| Niveau | Coût (Pièces) | Capacité | Temps Acclimatation | Temps Construction |
|
||||
| :--- | :--- | :--- | :--- | :--- |
|
||||
| 1 | 100 | 1 | 10 min | 0s |
|
||||
| 2 | 200 | 2 | 8 min | 0s |
|
||||
| 3 | 400 | 3 | 6 min | 0s |
|
||||
| 4 | 800 | 4 | 4 min | 0s |
|
||||
| 5 | 1600 | 5 | 2 min | 0s |
|
||||
| 6 | 3200 | 6 | 1 min | 0s |
|
||||
| 7 | 6400 | 7 | 0 min | 0s |
|
||||
|
||||
## 8. Logique et Interfaces
|
||||
### Pseudo-code Impacts
|
||||
```
|
||||
function updateReception(center):
|
||||
for slot in center.slots:
|
||||
if currentTime >= slot.ready_time:
|
||||
notifyPlayer("ANIMAL_READY", slot.animal_id)
|
||||
```
|
||||
|
||||
### Messages d'Infos / Alerte
|
||||
| ID | Niveau | Message |
|
||||
| :--- | :--- | :--- |
|
||||
| `ANIMAL_READY` | Info | "Un nouvel animal est prêt à rejoindre le zoo !" |
|
||||
| `RECEPTION_FULL` | Warning | "Accueil saturé, impossible d'acheter." |
|
||||
|
||||
# Annexes UX/UI
|
||||
|
||||
## 1. Expérience Utilisateur (UX)
|
||||
### Arrivée Animal (Passif)
|
||||
**Description UX** : Le camion décharge un animal. Il apparaît dans l'Accueil en mode "Attente".
|
||||
**Description UI** : Notification "Livraison effectuée". L'icône de l'Accueil change (ex: porte fermée -> porte avec caisse devant).
|
||||
**Notification Push** : "Votre [Animal] est arrivé à l'accueil !" envoyée si le joueur est hors ligne.
|
||||
**Emplacement** : Case Accueil.
|
||||
**Intégration** : Suite de l'action Camion.
|
||||
**Navigation** : N/A
|
||||
**Événements** : `DELIVERY_COMPLETE`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Sons** : `truck_door.mp3`, `crate_drop.mp3`.
|
||||
- **Graphiques** : Sprite Caisse en bois.
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Animations** : Camion qui repart.
|
||||
- **Couleurs** : Marron (Caisse).
|
||||
- **Textes** : N/A
|
||||
- **Formes** : N/A
|
||||
|
||||
### Consultation & Acclimatation (Consultation)
|
||||
**Description UX** : Le joueur vérifie le temps restant avant de pouvoir placer l'animal.
|
||||
**Description UI** : **Bottom Sheet** listant les animaux en transit. Barre de progression "Acclimatation" pour chacun.
|
||||
**Emplacement** : Modal Accueil.
|
||||
**Intégration** : Liste verticale.
|
||||
**Navigation** : Clic Accueil -> Modal.
|
||||
**Événements** : `OPEN_RECEPTION`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Sons** : `ui_open.mp3`
|
||||
- **Graphiques** : Style "Quarantaine" ou "Étable propre".
|
||||
- **Images** : Portrait animal.
|
||||
- **Vidéos** : N/A
|
||||
- **Animations** : Barre de progression qui avance.
|
||||
- **Couleurs** : Orange (En cours), Vert (Prêt).
|
||||
- **Textes** : "Prêt dans X min".
|
||||
- **Formes** : Barres arrondies.
|
||||
|
||||
### Transfert vers Zoo (Action)
|
||||
**Description UX** : L'animal est prêt. Le joueur le glisse vers le zoo.
|
||||
**Description UI** : Bouton "Placer" ou Drag & Drop depuis la liste.
|
||||
**Alternative** : Tap to Select -> Tap to Place.
|
||||
**Emplacement** : Modal Accueil -> Carte Zoo.
|
||||
**Intégration** : Mode placement (comme Nurserie).
|
||||
**Navigation** : Drag -> Drop.
|
||||
**Événements** : `PLACE_ANIMAL`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Sons** : `animal_happy.mp3` (cri de l'animal).
|
||||
- **Graphiques** : Sprite Animal.
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Animations** : Animal qui saute de joie au placement.
|
||||
- **Couleurs** : N/A
|
||||
- **Textes** : N/A
|
||||
- **Formes** : N/A
|
||||
Reference in New Issue
Block a user