chocolatine.be - Epic 1 MVP

Base Next.js (App Router) + Tailwind pour l Epic 1:

• US-001: homepage + recherche ville/commerce en base locale
• US-002: pages legales FR
• US-003: disclaimers non-affiliation sur page commerce

Lancer localement

npm install
npm run dev

Base PostgreSQL locale (Docker)

1. Copier les variables d'environnement:

cp .env.example .env

2. Demarrer PostgreSQL:

npm run db:up

Si le port 5432 est deja utilise, lancer sur un autre port:

POSTGRES_PORT=55432 npm run db:up

3. Appliquer les migrations Prisma:

npm run prisma:migrate

4. Generer le client Prisma:

npm run prisma:generate

Import BCE/KBO (boulangeries et patisseries)

Import complet (full refresh):

npm run import:boulangeries -- --data-dir ./data

Options:

• --nace-version (defaut: 2025)
• --nace-codes (codes/prefixes NACE, separes par virgules)

Codes utilises par defaut:

• 10.7 Fabrication de produits de boulangerie-patisserie et de pates alimentaires
• 10.71 Fabrication de pain; fabrication de patisserie fraiche
• 10.712 Fabrication artisanale de pain et de patisserie fraiche
• 47.241 Commerce de detail de pain et de patisserie (depots)

Exemple:

npm run import:boulangeries -- --data-dir ./data --nace-version 2025 --nace-codes "10.7,10.71,10.712,47.241"

Verifications SQL rapides:

SELECT COUNT(*) FROM "Commerce";
SELECT COUNT(*) FROM "ImportRun" WHERE status = 'SUCCESS';
SELECT "establishmentNumber", "slug" FROM "Commerce" LIMIT 20;

Brancher l UI sur la DB locale

1. Configurer DATABASE_URL dans .env (adapter le port si besoin):

DATABASE_URL=postgresql://chocolatine:chocolatine@localhost:5432/chocolatine?schema=public

2. Demarrer l app:

npm run dev

3. Recherche live disponible via:

• endpoint GET /api/search?q=...&limit=...
• homepage / (suggestions dynamiques)
• pages /boulangeries/[ville] et /boulangerie/[slug] alimentees depuis PostgreSQL

Verification

npm run typecheck
npm run test
npm run test:e2e

Configuration legale

Mettre a jour les placeholders dans:

• lib/site-config.ts

Routes publiques

• /
• /cookies
• /mentions-legales
• /politique-confidentialite
• /gerer-ou-supprimer-cette-fiche
• /boulangerie/[slug]
• /boulangeries/[ville]