Biblio Holy
Manuel complet de gestion de la bibliothèque
Présentation
Biblio Holy est une application web de gestion de bibliothèque paroissiale. Elle fonctionne directement dans votre navigateur, sans installation sur les postes clients. Toutes les données sont stockées sur votre serveur (NAS Synology ou hébergement web).
Fonctionnalités principales
- Catalogue de livres avec catégories, ISBN et disponibilité en temps réel
- Gestion des adhérents avec suivi des cotisations annuelles (payé / non payé)
- Enregistrement des emprunts avec scanner code-barres ISBN (USB ou caméra)
- Alertes automatiques : retards, expiration de cotisation, relances par email
- Tableau de bord avec statistiques, graphiques et alertes en un coup d'œil
- Historique complet des prêts avec export CSV
- Import en masse de livres et catégories depuis fichier CSV ou Excel (.xlsx)
- Gestion multi-utilisateurs (administrateur / bibliothécaire)
- Interface 100 % responsive, utilisable sur tablette
Rôles utilisateurs
| Rôle | Droits |
|---|---|
| 🛡️ Administrateur | Accès complet : livres, adhérents, emprunts, historique, utilisateurs, configuration |
| 📖 Bibliothécaire | Gestion des livres, adhérents, emprunts et retours — pas d'accès aux comptes utilisateurs |
Connexion
Accédez à l'application via votre navigateur à l'adresse configurée sur votre serveur (ex : http://nas.local/biblioholy/).
admin ou biblio)admin / Admin2026! et biblio / Biblio2026!. Changez-les immédiatement depuis la section Utilisateurs.Tableau de bord
La page d'accueil offre une vue synthétique de l'activité de la bibliothèque.
Cartes statistiques
Graphiques
📈 Emprunts par mois — Histogramme des 6 derniers mois (emprunts en cours + historique).
✝️ Par catégorie — Répartition en anneau des livres par catégorie.
Section cotisations non payées
Si des adhérents ont leur cotisation expirée, une section apparaît automatiquement en bas du tableau de bord avec :
- La liste de tous les adhérents avec cotisation non payée, date d'expiration et nombre de jours de retard
- Bouton 💳 pour ouvrir le modal de gestion de cotisation
- Bouton 📧 pour envoyer un email de relance individuel
- Bouton 📧 Relancer tous pour envoyer en masse à tous les adhérents expirés disposant d'un email
Cloche de notifications 🔔
Le compteur en haut à droite affiche le nombre de livres en retard. Cliquez dessus pour accéder directement à la page des emprunts.
Gestion des livres
Catalogue
La page Livres liste tous les ouvrages avec leur disponibilité en temps réel. Filtrez par catégorie, disponibilité ou recherchez par titre/auteur/ISBN.
| Colonne | Description |
|---|---|
| Titre / Éditeur | Titre du livre, année et éditeur |
| ISBN | Code barre international (utilisé par le scanner) |
| Catégorie | Catégorie attribuée au livre |
| Exemplaires | Nombre total d'exemplaires physiques |
| Dispo. | 2/3 = 2 disponibles sur 3 · 0/2 = tous empruntés |
Ajouter / Modifier un livre
Importer des livres depuis un fichier (CSV / Excel)
Le bouton ⬇ Importer dans la barre d'outils permet d'ajouter des livres en masse depuis un fichier CSV ou Excel (.xlsx).
titre · auteur (obligatoires) · isbn · categorie · annee · editeur · exemplaires · langue · resumeFormat CSV : séparateur point-virgule
; (format Excel français), encodage UTF-8. Le modèle téléchargeable est déjà configuré pour s'ouvrir directement dans Excel.
Catégories
Les catégories permettent de classer les livres par genre (Roman, Sciences, Histoire…). Chaque livre appartient à une catégorie.
Importer des catégories depuis un fichier (CSV / Excel)
Comme pour les livres, le bouton ⬇ Importer permet d'ajouter plusieurs catégories en une seule opération.
nom et descriptionnom (obligatoire) · description (optionnelle)Adhérents
La page Adhérents gère les membres de la bibliothèque. Le tableau affiche : Nom / Prénom · Début cotisation · Fin cotisation · Emprunts · Cotisation · Actions.
Statut affiché dans la colonne Nom
Le badge sous le nom indique le statut administratif de l'adhérent :
Actif L'adhérent peut emprunter (sous réserve de cotisation valide)
Suspendu L'adhérent est temporairement bloqué (bouton 🔒 dans les actions)
Ajouter un nouvel adhérent
Boutons d'action par ligne
| Bouton | Action |
|---|---|
| ✏️ | Modifier les informations de l'adhérent (nom, email, type…) |
| 🔒 / 🔓 | Suspendre / réactiver l'adhérent |
| 💳 | Gérer la cotisation (payé / non payé / retrait) |
| 📧 | Envoyer un email de relance cotisation (visible si expire ou expire bientôt) |
| 🗑️ | Supprimer l'adhérent (impossible s'il a des emprunts en cours) |
Filtres disponibles
La barre de filtres permet d'afficher uniquement : Cotisation valide · Expire bientôt (≤ 15 j) · Expiré · Suspendu
Bouton "📧 Rappels cotisations"
Envoie automatiquement un email de rappel à tous les adhérents dont la cotisation expire dans les 15 prochains jours et qui n'ont pas encore été contactés aujourd'hui.
Gestion des cotisations
La cotisation annuelle conditionne le droit d'emprunt. Un adhérent avec cotisation expirée ou inconnue ne peut pas emprunter.
États possibles
| Badge | Signification | Emprunt autorisé ? |
|---|---|---|
| ✅ Payé | Cotisation en cours, date de fin dans le futur (> 15 j) | ✅ Oui |
| ⚠️ Payé (expire bientôt) | Cotisation valide mais expire dans ≤ 15 jours | ✅ Oui (avec avertissement) |
| ❌ Non payé | Date de fin dépassée | ❌ Non |
| — Inconnu | Aucune cotisation enregistrée | ❌ Non |
Enregistrer ou modifier une cotisation
Cliquer sur le bouton 💳 sur la ligne de l'adhérent :
Retirer une cotisation
Sélectionner "❌ Non payé" puis enregistrer. Une confirmation est demandée. Le statut repasse à — Inconnu et l'adhérent ne peut plus emprunter.
Emails automatiques liés aux cotisations
- Rappel 15 jours avant — envoyé via "📧 Rappels cotisations" ou automatiquement via
check_rappels - Relance expiration — envoyé via le bouton 📧 sur une ligne expirée ou "📧 Relancer tous" depuis le tableau de bord
Emprunts
Enregistrer un nouvel emprunt
Scanner code-barres ISBN
Le scanner permet d'identifier un livre rapidement en flashant son code-barres :
- Scanner USB / douchette — cliquez dans le champ de saisie et passez le scanner sur le code-barres. Appuyez sur Entrée pour rechercher.
- Caméra — cliquez sur 📷 pour activer la caméra. La détection est automatique (Chrome / Edge requis). La caméra s'arrête après lecture.
- Le livre identifié est pré-sélectionné dans la liste déroulante avec ses disponibilités.
Livres en retard
Les lignes en rouge clair indiquent un emprunt dépassant la date de retour prévue.
Le bouton 📧 permet d'envoyer un email de relance à l'emprunteur.
Retours
Pour enregistrer le retour d'un livre :
Historique
L'historique conserve tous les emprunts retournés. Filtrez par mois ou recherchez par titre/adhérent.
Chaque ligne affiche : livre · adhérent · date d'emprunt · date de retour · durée · éventuel retard.
Export CSV
Le bouton ⬇ Exporter CSV génère un fichier téléchargeable avec l'ensemble de l'historique, prêt à ouvrir dans Excel ou LibreOffice Calc (séparateur ;).
Emails automatiques
Biblio Holy envoie plusieurs types d'emails HTML via SMTP.
| Déclencheur | Destinataire | |
|---|---|---|
| Confirmation d'emprunt | Automatique à l'enregistrement d'un emprunt | Emprunteur |
| Relance retard | Bouton 📧 dans la liste des emprunts | Emprunteur |
| Rappel cotisation (15 j) | Bouton "📧 Rappels cotisations" ou automatique | Adhérent |
| Relance cotisation expirée | Bouton 📧 sur ligne adhérent ou "Relancer tous" tableau de bord | Adhérent |
SMTP_ENABLED est à false dans api.php, aucun email n'est envoyé (mode test). Les boutons restent visibles mais ne font rien.Gestion des utilisateurs
Accessible uniquement aux Administrateurs. En tant qu'administrateur, la section Administration du menu affiche trois entrées : 👤 Utilisateurs, 🔑 Licences et ⚙️ Paramètres.
Créer un utilisateur
Changer un mot de passe
Cliquez sur ✏️ sur la ligne de l'utilisateur. Laissez le champ mot de passe vide pour le conserver, ou saisissez un nouveau mot de passe pour le modifier.
Gestion des licences
La page 🔑 Licences (visible uniquement pour les administrateurs) permet de générer et gérer les clés de licence pour les paroisses ou organisations qui utilisent la version distribuée de Biblio Holy.
Générer une nouvelle licence
BHOLY-XXXXX-XXXXX-XXXXX. Cliquez sur 📋 Copier pour la transmettre au client.Tableau des licences
Le tableau liste toutes les licences générées avec : organisation · email · clé · date d'expiration · date de création · statut.
| Statut | Signification |
|---|---|
| Active | Licence valide, le client peut utiliser l'application normalement |
| Expire bientôt | Expiration dans moins de 30 jours — à renouveler |
| Expirée | L'installation cliente passe en mode lecture seule (aucune modification possible) |
| Révoquée | Licence annulée manuellement — le client ne peut plus activer de nouvelle installation |
Paramètres
La page ⚙️ Paramètres (administrateurs uniquement) regroupe deux blocs de configuration accessibles directement depuis l'interface, sans modifier de fichiers.
Paramètres généraux
- Nombre maximum d'emprunts simultanés par défaut — valeur appliquée aux nouveaux adhérents. Chaque adhérent peut avoir sa propre limite individuelle définie dans son profil.
Configuration email (SMTP)
Exemples de serveurs SMTP courants
| Fournisseur | Serveur | Port | Sécurité |
|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | TLS — utiliser un mot de passe d'application Google |
| OVH | smtp.mail.ovh.net | 465 | SSL |
| Infomaniak | mail.infomaniak.com | 587 | TLS |
| Outlook / Office 365 | smtp.office365.com | 587 | TLS |
| Synology MailPlus | localhost | 25 | aucune |
Installation
Prérequis serveur
- PHP 7.4 ou supérieur avec extensions
PDOetpdo_sqlite - Serveur web Nginx (Synology) ou Apache (OVH)
- Dossier
data/accessible en écriture par le processus PHP
Sur Synology NAS (DSM 7)
biblioholy/ dans /volume1/web/ via le Gestionnaire de fichiers DSMmkdir -p /volume1/web/biblioholy/data && chmod 755 /volume1/web/biblioholy/data && chown -R http:http /volume1/web/biblioholy/datanginx-synology.conf fournipdo_sqlite est activé dans le profil PHPhttp://votre-nas/biblioholy/ et vous connecter avec admin / Admin2026!Sur hébergement mutualisé OVH
www/biblioholy/ ou à la racine www/data/ doit être en chmod 755 — OVH l'applique automatiquement dans la plupart des cashttp://votre-site.fr/biblioholy/diagnostic.php — supprimer ce fichier après vérification !biblio.db est créée automatiquement au premier accès à api.php. Les données de démonstration sont insérées une seule fois et ne se réinitialisent jamais, même si tous les emprunts sont retournés.Fichiers de l'application
| Fichier | Rôle |
|---|---|
index.html | Interface utilisateur (SPA — Single Page Application) |
api.php | Backend PHP — toute la logique métier et l'accès à la base |
logo.svg | Logo Biblio Holy (livre avec croix catholique) |
manuel.html | Ce manuel utilisateur |
data/biblio.db | Base de données SQLite (créée automatiquement) |
nginx-synology.conf | Configuration Nginx pour Synology DSM 7 |
.htaccess | Configuration Apache / protection (OVH) |
diagnostic.php | Outil de diagnostic — à supprimer après installation ! |
Biblio Holy v2.0 — Manuel utilisateur — 2026
← Retour à l'application