- Astro 60.7%
- TypeScript 25.6%
- CSS 6.1%
- JavaScript 5.9%
- Dockerfile 1.7%
| .forgejo/workflows | ||
| docs | ||
| public | ||
| scripts | ||
| src | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| astro.config.mjs | ||
| Dockerfile | ||
| LICENSE | ||
| package.json | ||
| pnpm-lock.yaml | ||
| README.md | ||
| tsconfig.json | ||
Site ACL 2026
Base Astro pour le site de gestion de l'école de musique associative.
Stack
- Astro (
output: server, adapter@astrojs/nodestandalone) — les pages vitrine (/,/auth/lien-envoye,/inscription) sont marquéesexport const prerender = trueet 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/parscripts/vendor.mjs(hookpostinstall) — 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.tsvérifie ce cookie. - n8n est la seule couche qui parle à Baserow (
src/lib/n8n.tsfait 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).