Files
MSP-Marcillac/README.md
T
Romulus21 9cc1530f2e
Déploiement / deploy (push) Failing after 6m40s
first commit
2026-10-29 15:36:23 +01:00

52 lines
3.2 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 GitHub Actions.
```
Client ─► /admin (Sveltia) ─► commit sur GitHub ─► Action : build Astro ─► rsync SSH ─► OVH
```
## Développement
```sh
nvm use # Node 24 (cf. .nvmrc)
npm install
npm run dev # http://localhost:4321
```
Pour tester l'admin sans GitHub : 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 GitHub** : créer le dépôt, pousser, puis renseigner `backend.repo` dans `public/admin/config.yml`.
2. **Authentification de l'admin** : déployer le Worker Cloudflare [sveltia-cms-auth](https://github.com/sveltia/sveltia-cms-auth), créer une *OAuth App* GitHub dont l'URL de callback est `https://<worker>/callback`, puis renseigner `backend.base_url`.
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 `.github/workflows/deploy.yml`.
4. **Domaine** : remplacer `https://www.msp-marcillac.fr` dans `astro.config.mjs` et `public/admin/config.yml`.
5. **Client** : l'inviter comme collaborateur (droit *Write*) sur le dépôt GitHub.
## Mode d'emploi pour le client
1. Aller sur **https://www.msp-marcillac.fr/admin/** puis cliquer sur « Se connecter avec GitHub ».
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.