Publier Globinours 1.0.0-rc.3

docs/01-premiers-pas.md

@@ -0,0 +1,56 @@
+# 1. Premiers pas
+
+[← Sommaire](README.md) · [Chapitre suivant : Animaux →](02-animaux.md)
+
+## Se connecter
+
+Ouvrez l’adresse fournie par l’administrateur, saisissez votre identifiant et votre mot de passe, puis validez. Si l’option d’appareil de confiance est proposée, ne l’utilisez que sur un appareil personnel ou exclusivement réservé au refuge.
+
+Après connexion, Globinours ouvre le **Dashboard** ou la première page autorisée à votre rôle. La roue crantée, en haut à droite, affiche votre nom, les réglages accessibles et la déconnexion.
+
+## Comprendre la navigation
+
+Le bandeau principal rassemble les modules du quotidien :
+
+- **Dashboard** : priorités et situation actuelle ;
+- **Animaux** : animaux actifs, archives et corbeille ;
+- **Annuaire** : personnes et structures ;
+- **Tournée** : contrôles du matin et du soir ;
+- **Statistiques** : activité et coûts ;
+- **Administratif** : registre, exports, documents et subventions ;
+- **Roue crantée** : compte et paramètres d’administration.
+
+Une page ou un bouton peut disparaître selon vos permissions. Les droits sont contrôlés également par le serveur : copier l’adresse d’une page ne contourne pas une interdiction.
+
+## Lire le Dashboard
+
+Le Dashboard répond à la question : **que faut-il surveiller aujourd’hui ?** Il présente notamment les effectifs, les lieux de vie, les alertes vaccinales, les informations médicales et la qualité des fiches. Les compteurs exploitables ouvrent le listing déjà filtré.
+
+Le Dashboard ne remplace pas la page Statistiques : le premier décrit la situation opérationnelle présente, la seconde analyse une année ou tout l’historique.
+
+## Rechercher et filtrer
+
+Dans le listing des animaux, saisissez une partie du nom, du code ou d’une autre information recherchée. Les listes déroulantes appliquent leurs filtres dès leur modification. Le tri choisi est conservé dans l’adresse de la page, ce qui permet de recharger ou partager une vue autorisée.
+
+Deux présentations sont disponibles :
+
+- la **vue tableau**, dense et triable ;
+- la **vue mosaïque**, visuelle et adaptée aux photos.
+
+Votre préférence est mémorisée pour votre compte.
+
+## Bonnes pratiques
+
+1. Recherchez toujours un animal ou un contact avant d’en créer un nouveau.
+2. Utilisez les événements de parcours et les actions médicales plutôt qu’une note libre lorsque le champ structuré existe.
+3. Ne mettez à la corbeille qu’une fiche créée par erreur ; archivez une fiche sortie du suivi courant.
+4. Ne publiez une photo que si elle peut être montrée au public.
+5. Signalez immédiatement une mauvaise manipulation à un administrateur : l’audit et les sauvegardes facilitent la correction.
+
+## Se déconnecter
+
+Ouvrez la roue crantée, puis choisissez **Déconnexion**. Sur un appareil partagé, révoquez également l’appareil de confiance depuis la gestion du compte si cette option avait été activée.
+
+---
+
+[← Sommaire](README.md) · [Animaux →](02-animaux.md)

docs/02-animaux.md

@@ -0,0 +1,78 @@
+# 2. Gérer les animaux
+
+[← Premiers pas](01-premiers-pas.md) · [Sommaire](README.md) · [Portées et liens →](03-portees-et-liens.md)
+
+## Le listing
+
+La page **Animaux** présente les animaux actuellement suivis par le refuge. Les animaux adoptés, décédés ou autrement sortis du suivi courant peuvent se trouver dans les archives. Les fiches supprimées logiquement se trouvent dans la corbeille.
+
+La vue tableau permet de trier les colonnes disponibles. Les lignes de portées et de groupes inséparables restent regroupées tout en participant au tri. Les icônes de compatibilité indiquent les relations avec les chiens, chats et enfants ainsi que la propreté. Un trait signifie que l’information n’est pas renseignée.
+
+La vue mosaïque met en avant la photo, le nom, le statut, la famille d’accueil éventuelle et les compatibilités.
+
+## Créer une fiche
+
+Cliquez sur **Ajouter un animal**. Renseignez au minimum les informations certaines. Une estimation doit rester présentée comme telle : ne créez pas une date précise si seul l’âge approximatif est connu.
+
+La fiche peut notamment contenir :
+
+- espèce, nom, sexe, date de naissance ou âge estimé ;
+- race, robe et signes particuliers ;
+- mode et motif d’entrée, déposant, commune et circonstances ;
+- identification par puce ou tatouage et statut I-CAD ;
+- stérilisation et disponibilité à l’adoption ;
+- compatibilités et profil de vie ;
+- lieu de vie, famille d’accueil et publication publique.
+
+Les espèces sont administrables. Utilisez **Chat**, **Chien** ou une espèce précise plutôt qu’une catégorie vague lorsque le référentiel la propose.
+
+## La fiche animale
+
+La fiche s’ouvre toujours sur **Identité**. Les autres onglets regroupent :
+
+- **Activité** : événements marquants ;
+- **Médical**, **Traitements** et **Vaccins** ;
+- **Lieux de vie** : position actuelle et historique interne ;
+- **Parcours d’accueil** : réservation, famille d’accueil, adoption, retour ou annulation ;
+- **Portées** pour les chats ;
+- **Documents**, **Historique** et **Photos**.
+
+Le menu **Ajouter** centralise les événements structurés. Le menu **Actions** contient les opérations globales comme l’impression, le décès, l’archivage ou la corbeille.
+
+## Photos et visibilité
+
+Depuis l’onglet **Photos**, téléversez une ou plusieurs images, choisissez la photo principale et définissez leur visibilité. Les photos privées restent réservées à l’application. Une photo publique peut apparaître sur le mini-site si l’animal lui-même est publié.
+
+Lorsque les outils d’image du serveur sont disponibles, Globinours réoriente, optimise et retire les métadonnées des images. Vérifiez néanmoins qu’aucune personne, adresse, ordonnance ou information sensible n’est visible.
+
+## Lieux de vie et familles d’accueil
+
+Le **lieu de vie** décrit où se trouve l’animal : refuge, salle, infirmerie, quarantaine, famille d’accueil, accueil permanent ou autre emplacement configuré. Lorsqu’une famille d’accueil est choisie, sélectionnez la personne correspondante dans l’annuaire.
+
+Le **parcours d’accueil** décrit pourquoi et dans quel cadre il s’y trouve : accueil en FA, retour, réservation, adoption, etc. Les deux notions sont liées mais ne sont pas interchangeables.
+
+## Enregistrer une adoption
+
+Depuis la fiche, choisissez l’action d’adoption, sélectionnez l’adoptant dans l’annuaire ou créez-le à la volée, puis renseignez la date. L’adoption met à jour le parcours, la sortie, la situation et l’archivage sans effacer l’historique antérieur en famille d’accueil.
+
+## Enregistrer un décès
+
+Choisissez **Enregistrer le décès** dans le menu Actions. Renseignez les informations connues : date ou année, cause, euthanasie éventuelle, vétérinaire, crématorium, devenir du corps et note mémorielle. N’inventez pas de jour précis pour un décès historique connu seulement à l’année.
+
+Un décès est une sortie et retire l’animal du suivi courant. La fiche reste consultable et modifiable dans les archives. Les statistiques annuelles n’attribuent pas artificiellement les décès sans année connue.
+
+## Archives et corbeille
+
+- **Archiver** retire une fiche du listing courant tout en conservant son dossier et son histoire.
+- **Mettre à la corbeille** sert aux créations erronées ou doublons. La fiche ne compte plus dans les statistiques.
+- **Restaurer** replace une fiche archivée ou supprimée dans le parcours prévu par l’interface.
+
+Les archives disposent de la recherche, des filtres et des tris du listing principal. Une archive peut être corrigée sans être restaurée pour rectifier une identité, un sexe ou une identification ; les champs qui déterminent sa situation historique restent protégés.
+
+## Chats libres
+
+Le parcours **Chat libre** permet de conserver le site ou la colonie, la commune, le référent, les dates de capture et de remise en liberté ainsi que l’état du suivi. Utilisez ce parcours plutôt qu’un statut approximatif : il alimente les filtres et les statistiques dédiées.
+
+---
+
+[← Premiers pas](01-premiers-pas.md) · [Portées et liens →](03-portees-et-liens.md)

