first commit

CLAUDE.md

@@ -0,0 +1,85 @@
+# CLAUDE.md — Portfolio johanleroy.fr
+
+Site vitrine personnel en **Astro 6 hybrid** (SSG public + SSR admin), identité **Cyberpunk Dark / Free Party tekno**.
+
+## Contexte rapide
+
+- Utilisateur : **Johan Leroy** — dev fullstack + DJ tekno
+- Objectif : remplacer l'ancien portfolio Angular 19 (`~/WebstormProjects/Portfolio_angular/`) par une version moderne, animée, maintenable sans recompilation
+- Déploiement : **Plesk Node.js** sur `johanleroy.fr` (CI Gitea FTP)
+- Commande `/context johanleroy` charge tout le contexte projet
+
+## Stack
+
+- **Astro 6** hybrid (`output: 'static'` + `@astrojs/node` standalone)
+- **React 19** (îlots interactifs uniquement)
+- **Tailwind CSS 4** + design system custom
+- **Framer Motion** + **Lenis** (animations)
+- **Zod** (schémas de contenu)
+- **jose + bcryptjs** (auth admin)
+- **@iconify-icon/react** (icônes simple-icons + lucide)
+
+## Points critiques à connaître
+
+### Content
+Tout le contenu du site est dans `public/content/*.json` (7 fichiers). Chaque fichier est validé par un schéma Zod dans `src/content/schemas/`. Édition possible via `/admin` ou directement en éditant le JSON.
+
+### Admin
+Protégé par mot de passe bcrypt + JWT cookie httpOnly 7j. Middleware dans `src/middleware.ts`. Routes `/admin/*` et `/api/*` ont `export const prerender = false`.
+
+### Env vars (.env)
+```
+ADMIN_PASSWORD_HASH=$2b$12$...
+ADMIN_JWT_SECRET=...
+PORT=3100
+```
+Générer : `npm run hash:password -- 'monMotDePasse'` (⚠️ **guillemets simples** toujours — les `!` et `$` sont interprétés par bash sinon).
+
+Important : `src/lib/auth.ts` lit à la fois `import.meta.env` (dev Vite) ET `process.env` (prod Node standalone). Ne pas casser ce merge.
+
+### Design
+- **Palette** : `--color-bg #0A0A0F`, `--color-cyan #00F0FF`, `--color-acid #C6FF00`, `--color-magenta #FF2A6D`, `--color-red #FF0040`
+- **Typos** : Inter (body), Space Grotesk (display), JetBrains Mono (code), **Bebas Neue** (stencil signature)
+- **Dark only** — pas de light mode
+- **Ligne éditoriale** : pro avant tout (nav FR, URLs grand public), free party = déco (stickers, BPM, LED, stencil)
+
+### Animations
+Tous les composants animés **doivent** respecter `prefers-reduced-motion`. Les 14 blocs livrés sont listés dans la memory `animations-blocks.md`.
+
+### Feedback important
+- ❌ Pas de 3D Hero pour l'instant (supprimé — on y reviendra)
+- ❌ Pas de curseur custom (supprimé)
+- ✅ Nav FR standards (`/projets`, `/experience`, `/formations`)
+- ✅ Sons off par défaut, togglables via header
+- ✅ Boot sequence au 1er load uniquement (sessionStorage)
+- ✅ Responsive : fallback grid pour le Crate horizontal pinned sur mobile
+
+## Commandes utiles
+
+- `npm run dev` — port 3100
+- `npm run build` — check + build prod
+- `npm run check` — `astro check`
+- `npm run hash:password -- 'mdp'` — génère bcrypt + JWT secret
+
+## Conventions de code
+
+- Tous les îlots React dans `src/components/islands/`
+- Composants Astro pure (sans JS) directement dans `src/components/`
+- Les schémas Zod sont la source de vérité pour les types — **ne pas** écrire de type custom à la main pour le contenu
+- `astro check` doit passer à 0 erreur avant commit
+- Utiliser `className` en TSX et `class` en Astro (erreur Astro commune)
+
+## Workflow d'édition
+
+1. Lire `docs/README.md` puis `docs/01-analyse-et-plan.md` + `docs/02-moodboard-freeparty.md` pour la direction artistique
+2. Pour un changement de contenu → éditer `public/content/*.json` (ou via `/admin`)
+3. Pour un changement de design → modifier `src/styles/global.css` + composants
+4. Pour un changement structurel → modifier schéma Zod d'abord, puis composant, puis JSON
+
+## Ne PAS faire sans demander
+
+- Ne pas changer la stack (Astro + React + Tailwind 4 est verrouillé)
+- Ne pas réintroduire de 3D hero sans validation
+- Ne pas retirer le respect `prefers-reduced-motion`
+- Ne pas commiter `.env` (vérifier `.gitignore`)
+- Ne pas toucher à `dist/` (généré par build)