geckobreizh/README.md

# 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 |
| **Abréviations** | référence des codes utilisés dans le suivi | une fiche de référence |

### 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.

Une entrée tient normalement sur une ligne. Si elle demande davantage de place, la ligne suivante sert de continuation en laissant la date vide.

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.

Dans **Évolution / contrôle**, une ligne correspond à une mise à jour datée. Une éventuelle continuation peut utiliser la ligne suivante en laissant la date vide.

### 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 et les cases de validation des réglages. Les horaires de P1 suivent approximativement le lever et le coucher du soleil vers le 15 de chaque mois à Brasparts. Ils sont convertis en **UTC+1 fixe** puis arrondis à 5 minutes ; P2 est décalé de 30 minutes vers l’intérieur. Pour éviter le saut artificiel lié au changement d’heure légal, l’horloge du programmateur reste en **UTC+1 toute l’année** et le passage à l’heure d’été n’est pas appliqué. Pendant la période d’heure d’été, l’heure civile a donc une heure d’avance sur l’affichage du programmateur.

### Abréviations

`src/reference/abreviations.html`

Fiche **A4 portrait** de référence pour les codes utilisés dans les notations d’alimentation et de supplémentation. La taille d’une proie peut être ajoutée après son code lorsqu’elle apporte une information utile.

## 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
│   ├── reference/
│   │   └── abreviations.html
│   └── templates/
│       └── fiche_gecko_modele.html
└── pdf/
    ├── delta.pdf
    ├── suivi_gecko.pdf
    ├── sante.pdf
    ├── reproduction.pdf
    ├── installation.pdf
    ├── eclairage_annuel.pdf
    └── abreviations.pdf
```

La mise en page commune est définie dans `assets/css/style.css`.