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

docs/specs/joueur.md

@@ -0,0 +1,158 @@
+# Spécifications : Joueur
+
+## Définition
+L'utilisateur humain.
+
+## Propriétés
+- **Compte** : Authentifié par clé privée (pas de mot de passe).
+- **Ressources** : Pièces, Unités de recherche.
+- **Zoo** : Possède et gère un unique zoo.
+- **Démarrage** : Commence avec 200 pièces et 3 couples reproducteurs basiques.
+
+## Actions
+- Achat/Vente.
+- Placement/Déplacement.
+- Upgrade bâtiments/carte.
+- Gestion des incidents visiteurs.
+- Configuration du profil d'absence (Bot).
+
+# Annexes Techniques
+
+## 1. Données et États
+### Modèle de Données (JSON)
+```json
+{
+  "id": "uuid",
+  "public_key": "string (ed25519)",
+  "username": "string",
+  "created_at": "timestamp",
+  "last_login": "timestamp",
+  "resources": {
+    "coins": "integer",
+    "research_points": "integer"
+  },
+  "settings": {
+    "music_enabled": "boolean",
+    "bot_profile_id": "integer"
+  }
+}
+```
+
+### Caractéristiques Initiales
+| Caractéristique | Valeur Initiale |
+| :--- | :--- |
+| Pièces | 200 |
+| Recherche | 0 |
+| Animaux | 3 couples (6 animaux) |
+
+### Scores Initiaux
+N/A
+
+## 2. Cycles de Vie et Apparition
+### Conditions d'Apparition
+Inscription.
+
+### Conditions de Disparition
+Suppression compte.
+
+### Hérédité
+N/A
+
+## 3. Impacts Environnementaux
+### Impact Température
+N/A
+
+### Impact Milieu (Biome)
+N/A
+
+### Impact Saisons
+N/A
+
+### Impact Heure / Jour-Nuit
+N/A
+
+## 4. Impacts Biologiques et Sociaux
+### Impact Reproduction
+**Démarrage autonome** : Le joueur reçoit 3 couples reproducteurs basiques (Lapins/Poules/Canards selon biome) pour garantir une reproduction immédiate et alimenter le marché bas prix.
+
+### Impact Mort
+N/A
+
+### Impact Nourriture
+N/A
+
+### Impact Attractivité (Visiteurs/Animaux)
+N/A
+
+### Impact Valeur
+N/A
+
+## 5. Impacts Logistiques et Économiques
+### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
+N/A
+
+### Dépenses (Boutiques/Visiteurs)
+N/A
+
+### Trajet Visiteurs
+N/A
+
+## 6. Événements
+### Événements du Jeu / Carte / Zoo / Ville / Visiteur
+*   **Connexion** : Chargement état.
+*   **Quête** : Validation.
+
+## 7. Progression
+### Tableau des Upgrades
+N/A
+
+## 8. Logique et Interfaces
+### Pseudo-code Impacts
+N/A
+
+### Messages d'Infos / Alerte
+| ID | Niveau | Message |
+| :--- | :--- | :--- |
+| `WELCOME` | Info | "Bienvenue dans votre nouveau zoo !" |
+| `NO_MONEY` | Alerte | "Fonds insuffisants." |
+
+# Annexes UX/UI
+
+## 1. Expérience Utilisateur (UX)
+### HUD Principal (Permanent)
+**Description UX** : Le joueur voit en permanence ses ressources et accès rapides.
+**Description UI** : Barre supérieure avec Compteurs (Pièces, Recherche, Réputation). Barre inférieure ou latérale avec Menus (Construction, Carte Monde, Inventaire, Profil).
+**Emplacement** : Écran (Overlay).
+**Intégration** : Fixe.
+**Navigation** : Clic Menu -> Ouverture Panneau.
+**Événements** : `UI_CLICK`.
+
+#### Assets
+- **Musiques** : N/A
+- **Sons** : `ui_click.mp3`.
+- **Graphiques** : Style UI "Bois et Pierre" ou "Moderne Clean".
+- **Images** : Icônes (Pièce, Fiole, Marteau, Carte).
+- **Vidéos** : N/A
+- **Animations** : Compteurs qui défilent quand gain/perte.
+- **Couleurs** : Or, Bleu, Blanc.
+- **Textes** : Chiffres, Labels menus.
+- **Formes** : Barres, Boutons ronds.
+
+### Profil & Bot (Configuration)
+**Description UX** : Le joueur configure son avatar et son bot d'absence.
+**Description UI** : Modal Profil. Onglet "Gestion Absence" avec sélecteur de Bot (Famille > Spécialisation).
+**Emplacement** : Menu Profil.
+**Intégration** : Modal.
+**Navigation** : Profil -> Bot -> Sauvegarder.
+**Événements** : `SAVE_PROFILE`.
+
+#### Assets
+- **Musiques** : N/A
+- **Sons** : `save_success.mp3`.
+- **Graphiques** : Portraits de bots.
+- **Images** : Avatars joueurs.
+- **Vidéos** : N/A
+- **Animations** : N/A
+- **Couleurs** : N/A
+- **Textes** : Description des bots ("Le Conservateur : Achète de la nourriture...").
+- **Formes** : Cartes de sélection.