Le projet en chiffres

Cette page donne la taille réelle du projet, mesurée dans le dépôt le 12 novembre 2026 sur la branche marceau, fichiers de la refonte des comptes et du mobile, de l'espace Paramètres du mobile et de la dernière série de corrections (ticket de connexion, comptes Mairie, pages légales, scripts Sepolia) compris, y compris ceux qui ne sont pas encore commités. Chaque chiffre est accompagné de la méthode de comptage, pour pouvoir le recalculer après une évolution. Les commandes se lancent depuis la racine du dépôt, dans un terminal Bash (Git Bash sous Windows).

#Vue d'ensemble

#API

70 routes, comptées comme le fait le générateur de la référence de l'API : chaque appel router.get|post|put|patch|delete( des fichiers *.routes.ts.

grep -cE "router\.(get|post|put|patch|delete)\(" backend/src/api/*/*.routes.ts

Les 65 routes métier sont servies deux fois : sous /api/v1 (préfixe à utiliser) et sous /api (compatibilité). Les 5 routes système (/health, /health/live, /health/ready, /health/deep, /api/config) sont montées à la racine. /metrics et /api/docs sont montés directement dans backend/src/app.ts et ne sont pas comptés.

Répartition par niveau d'accès : 23 routes publiques (dont les 5 sondes, le webhook signé et les 5 routes d'inscription, de connexion par mot de passe ou Google et de réinitialisation), 27 réservées à un utilisateur connecté, 5 aux rôles PARTNER ou ADMIN, 15 au rôle ADMIN seul.

#Interfaces

#Frontend web : 35 pages

Une page Next.js (App Router) est un fichier page.tsx sous frontend-web/src/app/.

find frontend-web/src/app -name page.tsx | wc -l

Les pages d'erreur (error.tsx, global-error.tsx, not-found.tsx) et les trois layout.tsx d'espace ne sont pas comptées. Le détail est dans Pages et espaces.

#Application mobile : 32 écrans

find mobile-app/src/screens -type f | wc -l

7 écrans d'authentification, 8 de loterie, 4 de boutique, 12 de profil et réglages (dont l'écran Legal des documents légaux) et 1 de parrainage, déclarés dans les navigateurs de mobile-app/src/navigation/. L'application mobile ne couvre que l'espace citoyen : les espaces Mairie et partenaire sont uniquement sur le web. Voir Navigation et écrans.

#Office de Tourisme

14 pages HTML statiques à la racine de frontend-office-tourisme/.

git ls-files frontend-office-tourisme | grep -cE "^frontend-office-tourisme/[^/]+\.html$"

#Données

Le détail est dans le modèle de données et la page Migrations.

#Configuration

59 variables d'environnement, déclarées dans le schéma Zod de backend/src/config/env.config.ts. Le script npm run env:check du backend vérifie que backend/.env.example contient exactement ces variables. Le frontend web lit 2 variables (NEXT_PUBLIC_API_URL, NEXT_PUBLIC_WS_URL) et l'application mobile 7 (EXPO_PUBLIC_API_URL, EXPO_PUBLIC_WS_URL, EXPO_PUBLIC_SENTRY_DSN, EXPO_PUBLIC_HELP_CENTER_URL et les trois identifiants client Google EXPO_PUBLIC_GOOGLE_IOS_CLIENT_ID, EXPO_PUBLIC_GOOGLE_ANDROID_CLIENT_ID, EXPO_PUBLIC_GOOGLE_WEB_CLIENT_ID, listés vides dans mobile-app/.env.example).

#Smart contracts

« Lignes de code » exclut les lignes vides et les lignes de commentaire :

grep -cvE '^\s*$|^\s*//|^\s*/?\*' smart-contract/contracts/BlockLucky.sol

BlockLucky déclare 11 événements et 18 erreurs personnalisées ; BlockLuckyPOAP 2 événements et 3 erreurs. Avec les éléments hérités d'OpenZeppelin et de Chainlink, l'ABI de BlockLucky expose 46 fonctions, 19 événements et 26 erreurs. Le contrat est compilé avec Solidity 0.8.34 (smart-contract/hardhat.config.ts).

#Tests

Un cas de test est un appel it( ou test( (TypeScript) ou une fonction test... (Solidity).

grep -cE "^\s*(it|test)\(\s*['\"\`]" backend/__tests__/*/*.ts

La couverture des contrats de production est de 100 % des lignes, contrôlée par npm run coverage:check (smart-contract/scripts/check-coverage.mjs). Le détail des suites est dans Tests, fuzzing et couverture et Tests du backend.

#Temps réel

13 événements sont typés dans backend/src/types/socket.types.ts : 9 du serveur vers les clients et 4 des clients vers le serveur (draw:join, draw:leave, chat:send, chat:react).

Le serveur n'émet réellement que 5 des 9 événements déclarés : draw:waiting-room, draw:winner, chat:message, chat:reaction et points:awarded. Les événements draw:countdown, draw:started, queue:position et network:fallback sont déclarés mais jamais émis ni écoutés.

grep -rnoE "emit\(\s*'[a-z:-]+'" backend/src | sort -u

#Infrastructure

#Code source

Fichiers TypeScript et JavaScript versionnés, hors tests et hors configuration :

(git ls-files backend/src; git ls-files --others --exclude-standard backend/src) | grep -E '\.(ts|tsx|js|mjs)$' | xargs cat | wc -l

Le dépôt compte 693 fichiers, versionnés ou non encore commités, hors dossier documentation-officielle/ et hors cache local mobile-app/.expo/.

#Historique Git

Tous les commits de la branche sont signés du même auteur Git ; seuls 12 commits de Dependabot existent sur d'autres branches distantes. Les livrables UX, marketing et budget de l'équipe sont des documents PDF hors dépôt. Les grandes étapes sont résumées dans Historique et feuille de route.