Backend Sveltia « gitea » avec application OAuth2 publique (PKCE), sans serveur d'authentification. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.3 KiB
Site de la MSP du Vallon de Marcillac
Site statique Astro édité par le client via Sveltia CMS (/admin), déployé sur l'hébergement mutualisé OVH par Gitea Actions (git.rodev.fr).
Client ─► /admin (Sveltia) ─► commit sur main ─► Action : build Astro ─► rsync SSH ─► OVH (préprod)
Pour l'instant, chaque commit sur main met à jour la préproduction : https://preprod.marcillacsante.fr (protégée par mot de passe, non indexée).
Développement
nvm use # Node 24 (cf. .nvmrc)
npm install
npm run dev # http://localhost:4321
Pour tester l'admin sans Gitea : ouvrir http://localhost:4321/admin/ dans Chrome ou Edge → « Travailler avec un dépôt local » → choisir ce dossier.
Où est quoi
| Contenu | Fichiers | Dans l'admin |
|---|---|---|
| Accueil, intros des pages Équipes / Actualité, coordonnées | src/content/reglages/*.yml |
Pages principales & réglages |
| Métiers (couleur, pictogramme, soins, encart RDV) | src/content/metiers/*.md |
Métiers |
| Praticiens | src/content/professionnels/*.md |
Praticiens |
| Actualités | src/content/actualites/*.md |
Actualités |
| Pages libres à blocs (À propos, Mentions légales…) | src/content/pages/*.md |
Pages |
| Images envoyées depuis l'admin | src/assets/uploads/ |
Médias |
Un champ ajouté au contenu doit être déclaré à deux endroits : src/content.config.ts (schéma) et public/admin/config.yml (formulaire de l'admin).
design/ contient la maquette Claude Design d'origine. Elle sert de référence et n'est pas versionnée.
Mise en production (à faire une seule fois)
- Dépôt : hébergé sur Gitea,
Rodev/MSP-Marcillacsur git.rodev.fr (backend.repodanspublic/admin/config.yml). - Authentification de l'admin : dans Gitea, Configuration → Applications → Créer une application OAuth2, avec comme URI de redirection l'adresse de chaque
/admin/(préprod, prod), Client confidentiel décoché. Mettre le Client ID dansbackend.app_id. Aucun serveur d'authentification n'est nécessaire (PKCE). - Déploiement OVH : générer une clé SSH dédiée (
ssh-keygen -t ed25519 -f msp-deploy), ajouter la clé publique dans~/.ssh/authorized_keyschez OVH, puis créer les secrets décrits en tête de.gitea/workflows/preprod.yml.
Préproduction
- OVH → Hébergement → Multisite → Ajouter un domaine :
preprod.marcillacsante.fr, dossier racinepreprod, cocher SSL (et la création de l'entrée DNS si le domaine est chez OVH). - Gitea → Paramètres du dépôt → Actions → Secrets : ceux de la connexion SSH, plus
PREPROD_USERetPREPROD_PASSWORD. - Pousser sur
main(ou lancer le workflow à la main). Le déploiement :- construit le site avec
SITE_URL=https://preprod.marcillacsante.fr(URL canoniques) ; - écrit
~/.htpasswd-preprodchez OVH, hors du dossier publié, à partir des secrets ; - ajoute l'authentification et l'en-tête
X-Robots-Tag: noindexen tête du.htaccess, et unrobots.txtqui interdit tout.
- construit le site avec
Changer le mot de passe = modifier le secret puis relancer le workflow.
4. Domaine : remplacer https://www.msp-marcillac.fr dans astro.config.mjs et public/admin/config.yml.
5. Client : lui créer un compte sur git.rodev.fr et l'ajouter comme collaborateur (droit Écriture) sur le dépôt.
Mode d'emploi pour le client
- Aller sur https://www.msp-marcillac.fr/admin/ puis cliquer sur « Se connecter avec Gitea ».
- Choisir une rubrique à gauche (Actualités, Praticiens…) et ouvrir une fiche, ou cliquer sur « Nouveau ».
- Modifier les textes. Pour une image, cliquer sur le champ puis « Envoyer » (JPG ou PNG ; le site les redimensionne tout seul).
- Cliquer sur Enregistrer. Le site en ligne est mis à jour environ 2 minutes plus tard.
- Ajouter un praticien : Praticiens → Nouveau, puis choisir son métier. Il apparaît automatiquement sur « Nos équipes » et sur la page de son métier.
- Ajouter une page : Pages → Nouveau, puis ajouter des blocs (texte, texte + image, encarts, grande image, bouton). Cocher « Afficher dans le menu » pour qu'elle apparaisse dans le menu.
- Ne jamais publier de données de santé sur le site.
test