docs/03-portees-et-liens.md

@@ -0,0 +1,42 @@
+# 3. Portées, fratries et animaux inséparables
+
+[← Animaux](02-animaux.md) · [Sommaire](README.md) · [Suivi médical →](04-suivi-medical.md)
+
+## Créer une portée
+
+Une portée peut être créée depuis le bouton **Ajouter une portée** du listing ou depuis l’onglet **Portées** d’un parent.
+
+Deux parcours sont proposés :
+
+- **Nouveaux chatons** : indiquez d’abord leur nombre ; Globinours affiche alors exactement le nombre de fiches à compléter.
+- **Chats existants** : sélectionnez des fiches déjà présentes pour les réunir dans une nouvelle portée.
+
+La date de naissance est saisie au format `JJ/MM/AAAA`. Le père, la mère ou les deux peuvent rester inconnus. Depuis la fiche d’un parent, Globinours préremplit naturellement celui-ci et propose l’autre parent parmi les chats vivants et non adoptés compatibles.
+
+## Nommer les chatons
+
+Le nom est facultatif. Sans nom saisi, Globinours construit un nom à partir d’un parent et du rang, par exemple `Caramel-Bébé-1`. Le sexe et la robe peuvent également rester inconnus puis être complétés plus tard.
+
+## Portées sans parent connu
+
+Une portée sans parent reste un groupe visible : un parent visuel factice et non cliquable maintient la même présentation que les autres portées. Les frères et sœurs ne sont donc jamais affichés comme des animaux sans relation.
+
+## Ajouter un animal après coup
+
+Depuis l’onglet **Portées** d’un chat ou l’action prévue sur la portée, choisissez **Ajouter des chats existants**. Cette opération convient lorsqu’une filiation est découverte après la création des fiches. Vérifiez le groupe sélectionné avant validation pour ne pas fusionner deux portées homonymes.
+
+## Groupes inséparables
+
+Un groupe inséparable relie des animaux qui doivent être placés ensemble, sans supposer de filiation. Depuis la fiche d’un animal, choisissez **Groupe inséparable**, recherchez les autres membres et nommez le groupe si nécessaire.
+
+Dans le listing, le groupe reçoit un en-tête et un fond léger commun. Chaque membre conserve sa propre fiche, ses soins et son parcours. Dissoudre le groupe supprime uniquement le lien : aucune fiche animale n’est supprimée.
+
+## Choisir le bon lien
+
+- Même naissance ou filiation : **portée**.
+- Placement obligatoirement commun : **groupe inséparable**.
+- Simple cohabitation dans une salle ou un box : **lieu de vie**, sans créer de lien familial.
+
+---
+
+[← Animaux](02-animaux.md) · [Suivi médical →](04-suivi-medical.md)

docs/04-suivi-medical.md

@@ -0,0 +1,55 @@
+# 4. Suivi médical
+
+[← Portées et liens](03-portees-et-liens.md) · [Sommaire](README.md) · [Tournées →](05-tournees.md)
+
+> Le module médical peut être masqué par les permissions. Les données de ce chapitre sont privées et ne sont jamais destinées au mini-site.
+
+## Aperçu médical
+
+La fiche regroupe les statuts FIV/FeLV, la stérilisation, les pathologies, le poids, les vaccinations, les traitements, le dernier vermifuge, les ordonnances et les analyses. Le listing affiche un aperçu compact pour repérer rapidement les informations manquantes ou préoccupantes.
+
+## Note médicale
+
+Dans **Ajouter → Note médicale**, saisissez la date, l’observation, le vétérinaire ou l’intervenant et, si nécessaire, une photo. Une photo prise depuis une tablette ou un téléphone rejoint les médias privés de l’animal. Une note anormale issue d’une tournée est également ajoutée à son activité ; un passage entièrement normal ne surcharge pas l’historique.
+
+La stérilisation peut être confirmée depuis ce parcours. La case reprend automatiquement l’état déjà enregistré.
+
+## Traitements
+
+Dans **Ajouter → Traitement**, choisissez le médicament, la dose, la voie, les dates et le caractère continu. La liste est triée alphabétiquement. Si le produit manque, utilisez l’ajout à la volée plutôt que de détourner un autre médicament.
+
+Les vermifuges disposent volontairement d’un catalogue séparé : ne les créez pas comme traitements ordinaires.
+
+## Vaccinations
+
+Enregistrez le vaccin, la date, le prochain rappel, le lot, l’expiration, le vétérinaire et l’intervenant lorsque ces informations sont connues. Le Dashboard distingue les vaccins en retard, attendus sous 7 jours et sous 30 jours.
+
+## Vermifuges
+
+L’action **Vermifuge** enregistre le produit, la dose, le poids éventuel et la prochaine échéance. Le dernier passage et le prochain sont visibles dans l’aperçu médical.
+
+Le calendrier proposé sert de repère : semaines 3, 5 et 7 pour les chatons, puis chaque mois jusqu’à 6 mois et généralement tous les 3 mois à l’âge adulte. Une maman allaitante peut être traitée avec sa portée. L’équipe vétérinaire reste prioritaire sur toute suggestion automatique.
+
+## Ordonnances
+
+Dans **Ajouter → Ordonnance**, photographiez ou déposez le document, renseignez sa date, la clinique et le vétérinaire, puis reliez les traitements concernés. Le fichier est stocké comme document privé et chaque ouverture est traçable.
+
+## Résultats d’analyses
+
+Dans **Ajouter → Résultats analyses**, choisissez un modèle adapté à l’espèce — bilan complet, rénal, hépatique ou thyroïdien — et saisissez les valeurs. La touche Tab suit les paramètres verticalement pour accélérer la saisie.
+
+Les intervalles configurés dans **Paramètres → Valeurs de référence** préremplissent les bornes et unités. Une valeur hors intervalle apparaît comme telle, mais Globinours ne pose aucun diagnostic. Les références propres au compte-rendu ou à la machine de la clinique priment toujours sur les valeurs initiales du logiciel.
+
+## Dépenses et coût estimé
+
+Dans **Ajouter → Dépense vétérinaire**, sélectionnez la structure, l’acte tarifé ou un intitulé libre, puis le prix et la remise applicables. Globinours conserve le prix catalogue, la réduction et le coût net au moment de l’enregistrement : une modification future du tarif ne réécrit pas l’historique.
+
+La fiche affiche une carte **Coût vétérinaire estimé**. Les statistiques consolident ensuite ces dépenses par structure, catégorie, période et commune d’origine.
+
+## Choisir vétérinaire et structure
+
+Un vétérinaire personne peut être rattaché à son cabinet dans l’annuaire. Le sélectionner complète automatiquement sa structure. Inversement, choisir d’abord une structure limite la liste aux vétérinaires compatibles.
+
+---
+
+[← Portées et liens](03-portees-et-liens.md) · [Tournées →](05-tournees.md)

docs/05-tournees.md

