first commit

README.md

@@ -0,0 +1,122 @@
+# GeckoBreizh
+
+GeckoBreizh est un ensemble de fiches imprimables pour le suivi d’un **élevage familial de geckos léopards**.
+
+Les documents sont conçus pour conserver les informations utiles au soin, à la traçabilité et à la reproduction, sans imposer de journal quotidien.
+
+## Principe de suivi
+
+- Le **nom de l’animal sert d’identifiant** dans tous les documents et doit rester unique dans l’élevage.
+- Les gestes de routine ne sont pas notés lorsqu’il n’y a rien de particulier à signaler.
+- Une nouvelle fiche est créée lorsqu’un événement, une nouvelle année ou une modification importante le justifie.
+- Les anciennes fiches sont conservées afin de garder l’historique de l’animal et de son installation.
+
+## Documents
+
+| Document | Usage | Rythme |
+| --- | --- | --- |
+| **Identité** | origine et informations durables de l’animal | une fiche par animal |
+| **Suivi** | poids, alimentation, supplémentation, mue, selles, observations et soins | une fiche par animal et par année ; plusieurs exemplaires si besoin |
+| **Santé** | problème de santé, consultation, traitement et évolution | une fiche par événement significatif |
+| **Reproduction** | couple, ovulation, accouplements, pontes, incubation et jeunes | une fiche par couple et par saison |
+| **Installation** | configuration du terrarium et maintenance UVB | une fiche par installation ou modification importante |
+| **Éclairage annuel** | programmation mensuelle des éclairages | une fiche par terrarium et par année |
+
+### Identité
+
+`src/templates/fiche_gecko_modele.html` sert de modèle pour créer la fiche d’un nouvel animal. `src/geckos/delta.html` est la fiche de Delta.
+
+Pour créer une fiche :
+
+```bash
+cp src/templates/fiche_gecko_modele.html src/geckos/nom_du_gecko.html
+```
+
+Ajouter ensuite la photo dans `assets/images/`, puis modifier dans le HTML le nom, les informations de l’animal, le chemin de l’image et son attribut `alt`.
+
+### Suivi
+
+`src/suivi/suivi_gecko.html`
+
+Fiche **A4 portrait** organisée par animal et par année. Une ligne est renseignée lorsqu’un élément mérite d’être conservé : date, poids, alimentation ou supplément, mue, selles, observation ou soin.
+
+Les colonnes **Mue** et **Selles** peuvent recevoir une coche ou une mention courte. Les détails éventuels sont notés dans **Observations / soins**.
+
+### Santé
+
+`src/sante/sante.html`
+
+Fiche **A4 portrait** destinée à un événement de santé nécessitant un historique séparé : symptômes, appétit, selles, consultation ou diagnostic, traitement, évolution et contrôle éventuel.
+
+### Reproduction
+
+`src/reproduction/reproduction.html`
+
+Fiche **A4 portrait** par couple et par saison. Elle permet de suivre l’ovulation, les accouplements, les pontes, l’incubation, les éclosions et jusqu’à 12 jeunes.
+
+Chaque jeune peut ensuite disposer de sa propre fiche d’identité et de suivi.
+
+### Installation
+
+`src/installation/installation.html`
+
+Fiche **A4 portrait** consacrée à la configuration du terrarium : dimensions, substrat, ventilation, chauffage, thermostat, UVB, températures cibles et modifications importantes.
+
+En cas de changement majeur de configuration ou d’occupant, archiver la fiche précédente et en commencer une nouvelle.
+
+### Éclairage annuel
+
+`src/installation/eclairage_annuel.html`
+
+Fiche **A4 paysage** contenant les horaires mensuels des programmateurs, les cases de validation des réglages et les contrôles liés aux changements d’heure été/hiver.
+
+## Impression et PDF
+
+Les fiches sont conçues pour une **impression laser noir et blanc**. L’affichage dans Firefox correspond au document destiné à être imprimé.
+
+Pour imprimer ou créer un PDF :
+
+1. Ouvrir le fichier HTML dans Firefox.
+2. Faire `Ctrl+P`.
+3. Utiliser une échelle de **100 %**.
+4. Activer **Imprimer les arrière-plans** dans les paramètres supplémentaires.
+5. Vérifier le format **A4** et l’orientation : portrait pour toutes les fiches sauf **Éclairage annuel**, en paysage.
+6. Imprimer ou choisir **Enregistrer au format PDF**.
+
+Le dossier `pdf/` contient des versions prêtes à imprimer des fiches courantes. Les fichiers HTML/CSS restent les fichiers à modifier.
+
+## Arborescence
+
+```text
+GeckoBreizh/
+├── README.md
+├── assets/
+│   ├── css/
+│   │   └── style.css
+│   └── images/
+│       ├── delta.jpg
+│       └── photo_modele.svg
+├── src/
+│   ├── geckos/
+│   │   └── delta.html
+│   ├── suivi/
+│   │   └── suivi_gecko.html
+│   ├── sante/
+│   │   └── sante.html
+│   ├── reproduction/
+│   │   └── reproduction.html
+│   ├── installation/
+│   │   ├── installation.html
+│   │   └── eclairage_annuel.html
+│   └── templates/
+│       └── fiche_gecko_modele.html
+└── pdf/
+    ├── delta.pdf
+    ├── suivi_gecko.pdf
+    ├── sante.pdf
+    ├── reproduction.pdf
+    ├── installation.pdf
+    └── eclairage_annuel.pdf
+```
+
+La mise en page commune est définie dans `assets/css/style.css`.