Guide Day 1 - Setup Local

Audience : Nouveaux développeurs rejoignant l’équipe
Durée estimée : 2-4 heures
Prérequis : Sprint 0 terminé

1. Prérequis

1.1. Outils requis

Outil	Version minimale	Installation
Node.js	20+	https://nodejs.org/
Git	2.30+	https://git-scm.com/
VS Code	Dernière	https://code.visualstudio.com/
Wrangler CLI	Dernière	`npm install -g wrangler`
Sanity CLI	Dernière	`npm install -g @sanity/cli`

1.2. Comptes requis

Compte GitHub avec accès au repository
Compte Cloudflare avec accès au workspace
Compte Sanity avec accès au projet

2. Clonage du repository

# Cloner le repository
git clone git@github.com:votre-org/votre-repo.git

# Se déplacer dans le dossier
cd votre-repo

# Installer les dépendances
npm install

3. Configuration des variables d’environnement

3.1. Création du fichier `.env`

# Copier le fichier d'exemple
cp .env.example .env

3.2. Remplir les variables

SANITY_PROJECT_ID=your-project-id
SANITY_DATASET=production
SANITY_API_READ_TOKEN=your-read-token
SANITY_API_WRITE_TOKEN=your-write-token
SANITY_PREVIEW_SECRET=your-preview-secret

CLOUDFLARE_ACCOUNT_ID=your-account-id

Où trouver ces valeurs :

SANITY_PROJECT_ID : Dashboard Sanity → Settings → API
SANITY_DATASET : production ou staging
SANITY_API_READ_TOKEN : Dashboard Sanity → Settings → API → Tokens
SANITY_API_WRITE_TOKEN : Dashboard Sanity → Settings → API → Tokens
SANITY_PREVIEW_SECRET : Généré aléatoirement (ex: openssl rand -base64 32)
CLOUDFLARE_ACCOUNT_ID : Dashboard Cloudflare → Workers & Pages → Account ID

4. Authentification

4.1. Cloudflare Wrangler

# Authentification
wrangler login

# Vérification
wrangler whoami

4.2. Sanity CLI

# Authentification
sanity login

# Vérification
sanity manage whoami

5. Configuration VS Code

5.1. Extensions recommandées

Extension	Usage
Astro	Support Astro
Sanity	Support Sanity
Tailwind CSS IntelliSense	Support Tailwind
ESLint	Linting
Prettier	Formatting
GitLens	Git amélioré

5.2. Configuration `.vscode/settings.json`

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  },
  "files.associations": {
    "*.astro": "astro"
  }
}

6. Lancement du serveur de développement

6.1. Build local

# Build du projet
npm run build

# Preview local
npm run preview

6.2. Développement local

# Serveur de développement
npm run dev

Le site sera accessible sur http://localhost:4321.

7. Tests

7.1. Lancer les tests

# Tests unitaires
npm run test

# Tests E2E
npm run test:e2e

7.2. Linting

# Linting
npm run lint

# Type checking
npm run typecheck

8. Workflow Git

8.1. Créer une branche

# Se mettre sur develop
git checkout develop

# Pull les dernières modifications
git pull origin develop

# Créer une branche feature
git checkout -b feature/slice-X-tache

8.2. Commiter les modifications

# Ajouter les fichiers
git add .

# Commiter
git commit -m "feat: description de la modification"

# Pusher
git push origin feature/slice-X-tache

8.3. Créer une Pull Request

Aller sur GitHub
Cliquer sur “New Pull Request”
Sélectionner la branche feature/slice-X-tache vers develop
Remplir le template de PR
Soumettre pour review

9. Déploiement local (Wrangler)

9.1. Déploiement staging

# Déploiement staging
wrangler pages deploy dist --project-name=votre-projet-staging

9.2. Logs en temps réel

# Logs du worker
wrangler tail

10. Sanity Studio local

10.1. Lancer le Studio

# Lancer le Studio
npm run sanity:dev

Le Studio sera accessible sur http://localhost:3333.

11. Dépannage

11.1. Problèmes courants

Symptôme	Cause probable	Solution
`npm install` échoue	Version Node.js incompatible	Mettre à jour Node.js
`wrangler login` échoue	Permissions insuffisantes	Vérifier les permissions Cloudflare
Variables d’environnement non chargées	Fichier `.env` manquant	Créer le fichier `.env`
Build échoue	Dépendances manquantes	`npm install`

11.2. Ressources

Documentation Astro : https://docs.astro.build/
Documentation Sanity : https://www.sanity.io/docs
Documentation Cloudflare : https://developers.cloudflare.com/

12. Checklist de validation

Avant de commencer le développement, vérifier :

13. Prochaines étapes

Une fois le setup local terminé :

Lire le guide de contribution (CONTRIBUTING.md)
Lire la méthodologie de développement (Standard-operating-procedure.md)
Consulter l’ordre des slices (Phase0-Ordre-Slices.md)
Commencer par Slice 1 : Schéma Sanity “page”

14. Support

En cas de problème :

Canal Slack : #dev
Email : dev@votre-entreprise.com
Documentation : Repository GitHub

15. Historique des modifications

Date	Version	Description	Auteur
YYYY-MM-DD	1.0	Création initiale	[Nom]