Files
MSP-Marcillac/README.md
T
Romulus21andClaude Opus 5.5 4e7cf6d761
Préproduction / deploy (push) Successful in 27s
Admin : connexion via Gitea (git.rodev.fr) au lieu de GitHub
Backend Sveltia « gitea » avec application OAuth2 publique (PKCE),
sans serveur d'authentification.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 18:04:50 +01:00

67 lines
4.3 KiB
Markdown

# Site de la MSP du Vallon de Marcillac
Site statique [Astro](https://astro.build) édité par le client via [Sveltia CMS](https://sveltiacms.app) (`/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
```sh
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)
1. **Dépôt** : hébergé sur Gitea, `Rodev/MSP-Marcillac` sur git.rodev.fr (`backend.repo` dans `public/admin/config.yml`).
2. **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* dans `backend.app_id`. Aucun serveur d'authentification n'est nécessaire (PKCE).
3. **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_keys` chez OVH, puis créer les secrets décrits en tête de `.gitea/workflows/preprod.yml`.
## Préproduction
1. **OVH → Hébergement → Multisite → Ajouter un domaine** : `preprod.marcillacsante.fr`, dossier racine `preprod`, cocher SSL (et la création de l'entrée DNS si le domaine est chez OVH).
2. **Gitea → Paramètres du dépôt → Actions → Secrets** : ceux de la connexion SSH, plus `PREPROD_USER` et `PREPROD_PASSWORD`.
3. 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-preprod` chez OVH, hors du dossier publié, à partir des secrets ;
- ajoute l'authentification et l'en-tête `X-Robots-Tag: noindex` en tête du `.htaccess`, et un `robots.txt` qui interdit tout.
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
1. Aller sur **https://www.msp-marcillac.fr/admin/** puis cliquer sur « Se connecter avec Gitea ».
2. Choisir une rubrique à gauche (Actualités, Praticiens…) et ouvrir une fiche, ou cliquer sur « Nouveau ».
3. Modifier les textes. Pour une image, cliquer sur le champ puis « Envoyer » (JPG ou PNG ; le site les redimensionne tout seul).
4. 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