- TypeScript 64.4%
- Svelte 34.6%
- CSS 0.3%
- PowerShell 0.3%
- Liquid 0.1%
- Other 0.1%
The version alone does not tell a development instance from a production one: the rolling `dev` image and a release image can carry the same version. CI now bakes the build channel into the admin image through the APP_CHANNEL build arg (`dev` on main, `release` on a published release) and the About dialog shows it as Production, Development or Local (any build made outside CI). |
||
|---|---|---|
| .claude | ||
| .dev | ||
| .forgejo/workflows | ||
| .vscode | ||
| apps | ||
| packages/ui | ||
| .dockerignore | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| .mcp.json | ||
| biome.json | ||
| CLAUDE.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
exKey
Monorepo contenant l'API et l'interface admin du projet exKey.
exkey/
├── apps/
│ ├── api/ # NestJS 12 (Swagger, Drizzle ORM, PostgreSQL, Brevo API)
│ ├── admin/ # SvelteKit 3 + Svelte 5 + Tailwind v4 + Paraglide i18n
│ └── widgets/ # widgets de reservation embarquables (Svelte 5, bundles IIFE servis par l'API)
├── packages/
│ └── ui/ # composants shadcn-svelte partagés admin / widgets (@exkey/ui)
├── .claude/ # configuration des agents IA (rules / skills / memory)
├── .forgejo/ # workflows CI Forgejo Actions
└── docker-compose.yml
Pour les conventions internes (style, archi, i18n, naming DB…), voir CLAUDE.md et le dossier .claude/.
Prerequis
- Node 26 LTS
- pnpm 10 (
npm install --global pnpm@10.34.9- Corepack n'est plus fourni avec Node depuis la v25) - PostgreSQL 18 local pour le mode dev (ou Docker uniquement)
- Docker + Docker Compose v2 pour la stack complete
- Un compte Brevo avec une cle API (dashboard Brevo > SMTP & API > Cles API) - necessaire des le premier demarrage car le wizard de setup envoie un email de verification via l'API Brevo
Quickstart - mode dev natif (Postgres local)
-
Sur ton PostgreSQL local, cree le user et la base :
CREATE USER exkey WITH PASSWORD 'exkey'; CREATE DATABASE exkey OWNER exkey; -
Installe les dependances depuis la racine :
pnpm install -
Copie les fichiers d'environnement :
cp .env.example .env cp apps/api/.env.example apps/api/.env cp apps/admin/.env.example apps/admin/.envRenseigne au minimum
BREVO_API_KEY/MAILER_ADDRESS_FROMdans.env(ouapps/api/.env). -
Lance API + Admin + widgets en parallele :
pnpm devLes migrations Drizzle s'appliquent automatiquement au demarrage de l'API (un advisory lock Postgres evite les courses si plusieurs instances bootent en meme temps). Pas besoin de
pnpm db:migrateau premier lancement.Cote admin, le premier chargement compile le graphe de modules a la demande : le shell de l'app est pre-compile des le demarrage du dev server (ligne
🔥 module graph warmed up), et toute page qui met plus de 2 s a repondre logge sa progression dans le terminal (⏳ compiling /page… 4s (717 modules so far)puis✅ /page served in 7.4s). Pas de log = chargement instantane.
URLs disponibles :
- Admin : http://localhost:5173
- API : http://localhost:3000
- Swagger : http://localhost:3000/docs
- Liveness probe : http://localhost:3000/health
Au premier acces a l'admin, tu es redirige automatiquement vers
/setuppour creer le tenant, le premier etablissement et le compte owner. Tant que le setup n'est pas valide, toutes les routes redirigent vers le wizard.
Quickstart - stack complete via Docker Compose
pnpm compose:up
Le script builde d'abord les images exkey-api:latest / exkey-admin:latest depuis le Dockerfile racine (pnpm compose:build), puis lance docker compose up. Le docker-compose.yml ne contient volontairement aucune section build: (voir la section deploiement ci-dessous), donc un docker compose up --build seul ne builderait rien.
Cela demarre 3 conteneurs :
exkey-db- PostgreSQL 18 (port hote5433par defaut pour ne pas entrer en conflit avec un Postgres local)exkey-api- NestJS sur3000exkey-admin- SvelteKit (adapter-node) sur5173
Pour personnaliser les ports / credentials / SMTP, copie .env.example en .env a la racine et adapte les valeurs.
Deployer avec les images du registre (sans build local)
La CI pousse les images exkey-api / exkey-admin sur le registre OCI a chaque push sur main (tag dev) et a chaque release (latest + tag de version).
Le docker-compose.yml est pull-only (aucune section build:) : compose tire les images du registre meme quand la commande contient --build. C'est ce qui permet de le coller tel quel comme source compose « raw » sur une plateforme de deploiement (type Dokploy) qui impose docker compose up -d --build.
-
Plateforme de deploiement (source compose « raw ») : coller le contenu de
docker-compose.yml, puis definir dans l'environnement du projetAPI_IMAGE,ADMIN_IMAGE,IMAGE_TAG(voir.env.example) et les autres variables requises (BETTER_AUTH_SECRET,POSTGRES_PASSWORD, etc.). La plateforme doit etre authentifiee sur le registre pour pouvoir pull.Pour exposer la stack sur internet, creer un domaine par service dans la plateforme (ex.
admin.mondomaine.tld→ serviceadmin,api.mondomaine.tld→ serviceapi), en pointant chaque domaine sur le port conteneur 3000 (les deux apps ecoutent sur 3000 dans leur conteneur). Les URLs publiques n'ont pas de port : le reverse proxy de la plateforme termine le HTTPS sur 443. Definir ensuite dans l'environnement :ADMIN_URL=https://admin.mondomaine.tld API_PUBLIC_URL=https://api.mondomaine.tld TRUST_PROXY=trueLe compose en derive
ORIGIN/PUBLIC_API_URL(admin) et les defaults Better Auth (api). Les ports hotesAPI_HOST_PORT/ADMIN_HOST_PORTne servent qu'a l'acces directip:port(debug) et sont independants des domaines - sur un serveur ou le port 3000 est deja pris (UI de la plateforme...), les changer ou ignorer l'acces direct. -
Serveur avec clone du depot :
docker login <registre>
docker compose pull api admin
docker compose up -d
latest et dev etant des tags mouvants, relance docker compose pull avant chaque up pour recuperer la derniere image.
Premier demarrage : wizard de setup
L'app n'expose aucune table metier seedee. Au premier acces, le layout admin probe l'API (GET /setup/status) et oriente l'utilisateur selon une logique tri-etat :
- API injoignable → page
/unavailable(avec message d'erreur et bouton "reessayer"). - API OK + non initialisee → wizard
/setup. - API OK + initialisee → page
/login(Better Auth : email + mot de passe, 2FA TOTP optionnelle, sessions en base).
Le wizard execute trois pre-checks avant de soumettre :
GET /health- l'API repond ;GET /api/setup/checks/database-SELECT 1+ latence ;POST /api/setup/checks/email- envoi reel d'un email de test via l'API Brevo.
A la soumission, POST /setup cree dans une transaction exkey_tenants, exkey_establishments et l'enregistrement owner dans exkey_users (mot de passe hash en argon2id). Le tenant est singleton au niveau base via un index unique partiel - toute reinitialisation se fait en truncant les tables setup (voir apps/api/scripts/reset-setup.mjs).
Donnees de demonstration (optionnel)
Si l'API demarre avec SETUP_ALLOW_DEMO_DATA=true, le wizard affiche un switch
« Injecter des donnees de demonstration » (desactive par defaut). Une fois coche,
le setup injecte apres sa reussite un jeu de donnees d'exemple : 7 etablissements
panaches (6 francais et 1 suisse en CHF, modules varies, dont une base nautique sans
chambres ni restaurant et un domaine viticole au contenu majoritairement en brouillon),
leurs chambres / restaurants et menus / spa / navettes / materiels de location avec
photos placeholder, un catalogue de bons cadeaux, des widgets publies et en brouillon,
120 clients (particuliers et societes de 22 pays, dont 6 issus d'un import CSV
historique) et 90 avis clients (repondus pour moitie, 5 masques pour illustrer la
moderation, un etablissement sans aucun avis) - sans reservations, bons emis ni
utilisateurs. Tout le contenu visible est en francais. Le seed vit
dans apps/api/src/setup/demo-data/ (un fichier de
fixtures par domaine, UUIDs deterministes dd0000… identifiables via
WHERE id::text LIKE 'dd0000%', invariants verifies par fixtures.spec.ts).
L'injection n'est possible que pendant le setup : une fois l'instance
initialisee, POST /setup repond 409 et aucun autre point d'entree (CLI ou
endpoint) n'existe. Flag off ou switch decoche → l'application reste vierge de
toute donnee de demo.
Le seed est best-effort : s'il echoue (cas typique : dossier UPLOAD_DIR
non accessible en ecriture, les photos placeholder etant copiees avant les
insertions), le setup reussit quand meme sans donnees de demo. L'erreur est
loguee cote API ([SetupService] Demo data seeding failed ...) et la page de
connexion affiche un avertissement. L'API verifie d'ailleurs au demarrage que
UPLOAD_DIR est accessible en ecriture et logue une erreur [StorageService]
sinon. Pour rejouer le setup avec les donnees de demo, repartir d'une base vide
(docker compose down -v puis up, ou node apps/api/scripts/reset-setup.mjs
en local).
Jobs en arriere-plan & metriques
L'API embarque pg-boss pour exécuter des
tâches hors du cycle HTTP. pg-boss tourne sur la même base PostgreSQL (via
DATABASE_URL) mais dans un schéma dédié pgboss auto-créé/migré au
démarrage - il n'interfère pas avec les migrations Drizzle et postgres.js reste
le driver applicatif.
- File
email.send: l'envoi d'email (ex. invitations) est désormais enfilé puis drainé par un worker, avec retry automatique (5 essais, backoff). La requête HTTP ne bloque plus sur l'appel Brevo. - Métriques : un job planifié (
metrics.snapshot, toutes les 15 min par défaut) enregistre les compteurs de file dansexkey_metric_samples; un job quotidien (metrics.prune) purge les points au-delà deMETRICS_RETENTION_DAYS. - Endpoints d'administration (
settings:manage) :GET /queue/stats(compteurs live) etGET /metrics/series?metric=...&bucket=hour(historique agrégé). - Dashboard : la page d'accueil admin affiche, pour les détenteurs de
settings:manage, des cartes KPI et un graphique (shadcn-svelte / LayerChart) du backlog email. - Arrêt gracieux :
app.enableShutdownHooks()laisse pg-boss terminer les jobs en cours surSIGTERM/SIGINT.
Scripts racine
| Commande | Description |
|---|---|
pnpm dev |
Lance API + Admin en watch + bundles widgets (watch) + playground |
pnpm widgets |
Watch des bundles widgets seul (sans le reste de la stack) |
pnpm build |
Build toutes les apps |
pnpm lint |
Lint Biome (verification) |
pnpm lint:fix |
Lint Biome avec auto-fix |
pnpm format |
Formattage Biome |
pnpm test |
Tests toutes les apps |
pnpm scan |
Recherche les vulnerabilites connues des dependances (osv-scanner requis dans le PATH) |
pnpm db:generate |
Genere une migration Drizzle depuis src/db/schema.ts |
pnpm db:migrate |
Applique les migrations en attente (rarement utile : auto au boot) |
pnpm compose:up |
Build + demarre la stack Docker |
pnpm compose:down |
Arrete la stack Docker |
Stack technique
API (apps/api)
- NestJS 12, TypeScript, ESM via
nest build - Swagger / OpenAPI 3 sur
/docs - Drizzle ORM 0.45 + driver
postgres(postgres.js) - Migrations Drizzle Kit, appliquees automatiquement au demarrage (advisory lock)
- Validation Zod 4 (env + DTO)
class-validator/class-transformerpour les DTO Nest- Hash de mot de passe via
@node-rs/argon2(argon2id) - Emails transactionnels via l'API REST Brevo (
BREVO_API_KEY) - Jobs en arrière-plan + planification via
pg-boss(file sur PostgreSQL, schémapgbossdédié) - Métriques persistées (séries temporelles) dans
exkey_metric_samples - Recherche globale :
GET /api/search(session uniquement) - requêtesILIKEmulti-établissements, résultats groupés par type d'entité (registre extensible danssrc/search/searchers.ts) - Import / export CSV : module
src/data-transfer/(session uniquement, permissiondata_transfer) - registre de « kinds » (catalogue de bons cadeaux, clients, bons émis), modèles CSV, exports ré-importables, aperçu obligatoire (dry run) puis import tout ou rien en une transaction, historiqueexkey_importset annulation d'import ;csv-parse/csv-stringify, délimiteur auto-détecté, sortie;+ BOM pour Excel - Healthchecks via
@nestjs/terminus
Admin (apps/admin)
- SvelteKit 3 + Svelte 5 (runes), adapter-node, Vite (configuration SvelteKit dans
vite.config.ts, plus desvelte.config.js) - Tailwind CSS v4 (plugin Vite officiel) +
@tailwindcss/forms+@tailwindcss/typography - Composants UI :
shadcn-svelte+bits-ui(tables :@tanstack/svelte-table) ; les composants communs avec les widgets sont danspackages/ui(@exkey/ui) - Toasts :
svelte-sonner - Rôles et permissions (Utilisateurs > Gérer les rôles, permission
users:manage) : matrice fonctionnalités x rôles avec trois niveaux (Consulter / Modifier / Gérer, avec implication). Trois rôles système seedés (Propriétaire verrouillé avec tous les droits, Administrateur et Utilisateur aux permissions modifiables) + rôles personnalisés (créer, renommer, supprimer si aucun utilisateur ne le porte). Un utilisateur porte un rôle et une liste d'établissements accessibles ; la sidebar, le menu de marque, la recherche Ctrl+K et les boutons d'action suivent ses permissions, relues par l'API à chaque requête - Import / export (menu de marque, avant Paramètres ; permission
data_transfer: Consulter = modèles + exports, Gérer = import et annulation) : pour chaque jeu de données (catalogue de bons cadeaux, clients, bons cadeaux émis) un modèle CSV à télécharger, un export CSV ré-importable et un import en deux temps - analyse du fichier (erreurs et avertissements par numéro de ligne, récapitulatif) puis import tout ou rien. Les bons importés gardent leur code d'origine (legacy_code, reconnu au comptoir et dans Ctrl+K) en plus d'un nouveau code exKey ; les clients sont identifiés par email (fiche existante rattachée, jamais dupliquée). Historique des imports avec annulation tant que les données n'ont pas été utilisées - Theme clair/sombre :
mode-watcher - Icones :
@lucide/svelte - i18n : Paraglide JS (locales
en/fr/de/es/it/pt, detection cookie + Accept-Language, runtime compile danssrc/lib/paraglide/) - Recherche globale Ctrl+K / Cmd+K : palette centrée (loupe dans l'en-tête) avec recherche live sur les réservations, clients, bons cadeaux, produits, chambres, restaurants, cartes et menus, prestations spa, navettes, matériels de location, widgets, établissements, pages (y compris calendrier, paramètres de module, onglets Paramètres et Mon compte) et documentation (entrée Documentation du menu exKey, accessible à tous, avec un sommaire de navigation dans les pages) ; bascule automatique d'établissement au clic (registre extensible dans
src/lib/search/registry.ts) - Tableau de bord en deux onglets : Aujourd'hui (arrivées/départs, clients présents, occupation ce soir, paiements en attente, volumes du jour des modules activés) et Performance, le comparatif période vs période - préréglages (7 j, 30 j, mois en cours, mois dernier, année) ou plage libre, bascule « vs période précédente » / « vs même période N-1 », portée établissement courant ou tous les établissements (totaux + ventilation par établissement, montants totalisés seulement à devise commune), graphique en superposition CA/réservations. Les agrégats sont calculés à la volée côté API (
GET /establishments/:id/bookings/stats/compareetGET /bookings/stats/compare) : CA des réservations confirmées/terminées à la date de confirmation, bons cadeaux comptés à la date d'émission (séparés du CA réservations), état de la vue conservé dans l'URL - Module Locations (location de matériel : skis, vélos, bateaux...) : chaque fiche décrit un matériel générique dont les déclinaisons sont des variantes portant le stock, avec une unité de location fixée à la création (heure, demi-journée, journée ou nuit). Le tarif de base par unité peut être complété par des tarifs saisonniers réutilisant les saisons de l'établissement (gérées dans l'onglet « Saisons » de sa page de paramètres) ; le tout est intégré au tunnel de réservation admin (étape « Locations » du wizard, prix figé à l'ajout)
- Avis clients (Webmarketing > Avis clients) : notes 1-5 étoiles + commentaire, ciblant l'établissement ou un service (chambres, restaurant, spa, navettes, locations). Note globale et moyennes par service au-dessus du tableau (filtres sujet/note/réponse/modération), réponse unique et définitive de l'établissement (permission
reviews:manage, verrouillée côté API), modération réversible (avis bloqué = exclu de toutes les moyennes et du futur affichage public). La fiche client (onglets Profil / Préférences / Statistiques / Réservations / Avis) reprend les avis du client, et le tableau de bord affiche la note moyenne de chaque établissement. Le dépôt d'avis public (widget post-séjour) viendra plus tard - Validation : Zod 4
Widgets embarquables (apps/widgets)
- Trois widgets de réservation rapide à intégrer sur des sites web tiers : Hôtel - Quick Search (dispo chambres par plage de dates + personnes, meilleur prix affiché à côté du bouton de recherche), Navette (date + passagers) et Restaurant (restaurant + couverts + date + heure), chacun conditionné au module correspondant de l'établissement ; formulaire de recherche sur une seule ligne dès que la place le permet
- Une soumission crée une vraie réservation en statut
pending_approval(canalwidget) qui bloque l'inventaire ; le staff l'accepte ou la refuse depuis l'admin (notification + emails invité localisés en 6 langues) ; expiration automatique via le réglagebookings.approval_ttl_hours - Bundles IIFE autonomes (Svelte 5 + Tailwind v4 + shadcn-svelte, CSS inliné) buildés dans
apps/widgets/dist/v1/et servis par l'API sous/public/widgets/v1/<type>.js(URL stable, ACAO*) ;pnpm devles builde et les garde en watch automatiquement (one-shot :pnpm --filter @exkey/widgets build) - Intégration en collant deux lignes (div + script) ; deux modes par widget : Shadow DOM (recommandé) ou iframe (page frame hébergée par l'API, hauteur auto via postMessage)
- Personnalisation par widget depuis l'admin (couleurs, arrondi, ombre, bordure, sélecteur de dates) appliquée sans re-copier le code ; overrides par page via data-attributes (
data-lang,data-primary-color,data-embed-mode, …) exposés dans l'éditeur par l'interrupteur « Inclure les options par page », pré-remplis en direct avec les réglages du formulaire (attribut vide = réglage enregistré, valides en shadow comme en iframe) - Langues servies = section Langues de l'établissement (sous-ensemble des 6 locales + langue par défaut)
- Surface publique anonyme
/api/public/widgets/:publicKey/*(config, disponibilités avec restrictions de vente appliquées, soumission) - clé publique 192 bits, rate limiting en mémoire, CORS ouvert sans credentials ; une clé de prévisualisation admin (?preview=wgtp_..., exposée uniquement par l'API authentifiée) débloque les lectures d'un widget en pause pour l'aperçu de l'éditeur, jamais la soumission - Playground de dev : démarré par
pnpm dev(port 5174, page hôte volontairement hostile) ; seul :pnpm --filter @exkey/widgets playground
Tooling
- pnpm workspaces (Node 26 LTS)
- Biome 2 (lint + format unifies pour tout le repo)
- Docker multi-stage avec cache pnpm
- CI : Forgejo Actions (lint + build + push registre OCI)
Variables d'environnement
.env racine
Consomme par docker-compose.yml et par l'API en mode dev natif (via dotenv en cascade). Voir .env.example pour la liste complete.
# PostgreSQL
POSTGRES_USER=exkey
POSTGRES_PASSWORD=exkey
POSTGRES_DB=exkey
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_SSL=false
POSTGRES_HOST_PORT=5433 # port hote du conteneur db
API_HOST_PORT=3000
ADMIN_HOST_PORT=5173
# Medias uploades (stockage disque local, servis sous /uploads)
UPLOAD_DIR=./var/uploads # volume monte (/app/uploads) en Docker, cree dans l'image avec le bon proprietaire
UPLOAD_MAX_FILE_SIZE_MB=10
# Donnees de demo au setup : si true, le wizard /setup propose un switch
# "Injecter des donnees de demonstration". A laisser false en production.
SETUP_ALLOW_DEMO_DATA=false
# Emails transactionnels (API REST Brevo)
BREVO_API_KEY=
MAILER_ADDRESS_FROM="exKey <no-reply@example.com>"
# Authentification (OBLIGATOIRE : l'API refuse de demarrer sans secret)
BETTER_AUTH_SECRET=replace-me-with-a-strong-random-32-plus-char-secret
# BETTER_AUTH_URL / BETTER_AUTH_TRUSTED_ORIGINS derivent de API_PUBLIC_URL / ADMIN_URL
# Niveau de log de l'API (error | warn | log | debug | verbose)
# LOG_LEVEL=log
Les autres variables (URLs publiques API_PUBLIC_URL / ADMIN_URL, TRUST_PROXY,
AUTH_COOKIE_DOMAIN, WIDGETS_DIST_DIR, MOLLIE_*, BOOKINGS_*) sont
documentees dans .env.example, qui reste la reference.
apps/api/.env
Surcharges propres a l'API. La connexion Postgres accepte soit DATABASE_URL (prioritaire), soit les variables POSTGRES_* separees.
NODE_ENV=development
PORT=3000
# DATABASE_URL=postgres://exkey:exkey@localhost:5432/exkey
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_USER=exkey
POSTGRES_PASSWORD=exkey
POSTGRES_DB=exkey
POSTGRES_SSL=false
# Jobs en arriere-plan (pg-boss) - valeurs par defaut, override optionnel
PGBOSS_SCHEMA=pgboss
PGBOSS_MAX=5
# Metriques (exkey_metric_samples)
METRICS_SNAPSHOT_CRON=*/15 * * * *
METRICS_RETENTION_DAYS=180
# Medias uploades (stockage disque local, servis sous /uploads)
UPLOAD_DIR=./var/uploads
UPLOAD_MAX_FILE_SIZE_MB=10
# Donnees de demo au setup (switch visible sur /setup uniquement si true)
SETUP_ALLOW_DEMO_DATA=false
# Emails transactionnels (override possible par rapport au .env racine)
BREVO_API_KEY=
MAILER_ADDRESS_FROM="exKey <no-reply@example.com>"
apps/admin/.env
PUBLIC_API_URL=http://localhost:3000
Schema base de donnees
Toutes les tables et enums crees par l'app sont prefixes exkey_ et utilisent le pluriel snake_case (cf. .claude/rules/db-naming.md).
La source de verite est le dossier apps/api/src/db/schema/
(un fichier par table, barrel schema.ts) : une soixantaine de tables couvrant le
setup (exkey_tenants, exkey_establishments, exkey_users, exkey_roles,
exkey_establishment_memberships), l'authentification Better Auth, les modules
metier (chambres, restaurants et menus, spa, navettes, locations, bons cadeaux,
reservations et paiements, clients, avis), les medias, les widgets, les
notifications, les imports CSV, les parametres applicatifs et les metriques
(exkey_metric_samples). La migration Drizzle initiale
(apps/api/drizzle/migrations/0000_*.sql) seed les 3 roles systeme.
Le schéma
pgboss(tables de la file de jobs) est géré automatiquement par pg-boss et n'apparaît pas dansapps/api/src/db/schema/ni dans les migrations Drizzle.
Pour reinitialiser le setup en local :
node apps/api/scripts/reset-setup.mjs
Cette commande tronque les 4 tables setup en cascade. A ne jamais utiliser hors developpement.
CI Forgejo
Le workflow .forgejo/workflows/ci.yml tourne sur ubuntu-latest (runner Forgejo compatible GitHub Actions).
Declencheurs et etapes
- PR vers
main:pnpm install+pnpm lint+pnpm check+pnpm test+pnpm build(pas de push d'image). - Push sur
main: memes etapes, puis build + push des deux images Docker. - Release publiee (
release: { types: [published] }) : memes etapes, puis build + push des deux images Docker.
Strategie de tags Docker
| Evenement | Tags pousses sur exkey-api et exkey-admin |
|---|---|
push sur main (commit simple) |
dev |
release publiee (tag ex. v1.2.3) |
latest et v1.2.3 (le nom du tag de release) |
Concretement :
- Un commit sur
mainecrase l'image:dev=> image "rolling" de la branche principale. - Une release ecrase
:latest(= derniere version stable) et publie egalement une image immuable taguee avec la version (:v1.2.3), pour pouvoir revenir en arriere ou epingler precisement une version en prod. - L'image admin embarque son canal de build (build arg
APP_CHANNEL, passe par la CI) : la modale A propos (menu exKey) affiche Developpement pour l'image:devet Production pour une image de release. Un build hors CI (pnpm dev,pnpm compose:build) affiche Local.
Secrets/variables a definir dans Forgejo
secrets.REGISTRY_URL- hote du registre OCI, ex :forgejo.example.comsecrets.REGISTRY_USERNAMEsecrets.REGISTRY_TOKEN
Les images sont nommees <REGISTRY_URL>/<owner>/<repo>-api et -admin (nom du depot en minuscules).
Le runner Forgejo doit supporter l'execution de jobs en container Docker (build + push via Buildx).
Hors-scope (pour l'instant)
- Pas de depot d'avis public ni de widget post-sejour (les avis sont saisis depuis l'admin)
- Pas de relais central Mollie (chaque etablissement connecte son propre compte)
- Pas d'integration channel manager (Channex) ni de distribution restaurant (Mozrest)
- Tests automatises limites aux fonctions pures de l'API (pas de tests d'integration ni de tests admin)