@@ -0,0 +1,37 @@
+# 5. Tournées de soins
+
+[← Suivi médical](04-suivi-medical.md) · [Sommaire](README.md) · [Annuaire →](06-annuaire.md)
+
+La page **Tournée** est conçue pour une utilisation tactile rapide, le matin ou le soir.
+
+## Avant de commencer
+
+Choisissez la date et la période **Matin** ou **Soir**. Les traitements actifs et leur programmation indiquent les soins ou médicaments attendus pour ce passage. Un symbole de médicament apparaît à côté du nom lorsqu’une action est prévue.
+
+## Salles et box
+
+- **Salle Silver** et **Salle Twix** sont des espaces collectifs ; plusieurs animaux y apparaissent côte à côte.
+- **Infirmerie** et **Quarantaine** disposent de box modulables, avec trois modules en haut et deux en bas.
+- Un box peut accueillir plusieurs animaux.
+
+Dans **Configurer les box**, assemblez ou séparez les modules selon l’installation physique réelle, puis affectez les animaux par leur lieu de vie habituel.
+
+## Valider un animal
+
+Ouvrez sa carte et contrôlez les éléments proposés : selles, urines, alimentation, eau, état général et soins prévus. Ajoutez un commentaire uniquement s’il apporte une information utile. Une photo peut documenter une plaie ou une anomalie ; elle est versée aux médias privés.
+
+## Valider une salle collective
+
+Pour Silver et Twix, **Tout le monde va bien** valide en une fois les animaux de la salle. Utilisez cette action seulement après avoir réellement contrôlé chacun d’eux. Si un animal présente une anomalie, ouvrez plutôt sa carte et saisissez son observation séparément.
+
+## Historique
+
+Un passage entièrement normal reste enregistré pour le suivi de la tournée mais n’encombre pas l’activité de chaque animal. Une anomalie, un commentaire préoccupant ou une photo crée en revanche une trace visible sur sa fiche.
+
+## Plein écran
+
+Le mode plein écran masque les éléments inutiles sur tablette. Sortez-en avec la commande du navigateur ou de l’appareil. La date, la période et la configuration restent accessibles dans l’en-tête de la tournée.
+
+---
+
+[← Suivi médical](04-suivi-medical.md) · [Annuaire →](06-annuaire.md)

docs/06-annuaire.md

@@ -0,0 +1,41 @@
+# 6. Annuaire
+
+[← Tournées](05-tournees.md) · [Sommaire](README.md) · [Statistiques et administratif →](07-statistiques-et-administratif.md)
+
+L’annuaire centralise les personnes et structures afin d’éviter de ressaisir leurs coordonnées dans chaque adoption, placement ou acte médical.
+
+## Personnes et structures
+
+Les rôles comprennent notamment : adoptant, bénévole, dirigeant, déposant, famille d’accueil et vétérinaire. Les structures comprennent les cabinets vétérinaires, crématoriums et fourrières. Une personne peut cumuler plusieurs rôles.
+
+Une personne peut être rattachée à une structure, par exemple un vétérinaire à son cabinet. Une structure ne doit pas être rattachée à une autre structure par ce champ.
+
+## Créer ou modifier un contact
+
+Recherchez d’abord son nom, son téléphone ou son courriel. Si aucun résultat ne correspond, choisissez **Ajouter** et sélectionnez le ou les rôles appropriés. Les rôles sont classés alphabétiquement dans les listes.
+
+Les contacts peuvent aussi être créés à la volée depuis une adoption ou une action médicale. Complétez ensuite leur fiche depuis l’annuaire si nécessaire.
+
+## Consulter une fiche
+
+Toute la ligne du contact est cliquable. Selon son rôle, la fiche présente :
+
+- les animaux adoptés, y compris ceux aujourd’hui archivés ou décédés ;
+- les accueils en famille d’accueil, séparés des adoptions ;
+- les animaux déposés ;
+- les dépenses rattachées à une structure partenaire ;
+- les relations médicales connues.
+
+Le nombre d’adoptions apparaît dans le listing des adoptants. Pour une structure, la fiche peut reprendre la période et la commune choisies dans les statistiques afin d’expliquer exactement le montant affiché.
+
+## Éviter et corriger les doublons
+
+Les variantes de casse, d’accents ou d’ordre prénom/nom peuvent désigner la même personne. Ne fusionnez pas manuellement deux personnes seulement parce que leurs noms se ressemblent : comparez coordonnées et animaux liés. Les outils de rapprochement administratifs effectuent une simulation et une sauvegarde avant toute fusion contrôlée.
+
+## Données personnelles
+
+Limitez les coordonnées à ce qui est nécessaire au refuge. N’écrivez pas d’information médicale humaine ni de commentaire subjectif. Les fonctions d’export et d’anonymisation se trouvent dans **Paramètres → Confidentialité/RGPD** et sont réservées aux administrateurs.
+
+---
+
+[← Tournées](05-tournees.md) · [Statistiques et administratif →](07-statistiques-et-administratif.md)

docs/07-statistiques-et-administratif.md

@@ -0,0 +1,51 @@
+# 7. Statistiques, administratif et subventions
+
+[← Annuaire](06-annuaire.md) · [Sommaire](README.md) · [Documents et site public →](08-documents-et-site-public.md)
+
+## Choisir le bon écran
+
+- Le **Dashboard** montre les priorités actuelles.
+- **Statistiques** analyse l’activité et les coûts.
+- **Administratif** produit le registre, les exports et les dossiers annuels.
+
+## Statistiques
+
+Sélectionnez une année ou **Toutes les années**. Une année affiche sa comparaison avec l’année précédente. La vue globale produit une évolution sur toutes les années sans inventer de date pour les événements historiques imprécis.
+
+Les indicateurs couvrent notamment : animaux distincts pris en charge, entrées, sorties, adoptions, décès, naissances, activité médicale, vaccinations, traitements, sexes, âges, espèces, races, robes, origines et délai d’adoption.
+
+Le nombre d’animaux pris en charge n’est pas la somme brute des événements : un même animal peut avoir plusieurs actes sans être compté plusieurs fois.
+
+## Filtrer par commune
+
+La commune représente l’origine ou le lieu de récupération de l’animal, jamais l’adresse de la famille d’accueil ni du cabinet. Cliquez sur une commune ou utilisez le filtre pour recalculer la page. Cette vue sert notamment à chiffrer l’activité réalisée pour une collectivité.
+
+Les anciens dossiers sans commune fiable restent dans les totaux généraux, mais ne sont pas attribués arbitrairement à une ville.
+
+## Analyser les coûts
+
+Les dépenses peuvent être réparties par structure et par catégorie. Le tableau indique total, animaux concernés, moyenne et médiane. Cliquez sur une structure pour ouvrir sa fiche avec la même année et la même commune : le détail permet de vérifier les actes avant de présenter un montant à un partenaire.
+
+Le coût moyen sur tous les animaux du périmètre et celui sur les seuls animaux ayant généré des frais répondent à deux questions différentes ; conservez leurs libellés dans toute communication de subvention.
+
+## Registre et exports
+
+L’espace Administratif permet de consulter et imprimer le registre des entrées et sorties. Les exports produisent des fichiers de travail ou de portabilité. Un export n’est pas une sauvegarde complète : il ne remplace pas la procédure de sauvegarde ZIP.
+
+Les données exportées peuvent contenir des informations personnelles. Stockez-les dans un emplacement protégé et supprimez les copies devenues inutiles.
+
+## Subventions et bilans
+
+Dans **Administratif → Subventions et bilans**, choisissez l’année puis complétez : effectifs associatifs, rapport d’activité, projets, données financières et demandes par organisme. Les chiffres issus de Globinours sont calculés automatiquement ; les informations comptables externes restent à saisir.
+
+La checklist documentaire suit les statuts manquant, valide, proche de l’expiration ou expiré. Les justificatifs sont privés et inclus dans les sauvegardes. La synthèse imprimable peut être enregistrée en PDF depuis le navigateur.
+
+Globinours prépare le socle commun, mais ne remplit pas automatiquement tous les formulaires officiels : leur contenu change selon les communes et les années.
+
+## Comprendre les données historiques
+
+Une donnée sans année certaine compte dans le total historique lorsque son existence est démontrée, mais pas dans une courbe annuelle. Ce principe explique qu’un total « Toutes les années » puisse dépasser la somme des années visibles. Il protège les statistiques contre les fausses dates créées pour combler un manque d’archives.
+
+---
+
+[← Annuaire](06-annuaire.md) · [Documents et site public →](08-documents-et-site-public.md)

