poupoule/cahierDesCharges.md

Cahier des charges — Mon Poulailler

1. Contexte

Le projet Mon Poulailler vise à créer une application web de gestion d’un poulailler.

Dans la gestion quotidienne d’un poulailler, il est important de connaître :

• le nombre de poules et de coqs ;
• l’identité et les caractéristiques de chaque animal ;
• l’état de santé ;
• les périodes de ponte (début, durée, fin) ;
• les périodes de couvage ;
• l’historique des animaux décédés.

L’application doit permettre de suivre ces informations de façon centralisée et à jour.

2. Objectif

Disposer d’une vue claire et à jour de l’état du poulailler : effectifs, animaux actifs, périodes de ponte et de couvage, et archives.

3. Périmètre

3.1 Inclus

• Authentification (création de comptes, connexion) ;
• gestion des poules et des coqs ;
• suivi des périodes de ponte et de couvage ;
• statistiques d’effectifs en temps réel ;
• archivage des animaux décédés ;
• déploiement local via Docker.

3.2 Hors périmètre (version initiale)

• Application mobile native ;
• notifications push / alertes automatiques ;
• suivi vétérinaire détaillé (ordonnances, traitements) ;
• gestion multi-poulaillers ;
• synchronisation cloud / multi-appareils hors réseau local ;
• inventaire des œufs au quotidien (sauf si lié explicitement à une période de ponte).

4. Utilisateurs

Profil	Description	Droits principaux
Administrateur	Responsable du poulailler / de l’application	Créer des comptes, gérer tous les animaux
Utilisateur	Personne qui s’occupe des poules	Gérer les poules et les coqs (sans création de comptes)

5. Fonctionnalités

5.1 Authentification et comptes

• Création de comptes (réservée à l’administrateur) ;
• connexion par identifiant et mot de passe ;
• déconnexion ;
• deux profils : Admin et Utilisateur.

Action	Admin	Utilisateur
Se connecter / se déconnecter	Oui	Oui
Créer un compte	Oui	Non
Gérer poules et coqs	Oui	Oui
Consulter les statistiques	Oui	Oui
Consulter les archives	Oui	Oui

5.2 Gestion des animaux (poules et coqs)

Pour chaque animal, l’application permet de renseigner et consulter :

Donnée	Description
Identifiant unique	Identifiant technique unique dans l’application
Photo	Image de l’animal
Couleur de bague	Couleur de la bague d’identification
Numéro de bague	Numéro associé à la bague
Date de naissance	Date de naissance (ou date d’arrivée si inconnue)
Type	Poule ou coq
État de santé	Indication simple de l’état de santé
Date de fin de vie	Renseignée lorsque l’animal décède

Actions attendues :

• créer un animal ;
• modifier ses informations ;
• consulter sa fiche détaillée ;
• marquer un animal comme décédé (passe en archive) ;
• lister les animaux actifs ;
• lister les animaux archivés (décédés).

5.3 Périodes de ponte (poules uniquement)

• Enregistrer une ou plusieurs périodes de ponte ;
• pour chaque période : date de début, date de fin (optionnelle si en cours), éventuellement une remarque ;
• indiquer si la poule pond actuellement.

5.4 Périodes de couvage (poules uniquement)

• Enregistrer une ou plusieurs périodes de couvage ;
• pour chaque période : date de début, date de fin (optionnelle si en cours), éventuellement une remarque ;
• indiquer si la poule est actuellement en couvage.

5.5 Statistiques

Affichage en temps réel (après chaque action ou au chargement) :

• nombre de poules actives ;
• nombre de coqs actifs ;
• nombre total d’animaux actifs ;
• nombre de poules actuellement en couvage ;
• nombre de poules actuellement en ponte (souhaitable).

5.6 Archives

• Vue dédiée aux animaux décédés ;
• conservation des informations (identité, bagues, dates, historique de ponte / couvage) ;
• pas de suppression définitive obligatoire en v1 (possibilité de la prévoir plus tard).

6. Exigences non fonctionnelles

Exigence	Attendu
Accessibilité	Interface utilisable sur ordinateur et tablette (responsive de base)
Performance	Réponses rapides sur un usage local (peu d’utilisateurs simultanés)
Sécurité	Mots de passe stockés de façon sécurisée (hachage) ; accès réservé aux utilisateurs authentifiés
Disponibilité	Application disponible en local via Docker
Ergonomie	Navigation simple : liste, fiche animal, statistiques, archives
Données	Persistance via fichiers JSON ; sauvegarde manuelle possible en copiant les fichiers

7. Spécifications techniques

Élément	Choix
Type d’application	Application web
Hébergement	Local, via Docker
Front-end	HTML, CSS, JavaScript
Back-end	JavaScript (Node.js recommandé)
Base de données	Fichiers JSON (stockage documentaire)

7.1 Architecture cible (indicatif)

• Interface web servie par le back-end ;
• API métier pour authentification et CRUD animaux / périodes ;
• persistance dans un ou plusieurs fichiers JSON montés en volume Docker.

7.2 Contraintes techniques

• Fonctionnement hors cloud, en environnement local ;
• pas de dépendance à une base relationnelle en v1 ;
• les données doivent survivre à un redémarrage du conteneur (volume Docker).

8. Modèle de données (indicatif)

Utilisateur

• id, login, motDePasseHash, profil (admin | utilisateur)

Animal

• id, type (poule | coq), photo, couleurBague, numeroBague, dateNaissance, etatSante, dateFinDeVie (nullable), actif (booléen)

PeriodePonte

• id, idAnimal, dateDebut, dateFin (nullable), remarque

PeriodeCouvage

• id, idAnimal, dateDebut, dateFin (nullable), remarque

9. Critères d’acceptation (v1)

• Un administrateur peut créer un compte utilisateur et se connecter.
• Un utilisateur connecté peut ajouter une poule avec photo, bague, date de naissance.
• Un utilisateur peut enregistrer une période de ponte et une période de couvage.
• Les statistiques affichent correctement le nombre de poules, de coqs et de poules en couvage.
• Marquer une poule comme décédée la retire de la liste active et l’ajoute aux archives.
• L’application démarre via Docker et conserve les données après redémarrage.

10. Livrables

• Code source de l’application ;
• Dockerfile / docker-compose pour le lancement local ;
• documentation courte de démarrage (installation, comptes, sauvegarde des JSON) ;
• le présent cahier des charges à jour.

11. Evolutions possibles (hors v1)

• Suivi quotidien des œufs collectés ;
• alertes (fin de ponte, couvage prolongé) ;
• export CSV / PDF ;
• multi-poulaillers ;
• application mobile.