No description
  • Astro 60.7%
  • TypeScript 25.6%
  • CSS 6.1%
  • JavaScript 5.9%
  • Dockerfile 1.7%
Find a file
Nicolas 0af19b788e
All checks were successful
CI/CD / build (push) Successful in 49s
CI/CD / deploy (push) Successful in 4s
Actualiser .forgejo/workflows/ci.yml
2026-11-18 12:33:57 +00:00
.forgejo/workflows Actualiser .forgejo/workflows/ci.yml 2026-11-18 12:33:57 +00:00
docs Téléverser les fichiers vers "docs" 2026-09-25 10:14:52 +02:00
public modif et ajout page desinscription mailingliste 2026-11-13 15:47:42 +01:00
scripts Téléverser les fichiers vers "scripts" 2026-09-25 10:17:10 +02:00
src modif dockerfile pour healhcheck 2026-11-17 15:45:27 +01:00
.dockerignore modif dockerfile pour healhcheck 2026-11-17 15:45:27 +01:00
.env.example ajout page désinscription mailing liste 2026-11-17 15:28:26 +01:00
.gitignore modif gitignore 2026-11-13 15:53:12 +01:00
astro.config.mjs ajout page désinscription mailing liste 2026-11-17 15:28:26 +01:00
Dockerfile modif dockerfile pour healhcheck 2026-11-17 15:45:27 +01:00
LICENSE Initial commit 2026-09-25 09:35:05 +02:00
package.json modif et ajout page desinscription mailingliste 2026-11-13 15:47:42 +01:00
pnpm-lock.yaml modif et ajout page desinscription mailingliste 2026-11-13 15:47:42 +01:00
README.md Actualiser README.md 2026-09-25 10:08:37 +02:00
tsconfig.json Téléverser les fichiers vers "/" 2026-09-25 10:11:18 +02:00

Site ACL 2026

Base Astro pour le site de gestion de l'école de musique associative.

