1. À quoi sert ce portail ?
Ce portail regroupe les outils internes du magasin Tom&Co Vanderkindere. Il sert à centraliser les procédures et les outils utiles au quotidien.
Les modules actifs sont Agenda Pension, Procédure quotidienne, Rapport quotidien animaux, Livraisons à domicile, Commande spéciale client, Gestion des pertes, l'Espace Responsable et la documentation interne. Les statistiques sont réservées au responsable.
2. GitHub : à quoi ça sert ?
GitHub stocke le code du portail et garde l'historique des modifications grâce aux commits.
index.html, style.css, app.js, storage.js, config.jsREADME.md, ONLINE-NOTES.md, CHANGELOG.mdfirestore.rules.example et le dossier assets/
Chaque évolution importante doit être validée, testée, puis enregistrée avec un commit clair.
3. Où se connecter à GitHub ?
- Aller sur github.com.
- Se connecter avec le compte propriétaire du dépôt.
- Ouvrir le dépôt du portail interne.
- Vérifier que la branche principale est
main.
Les identifiants GitHub doivent rester confidentiels et ne doivent pas être partagés inutilement.
4. GitHub Pages : à quoi ça sert ?
GitHub Pages publie l'unique portail à son adresse officielle :
https://www.tomandcovdk.be/
L'ancienne adresse GitHub Pages reste utilisable jusqu'à la bascule du domaine, puis redirige vers l'adresse officielle.
Quand le code est poussé sur main, GitHub Pages met ensuite le site à jour automatiquement.
Il peut y avoir un petit délai entre le push sur GitHub et l'affichage de la nouvelle version en ligne.
5. Firebase : à quoi ça sert ?
Firebase gère la connexion des utilisateurs, la base de données partagée et les données des réservations de pension.
- Firebase Authentication avec Email/Password
- Firebase Firestore
- Collection Firestore :
pensionReservations
- Collection dossiers d'arrivée Pension :
pensionIntakeForms
- Collections procédures :
dailyProcedures et animalWeeklyReports
- Collection de configuration :
portalSettings
- Collections livraisons :
homeDeliveries et homeDeliveryCustomers
- Collections commandes spéciales :
specialOrders et specialOrderCustomers
6. Où se connecter à Firebase ?
- Aller sur console.firebase.google.com.
- Ouvrir le projet Firebase lié au portail.
- Vérifier les sections Authentication, Firestore Database et Rules.
Il ne faut pas modifier les règles Firestore ou supprimer des données sans être certain de ce que l'on fait.
7. Firebase Authentication
L'authentification contrôle qui peut se connecter au portail.
- Compte Magasin :
30206@tomandco.eu
- Responsable :
sgoubau@tomandco.be
- Responsable :
simon.goubau@gmail.com
Les comptes utilisateurs doivent être gérés prudemment dans Firebase Authentication.
Le portail ne doit pas créer ou supprimer directement des comptes Firebase depuis le front-end sans backend sécurisé.
8. Firestore Database
Firestore est la base de données partagée. La collection pensionReservations contient les réservations de pension et pensionIntakeForms contient séparément les contrats et questionnaires liés par reservationId. Les collections dailyProcedures et animalWeeklyReports contiennent les validations magasin et animaux. La collection portalSettings contient la configuration des tâches et contrôles. Les collections homeDeliveries et homeDeliveryCustomers contiennent les livraisons et leurs clients. Les collections specialOrders et specialOrderCustomers contiennent séparément les commandes spéciales et leurs clients sans adresse.
Le cadencier Aniserco reste local à chaque appareil dans IndexedDB. La même base locale est utilisée par Livraisons à domicile et Commande spéciale client.
Les données de test des deux nouveaux modules sont marquées avec isDemo: true et peuvent être effacées sans toucher aux vrais rapports.
Ne jamais supprimer manuellement la collection pensionReservations depuis Firebase, sauf si une sauvegarde fiable existe et que l'action est volontaire.
9. Sauvegardes JSON
Agenda Pension permet d'exporter les données en JSON. Cet export sert de sauvegarde manuelle.
- Avant toute grosse modification
- Avant un import ou un reset
- Avant une nouvelle version importante
- Régulièrement par sécurité
Les fichiers JSON exportés doivent être conservés dans un endroit sûr.
10. Bonnes pratiques avant modification
- Vérifier que la version publiée fonctionne.
- Vérifier que Git est propre.
- Ne pas tester avec une vraie réservation client.
- Créer une réservation de test clairement identifiable.
- Faire un export JSON si nécessaire.
- Travailler par petit patch.
- Ne pas tout modifier en même temps.
11. Tests à faire avant publication
- Tester la connexion et l'ouverture de l'Agenda Pension.
- Tester tableau de bord, semaine, mois, présences, réservations et historique clients.
- Créer, modifier, annuler, réactiver puis supprimer une réservation de test.
- Tester la procédure quotidienne avec une semaine de test et des initiales.
- Tester le rapport animaux avec un rapport de test et des remarques.
- Tester le chargement et l'effacement des données de démonstration
isDemo: true.
- Tester export JSON, et import JSON si l'import/export a été modifié.
- Vérifier l'affichage mobile ou en largeur réduite.
- Vérifier les impressions si le CSS a été modifié.
12. Commandes de contrôle avant commit
node --check app.js
git diff --check
git status
Le commit clair se fait uniquement après validation.
13. Publication
- Valider les modifications.
- Faire un commit clair.
- Pousser sur
main uniquement après validation.
- Attendre la mise à jour GitHub Pages.
- Vérifier l'URL publiée.
Vérifier le portail officiel
