Anatomie d'un projet

mon-site/
├── astro.config.mjs           ★ intégration, langues, sortie statique
├── package.json               ★ scripts du site
├── wrangler.toml                configuration des fonctions chez l'hébergeur
├── tsconfig.json
├── .env.example                 modèle de variables — le seul versionné
├── .dev.vars                    variables locales — ignoré par Git
├── .gitignore
│
├── functions/
│   └── api/
│       ├── auth.ts              ┐
│       ├── content.ts           │ quatre adaptateurs de 5 lignes,
│       ├── save.ts              │ jamais une règle
│       └── upload.ts            ┘
│
├── scripts/
│   ├── check-html.mjs           contenu présent dans le HTML brut
│   ├── check-locales.mjs        parité des clés entre langues
│   ├── check-logs.mjs           aucun secret dans un console.*
│   ├── check-secrets.mjs        aucun secret dans dist/
│   ├── make-key.mjs             une clé et son empreinte — la rotation
│   └── mock-git-api.mjs         faux dépôt local
│
├── src/
│   ├── content/
│   │   ├── config.ts            déclaration de la collection (schéma du paquet)
│   │   ├── site.json          ★ navigation, coordonnées, pied de page
│   │   ├── site.ts              validation de site.json au build
│   │   └── pages/
│   │       ├── fr/home.json   ★ LE contenu — une page, une langue, un fichier
│   │       └── en/home.json   ★
│   │
│   ├── components/            ★ vos composants — statiques par défaut
│   │   └── Testimonial.astro
│   ├── layouts/
│   │   └── Base.astro         ★ métadonnées, navigation, pied de page
│   ├── lib/
│   │   └── locales.ts         ★ les langues de CE site
│   ├── media/                 ★ les images — dans src/, pas dans public/
│   │   └── library.ts           créé par l'intégration, à laisser tel quel
│   ├── pages/
│   │   └── [lang]/[...slug].astro  ★ le gabarit de page
│   └── styles/
│       └── theme.css          ★ LA charte : palette, échelle, rythme
│
└── .github/workflows/ci.yml     contrôles automatiques

inline-core/
├── astro/index.ts             l'intégration : /admin, /aide, overlay, amorce
├── components/
│   ├── Editable.astro         un champ texte ou richtext
│   ├── Media.astro            une image ou une vidéo
│   └── Collection.astro       une liste + son template d'item
├── pages/
│   ├── admin.astro            la page de saisie de la clé
│   └── aide.astro             l'aide du client, clé en main
├── styles/tokens.css          une classe par valeur du schéma
└── src/
    ├── schema.ts              LE modèle de contenu (Zod) — build ET serveur
    ├── style-tokens.ts        les variantes autorisées, source unique
    ├── safe-href.ts           ce qu'est un lien sûr, des deux côtés
    ├── video.ts               lecture d'une adresse YouTube / Vimeo
    ├── translate.ts           repli de traduction (pas la liste des langues)
    ├── editor/                l'overlay — TypeScript sans framework
    │   ├── index.ts           la boucle : un chemin, un pointeur, une mutation
    │   ├── bar.ts             barre flottante et bandeaux
    │   ├── toolbar.ts         barre de variantes et de richtext
    │   ├── media.ts           panneau image / vidéo
    │   ├── collection.ts      ajout, duplication, déplacement, suppression
    │   ├── draft.ts           brouillon local
    │   ├── sanitize.ts        assainissement côté navigateur
    │   ├── heic.ts            décodage des photos d'iPhone, à la demande
    │   └── api.ts             les appels aux quatre routes
    └── server/
        ├── auth.ts            verifyAuth / createSession — seul juge de l'identité
        ├── guard.ts           débit, plafonds, chemins autorisés
        ├── rate-limit.ts      comptage des appels, stockage interchangeable
        ├── git-provider.ts    l'interface du fournisseur Git
        ├── github.ts          implémentation GitHub (version = SHA du blob)
        ├── gitlab.ts          signature + notes — non implémenté
        ├── image.ts           reconnaissance des formats aux octets
        ├── sanitize.ts        assainissement côté serveur (sans DOM)
        └── routes/            les quatre routes, en fabriques configurables