Stack

  • Astro (output: server, adapter @astrojs/node standalone) — les pages vitrine (/, /auth/lien-envoye, /inscription) sont marquées export const prerender = true et servies statiquement ; le reste (/evenements, /dashboard/*, /profs/*, /auth/verify) est en SSR.
  • Alpine.js et Open Props installés via pnpm puis copiés dans public/vendor/ par scripts/vendor.mjs (hook postinstall) — aucun CDN externe n'est appelé au runtime.
  • Auth par magic link : n8n génère/valide le token via Baserow ; une fois validé, Astro émet lui-même un cookie de session signé (HMAC-SHA256, src/lib/session.ts) pour ne pas re-solliciter n8n à chaque requête protégée. src/middleware.ts vérifie ce cookie.
  • n8n est la seule couche qui parle à Baserow (src/lib/n8n.ts fait les appels webhook depuis Astro).

Arborescence

src/
  layouts/        BaseLayout (Open Props + Alpine vendorisés), DashboardLayout
  components/      Header, Footer, EventCard
  lib/
    n8n.ts         client webhooks n8n (typé par fonction métier)
    session.ts     signature/vérification du cookie de session
  middleware.ts    protège /dashboard (role famille) et /profs (role prof)
  pages/
    index.astro              vitrine (statique)
    evenements/index.astro   liste d'événements (SSR, depuis n8n)
    inscription.astro        formulaire d'inscription (statique, POST SSR)
    auth/                    login, lien-envoye, verify
    dashboard/               espace famille (liste + édition d'inscriptions)
    profs/                   espace profs (classes + élèves)
    api/                     routes POST (request-link, logout, inscription)
scripts/vendor.mjs  copie alpinejs + open-props depuis node_modules

Webhooks n8n attendus

Voir le détail complet des 8 workflows (nodes, logique, format de réponse) dans docs/n8n-workflows.md, et le schéma des tables Baserow correspondantes dans docs/baserow-schema.md.

Résumé rapide des chemins (à adapter dans src/lib/n8n.ts si vous changez) :

Méthode Chemin Rôle
POST /webhook/auth/request-link cherche l'email dans Baserow, crée un token, envoie l'email
POST /webhook/auth/verify-link valide le token (un usage, expiration courte), renvoie {id,email,role,nom}
GET /webhook/evenements liste des événements publiés
POST /webhook/inscriptions crée une inscription (+ famille/élève si besoin)
GET /webhook/familles/:userId/inscriptions inscriptions liées à cette famille
GET /webhook/inscriptions/:id détail d'une inscription (vérifier l'appartenance !)
POST /webhook/inscriptions/:id mise à jour d'une inscription
GET /webhook/profs/:userId/classes classes + élèves du prof

Chaque webhook doit vérifier le header X-Webhook-Secret (== N8N_WEBHOOK_SECRET) pour éviter les appels non authentifiés.

Initialisation dans code-server

Ces commandes sont à lancer dans le terminal intégré de code-server (rien de spécifique à code-server : ce sont les commandes standard).

1. Prérequis sur la machine qui héberge code-server

node --version   # doit être en 20.x (voir "engines" dans package.json)
corepack enable
corepack prepare pnpm@9.15.9 --activate

Si Node n'est pas en 20.x, utiliser nvm/fnm dans l'image code-server, ou fixer la version de l'extension "Node.js" si vous en utilisez une.

2. Récupérer le projet

Si vous partez de cette base (dézippée) :

cd ~/workspace
unzip musique-asso.zip
cd musique-asso
git init
git branch -M main

3. Créer le dépôt sur Codeberg et pousser

Sur codeberg.org : New repository → musique-asso (vide, sans README auto-généré pour éviter un conflit).

git remote add origin git@codeberg.org:VOTRE_ORG/musique-asso.git
# ou en HTTPS : https://codeberg.org/VOTRE_ORG/musique-asso.git

git add .
git commit -m "Base Astro initiale"
git push -u origin main

Pensez à générer une clé SSH dans code-server (ssh-keygen -t ed25519) et à l'ajouter dans Codeberg → Settings → SSH Keys si vous poussez en SSH.

4. Config locale et premier lancement

cp .env.example .env
# éditer .env : SESSION_SECRET (openssl rand -base64 32), N8N_BASE_URL,
# N8N_WEBHOOK_SECRET

pnpm install       # installe + vendorise alpine.js et open-props automatiquement
pnpm run dev       # http://localhost:4321

5. Vérifier que le build de prod fonctionne avant de pousser

pnpm run build     # astro check (types) + astro build
node ./dist/server/entry.mjs   # sert la version buildée en local

6. CI Codeberg

Le pipeline .forgejo/workflows/ci.yml tourne sur un runner Forgejo Actions (à enregistrer sur l'org/dépôt si vous êtes en self-host, ou activer celui de Codeberg s'il est disponible pour votre compte). Il bloque si astro check, astro build ou le docker build échouent.

7. Déploiement Coolify

Dans Coolify : nouvelle Application → source Git → Codeberg (via un token d'accès ou une deploy key) → détection automatique du Dockerfile à la racine. Renseigner les variables d'environnement (SESSION_SECRET, N8N_BASE_URL, N8N_WEBHOOK_SECRET, PUBLIC_SITE_NAME) dans l'onglet Environment Variables de Coolify (jamais dans le repo). Le port exposé par le conteneur est 4321.

Configurer le déploiement pour ne se déclencher que sur push vers main après succès de la CI (webhook Coolify déclenché par Codeberg, ou étape manuelle tant que CI ↔ Coolify n'est pas branché automatiquement).

Points à trancher / TODO avant mise en prod

  • Ajouter une politique de renouvellement du cookie de session (actuellement 30 jours fixes) et un moyen de révoquer une session côté n8n/Baserow.
  • Rate-limiting sur /api/auth/request-link (anti-spam d'emails).
  • Vérification d'appartenance systématique côté n8n avant de renvoyer/modifier une inscription (ne jamais faire confiance à l'ID dans l'URL).
  • Page /inscription/merci à créer (redirection actuelle après succès).
  • Choix de la politique de rétention Baserow (RGPD : coordonnées de mineurs).