docs/08-documents-et-site-public.md

@@ -0,0 +1,45 @@
+# 8. Documents et mini-site public
+
+[← Statistiques et administratif](07-statistiques-et-administratif.md) · [Sommaire](README.md) · [Utilisateurs et RGPD →](09-utilisateurs-et-rgpd.md)
+
+## Documents administratifs vierges
+
+Dans **Administratif**, ouvrez la liste des documents pour télécharger un modèle ODT ou afficher sa version imprimable. Les modèles vierges servent lorsqu’aucun animal n’est encore sélectionné.
+
+## Documents préremplis d’un animal
+
+Dans la fiche animale, ouvrez **Plus → Documents**. Les contrats et formulaires proposés reprennent les informations structurées de la fiche. Vérifiez systématiquement le nom, l’identification, la race, la robe, l’adoptant et les dates avant impression.
+
+Le fichier ODT reste modifiable dans une suite bureautique. La version PDF/HTML est destinée à la visualisation ou l’impression. Les documents générés portent une mention de génération afin d’identifier leur date et leur origine.
+
+## Activer le mini-site
+
+Dans **Paramètres → Site public**, activez le site, choisissez son thème et complétez les contenus : accueil, présentation libre, dons, contact et mentions légales. Trois thèmes légers sont fournis.
+
+Deux modes existent :
+
+- **intégré** : le site est disponible sous `/site` ;
+- **domaine public** : le site occupe `/` et l’application interne reste accessible par `/gestion`.
+
+## Publier un animal
+
+Une fiche publique apparaît uniquement si l’animal est à la fois :
+
+1. disponible à l’adoption ;
+2. autorisé à être publié sur le mini-site.
+
+Au moins une photo doit être publique pour illustrer correctement la fiche. Les données privées — identification, médical, lieux internes, coordonnées de FA, notes et documents — ne sont jamais chargées par les pages publiques.
+
+## Pages publiques
+
+Le menu présente directement les espèces publiées, puis les pages de texte, dons et contact. Le pied de page utilise l’adresse complète, le RNA et le SIRET configurés. La page Contact affiche une carte positionnée sur l’adresse de l’association ; la bibliothèque cartographique est locale mais les tuiles OpenStreetMap nécessitent Internet.
+
+Le téléphone et le courriel bénéficient d’une obfuscation CSS légère contre les robots simples. Cela ne remplace ni une politique antispam ni une adresse dédiée au public.
+
+## Mentions légales et confidentialité
+
+Des contenus FR/EN préremplis sont proposés, mais l’association reste responsable de leur exactitude. Complétez l’hébergeur, le responsable de publication, les finalités du formulaire éventuel et les coordonnées adaptées avant mise en ligne.
+
+---
+
+[← Statistiques et administratif](07-statistiques-et-administratif.md) · [Utilisateurs et RGPD →](09-utilisateurs-et-rgpd.md)

docs/09-utilisateurs-et-rgpd.md

@@ -0,0 +1,48 @@
+# 9. Utilisateurs, rôles et confidentialité
+
+[← Documents et site public](08-documents-et-site-public.md) · [Sommaire](README.md) · [Paramètres →](10-parametres.md)
+
+## Créer les comptes
+
+Dans **Paramètres → Utilisateurs**, créez un compte nominatif par personne. Ne partagez pas un compte d’équipe : l’historique et l’audit doivent pouvoir attribuer une action à son auteur réel.
+
+Les mots de passe sont hachés et leur validation est affichée dans l’interface. Un administrateur ne doit jamais demander à connaître le mot de passe d’un utilisateur.
+
+## Rôles et permissions
+
+Les groupes fournis sont **Administrateur**, **Responsable**, **Bénévole** et **Lecture seule**. Dans **Rôles et permissions**, chaque module distingue :
+
+- **Voir** : consulter les informations ;
+- **Modifier** : créer ou changer des données.
+
+Les permissions portent sur un groupe, jamais sur une personne isolée. Les administrateurs conservent tous les droits. Le module médical exige également l’accès en lecture aux animaux.
+
+Appliquez le principe du moindre privilège : un bénévole chargé des tournées n’a pas nécessairement besoin des exports administratifs ou des coordonnées complètes de l’annuaire.
+
+## Appareils de confiance
+
+Une session persistante peut reconnaître un appareil pendant une durée limitée sans enregistrer le mot de passe. Depuis la page des appareils du compte, révoquez un appareil perdu, revendu ou partagé. La révocation globale déconnecte les appareils concernés.
+
+## Journal d’audit
+
+**Paramètres → Audit** retrace les actions importantes : auteur, date, type d’action et objet. L’audit aide à comprendre une correction ou une suppression ; il ne remplace pas une sauvegarde.
+
+## Confidentialité/RGPD
+
+Dans **Paramètres → Confidentialité/RGPD**, configurez la durée de conservation indicative et examinez les contacts à revoir. Globinours ne supprime pas automatiquement les dossiers arrivés à échéance : une décision humaine reste nécessaire.
+
+Pour un contact, les outils permettent :
+
+- d’exporter les données le concernant ;
+- de lancer une anonymisation contrôlée ;
+- de préserver les statistiques agrégées sans conserver inutilement son identité.
+
+L’anonymisation demande un motif et déclenche une sauvegarde préalable. Vérifiez les obligations légales, comptables, contractuelles et de protection animale avant de l’utiliser.
+
+## Fichiers privés
+
+Les ordonnances, analyses, justificatifs et médias privés sont servis par des routes contrôlées. Leur consultation est journalisée. Ne contournez pas cette protection en copiant les fichiers dans un dossier public ou dans un ticket Forgejo.
+
+---
+
+[← Documents et site public](08-documents-et-site-public.md) · [Paramètres →](10-parametres.md)

docs/10-parametres.md

@@ -0,0 +1,43 @@
+# 10. Paramètres et référentiels
+
+[← Utilisateurs et RGPD](09-utilisateurs-et-rgpd.md) · [Sommaire](README.md) · [Sauvegardes et maintenance →](11-sauvegardes-et-maintenance.md)
+
+La roue crantée et la barre interne utilisent les mêmes catégories : **Configuration**, **Référentiels métier**, **Accès** et **Maintenance**.
+
+## Paramètres généraux
+
+Renseignez l’identité de l’association : nom, coordonnées, adresse, RNA, SIRET, logo, langue et tarifs d’adoption. Ces valeurs alimentent l’interface, le mini-site et les documents générés.
+
+Le logo de l’association est une donnée propre à l’installation. Le logo Globinours reste l’identité du logiciel.
+
+## Espèces
+
+Le référentiel des espèces contrôle les choix des fiches et la navigation du site public. Chaque entrée peut disposer d’un nom, d’une catégorie, d’une icône, d’une couleur et d’un état actif. Désactivez une espèce inutilisée plutôt que de supprimer une valeur déjà liée à des animaux.
+
+## Tarifs
+
+Les structures éligibles sont les cabinets vétérinaires, crématoriums et fourrières de l’annuaire. Pour chacune, configurez les actes, produits, prix et remises. Les intitulés peuvent être ajoutés à la volée.
+
+Les tarifs servent à préremplir une dépense, mais la dépense enregistrée garde son propre instantané financier. Modifiez donc un ancien acte sur la fiche concernée plutôt que son référentiel si vous corrigez une facture passée.
+
+## Valeurs de référence biologiques
+
+Configurez les intervalles par analyseur, bilan, paramètre et espèce. Les valeurs fournies servent d’aide visuelle, pas de diagnostic. Si une clinique a personnalisé sa machine, saisissez les bornes imprimées sur ses comptes-rendus.
+
+Une absence d’intervalle constructeur doit rester vide. Ne créez pas une plage simplement pour obtenir un affichage vert ou rouge.
+
+## Site public
+
+Cette rubrique gère l’activation, le mode d’URL, le thème, les textes et les pages légales. Consultez le chapitre [Documents et mini-site public](08-documents-et-site-public.md) avant la première publication.
+
+## Santé et notifications
+
+La page Santé vérifie les prérequis, les répertoires, SQLite et les composants utiles. Les notifications configurées complètent le Dashboard pour les rappels prévus par l’installation.
+
+## Données et démonstration
+
+Les outils de données permettent de charger un jeu factice ou de vider les données métier. Ils exigent une phrase de confirmation traduite exactement dans la langue active. Ces fonctions sont destructives : créez et téléchargez une sauvegarde avant toute utilisation.
+
+---
+
+[← Utilisateurs et RGPD](09-utilisateurs-et-rgpd.md) · [Sauvegardes et maintenance →](11-sauvegardes-et-maintenance.md)

