Lancer les applications

Cette page lance, dans l'ordre, le backend, le frontend web, l'application mobile et le site de l'Office de Tourisme sur un poste de développement. Elle suppose que l'infrastructure locale tourne (docker compose up -d --wait). Chaque application se lance dans son propre terminal.

flowchart LR
    I["Docker Compose : PostgreSQL, Redis, Mailpit, blockchain"] --> B["Backend : migrations, seed, npm run dev"]
    B --> W["Frontend web : npm run dev"]
    B --> M["Mobile : npm start"]
    T["Office de Tourisme : npm run dev"]

Le site de l'Office de Tourisme est indépendant : il ne dépend ni du backend ni de l'infrastructure.

#Backend

Depuis backend/ :

cp .env.example .env
npm ci
npx prisma generate
npm run prisma:deploy
npm run prisma:seed
npm run dev

Au démarrage, la configuration est validée par backend/src/config/env.config.ts. Une valeur invalide arrête le processus avec la liste des erreurs, sous la forme « Configuration invalide, démarrage interrompu ». Le serveur écoute ensuite sur le port 2053 et journalise :

• « Serveur BlockLucky démarré sur http://localhost:2053 » ;
• « Documentation Swagger disponible sur http://localhost:2053/api/docs » ;
• « Indexation blockchain et automate du tirage démarrés », qui confirme le mode onchain.

#Workers

Par défaut (RUN_WORKERS=true), le processus de l'API exécute aussi les workers BullMQ (emails, ledger, actions on-chain), l'indexeur et le keeper. Pour les séparer, comme en production :

RUN_WORKERS=false npm run dev

npm run dev:worker

Le worker expose ses sondes sur le port PORT + 1, soit 2054 (/health/live, /metrics).

#Vérifier le backend

curl -s http://localhost:2053/api/v1/lottery/status

#Frontend web

Depuis frontend-web/ :

cp .env.example .env
npm ci
npm run dev

Le site est servi sur http://localhost:3000. Le fichier frontend-web/.env.example contient deux variables :

Ces variables sont lues au moment de la compilation par Next.js et servent aussi à construire la Content-Security-Policy dans frontend-web/next.config.mjs. Après une modification, redémarrer npm run dev. Sans fichier .env, les mêmes valeurs par défaut s'appliquent (frontend-web/src/lib/config.ts).

Autres scripts utiles :

#Application mobile

Depuis mobile-app/ :

cp .env.example .env
npm ci
npm start

npm start lance expo start : le serveur Metro écoute sur le port 8081 et affiche un QR code. Le scanner avec Expo Go, ou taper a pour un émulateur Android et i pour un simulateur iOS (macOS). Les scripts npm run android et npm run ios lancent directement la plateforme voulue.

L'application mobile n'a pas de script test : ses tests ne s'exécutent pas aujourd'hui. Les contrôles disponibles sont npm run typecheck et npm run lint.

#Office de Tourisme

Depuis frontend-office-tourisme/ :

npm run dev

Le script télécharge au besoin serve 14.2.7 et sert le dossier sur http://localhost:4000, avec la configuration de frontend-office-tourisme/serve.json. Aucune installation préalable n'est nécessaire.

#Smart contracts

La blockchain locale en conteneur suffit pour utiliser l'application. Pour travailler sur les contrats, depuis smart-contract/ :

npm ci
npm test

Les autres commandes (couverture, gaz, Slither, export des ABI) sont dans Tests, fuzzing et couverture. Après une modification d'un contrat, il faut exporter les ABI vers le backend (npm run export:abi) et reconstruire l'image de la blockchain locale.

#Récapitulatif des adresses

#Tests du backend

Voir Tests du backend.

La suite se passe dans Comptes de démonstration et connexion.