Application Web de gestion du budget

Module	Version
IHM
Services serverless

Statut

Description

Frontend React/TypeScript strict de gestion du budget personnel. L'application permet de consulter les comptes, analyser les operations, gerer les budgets et naviguer via HashRouter. Les echanges HTTP passent par ClientHTTP.service.ts, avec etat global centralise dans BudgetContextProvider.tsx.

---

Prérequis

• Node.js version épinglée dans .nvmrc et npm 10+
• Un fichier .env.dev (ou .env.qua / .env.prod) sous external-ressources/conf/

---

Installation

npm ci --ignore-scripts

---

Démarrage local

npm run start:dev     # utilise .env.dev (http://localhost:3000)
npm run start:qua     # utilise .env.qua
npm run start:prod    # utilise .env.prod

---

Commandes

# Lancer tous les tests (mode watch)
npm run test

# Tests en CI (sans watch, avec coverage)
npm run test:coverage

# Lancer le linter
npm run lint

# Build de production
npm run build

---

Variables d'environnement

Préfixe VITE_* (migré depuis REACT_APP_*, voir ADR 001). Chaque fichier .env.* doit définir :

Variable	Description
VITE_CONFIG_URL_COMPTES	URL µService comptes
VITE_CONFIG_URL_OPERATIONS	URL µService opérations
VITE_CONFIG_URL_PARAMS	URL µService paramètres
VITE_CONFIG_URL_UTILISATEURS	URL µService utilisateurs
VITE_CONFIG_OIDC_AUTHORITY	URL autorité OIDC (Google)
VITE_CONFIG_OIDC_CLIENT_ID	Client ID Google OAuth
VITE_CONFIG_OIDC_CLIENT_SECRET	Secret Google OAuth
VITE_CONFIG_API_KEY	Clé API Gateway AWS (X-Api-Key)

---

Documentation

• Architecture
• Instructions Copilot
• Wiki du projet
• Backend (gestion-budget-serverless)