docs/11-sauvegardes-et-maintenance.md

@@ -0,0 +1,57 @@
+# 11. Sauvegardes, import ASM3 et maintenance
+
+[← Paramètres](10-parametres.md) · [Sommaire](README.md) · [Mobile →](12-mobile.md)
+
+## Créer une sauvegarde
+
+Dans **Paramètres → Sauvegardes**, créez une archive ZIP puis téléchargez-en régulièrement une copie hors du serveur. Une sauvegarde complète inclut la base SQLite et les fichiers privés nécessaires à la restauration.
+
+Conservez plusieurs générations sur un support séparé. Une archive stockée uniquement sur le même disque ne protège pas contre sa panne.
+
+## Restaurer
+
+La restauration remplace des données actuelles par le contenu de l’archive. Avant de confirmer :
+
+1. vérifiez la provenance et la date du fichier ;
+2. prévenez les utilisateurs et interrompez les saisies ;
+3. créez une sauvegarde de l’état actuel ;
+4. restaurez puis contrôlez la page Santé, les animaux récents et les médias.
+
+Globinours crée une sauvegarde d’urgence lors des opérations sensibles prévues, mais cette protection ne dispense pas d’une copie externe.
+
+## Importer Animal Shelter Manager 3
+
+Dans **Paramètres → Migration ASM3**, déposez un dump SQL ou PostgreSQL. L’assistant commence par analyser le format, les volumes et ambiguïtés. Lisez le rapport avant l’import.
+
+Deux modes sont disponibles :
+
+- **Fusionner** conserve les données Globinours et ajoute les correspondances sûres ;
+- **Remplacer les données métier** efface animaux, annuaire et historique opérationnel avant import, tout en conservant comptes et configuration.
+
+Le remplacement est réservé à une installation de test ou une migration initiale. Il exige une phrase de confirmation et ne doit jamais être lancé pendant que d’autres personnes travaillent.
+
+L’import est transactionnel : une erreur annule ses écritures. Une sauvegarde est créée au préalable. Les ambiguïtés ne doivent pas être forcées automatiquement ; corrigez-les à partir des rapports produits.
+
+## Photos ASM3
+
+Les dumps ASM3 peuvent ne contenir que les références des médias. Les fichiers physiques doivent alors être fournis séparément et rapprochés avec les tables `media` et `dbfs`. L’import dédié vérifie les images, conserve les médias existants et reprend la photo principale lorsqu’elle est identifiable.
+
+## Mise à jour de Globinours
+
+Suivez le guide de déploiement fourni avec la version utilisée. Une mise à jour sûre comprend au minimum : sauvegarde, validation de l’archive, activation de la maintenance, remplacement du code, migrations, contrôle SQLite et possibilité de retour à la version précédente.
+
+Ne copiez jamais une base réelle, un `.env`, les médias privés ou une sauvegarde dans un dépôt Git.
+
+## Contrôles après maintenance
+
+- connexion et permissions ;
+- page **Paramètres → Santé** ;
+- ouverture d’une fiche active et d’une archive ;
+- affichage d’une photo privée autorisée ;
+- création puis suppression d’une donnée de test si le contexte le permet ;
+- sauvegarde téléchargeable ;
+- mini-site public sans information privée.
+
+---
+
+[← Paramètres](10-parametres.md) · [Mobile →](12-mobile.md)

docs/12-mobile.md

@@ -0,0 +1,36 @@
+# 12. Mobile, PWA et application Android
+
+[← Sauvegardes et maintenance](11-sauvegardes-et-maintenance.md) · [Sommaire](README.md) · [FAQ →](13-faq.md)
+
+## Interface responsive
+
+Globinours adapte ses listes, cartes, onglets et formulaires aux ordinateurs, tablettes et téléphones. Le mode Tournée est particulièrement pensé pour la tablette, mais les autres fonctions restent disponibles selon les permissions.
+
+## Installer la PWA
+
+Sur un navigateur compatible, utilisez **Installer l’application** ou **Ajouter à l’écran d’accueil**. La PWA ouvre Globinours comme une application mais utilise toujours le serveur de l’association.
+
+Elle ne conserve pas de copie locale des animaux. Sans réseau vers l’instance, les données métier ne sont pas accessibles. Les bibliothèques d’interface sont embarquées localement ; la cartographie et les intégrations externes peuvent toutefois nécessiter Internet.
+
+## Application Android
+
+L’application Android est un wrapper sécurisé de l’instance web, pas une seconde version de Globinours. Au premier lancement :
+
+1. saisissez l’adresse HTTPS complète de votre instance ;
+2. vérifiez soigneusement le domaine ;
+3. connectez-vous dans l’interface Globinours ;
+4. activez la protection biométrique ou le code de l’appareil si elle est proposée.
+
+La WebView reste limitée au domaine choisi. Le mot de passe n’est pas enregistré par l’application ; la connexion persistante repose sur la session délivrée par Globinours.
+
+## Sécurité de l’appareil
+
+- Utilisez un verrouillage Android robuste.
+- N’installez un APK que depuis la source officielle du projet ou de votre administrateur.
+- Révoquez l’appareil depuis votre compte s’il est perdu.
+- N’utilisez pas l’application sur un téléphone partagé sans déconnexion.
+- N’acceptez jamais un certificat HTTPS invalide.
+
+---
+
+[← Sauvegardes et maintenance](11-sauvegardes-et-maintenance.md) · [FAQ →](13-faq.md)

docs/13-faq.md

