feat: EVODRON architecture — rate limiting, health check, Docker, CI, docs

Co-authored-by: julesdemangeot-ship-it <307666271+julesdemangeot-ship-it@users.noreply.github.com>

Author: Copilot

.env.example

@@ -0,0 +1,29 @@
+# Variables d'environnement — Evodron
+
+# Copier ce fichier en `.env` et remplir les valeurs.
+# Ne jamais committer `.env` dans le dépôt.
+
+# ── Sécurité ──────────────────────────────────────────────────────────────
+# Clé secrète JWT. Utiliser une valeur aléatoire longue (minimum 32 caractères).
+# Exemple : openssl rand -hex 32
+JWT_SECRET=changeme-use-a-long-random-value-here
+
+# Durée de validité des tokens JWT (défaut : 7d)
+# Formats acceptés : "7d", "24h", "3600s"
+JWT_EXPIRY=7d
+
+# ── Serveur ───────────────────────────────────────────────────────────────
+PORT=3000
+
+# URL publique de l'application (utilisée pour générer les liens de parrainage)
+# Exemple : https://app.evodron.com
+APP_URL=http://localhost:3000
+
+# ── Base de données ───────────────────────────────────────────────────────
+# Chemin vers le fichier SQLite (défaut : ./evodron.db)
+# Utiliser :memory: pour les tests uniquement
+DB_PATH=./evodron.db
+
+# ── Environnement ─────────────────────────────────────────────────────────
+# Valeurs : development | production | test
+NODE_ENV=development

.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        env:
+          JWT_SECRET: test-secret-ci
+          DB_PATH: ":memory:"
+          NODE_ENV: test
+        run: npm test

CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Guide de contribution — Evodron
+
+Merci de contribuer à Evodron ! Voici les règles à suivre.
+
+## Pré-requis
+
+- Node.js >= 18
+- npm >= 9
+
+## Installation locale
+
+```bash
+git clone https://github.com/julesdemangeot-ship-it/EVODRON.git
+cd EVODRON
+npm install
+cp .env.example .env
+# Éditer .env et définir JWT_SECRET
+```
+
+## Lancer les tests
+
+```bash
+npm test
+```
+
+Les tests utilisent une base SQLite en mémoire. Aucune configuration externe requise.
+
+## Conventions
+
+- **Code** : `'use strict'` en tête de chaque fichier JS.
+- **Commits** : messages en anglais, préfixés (`feat:`, `fix:`, `chore:`, `docs:`, `test:`).
+- **Branches** : `feature/<nom>`, `fix/<nom>`, `chore/<nom>`.
+- **Tests** : toute nouvelle fonctionnalité doit être accompagnée de tests dans `tests/`.
+
+## Structure du code EVODRON
+
+Voir `EVODRON.md` pour la description complète de l'architecture.
+
+## Pull Requests
+
+1. Créer une branche depuis `main`.
+2. Écrire ou adapter les tests.
+3. S'assurer que `npm test` passe à 100%.
+4. Ouvrir une PR avec une description claire.
+
+## Sécurité
+
+Voir `SECURITY.md` pour signaler une vulnérabilité.

Dockerfile

@@ -0,0 +1,22 @@
+FROM node:20-alpine
+
+WORKDIR /app
+
+# Install dependencies first (layer cache)
+COPY package*.json ./
+RUN npm ci --omit=dev
+
+# Copy application source
+COPY app.js ./
+COPY src/ ./src/
+COPY public/ ./public/
+
+# SQLite database volume mount point
+VOLUME ["/data"]
+ENV DB_PATH=/data/evodron.db
+
+EXPOSE 3000
+
+USER node
+
+CMD ["node", "app.js"]

EVODRON.md

