Office des Coffres — Frontend

Outil communautaire non officiel pour le jeu Renaissance Kingdoms. Ce site n'est pas affilié à Celsius Online, l'éditeur du jeu.

Site : officedescoffres.creacube.be Dépôt backend : Office-des-coffres-backend

---

Stack technique

Outil	Version	Rôle
Vue.js	3.4	Framework (Composition API)
Vite	6.2	Bundler
Tailwind CSS	3.4	Styling utilitaire
Pinia	2.1	État global
Vue Router	4.2	Routage SPA
vue-i18n	9.9	Internationalisation (FR/EN)
notivue	2.4	Notifications toast
Axios	1.6	Requêtes HTTP

---

Structure du projet

Voir docs/ARCHITECTURE.md (source unique — vues, stores, composants, i18n, tests).

---

Déploiement

Production

Déploiement automatique via GitHub Actions sur push main :

1. Build Vite (npm run build) — variable VITE_API_ENDPOINT_PROD injectée depuis les secrets GitHub
2. Transfert FTP du dossier dist/ vers officedescoffres.creacube.be (O2Switch, dossier /front/)

Développement local

npm install
npm run dev       # Serveur dev Vite sur http://localhost:5001 (port fixé dans vite.config.js)

Variables d'environnement à configurer dans .env (voir .env.example) :

VITE_API_ENDPOINT_DEV=
VITE_API_ENDPOINT_PROD=

---

Modules

Module	Route	État
Accueil	/app/	Fonctionnel — intègre la "Chronique de l'Office" (whatsNew.json), entrées publiques et privées (connecté)
Sécurité — Guet	/app/secu/guet	Fonctionnel (liste "d'hier" pré-remplie via cookie comfort)
Économie — Bilan des mines	/app/eco/mines (/app/eco redirige)	Fonctionnel — colle le texte "mines" du jeu, bilan hebdo ou mise en forme du jour, export BBcode, mémorisation "confort", aide contextuelle.
Animation	/app/anim	En développement
Compagnie	/app/company	En développement
Vérification email	/verify-email	Fonctionnel — connexion auto après clic sur le lien reçu
Créer un personnage	/app/character/new	Fonctionnel — sélecteur royaume→province→ville en cascade
Profil	/app/profil	Fonctionnel — liste des personnages du compte, statut individuel, choix du personnage actif, suppression de compte self-service (zone dangereuse, art. 17 RGPD), FR/EN
Pages légales	/legal/cookies, /legal/privacy, /legal/mentions	Fonctionnel — politique cookies, politique de confidentialité, mentions légales (RGPD + APD belge). Liens accessibles via AppFooter (bas de page, toutes routes sauf Welcome qui a son propre footer fusionné)
Page introuvable	toute URL inconnue	Fonctionnel — retour à l'Office (app ou accueil public selon la connexion) et retour à la page précédente, FR/EN

Un compte s'inscrit désormais avec seulement email + mot de passe ; la création de personnage (pseudo + ville) se fait ensuite via /app/character/new, un compte pouvant avoir plusieurs personnages.

---

Tests

npm test               # Tous les tests, one-shot (alias de `vitest run`)
npm run test:watch     # Mode watch — boucle de dev, ne repaie le démarrage qu'une fois
npm run test:auth      # Un domaine ciblé — voir docs/TESTS.md pour la liste complète

853 tests verts au 28/10/2026, répartis par domaine dans tests/{auth,cookies,eco,anim,security, mandates,province,common,enforcement,legal,fixtures} — structure, scripts et méthode ("quoi lancer, et quand") détaillés dans docs/TESTS.md.

Fixtures réelles dans tests/fixtures/ :

• Bug_ExportSorties.txt — données anonymisées, non-régression du parsing des sorties (Guet)

Toute vue utilisant useI18n() doit recevoir un plugin createI18n({ legacy: false, ... }) dans global.plugins du test.

---

Conventions spécifiques au frontend

Conventions transverses (traductions FR/EN, mention "outil non officiel"...) : voir CLAUDE.md à la racine du workspace, source unique.

• Exports BBcode : les trois régimes sont volontairement différents, ne pas les uniformiser. EconomyMines::bilanToBBcode() (bilan hebdo) suit la langue de l'UI — le forum du jeu a aussi des parties anglaises ; EconomyMines::formatDayForForum() et SecurityGuet::to_export() restent en français fixe. Décision explicite de Greg (08/08/2026)
• Dates lues par un joueur : toujours l'année du jeu (gameCalendar.js, 2026 → 1474) — interface comme export. Les dates réelles ne servent qu'en interne (bornes de semaine, filtrage, clés de cache)
• Cookies : catégories "session" (connexion) et "comfort" (thème/langue/préférences par module, optionnelle, dégradation gracieuse) uniquement — aucun cookie publicitaire ni traçage
• Tests Vitest obligatoires pour chaque nouvelle fonctionnalité, avant commit
• Branches : feat/<nom>, fix/<nom>, chore/<nom> — jamais directement sur main
• Commits et push uniquement à la demande explicite