ok
This commit is contained in:
@@ -59,3 +59,477 @@ Employé spécialisé dans la santé des animaux. Il intervient pour prévenir l
|
||||
* **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.
|
||||
|
||||
|
||||
## Définition
|
||||
|
||||
| Champ | Valeur |
|
||||
|---|---|
|
||||
| Entité | Employé “Soigneur” |
|
||||
| Rôle | Prévenir/traiter maladies, stabiliser les états critiques, améliorer bien-être. |
|
||||
| Portée | Zone ou enclos assigné + rayon `stats.range`. |
|
||||
| Contraintes | Se déplace (coût temps), file de tâches, disponibilité. |
|
||||
| Vue | Isométrique 2.5D, sprite 4 directions, hitbox base-sprite. |
|
||||
|
||||
## Fonctions (tableau détaillé)
|
||||
|
||||
| Fonction | Déclencheur | Entrées | Sorties | Règles | Observabilité |
|
||||
|---|---|---|---|---|---|
|
||||
| Prévention maladies | Tick soigneur / tick zoo | `efficiency`, enclos, densité | probas maladies - | Effet plafonné ; dépend propreté enclos | Event `HEALER_PREVENTION_TICK`, métrique “maladies évitées” |
|
||||
| Soin automatique | Animal `SICK` | animal, soigneur dispo | état animal amélioré | Priorité: critique > contagieux > léger | Event `HEALER_TREAT_START/END` |
|
||||
| Quarantaine (si prévue) | Animal contagieux | enclos, iso | propagation - | nécessite zone dédiée | Event `HEALER_QUARANTINE` |
|
||||
| Boost bien-être | Tick | `efficiency` | `wellbeing +` | Bonus léger, cumul limité/jour | Event `HEALER_WELLBEING_TICK` |
|
||||
|
||||
## Icone de base
|
||||
|
||||
| Élément | Spécification |
|
||||
|---|---|
|
||||
| Représentation | Croix verte / trousse de soin |
|
||||
| Couleur dominante | Blanc / vert |
|
||||
| Variantes | `icon_healer_cross.png`, `icon_healer_bag.png` |
|
||||
| États | Badge “occupé” (sablier), “urgence” (rouge), “en pause” (Zzz) |
|
||||
|
||||
## Interactions (tableau détaillé)
|
||||
|
||||
| Interaction | Type | Préconditions | Étapes UI | Résultat | Erreurs / Messages |
|
||||
|---|---|---|---|---|---|
|
||||
| Recruter | Action | coins ≥ `hire_cost` | Menu Employés → Soigneur → Confirmer | entité créée | `INSUFFICIENT_FUNDS`, `EMPLOYEE_CAP_REACHED` |
|
||||
| Assigner zone/enclos | Action | zone existe, path possible | Sélection soigneur → “Assigner” → clic zone/enclos | priorité locale | `NO_PATH`, `INVALID_TARGET` |
|
||||
| Forcer intervention | Action | animal malade visible | clic animal → “Appeler soigneur” | tâche ajoutée | `NO_HEALER_AVAILABLE` |
|
||||
| Former | Action (option) | ressources/temps | panel → “Former” | `efficiency +` | `INSUFFICIENT_FUNDS` |
|
||||
| Inspecter file | Consultation | - | panel soigneur | liste tâches + ETA | - |
|
||||
|
||||
## Annexes Techniques
|
||||
|
||||
### 1. Données et États (tableau détaillé)
|
||||
|
||||
| Donnée / État | Type | Exemple | Source | Contraintes |
|
||||
|---|---|---|---|---|
|
||||
| `employee_id` | string | `healer_01` | DB | unique |
|
||||
| `type` | enum | `soigneur` | DB | constante |
|
||||
| `salary` | int | 50 | config | coins/jour |
|
||||
| `hire_cost` | int | 500 | config | one-shot |
|
||||
| `stats.speed` | float | 1.0 | DB | modifie déplacement |
|
||||
| `stats.efficiency` | float | 0.8 | DB | [0..1.5] |
|
||||
| `stats.range` | int | 5 | DB | [1..10] |
|
||||
| `assigned_zone` | uuid/null | null | runtime | null = global |
|
||||
| `task_queue` | array | - | runtime | FIFO + priorités |
|
||||
| `state` | enum | `IDLE|MOVING|TREATING|BREAK` | runtime | transitions contrôlées |
|
||||
| `grid` | object | `{x,y}` | runtime | position |
|
||||
| `iso_x/iso_y` | int | - | rendu | projection |
|
||||
| `z_index` | int | - | rendu | profondeur |
|
||||
| `hitbox` | enum | `base_sprite` | rendu | click base |
|
||||
|
||||
#### Caractéristiques Initiales (tableau détaillé)
|
||||
|
||||
| Caractéristique | Valeur initiale | Unité | Notes |
|
||||
|---|---:|---|---|
|
||||
| Rayon action | 5 | cases | `range` |
|
||||
| Efficacité | 0.8 | coef | prévention/soin |
|
||||
| Temps soin léger | 2 | min in-game | tâche |
|
||||
| Temps soin moyen | 5 | min in-game | tâche |
|
||||
| Temps soin critique | 10 | min in-game | tâche |
|
||||
| Pause | 15 | min in-game | toutes 4h in-game |
|
||||
|
||||
#### Scores Initiaux (tableau détaillé)
|
||||
|
||||
| Score | Valeur initiale | Plage | Impact |
|
||||
|---|---:|---|---|
|
||||
| Animaux soignés/jour | 0 | 0..∞ | santé globale |
|
||||
| Maladies évitées/jour | 0 | 0..∞ | survie |
|
||||
| Coût santé/jour | 50 | 0..∞ | dépenses employés |
|
||||
|
||||
### 2. Cycles de Vie et Apparition (tableau détaillé)
|
||||
|
||||
| Phase | Déclencheur | Entrées | Sorties | Invariants |
|
||||
|---|---|---|---|---|
|
||||
| Apparition | embauche | coins | entité | état `IDLE` |
|
||||
| Action | détection maladie | animal | tâche | priorité |
|
||||
| Pause | fatigue | temps | état `BREAK` | pas de soin |
|
||||
| Disparition | licenciement (si prévu) | - | suppression | stop tâches |
|
||||
|
||||
#### Conditions d'Apparition (tableau détaillé)
|
||||
|
||||
| Condition | Seuil | Opérateur | Résultat |
|
||||
|---|---:|---|---|
|
||||
| Achat | coins ≥ `hire_cost` | vrai | création |
|
||||
|
||||
#### Conditions de Disparition (tableau détaillé)
|
||||
|
||||
| Condition | Seuil | Opérateur | Résultat |
|
||||
|---|---:|---|---|
|
||||
| Licenciement | action joueur | vrai | suppression |
|
||||
| Zoo supprimé | - | vrai | suppression |
|
||||
|
||||
#### Hérédité (tableau détaillé)
|
||||
|
||||
| Élément | Hérité | Règle |
|
||||
|---|---|---|
|
||||
| `stats` | Oui | persistées |
|
||||
| `task_queue` | Non | vidée au reset jour |
|
||||
|
||||
### 3. Impacts Environnementaux
|
||||
|
||||
#### Impact Température (tableau détaillé)
|
||||
|
||||
| Température | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Extrême | charge + | plus d’animaux critiques |
|
||||
| Tempérée | neutre | - |
|
||||
|
||||
#### Impact Milieu (Biome) (tableau détaillé)
|
||||
|
||||
| Biome | Effet | Notes |
|
||||
|---|---|---|
|
||||
| Chemins | déplacement + | visiteurs attirés aux chemins |
|
||||
| Boue | déplacement - | pénalité path |
|
||||
|
||||
#### Impact Saisons (tableau détaillé)
|
||||
|
||||
| Saison | Effet | Modificateur |
|
||||
|---|---|---|
|
||||
| Hiver | maladies froid + | tâches + |
|
||||
| Été | stress chaleur + | tâches + |
|
||||
|
||||
#### Impact Heure / Jour-Nuit (tableau détaillé)
|
||||
|
||||
| Période | Effet | Règle |
|
||||
|---|---|---|
|
||||
| Jour | soins actifs | - |
|
||||
| Nuit | interventions urgentes uniquement | sinon pause |
|
||||
|
||||
### 4. Impacts Biologiques et Sociaux
|
||||
|
||||
#### Impact Reproduction (tableau détaillé)
|
||||
|
||||
| Facteur | Effet sur taux | Condition |
|
||||
|---|---|---|
|
||||
| Soins réguliers | + | animaux non malades |
|
||||
|
||||
#### Impact Mort (tableau détaillé)
|
||||
|
||||
| Cas | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Animal critique sans soigneur | risque mort + | file saturée |
|
||||
| Animal contagieux traité | mortalité - | quarantaine/soin |
|
||||
|
||||
#### Impact Nourriture (tableau détaillé)
|
||||
|
||||
| Ressource | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Nourriture spéciale | soins + efficaces | si buff actif |
|
||||
|
||||
#### Impact Attractivité(Visiteurs (tableau détaillé)
|
||||
|
||||
| État | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Animaux visibles en bonne santé | satisfaction + | enclos propres |
|
||||
| Animaux malades visibles | satisfaction - | incidents |
|
||||
|
||||
#### Impact Attractivité Animaux) (tableau détaillé)
|
||||
|
||||
| Action | Effet animaux | Condition |
|
||||
|---|---|---|
|
||||
| Soins | stress - | traitement réussi |
|
||||
|
||||
#### Impact Valeur (tableau détaillé)
|
||||
|
||||
| Facteur | Variation | Condition |
|
||||
|---|---:|---|
|
||||
| Certificat santé | +10% | vente animal si soigné récemment |
|
||||
|
||||
### 5. Impacts Logistiques et Économiques
|
||||
|
||||
#### Vitesse (Camion) (tableau détaillé)
|
||||
|
||||
| Paramètre | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Transport animaux malades | interdit | vente/transport bloqué |
|
||||
|
||||
#### Vitesse (Nurserie) (tableau détaillé)
|
||||
|
||||
| Paramètre | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Urgence bébé | soin possible | nurserie niv 4+ |
|
||||
|
||||
#### Vitesse (Accueil) (tableau détaillé)
|
||||
|
||||
| Paramètre | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Réception | - | pas d’effet direct |
|
||||
|
||||
#### Vitesse (Recherche) (tableau détaillé)
|
||||
|
||||
| Paramètre | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Tech médecine | soins + rapides | si débloquée |
|
||||
|
||||
#### Vitesse (Labo) (tableau détaillé)
|
||||
|
||||
| Paramètre | Effet | Condition |
|
||||
|---|---|---|
|
||||
| - | aucun | - |
|
||||
|
||||
#### Vitesse (Visite) (tableau détaillé)
|
||||
|
||||
| Paramètre | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Temps visite | + | zoo sain |
|
||||
|
||||
#### Dépenses (Billeterie) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| - | 0 | - | - |
|
||||
|
||||
#### Dépenses (Boutiques) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Vente soins | revenu + | coins | boutique pharmacie (si ajoutée) |
|
||||
|
||||
#### Dépenses (Visiteurs) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Remboursement | -coins | coins | visiteur choqué |
|
||||
|
||||
#### Dépenses (Employés) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Salaire | 50 | coins/jour | actif |
|
||||
| Formation | 300 | coins | upgrade |
|
||||
|
||||
#### Dépenses (Boutiques) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Section dupliquée | 0 | - | conservée |
|
||||
|
||||
#### Dépenses (Nurseries) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Soins bébé | 10 | coins | action “urgence” |
|
||||
|
||||
#### Dépenses (Nourriture) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Médicaments | 5 | coins/soin | si consommable |
|
||||
|
||||
#### Dépenses (Acceuil des animaux) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Diagnostic arrivée | 10 | coins | si check santé |
|
||||
|
||||
#### Dépenses (Camion) (tableau détaillé)
|
||||
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Transport vers clinique | 100 | coins | si feature externe |
|
||||
|
||||
#### Trajet Visiteurs
|
||||
|
||||
##### Trajet Visiteurs vers/depuis la ville (tableau détaillé)
|
||||
|
||||
| Source | Destination | Déclencheur | Effet |
|
||||
|---|---|---|---|
|
||||
| Ville | Zoo | réputation | soigneur indirect (via santé zoo) |
|
||||
|
||||
##### Trajet Visiteurs vers/depuis les animaux (tableau détaillé)
|
||||
|
||||
| Source | Destination | Déclencheur | Effet |
|
||||
|---|---|---|---|
|
||||
| Soigneur | Enclos | tâche | déplacement sur chemins |
|
||||
|
||||
##### Trajet Visiteurs vers/depuis les boutiques (tableau détaillé)
|
||||
|
||||
| Source | Destination | Déclencheur | Effet |
|
||||
|---|---|---|---|
|
||||
| Visiteurs | Boutique | santé/incident | achats + |
|
||||
|
||||
##### Trajet Visiteurs vers/depuis la billeterie (entrées/sorties du zoo) (tableau détaillé)
|
||||
|
||||
| Source | Destination | Déclencheur | Effet |
|
||||
|---|---|---|---|
|
||||
| Visiteur mécontent | sortie | incident non résolu | départ + |
|
||||
|
||||
### 6. Événements
|
||||
|
||||
#### Événements du Jeu (tableau détaillé)
|
||||
|
||||
| Event | Déclencheur | Payload | Effet |
|
||||
|---|---|---|---|
|
||||
| `ANIMAL_SICK` | état maladie | animal_id | alerte |
|
||||
| `ANIMAL_HEALED` | fin soin | animal_id | info |
|
||||
|
||||
#### Événements du Carte (tableau détaillé)
|
||||
|
||||
| Event | Déclencheur | Effet |
|
||||
|---|---|---|
|
||||
| `HEALER_MOVING` | tâche | rendu déplacement |
|
||||
|
||||
#### Événements du Zoo (tableau détaillé)
|
||||
|
||||
| Event | Déclencheur | Effet |
|
||||
|---|---|---|
|
||||
| `HEALTH_SYSTEM_OVERLOADED` | trop malades | alerte |
|
||||
|
||||
#### Événements du Ville / Visiteur (tableau détaillé)
|
||||
|
||||
| Event | Déclencheur | Effet |
|
||||
|---|---|---|
|
||||
| `VISITOR_WORRIED` | animal malade vu | satisfaction - |
|
||||
|
||||
#### Événements du Visiteur (tableau détaillé)
|
||||
|
||||
| Event | Déclencheur | Effet |
|
||||
|---|---|---|
|
||||
| `VISITOR_REFUND_REQUEST` | très mécontent | remboursement |
|
||||
|
||||
#### Événements du Joueur (tableau détaillé)
|
||||
|
||||
| Event | Déclencheur | Effet |
|
||||
|---|---|---|
|
||||
| `PLAYER_CALL_HEALER` | bouton | tâche prioritaire |
|
||||
|
||||
### 7. Progression
|
||||
|
||||
#### Tableau des Upgrades (tableau détaillé)
|
||||
|
||||
| Niveau | Coût | Effet | Débloque |
|
||||
|---|---:|---|---|
|
||||
| 1 | 0 | prévention base | - |
|
||||
| 2 | 1500 | `range` +1 | couverture |
|
||||
| 3 | 3000 | `efficiency` +0.1 | soins plus rapides |
|
||||
| 4 | 6000 | soins contagieux + | quarantaine (option) |
|
||||
|
||||
### 8. Logique et Interfaces
|
||||
|
||||
#### Pseudo-code Impacts (tableau détaillé)
|
||||
|
||||
| Fonction | Entrées | Sorties | Notes |
|
||||
|---|---|---|---|
|
||||
| `scan_sick_animals` | zoo state | list | priorités |
|
||||
| `enqueue_heal_task` | animal | task | file |
|
||||
| `apply_treatment` | animal, efficiency | state | clamp |
|
||||
|
||||
#### Messages d'Infos / Alerte (tableau détaillé)
|
||||
|
||||
| ID | Niveau | Message | Condition |
|
||||
|---|---|---|---|
|
||||
| `NO_HEALER_AVAILABLE` | Alerte | "Aucun soigneur disponible." | file saturée |
|
||||
| `ANIMAL_HEALED` | Info | "Animal soigné." | fin soin |
|
||||
| `DISEASE_SPREAD` | Warning | "Risque de contagion." | cluster |
|
||||
|
||||
## Annexes UX/UI
|
||||
|
||||
### 1. Expérience Utilisateur (UX)
|
||||
|
||||
#### Description UX (tableau détaillé)
|
||||
|
||||
| Parcours | But | Friction | Réduction clics |
|
||||
|---|---|---|---|
|
||||
| Recruter | diminuer morts | coût | bouton recruter direct |
|
||||
| Traiter urgence | sauver animal | localisation | deep-link depuis notif |
|
||||
|
||||
#### Description UI (tableau détaillé)
|
||||
|
||||
| Composant | Contenu | États |
|
||||
|---|---|---|
|
||||
| Panel soigneur | file tâches, range | IDLE/MOVING/TREATING |
|
||||
| Badge maladie | icône croix/virus | levels |
|
||||
|
||||
#### Emplacement (tableau détaillé)
|
||||
|
||||
| Zone UI | Position | Notes |
|
||||
|---|---|---|
|
||||
| Carte | sprite soigneur | sélection base |
|
||||
| Panel animal | bouton “Appeler” | urgence |
|
||||
|
||||
#### Intégration (tableau détaillé)
|
||||
|
||||
| Intégration | Contrat | Notes |
|
||||
|---|---|---|
|
||||
| États animaux | `SICK/CRITICAL` | pas de fallback |
|
||||
| Notifications | push HUD | - |
|
||||
|
||||
#### Navigation (tableau détaillé)
|
||||
|
||||
| Action | Chemin | Résultat |
|
||||
|---|---|---|
|
||||
| Ouvrir panel | clic soigneur | panel |
|
||||
| Appeler | clic animal → bouton | tâche |
|
||||
|
||||
#### Événements (tableau détaillé)
|
||||
|
||||
| Event UI | Déclencheur | Effet |
|
||||
|---|---|---|
|
||||
| `OPEN_HEALER_PANEL` | clic | panel |
|
||||
| `CLICK_CALL_HEALER` | bouton | tâche |
|
||||
|
||||
#### Assets Skinables
|
||||
|
||||
##### Musiques (tableau détaillé)
|
||||
|
||||
| Asset | Usage | Durée | Notes |
|
||||
|---|---|---:|---|
|
||||
| `clinic_soft_loop.mp3` | ambiance soin | loop | discret |
|
||||
|
||||
##### Sons (tableau détaillé)
|
||||
|
||||
| Asset | Usage | Volume |
|
||||
|---|---|---|
|
||||
| `ui_alert_med.mp3` | alerte maladie | moyen |
|
||||
| `heal_success.mp3` | fin soin | faible |
|
||||
|
||||
##### Graphiques (tableau détaillé)
|
||||
|
||||
| Asset | Usage | Contraintes |
|
||||
|---|---|---|
|
||||
| `healer_sprite_[dir].png` | sprite | 4 dirs |
|
||||
| `fx_green_cross.png` | FX | overlay |
|
||||
|
||||
##### Images (tableau détaillé)
|
||||
|
||||
| Asset | Usage |
|
||||
|---|---|
|
||||
| `icon_healer_cross.png` | HUD |
|
||||
| `portrait_healer.png` | panel |
|
||||
|
||||
##### Vidéos (tableau détaillé)
|
||||
|
||||
| Asset | Usage | Durée |
|
||||
|---|---|---:|
|
||||
| `heal_popup.webm` | popup | 1.0s |
|
||||
|
||||
##### Animations (tableau détaillé)
|
||||
|
||||
| Animation | Déclencheur | Notes |
|
||||
|---|---|---|
|
||||
| pulsation croix | animal malade | loop |
|
||||
| sparkles verts | soin | burst |
|
||||
|
||||
##### Couleurs (tableau détaillé)
|
||||
|
||||
| Token | Valeur | Usage |
|
||||
|---|---|---|
|
||||
| `healer_primary` | #2ECC71 | UI |
|
||||
| `healer_alert` | #E74C3C | urgence |
|
||||
|
||||
##### Textes (tableau détaillé)
|
||||
|
||||
| Clé | FR | EN |
|
||||
|---|---|---|
|
||||
| `healer.call` | Appeler le soigneur | Call healer |
|
||||
| `healer.busy` | Soigneur occupé | Healer busy |
|
||||
|
||||
##### Formes (tableau détaillé)
|
||||
|
||||
| Élément | Forme | Notes |
|
||||
|---|---|---|
|
||||
| Badge maladie | rond | lisible |
|
||||
| Barre santé | rectangulaire | standard |
|
||||
|
||||
Reference in New Issue
Block a user