@@ -0,0 +1,156 @@
+# Evodron
+
+**Plateforme de parrainage** — backend Node.js/Express, base SQLite, frontend statique.
+
+> ℹ️ Le fichier `README.md` à la racine documente le **GitHub Copilot CLI** (outil de développement intégré à ce dépôt). Ce fichier `EVODRON.md` documente le **produit EVODRON** lui-même.
+
+---
+
+## Architecture
+
+```
+evodron/
+├── app.js                  # Point d'entrée Express
+├── public/                 # Frontend statique (HTML/CSS/JS)
+│   ├── index.html
+│   ├── login.html
+│   ├── register.html
+│   ├── dashboard.html
+│   ├── referral.html
+│   ├── css/style.css
+│   └── js/referral.js
+├── src/
+│   ├── config/
+│   │   └── rewards.js      # Configuration des récompenses
+│   ├── db/
+│   │   ├── database.js     # Connexion SQLite (better-sqlite3)
+│   │   └── schema.sql      # Schéma de la base de données
+│   ├── middleware/
+│   │   ├── auth.js         # Vérification JWT
+│   │   └── rateLimiter.js  # Rate limiting par IP
+│   ├── models/
+│   │   ├── user.js         # Modèle utilisateur
+│   │   ├── referral.js     # Modèle parrainage
+│   │   └── reward.js       # Modèle récompenses
+│   └── routes/
+│       ├── auth.js         # /api/auth (register, login)
+│       ├── health.js       # /api/health
+│       └── referral.js     # /api/referral (link, stats, rewards, activate-use)
+└── tests/
+    ├── referral.test.js    # Tests flux de parrainage
+    └── anti-abuse.test.js  # Tests anti-fraude
+```
+
+## Prérequis
+
+- **Node.js** >= 18
+- **npm** >= 9
+
+## Installation
+
+```bash
+git clone https://github.com/julesdemangeot-ship-it/EVODRON.git
+cd EVODRON
+npm install
+cp .env.example .env
+# Éditer .env et définir JWT_SECRET
+```
+
+## Démarrage
+
+```bash
+JWT_SECRET=votre-clé-secrète npm start
+# ou avec le fichier .env :
+npm start
+```
+
+Le serveur écoute sur `http://localhost:3000` (configurable via `PORT`).
+
+## Tests
+
+```bash
+npm test
+```
+
+Tous les tests utilisent une base SQLite en mémoire (`DB_PATH=:memory:`). Aucune configuration supplémentaire n'est requise.
+
+## API
+
+### Authentification
+
+| Méthode | Endpoint | Description |
+|---------|----------|-------------|
+| `POST` | `/api/auth/register` | Créer un compte (avec code de parrainage optionnel) |
+| `POST` | `/api/auth/login` | Se connecter, obtenir un token JWT |
+
+### Parrainage
+
+| Méthode | Endpoint | Auth | Description |
+|---------|----------|------|-------------|
+| `GET` | `/api/referral/link` | ✅ | Obtenir son lien de parrainage |
+| `GET` | `/api/referral/stats` | ✅ | Statistiques de parrainage |
+| `GET` | `/api/referral/rewards` | ✅ | Historique et récompenses disponibles |
+| `POST` | `/api/referral/claim-reward/:id` | ✅ | Réclamer une récompense |
+| `POST` | `/api/referral/activate-use` | ✅ | Déclarer la première utilisation active |
+| `GET` | `/api/referral/program-info` | ❌ | Conditions du programme (public) |
+
+### Santé
+
+| Méthode | Endpoint | Description |
+|---------|----------|-------------|
+| `GET` | `/api/health` | État de l'application et de la base de données |
+
+### Authentification JWT
+
+Passer le token dans le header `Authorization: ****** ou dans un cookie `token`.
+
+## Variables d'environnement
+
+Voir `.env.example` pour la liste complète.
+
+| Variable | Obligatoire | Défaut | Description |
+|----------|-------------|--------|-------------|
+| `JWT_SECRET` | ✅ | — | Clé secrète JWT |
+| `JWT_EXPIRY` | ❌ | `7d` | Durée de validité du token |
+| `PORT` | ❌ | `3000` | Port d'écoute |
+| `APP_URL` | ❌ | détecté | URL de base pour les liens de parrainage |
+| `DB_PATH` | ❌ | `./evodron.db` | Chemin du fichier SQLite |
+| `NODE_ENV` | ❌ | `development` | Environnement d'exécution |
+
+## Déploiement Docker
+
+```bash
+# Copier et éditer les variables
+cp .env.example .env
+# Démarrer
+docker compose up -d
+```
+
+## Flux de parrainage
+
+```
+Alice s'inscrit → obtient un code de parrainage unique
+  ↓
+Alice partage son lien : /register?ref=ABCD1234
+  ↓
+Bob s'inscrit avec ce lien → reçoit un bonus de bienvenue (10 crédits)
+  ↓
+Bob effectue sa première action active → POST /api/referral/activate-use
+  ↓
+Alice reçoit sa récompense de parrain (20 crédits)
+```
+
+## Sécurité
+
+- Mots de passe hachés avec **bcrypt** (coût 12)
+- Tokens JWT signés (HS256)
+- Rate limiting : 10 req/15 min sur `/api/auth`, 100 req/min sur `/api/referral`
+- Auto-parrainage interdit (vérification modèle + contrainte DB)
+- Un utilisateur ne peut avoir qu'un seul parrain (contrainte UNIQUE en base)
+- Pas de récompense sans activation effective du filleul
+
+## Licence
+
+Le code source EVODRON (dossiers `src/`, `public/`, `tests/`, fichiers `app.js`, `package.json`) est propriétaire.
+
+Le fichier `README.md`, `install.sh`, `changelog.md` et `LICENSE.md` sont des fichiers hérités du **GitHub Copilot CLI** distribués sous leur propre licence (voir `LICENSE.md`).

SECURITY.md

@@ -0,0 +1,26 @@
+# Politique de sécurité — Evodron
+
+## Signaler une vulnérabilité
+
+Si vous découvrez une vulnérabilité de sécurité dans Evodron, **ne l'ouvrez pas publiquement** en tant qu'issue GitHub.
+
+Contactez directement le mainteneur via la fonctionnalité **"Report a vulnerability"** de GitHub (onglet "Security" du dépôt) ou par email privé.
+
+Nous nous engageons à :
+- Accuser réception sous 48 heures.
+- Fournir un correctif ou un plan d'action sous 7 jours pour les vulnérabilités critiques.
+- Créditer le rapporteur dans le changelog si souhaité.
+
+## Versions supportées
+
+| Version | Support sécurité |
+|---------|-----------------|
+| 1.x     | ✅ Oui           |
+
+## Bonnes pratiques intégrées
+
+- Mots de passe hachés avec **bcrypt** (coût 12)
+- Tokens JWT signés HS256 avec expiration
+- Rate limiting sur toutes les routes d'authentification
+- Protection anti-auto-parrainage (modèle + contrainte DB)
+- Variables sensibles jamais commitées (`.env` dans `.gitignore`)

app.js

@@ -6,6 +6,8 @@ const path         = require('path');
 
 const authRoutes     = require('./src/routes/auth');
 const referralRoutes = require('./src/routes/referral');
+const healthRoutes   = require('./src/routes/health');
+const { authLimiter, apiLimiter } = require('./src/middleware/rateLimiter');
 
 const app  = express();
 const PORT = process.env.PORT || 3000;
@@ -18,9 +20,12 @@ app.use(cookieParser());
 // Serve static frontend files
 app.use(express.static(path.join(__dirname, 'public')));
 
+// Health check (no rate limit)
+app.use('/api/health', healthRoutes);
+
 // API routes
-app.use('/api/auth',     authRoutes);
-app.use('/api/referral', referralRoutes);
+app.use('/api/auth',     authLimiter, authRoutes);
+app.use('/api/referral', apiLimiter,  referralRoutes);
 
 // Catch-all: serve index.html for client-side navigation
 app.get('*', (req, res) => {

docker-compose.yml

@@ -0,0 +1,22 @@
+services:
+  app:
+    build: .
+    ports:
+      - "3000:3000"
+    environment:
+      - JWT_SECRET=${JWT_SECRET:?JWT_SECRET is required}
+      - JWT_EXPIRY=${JWT_EXPIRY:-7d}
+      - APP_URL=${APP_URL:-http://localhost:3000}
+      - NODE_ENV=${NODE_ENV:-production}
+    volumes:
+      - evodron_data:/data
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://localhost:3000/api/health"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 10s
+
+volumes:
+  evodron_data: