Nicolas Cantu
e92c1355d0
**Motivations:** - Aligner toute la documentation technique avec la nouvelle direction artistique isométrique (Réf IMG_20260303_170253). - Faciliter l'implémentation en ajoutant les contraintes techniques liées à la 2.5D (Z-index, Sprites 4 directions). **Root causes:** - Besoin de cohérence visuelle et technique sur l'ensemble du projet. **Correctifs:** - N/A **Evolutions:** - Ajout systématique de la section "Direction Artistique & Vue" dans `Annexes UX/UI` de tous les fichiers. - Enrichissement des modèles JSON avec coordonnées isométriques (`iso_x`, `iso_y`, `z_index`). - Précision des interactions (clic, survol) adaptées à la grille losange. - Conservation stricte de la structure existante (aucun titre supprimé). **Pages affectées:** - docs/specs/*
155 lines
4.8 KiB
Markdown
155 lines
4.8 KiB
Markdown
# Spécifications : Ville (Site)
|
|
|
|
## Définition
|
|
Une ville est une entité sur la Carte du Monde qui génère le flux de visiteurs vers les zoos.
|
|
|
|
## Propriétés
|
|
- **Nom** : Nom de la ville.
|
|
- **Population** : Nombre de visiteurs potentiels maximum.
|
|
- **Icône** : 🏙️
|
|
|
|
## Mécanique d'Attraction
|
|
- Les visiteurs partent de la ville pour aller vers les zoos.
|
|
- **Facteur de Distance** : Plus un zoo est proche d'une ville, plus il attire de visiteurs.
|
|
- **Facteur d'Attractivité** : La valeur et la diversité du zoo influencent le choix des visiteurs.
|
|
|
|
# Annexes Techniques
|
|
|
|
## 1. Données et États
|
|
### Modèle de Données (JSON)
|
|
```json
|
|
{
|
|
"id": "uuid",
|
|
"type": "city",
|
|
"name": "string",
|
|
"population": "integer",
|
|
"wealth_factor": "float (0.5 - 2.0)",
|
|
"iso_x": "integer",
|
|
"iso_y": "integer",
|
|
"z_index": "integer"
|
|
}
|
|
```
|
|
|
|
### Caractéristiques Initiales
|
|
| Caractéristique | Valeur Moyenne |
|
|
| :--- | :--- |
|
|
| Population | 10,000 - 1,000,000 |
|
|
| Richesse | 1.0 |
|
|
|
|
### Scores Initiaux
|
|
**Niveau de Bonheur** : 50% (Influence la fréquence des visites).
|
|
|
|
## 2. Cycles de Vie et Apparition
|
|
### Conditions d'Apparition
|
|
Génération carte.
|
|
|
|
### Conditions de Disparition
|
|
**Désastre** : Ville détruite (Event rare "Météorite" ou "Crise Éco").
|
|
|
|
### Hérédité
|
|
**Jumelage** : Bonus permanent de flux (+5%) si relation max atteinte avec une ville.
|
|
|
|
## 3. Impacts Environnementaux
|
|
### Impact Température
|
|
**Ilot de chaleur** : La ville est toujours +2°C par rapport à la campagne environnante.
|
|
|
|
### Impact Milieu (Biome)
|
|
**Architecture** : Adaptée au biome (Igloos en Toundra, Tentes en Désert, Gratte-ciels en Plaine).
|
|
|
|
### Impact Saisons
|
|
**Festivals** : Event saisonnier en ville (+Visiteurs pendant 24h).
|
|
- Été : Carnaval.
|
|
- Hiver : Marché de Noël.
|
|
|
|
### Impact Heure / Jour-Nuit
|
|
**Lumières** : La ville brille la nuit (Pollution lumineuse visible).
|
|
|
|
## 4. Impacts Biologiques et Sociaux
|
|
### Impact Reproduction
|
|
**Baby Boom** : Augmente la population de la ville (+Flux) pendant 1 semaine.
|
|
|
|
### Impact Mort
|
|
**Épidémie** : Baisse population temporaire (-Flux).
|
|
|
|
### Impact Nourriture
|
|
**Marché** : La ville vend de la nourriture au joueur (Source d'approvisionnement).
|
|
|
|
### Impact Attractivité (Visiteurs/Animaux)
|
|
Source du flux. `Flux = Pop * (AttractivitéZoo / Distance²)`.
|
|
|
|
### Impact Valeur
|
|
**PIB** : Influence le budget des visiteurs (Richesse). Une ville riche envoie des VIP.
|
|
|
|
## 5. Impacts Logistiques et Économiques
|
|
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
|
|
**Trafic** : Ralentit les camions traversant la ville aux heures de pointe (8h-9h, 17h-18h).
|
|
|
|
### Dépenses (Boutiques/Visiteurs)
|
|
**Facteur Richesse** : Multiplie le budget des visiteurs issus de cette ville.
|
|
|
|
### Trajet Visiteurs
|
|
Point de départ. Les visiteurs arrivent en bus/voiture depuis la ville.
|
|
|
|
## 6. Événements
|
|
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
|
|
* **Fête Nationale** : Flux x2.
|
|
* **Grève** : Flux / 2.
|
|
|
|
## 7. Progression
|
|
### Tableau des Upgrades
|
|
*Note : Campagnes Marketing ciblées.*
|
|
| Niveau Campagne | Coût | Effet |
|
|
| :--- | :--- | :--- |
|
|
| 1 (Panneaux) | 500 | +5% Flux |
|
|
| 2 (Radio) | 1500 | +10% Flux |
|
|
| 3 (TV) | 5000 | +20% Flux |
|
|
|
|
## 8. Logique et Interfaces
|
|
### Pseudo-code Impacts
|
|
```javascript
|
|
function calculateVisitorFlow(city, zoo):
|
|
distance = getDistance(city, zoo)
|
|
baseFlow = city.population * (zoo.attractiveness / (distance * distance))
|
|
|
|
if isPeakHour(): baseFlow *= 1.5
|
|
if city.hasEvent(): baseFlow *= 2.0
|
|
|
|
return baseFlow
|
|
```
|
|
|
|
### Messages d'Infos / Alerte
|
|
| ID | Niveau | Message |
|
|
| :--- | :--- | :--- |
|
|
| `CITY_EVENT` | Info | "C'est la fête à [NomVille] ! Attendez-vous à du monde." |
|
|
|
|
# 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)
|
|
### Visualisation Taille (Passif)
|
|
**Description UX** : Distinguer les grandes villes des petites.
|
|
**Description UI** : Taille de l'icône proportionnelle à la population. Gratte-ciels vs Maisons.
|
|
**Emplacement** : Carte Monde.
|
|
**Intégration** : Sprite.
|
|
**Navigation** : Zoom sur la carte.
|
|
**Événements** : `MAP_ZOOM`.
|
|
|
|
#### Assets
|
|
- **Musiques** : Ambiance urbaine (klaxons lointains, vent).
|
|
- **Sons** : Bruit de trafic faible.
|
|
- **Graphiques** : Sprites Ville (Petit, Moyen, Grand).
|
|
- **Images** : Silhouette Skyline.
|
|
- **Vidéos** : Lumières des fenêtres qui s'allument la nuit (Pixel Art animé).
|
|
- **Animations** : Fumée des cheminées.
|
|
- **Couleurs** : Gris/Bleu.
|
|
- **Textes** : Nom Ville.
|
|
- **Formes** : Cercle d'influence (zone de chalandise).
|