Skip to content

README.md

Latest commit

 

History

History
83 lines (63 loc) · 3.33 KB

README.md

File metadata and controls

83 lines (63 loc) · 3.33 KB
Raw

cash

Panneau d'administration DaVinciBot (SvelteKit + Svelte 5) : trésorerie, commandes, gestion des membres et réglages de compte. Servi sous le base path /admin du domaine davincibot.fr.

Apps voisines : davincibot.fr (/), formation (/formation), auth (auth.davincibot.fr).

Prérequis

  • Node 24.11.0 (.nvmrc), pnpm 11.5.2 (épinglé par packageManager)
  • Un NPM_TOKEN (PAT GitHub avec read:packages) exporté dans le shell : les dépendances @davincibot/* viennent de GitHub Packages (privé). Voir DaVinciBot/packages.

Configuration

Copier .env.example en .env :

PUBLIC_SUPABASE_URL=https://project.supabase.co
PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_xx
# Clé secrète Supabase (service role) — serveur uniquement
SUPABASE_SECRET_KEY=
AUTH_PROXY_TARGET=http://localhost:5174
# Service auth central (prod : https://auth.davincibot.fr)
PUBLIC_AUTH_BASE_URL=http://localhost:5177
# Préfixe optionnel des noms de cookies, vide en prod
PUBLIC_COOKIE_PREFIX=
# Facultatif — adresse par laquelle le serveur s'atteint lui-même pour les PDF
# PDF_INTERNAL_BASE=http://127.0.0.1:3000

Le téléchargement d'un document en PDF passe par un navigateur embarqué : le serveur ouvre sa propre page de document et l'imprime. C'est le seul moyen d'imposer le nom du fichier — la boîte « Enregistrer au format PDF » d'un navigateur n'obéit à aucun standard. En développement, pnpm dev suffit ; le navigateur, lui, doit exister :

node node_modules/playwright/cli.js install chromium-headless-shell

L'image de production l'installe elle-même (voir Dockerfile) et pèse environ 650 Mo de plus pour cette raison. Si le navigateur manque, le téléchargement répond 503 et la pièce reste imprimable depuis le navigateur de l'utilisateur.

L'authentification est déléguée au service auth : pour un parcours de login complet en local, faire tourner l'app auth sur le port 5177. L'enrôlement des passkeys et le step-up MFA tournent sur l'origine de cash — penser à lister http://localhost:5175 dans WEBAUTHN_ORIGINS côté auth, sinon l'attestation est rejetée.

Développement

pnpm install
pnpm dev            # http://localhost:5175/admin
pnpm dev -- --open

Pour lancer les 3 sites d'un coup, utiliser pnpm dev:all depuis ../davincibot.fr.

Qualité et build

pnpm check        # svelte-check
pnpm lint         # prettier --check + eslint --max-warnings=0
pnpm format       # eslint --fix + prettier --write
pnpm test:unit    # vitest run --coverage
pnpm test:e2e     # playwright
pnpm build        # svelte-kit sync && vite build
pnpm preview      # 127.0.0.1:4173
pnpm ci           # check + lint + test:unit + build (ce que fait la CI)

Déploiement

Build adapter-node avec paths.base = '/admin', image Docker publiée sur GHCR puis déployée par Dokploy (service Swarm derrière Traefik). Les workflows de .github/workflows appellent les workflows réutilisables de DaVinciBot/shared-workflows.

Notes métier

  • L'année scolaire commence le 1ᵉʳ septembre : « CDR 2025 » = 1ᵉʳ septembre 2024 → 31 août 2025.