@@ -0,0 +1,51 @@
+# 13. FAQ et dépannage
+
+[← Mobile](12-mobile.md) · [Sommaire](README.md)
+
+## Je ne vois pas un menu ou un bouton
+
+Votre rôle ne possède probablement pas le droit de voir ou modifier ce module. Demandez à un administrateur de vérifier **Paramètres → Rôles et permissions**. Une URL directe ne contourne pas ces droits.
+
+## Un animal a disparu du listing
+
+Recherchez-le dans **Archives**, puis dans **Corbeille**. Une adoption ou un décès l’archive normalement. Une fiche en corbeille ne compte plus dans les statistiques.
+
+## Une statistique globale dépasse la somme des années
+
+Des événements historiques sont connus sans date ou année certaine. Ils comptent dans **Toutes les années**, mais Globinours refuse de les placer arbitrairement dans une courbe annuelle.
+
+## La carte n’affiche rien
+
+Vérifiez que l’adresse ou les coordonnées sont renseignées. La bibliothèque Leaflet est locale, mais les tuiles OpenStreetMap et la recherche d’adresse nécessitent un accès réseau. Un blocage 403 peut également provenir d’un proxy ou d’une politique réseau.
+
+## Une photo ne s’affiche pas sur le site public
+
+Vérifiez les trois conditions : animal disponible, publication de l’animal autorisée et photo marquée publique. Une photo privée ne doit jamais être rendue publique automatiquement.
+
+## Je ne peux pas ouvrir un document privé
+
+Vérifiez votre accès au module médical ou administratif et l’existence du fichier. Consultez **Paramètres → Santé**. Ne déplacez pas manuellement le document dans `public/`.
+
+## Une restauration ou un import échoue
+
+Arrêtez les autres saisies, conservez le message exact et consultez la page Santé ainsi que les journaux serveur. Ne relancez pas en boucle un remplacement ASM3. L’opération transactionnelle ne conserve normalement aucune écriture partielle.
+
+## Le serveur affiche « could not find driver »
+
+L’extension PDO SQLite de PHP manque. Installez le paquet correspondant à votre version de PHP, activez-le pour le mode web utilisé, puis redémarrez PHP-FPM ou le service concerné.
+
+## Le calendrier est en anglais
+
+Vérifiez la langue dans **Paramètres généraux** et videz le cache du navigateur après une mise à jour. Les sélecteurs de date Globinours utilisent normalement le français et le format `JJ/MM/AAAA` en interface française.
+
+## Puis-je travailler sans Internet ?
+
+Oui si votre appareil peut joindre le serveur Globinours sur le réseau local. Les fonctions internes et bibliothèques d’interface sont locales. Les cartes, tuiles et services externes restent indisponibles sans Internet.
+
+## Comment demander de l’aide ?
+
+Indiquez la version du pied de page, la page, l’action, le rôle de votre compte et le message exact. Masquez noms, adresses, identifications, documents et données médicales avant toute capture publique.
+
+---
+
+[← Mobile](12-mobile.md) · [Retour au sommaire](README.md)

docs/14-agenda.md

@@ -0,0 +1,60 @@
+# Agenda partagé
+
+[← Tournées de soins](05-tournees.md) · [Sommaire](README.md) · [Annuaire →](06-annuaire.md)
+
+L’agenda se trouve dans la navigation principale, entre **Tournée** et **Statistiques**. Sa visibilité et sa modification dépendent des permissions du groupe utilisateur.
+
+## Lire le calendrier
+
+Les boutons **Mois** et **Semaine** changent la présentation ; Globinours mémorise ce choix pour chaque utilisateur. Les flèches changent de période et **Aujourd’hui** revient immédiatement à la période courante. Chaque événement présente son heure, son titre et l’animal éventuellement lié. La table inférieure rassemble les trente prochains jours et permet de terminer rapidement une tâche.
+
+Cliquez dans l’espace libre d’une journée pour ouvrir directement le formulaire avec cette date déjà renseignée. Le petit `+` apparaît au survol. Au clavier, placez le focus sur la case puis utilisez Entrée ou Espace. Cliquer sur un événement existant conserve son action habituelle.
+
+Les rappels de vaccins, les prochains vermifuges et les débuts ou fins de traitements apparaissent automatiquement avec leur propre couleur. Ils ouvrent la section médicale concernée et ne se modifient pas depuis l’agenda.
+
+Les filtres permettent d’afficher **Toute l’équipe** ou **Mon agenda**, puis de cibler un responsable, un bénévole, une catégorie ou un texte présent dans la mission, l’animal, le lieu ou le nom d’une personne. Les échéances médicales automatiques peuvent être masquées temporairement. Les filtres restent actifs lorsque vous changez de semaine ou de mois et s’appliquent aussi à l’export ponctuel.
+
+## Exporter ou synchroniser
+
+**Exporter en .ics** télécharge uniquement le mois ou la semaine affichée. Le fichier peut être ouvert dans Google Agenda, Outlook, Apple Calendrier ou Thunderbird.
+
+Pour une mise à jour automatique, ouvrez **Abonnement à l’agenda**, puis créez votre lien privé. Copiez-le immédiatement dans la fonction d’abonnement par URL de votre application de calendrier : Globinours ne l’affiche qu’une seule fois et ne conserve que son empreinte cryptographique.
+
+Ce lien donne accès à l’agenda sans demander de connexion afin que le téléphone puisse le synchroniser en arrière-plan. Il doit donc rester secret. **Régénérer le lien** invalide l’ancienne adresse et en fournit une nouvelle ; **Révoquer le lien** coupe immédiatement la synchronisation. Le flux couvre les 90 derniers jours et les 365 prochains jours.
+
+## Ajouter un élément
+
+Cliquez sur **Ajouter un événement**, puis choisissez le type :
+
+- rendez-vous ;
+- rendez-vous vétérinaire ;
+- transport ;
+- visite pré-adoption ;
+- tâche ;
+- autre.
+
+Indiquez au minimum un titre, une date et une heure, ou cochez **Toute la journée**. Vous pouvez ensuite ajouter un lieu, une description, une priorité, un responsable, un animal et un contact de l’annuaire.
+
+Le responsable est un utilisateur de Globinours chargé du suivi. Les **bénévoles mobilisés** sont sélectionnés séparément parmi les personnes ayant le rôle Bénévole dans l’annuaire ; plusieurs personnes peuvent participer à la même mission sans disposer d’un compte. Leur nom apparaît directement avec la mission. Si un responsable ou un bénévole possède déjà une autre mission sur le même créneau, Globinours enregistre l’événement mais affiche un avertissement afin de laisser l’équipe arbitrer.
+
+## Rappels et répétitions
+
+Le rappel peut être fixé à l’heure prévue, trente minutes, une heure, un jour, deux jours ou une semaine avant. Les éléments sous vingt-quatre heures sont visibles sur le dashboard et dans le résumé des notifications.
+
+Une répétition quotidienne, hebdomadaire ou mensuelle peut être limitée par une date. Globinours développe les occurrences dans le calendrier sans copier l’événement dans la base.
+
+## Terminer ou annuler
+
+Le bouton ✓ de la liste marque l’élément comme terminé et conserve l’utilisateur ayant effectué l’action. Un événement peut également être modifié ou annulé. Les événements annulés ne sont plus affichés dans le calendrier courant.
+
+## Bonnes pratiques
+
+- liez toujours un rendez-vous à l’animal concerné ;
+- attribuez les transports et visites à une personne précise ;
+- réservez la priorité urgente aux actions qui nécessitent réellement une réaction immédiate ;
+- terminez les tâches réalisées afin de conserver un dashboard lisible ;
+- utilisez les répétitions pour les obligations organisationnelles, pas pour les traitements médicaux déjà gérés dans leur module dédié.
+
+---
+
+[← Tournées de soins](05-tournees.md) · [Sommaire](README.md) · [Annuaire →](06-annuaire.md)

docs/15-audit-structure-fichiers.md

@@ -0,0 +1,60 @@
+# Audit des fichiers du projet
+
+Audit réalisé le 31 août 2026. Les éléments non applicatifs ont ensuite été déplacés, sans suppression, vers le dossier voisin `ARCHIVES/Globinours-recuperation-2026/`.
+
+## Résumé
+
+Le cœur déployable de Globinours est désormais séparé de ses données temporaires. Les **612 Mo** de travail historique ont quitté `Twix Codex`, qui ne représente plus qu’environ **130 Mo** avec ses données et sauvegardes locales.
+
+## Éléments indispensables
+
+- `app/`, `public/`, `resources/` : code, interface et ressources livrées ;
+- `migrations/` : **indispensable**. Les 81 fichiers SQL correspondent aux 81 migrations enregistrées dans `_migrations`. Ils reconstruisent une installation neuve et mettent à niveau les anciennes bases ;
+- `data/refuge.sqlite` et les médias présents dans `data/` ou `public/media/` : données de l’instance ;
+- `storage/` : sauvegardes, journaux, rapports et dumps ASM3 encore associés aux travaux d’import ;
+- `scripts/`, `deploy/`, `tests/` et `docs/` : maintenance, déploiement, contrôles et documentation.
+
+## Doublons confirmés
+
+Les comparaisons récursives ne montrent aucune différence entre :
+
+- `tmp/Website/` et le projet voisin `Website/` ;
+- `tmp/repositories/Android/` et le projet voisin `Android/` ;
+- `tmp/repositories/yunohost/` et le projet voisin `yunohost/`.
+
+Les trois copies placées dans `tmp/` étaient donc redondantes. Elles sont conservées dans l’archive de récupération, sans toucher aux projets voisins.
+
+## Données temporaires historiques
+
+| Élément | Taille approximative | Conclusion |
+|---|---:|---|
+| `tmp/recup_chat/` | 580 Mo | Sources PDF/CSV de la récupération historique. Non nécessaires au fonctionnement quotidien, mais à conserver ailleurs tant que la récupération n’est pas officiellement clôturée. |
+| `tmp/recup_photo/` | 24 Mo | Anciennes photos ASM3 déjà importées. Non nécessaires à l’exécution ; archivage externe conseillé avant suppression. |
+| `tmp/dump_asm3.sql` | 5 Mo | Copie de travail d’un dump déjà importé. Les scripts historiques le prennent encore comme chemin par défaut ; mieux vaut rendre leur argument obligatoire avant suppression définitive. |
+| rapports et simulations `tmp/*.json` / `tmp/*.md` | moins de 300 Ko | Traces de migration utiles uniquement pour l’audit historique. |
+| `tmp/test/` | 156 Ko | Documents de test, non nécessaires en production. |
+
+`tmp/` est maintenant vide, hormis son éventuel fichier `.gitkeep`, et reste entièrement ignoré par Git. Il ne doit jamais être copié dans un paquet de production. Les scripts historiques exigent désormais un chemin source explicite et ne dépendent plus de sa présence.
+
+## Stockage applicatif
+
+- `storage/backups/` : environ 88 Mo. Ce ne sont pas des doublons de code mais de vraies sauvegardes ; définir une politique de rotation avant nettoyage.
+- `storage/asm3-imports/` : environ 25 Mo pour cinq imports. Trois travaux sont encore marqués `failed` ou `analyzed`, deux seulement étant finalisés ou analysés. Ces fichiers doivent être nettoyés depuis une fonction applicative qui synchronise également `asm3_import_jobs`, pas manuellement.
+- `storage/logs/` et `storage/reports/` : petits et utiles au diagnostic.
+
+## Dossiers vides
+
+Les anciens dossiers vides `conf/` et `doc/`, distincts des vrais dossiers `deploy/` et `docs/`, ont été retirés lors du nettoyage pré-1.0 du 2 septembre 2026.
+
+## Nettoyage réalisé et suite recommandée
+
+1. ✅ copies de travail et sources historiques déplacées vers `ARCHIVES/Globinours-recuperation-2026/` ;
+2. ✅ chemins des anciens scripts rendus obligatoires au lieu de dépendre de `tmp/` ;
+3. protéger l’archive externe, car elle contient des documents et données personnelles historiques ;
+4. ajouter une politique de rotation des sauvegardes et une suppression contrôlée des imports ASM3 ;
+5. ✅ dossiers réellement vides `conf/` et `doc/` retirés ;
+6. conserver sans exception tous les fichiers `migrations/*.sql`.
+
+## Nettoyage pré-1.0 du 2 septembre 2026
+
+Le script historique `architecture.sh` et les trois tableurs ponctuels revenus dans `tmp/` ont été déplacés sans suppression vers `ARCHIVES/Globinours-nettoyage-pre-1.0-20260902/`. Le dossier `tmp/` ne contient plus que son fichier `.gitkeep`.

docs/ANALYSE_SUBVENTIONS.md

@@ -0,0 +1,108 @@
+# Analyse des dossiers de subvention
+
+Analyse réalisée à partir des dossiers communaux et des pièces justificatives placés temporairement dans `tmp/`. Cette synthèse ne reprend aucune donnée bancaire ni coordonnée personnelle issue des fichiers.
+
+## Constat
+
+Les communes utilisent des présentations différentes, mais demandent un socle largement commun. Globinours ne doit donc pas reproduire chaque formulaire : il doit conserver une fiche annuelle structurée, calculer les indicateurs disponibles et produire une synthèse réutilisable pour chaque organisme.
+
+Les modèles analysés datent principalement de 2022. Les champs et pièces devront rester configurables afin d’intégrer les futures versions des communes.
+
+## Noyau commun
+
+### Identité et vie statutaire
+
+- nom, objet, activité, siège, téléphone, courriel et site ;
+- RNA/récépissé, SIRET, date de création et date de déclaration ;
+- affiliation, fédération et agréments éventuels ;
+- président, secrétaire, trésorier, personne chargée du dossier et membres du bureau ;
+- date de la dernière assemblée générale.
+
+### Moyens humains
+
+- adhérents, parfois ventilés par commune, âge et sexe ;
+- montant des cotisations ;
+- bénévoles réguliers et valorisation du bénévolat ;
+- salariés, type de contrat et équivalent temps plein ;
+- informations sportives non pertinentes pour le refuge, à pouvoir marquer « sans objet ».
+
+### Activité et projet
+
+- rapport d’activité de l’exercice précédent ;
+- actions et manifestations passées et prévues ;
+- publics bénéficiaires et participation à la vie locale ;
+- description, calendrier, objectifs et budget d’un projet particulier ;
+- moyens ou avantages en nature accordés par la commune ;
+- montant demandé, montant reçu l’année précédente et autres demandes publiques.
+
+### Finances
+
+- compte de résultat ou bilan financier de l’exercice précédent ;
+- budget prévisionnel de l’exercice courant ;
+- trésorerie et soldes bancaires à la clôture ;
+- charges et produits selon les catégories comptables associatives 60 à 78 ;
+- contributions volontaires en nature, comptes 86 et 87 ;
+- aides publiques cumulées sur les trois derniers exercices ;
+- certification de sincérité, régularité sociale et fiscale.
+
+## Pièces justificatives
+
+### Permanentes ou rarement renouvelées
+
+- statuts signés ;
+- récépissé de déclaration en préfecture ;
+- publication au Journal officiel ;
+- relevé d’identité bancaire ;
+- composition du bureau.
+
+### À renouveler
+
+- attestation d’assurance avec date de validité ;
+- procès-verbal de la dernière assemblée générale ;
+- rapport d’activité et rapport moral ;
+- comptes, bilan financier et compte de résultat ;
+- budget prévisionnel ;
+- relevés ou attestation des soldes bancaires.
+
+### Selon la commune ou le projet
+
+- liste des adhérents résidant dans la commune ;
+- convention de mise à disposition d’une salle ;
+- lettre motivant la demande ;
+- contrat d’engagement républicain ;
+- devis et budget d’une action ;
+- justificatifs de demandes adressées à d’autres communes ;
+- revue de presse ou supports présentant l’activité.
+
+## Données calculables par Globinours
+
+- entrées, sorties, adoptions et animaux encore pris en charge ;
+- adultes, chatons, sexes, statuts et lieux d’accueil ;
+- portées et chatons accueillis ;
+- soins, traitements, vaccinations et stérilisations ;
+- décès, causes, euthanasies et contexte de prise en charge ;
+- durées de séjour et activité par période ;
+- animaux confiés ou récupérés par commune lorsque l’origine est correctement renseignée.
+
+## Données à saisir ou importer
+
+- comptabilité et trésorerie ;
+- adhérents, bénévoles, salariés et temps consacré ;
+- manifestations, actions locales et rapports narratifs ;
+- subventions demandées, obtenues ou refusées ;
+- avantages en nature et moyens municipaux ;
+- dates de validité et versions des pièces justificatives.
+
+## Module recommandé
+
+1. **Profil administratif enrichi** : identité légale, objet, dirigeants et vie statutaire.
+2. **Exercices annuels** : effectifs humains, rapport d’activité, événements et commentaires.
+3. **Synthèse comptable** : compte de résultat, budget prévisionnel, trésorerie et bénévolat valorisé, sans chercher à remplacer un logiciel comptable complet.
+4. **Demandes de subvention** : organisme, année, date limite, montant demandé/obtenu, état et particularités locales.
+5. **Coffre documentaire** : pièces permanentes et annuelles, validité, version et checklist par demande.
+6. **Statistiques automatiques du refuge** : chiffres annuels issus de la base avec comparaison N-1.
+7. **Sorties** : bilan imprimable, annexes CSV et dossier ZIP des pièces sélectionnées.
+
+## Règle de conception
+
+Le PDF propre à une commune reste une pièce externe à compléter lorsque son format l’impose. Globinours doit préparer les chiffres, textes et annexes communs, signaler les éléments manquants et assembler le dossier final, sans enfermer les données dans un formulaire municipal particulier.

docs/AUDIT-1.0.md

@@ -0,0 +1,47 @@
+# Audit fonctionnel — Globinours 1.0.0
+
+Audit exécuté le 30 août 2026. Les contrôles automatisés utilisent une base SQLite temporaire et ne lisent ni ne modifient la base du refuge.
+
+## Contrôles validés
+
+- reconstruction complète du schéma et application ordonnée des migrations ;
+- `PRAGMA integrity_check` et absence de relations étrangères invalides ;
+- installation initiale, authentification, hachage des mots de passe et permissions ;
+- parcours animal, note médicale, adoption et relations avec l’annuaire ;
+- référentiels biologiques chat et chien ;
+- notifications d’échéance ;
+- création d’une sauvegarde, manifeste, empreintes, extraction de la base et contrôle SQLite ;
+- pharmacie : réception, valorisation, consommation, historique et refus d’un stock négatif ;
+- export RGPD et registre des accès privés ;
+- purge à échéance du seul registre technique, sans suppression automatique des contacts ;
+- appareils de confiance et révocation ;
+- parité des catalogues français et anglais et cohérence des variables traduites ;
+- validation syntaxique des contrôleurs, services et vues modifiés.
+
+## Défauts corrigés pendant l’audit
+
+1. Le formulaire de vermifugation utilisait le champ `medication_id` et le catalogue des médicaments ; il utilise désormais `dewormer_id` et le référentiel dédié.
+2. Les actions de suppression et vérification d’une sauvegarde possèdent désormais leur jeton CSRF dans le HTML, sans dépendre de l’initialisation JavaScript.
+3. Une archive créée n’était pas relue comme un tout hors restauration ; la vérification autonome contrôle maintenant chaque empreinte et la base extraite.
+4. Une dépense médicamenteuse pouvait rester étrangère au coût de l’animal ; la consommation d’un lot tarifé crée désormais la dépense correspondante.
+
+## Validations terrain encore nécessaires
+
+Ces points dépendent d’un environnement réel et ne constituent pas des erreurs connues :
+
+- réception effective des e-mails par le serveur choisi ;
+- caméra et sélecteur de fichiers sur les modèles Android/iOS réellement utilisés ;
+- tâches cron ou timer systemd sous l’utilisateur PHP de production ;
+- restauration complète sur une copie d’installation avec ses médias réels ;
+- installation et mise à niveau du futur paquet YunoHost ;
+- ergonomie de la pharmacie avec les unités réellement employées par le refuge.
+
+## Commandes de contrôle
+
+```bash
+php tests/run.php
+php scripts/check_translations.php
+php scripts/maintenance.php run
+```
+
+Une sauvegarde de production doit toujours être téléchargée ou répliquée hors du serveur. Une archive présente uniquement sur la même machine ne protège pas d’une panne matérielle.

docs/README.md

@@ -0,0 +1,52 @@
+# Manuel d’utilisation de Globinours
+
+Bienvenue dans la documentation utilisateur de **Globinours**, le logiciel de gestion quotidienne d’un refuge animalier.
+
+Ce manuel décrit l’interface telle qu’elle existe actuellement. Il peut être lu directement dans Forgejo, téléchargé avec le projet ou consulté fichier par fichier depuis le dossier `docs/`.
+
+> Les écrans visibles dépendent du rôle et des permissions de votre compte. Une action absente de votre interface peut simplement ne pas être autorisée pour votre groupe.
+
+## Sommaire
+
+### Prendre en main Globinours
+
+1. [Premiers pas](01-premiers-pas.md) — connexion, navigation, tableau de bord et bonnes pratiques.
+2. [Animaux](02-animaux.md) — création, recherche, fiche, photos, lieux de vie, placements, adoption, décès, archives et corbeille.
+3. [Portées, fratries et animaux inséparables](03-portees-et-liens.md).
+4. [Suivi médical](04-suivi-medical.md) — notes, traitements, vaccins, vermifuges, ordonnances, analyses et dépenses.
+5. [Tournées de soins](05-tournees.md) — utilisation rapide sur tablette, salles, box et anomalies.
+6. [Agenda partagé](14-agenda.md) — rendez-vous, transports, visites, tâches, responsables et rappels.
+7. [Annuaire](06-annuaire.md) — personnes, structures, familles d’accueil, adoptants et partenaires.
+8. [Statistiques et subventions](07-statistiques-et-administratif.md) — indicateurs, coûts, communes, registre, exports et dossiers annuels.
+9. [Documents et mini-site public](08-documents-et-site-public.md).
+
+### Administrer l’installation
+
+10. [Utilisateurs, rôles et confidentialité](09-utilisateurs-et-rgpd.md).
+11. [Paramètres et référentiels](10-parametres.md).
+12. [Sauvegardes, import ASM3 et maintenance](11-sauvegardes-et-maintenance.md).
+13. [Mobile, PWA et application Android](12-mobile.md).
+14. [FAQ et dépannage](13-faq.md).
+
+## Parcours conseillés
+
+- **Je découvre le logiciel :** lisez [Premiers pas](01-premiers-pas.md), puis [Animaux](02-animaux.md).
+- **Je réalise les soins :** consultez [Suivi médical](04-suivi-medical.md) et [Tournées de soins](05-tournees.md).
+- **Je prépare un bilan :** ouvrez [Statistiques et subventions](07-statistiques-et-administratif.md).
+- **J’administre Globinours :** commencez par [Paramètres](10-parametres.md), puis [Sauvegardes et maintenance](11-sauvegardes-et-maintenance.md).
+- **Je déploie le projet :** consultez la section **Déploiement** du [README principal](../README.md) et les fichiers de déploiement fournis dans la distribution.
+
+## Conventions du manuel
+
+- Les chemins tels que **Paramètres → Sauvegardes** désignent les menus à ouvrir successivement.
+- Les libellés peuvent légèrement varier si l’interface est configurée en anglais.
+- Une action sensible signalée par Globinours doit être précédée d’une sauvegarde et relue avant confirmation.
+- Les informations médicales et personnelles ne doivent jamais être copiées vers le mini-site public.
+
+## Aide et contribution
+
+Si une procédure ne correspond plus à l’écran, ouvrez un ticket sur le dépôt du projet en indiquant la page concernée, votre rôle et la version affichée dans le pied de page. Ne joignez jamais de données personnelles, de document médical ni de sauvegarde réelle à un ticket public.
+
+---
+
+[Lire le premier chapitre →](01-premiers-pas.md)