MadJax/SatAff
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit — specs pré-projet SatPRO + site de présentation (viewer, annotations, gestion des accès)

Browse Source
This commit is contained in:
MadJax
2026-10-12 12:11:04 +02:00
commit 30608afd9e
77 changed files with 20581 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
site/.env.example
+24
View File
@@ -0,0 +1,24 @@
# Exemple de configuration d'environnement pour Docker Compose.
# Copiez ce fichier vers `.env` puis renseignez les valeurs réelles :
# cp .env.example .env
#
# Le fichier `.env` n'est PAS commité (voir .gitignore). Ne mettez jamais de secret
# réel dans `.env.example`.
# --- Session ---
# Secret de signature JWT (OBLIGATOIRE). Générez une valeur aléatoire longue (>= 32 caractères).
# Ex. pour générer : openssl rand -hex 32
JWT_SECRET=change-me-generer-une-longue-chaine-aleatoire-de-32-caracteres-min
JWT_EXPIRATION_MINUTES=720
# --- Compte administrateur (UNIQUE compte défini hors de l'application) ---
# Tous les autres comptes se créent/gèrent dans le site, page « Gestion des accès ».
ADMIN_USER=madjax
ADMIN_PASSWORD=Change-moi
# --- Amorçage facultatif des comptes initiaux (1er démarrage, si store vide) ---
# Format : "login:motdepasse:role,..." avec role ∈ consultation|contributeur|desactive.
# Laisser vide pour utiliser l'amorçage par défaut intégré (les 3 comptes d'atelier
# en contributeur). Les comptes amorcés devront changer leur mot de passe à la
# première connexion. Une fois le store créé, cette variable n'a plus d'effet.
SEED_USERS=
site/.gitignore
+18
View File
@@ -0,0 +1,18 @@
# Secrets / configuration locale
.env
# Dépendances
node_modules/
# Artefacts de build Angular
frontend/dist/
frontend/.angular/
# Annotations générées à l'exécution (données d'atelier), on garde le dossier (.gitkeep)
annotations/*.json
# Comptes gérés via le site (mots de passe hachés) — données d'exécution, dossier gardé
users/*.json
# Logs
*.log
site/Caddyfile.example
+38
View File
@@ -0,0 +1,38 @@
# Exemple de configuration Caddy pour exposer le site des specs SatPRO en HTTPS.
#
# Topologie (Caddy éventuellement sur une machine séparée de la machine Docker) :
# Internet ──HTTPS──> [Caddy] ──HTTP──> [Machine Docker] : port 2002
# (frontend nginx du compose : app + /api)
#
# Remplace `192.168.1.50` par l'IP (LAN/VPN) de la machine Docker qui publie le compose.
# Le DNS de satpro.madjax.fr doit pointer vers la machine qui exécute CE Caddy.
satpro.madjax.fr {
encode zstd gzip
# Renforce l'anti-indexation côté edge (en plus de nginx, du <meta robots> et du robots.txt).
header {
X-Robots-Tag "noindex, nofollow, noarchive, nosnippet"
}
reverse_proxy 192.168.1.50:2002 {
header_up X-Forwarded-Proto {scheme}
header_up X-Forwarded-Host {host}
header_up X-Forwarded-For {remote_host}
health_uri /health
health_interval 30s
}
# Caddy gère automatiquement le certificat TLS (Let's Encrypt) pour satpro.madjax.fr,
# à condition que le DNS pointe vers cette machine et que les ports 80/443 soient ouverts.
}
# --- SÉCURITÉ RÉSEAU (si machines séparées) ---
# Restreindre l'accès au port 2002 de la machine Docker à la seule IP de la machine Caddy :
# ufw allow from <IP_CADDY> to any port 2002 proto tcp
# ufw deny 2002
# Idéalement, faire communiquer les deux machines via un réseau privé/VPN (WireGuard, etc.).
#
# Si Caddy tourne SUR la même machine que Docker, remplace l'IP par localhost :
# reverse_proxy localhost:2002 { ... }
site/README.md
+248
View File
@@ -0,0 +1,248 @@
# SatPRO — Site de présentation des specs (pré-projet)
Site web privé pour **présenter les specs métier SatPRO** (les fichiers Markdown de
`../docs/specs-pre-projet/`) en séance d'atelier.
- **Viewer Markdown** : navigation entre les documents, rendu GFM + tableaux + diagrammes Mermaid.
- **Lecture en direct** : le site lit les fichiers `.md` sur le disque. Quand les specs
sont éditées (dans l'IDE), un simple **Rafraîchir** affiche la dernière version. Aucune
recompilation, aucune duplication de contenu.
- **Accès gérés dans le site** : un **administrateur** unique est défini dans `.env` ;
tous les autres comptes se créent/gèrent via la page **Gestion des accès** (rôles
consultation / contributeur / désactivé, réinitialisation de mot de passe, changement
imposé à la première connexion). Session JWT.
- **Annotations en ligne** : chaque utilisateur peut annoter une section (ajout / correction /
question / remarque). Les annotations sont stockées côté serveur et **exportables** (admin)
en Markdown de synthèse ou JSON, pour transmission et mise à jour des `.md`.
- **Non indexable** : `robots.txt`, balise `<meta robots>`, en-tête `X-Robots-Tag` (nginx + Caddy).
> **Note sur le chat IA.** Ce site est volontairement **sans chat** (Option B). L'assistant
> (Kiro) vit dans l'IDE : pendant l'atelier, les questions se posent dans l'IDE, les specs
> y sont éditées, et le site reflète les changements. Le site **présente**, il ne discute pas.
## Architecture
```
site/
├─ frontend/ Angular 22 (viewer : marked + DOMPurify + mermaid), servi par nginx
├─ backend/ API Node/Express : auth + /api/specs + /api/annotations + /api/users
├─ annotations/ Données d'annotations (1 JSON par document) — volume RW, non commité
├─ users/ Comptes gérés (users.json, mots de passe bcrypt) — volume RW, non commité
├─ docker-compose.yml
├─ Caddyfile.example (reverse-proxy HTTPS pour satpro.madjax.fr)
├─ .env.example (comptes + secret JWT — à copier en .env, NON commité)
└─ .gitignore
```
Les specs ne sont **pas** copiées dans l'image : le dossier `../docs/specs-pre-projet`
est monté **en lecture seule** (`:ro`) dans le conteneur backend sur `/specs`. Les
annotations, elles, sont écrites dans `./annotations` (monté **en lecture-écriture** sur
`/annotations`), donc persistées sur l'hôte et faciles à récupérer.
## Configuration (.env)
```bash
cp .env.example .env
```
Puis éditez `.env` :
| Variable | Rôle |
|----------|------|
| `JWT_SECRET` | Secret de signature des sessions (**obligatoire**, ≥ 32 caractères). Ex. `openssl rand -hex 32` |
| `JWT_EXPIRATION_MINUTES` | Durée de session (défaut 720 = 12 h) |
| `ADMIN_USER` | Login de l'**administrateur** unique (seul compte défini hors application). Ex. `madjax` |
| `ADMIN_PASSWORD` | Mot de passe de l'administrateur. Ex. `Change-moi` |
| `SEED_USERS` | *(facultatif)* Comptes amorcés au **premier** démarrage si le store est vide : `login:mdp:role,...` (`role` ∈ `consultation`/`contributeur`/`desactive`). Vide = amorçage par défaut intégré. Sans effet une fois `users/users.json` créé. |
> Seul l'`ADMIN_USER` vit dans `.env`. **Tous les autres comptes** se créent et se gèrent
> dans l'application (page **Gestion des accès**, accessible à l'admin) et sont persistés
> dans `users/users.json` (mots de passe hachés bcrypt).
## Lancement en production (Docker)
Depuis `site/` :
```bash
docker compose up -d --build
```
- Le frontend (nginx) est publié sur le port **2002** de la machine Docker.
- Le backend reste interne au réseau Compose (non publié).
- Vérifier : `curl http://localhost:2002/health` → `{"statut":"ok"}`.
### Exposition HTTPS (Caddy) — satpro.madjax.fr
```bash
cp Caddyfile.example Caddyfile # puis adapter l'IP de la machine Docker
```
Caddy termine le TLS (Let's Encrypt) et proxifie vers le port 2002. Voir les notes de
sécurité réseau dans `Caddyfile.example` (filtrage du port 2002, réseau privé/VPN).
Prérequis DNS : `satpro.madjax.fr` doit pointer vers la machine qui exécute Caddy.
## Développement local (sans Docker)
### Méthode recommandée : `run-dev.sh`
Depuis `site/` :
```bash
./run-dev.sh
```
Le script :
- charge `JWT_SECRET`, `ADMIN_USER`/`ADMIN_PASSWORD` et `SEED_USERS` depuis `.env` s'il
existe (sinon : secret de dev aléatoire + admin par défaut `admin` / `admin`) ;
- installe les dépendances si `node_modules` manque (back et front) ;
- démarre le **backend** Node sur `:8080` (specs lues en direct dans `../docs/specs-pre-projet`)
et le **frontend** Angular sur `:4200` ;
- attend que le frontend soit réellement prêt (HTTP 200) avant d'afficher le récapitulatif ;
- arrête proprement les deux processus à `Ctrl+C`.
Ouvrir ensuite http://localhost:4200 (admin `admin` / `admin` par défaut en dev, ou les
valeurs de `.env` ; les comptes amorcés devront changer leur mot de passe à la 1re connexion).
### Méthode manuelle (deux terminaux)
```bash
# 1) Backend (port 8080)
cd backend
npm install
JWT_SECRET="dev-secret-32-caracteres-minimum-ok" \
ADMIN_USER="admin" ADMIN_PASSWORD="admin" \
npm start
# 2) Frontend (port 4200, proxy vers :8080 via environment.ts)
cd frontend
npm install
npm start
```
## Ajouter / modifier un document
1. Créez ou éditez un fichier dans `../docs/specs-pre-projet/` (ex. `14-annexes.md`).
2. Le **menu se met à jour automatiquement** : les fichiers `.md` sont listés par ordre
de nom (préfixes `00`, `01`, …) et le titre est tiré du premier titre `#` du fichier.
3. En séance : cliquez **Rafraîchir** (ou rechargez la page) pour voir la dernière version.
## Gestion des accès (administrateur)
L'administrateur (défini dans `.env`) dispose d'un bouton **Gestion des accès** dans
l'en-tête. Cette page permet de :
- **Créer un compte** : login + mot de passe par défaut + rôle. Le compte devra **changer
son mot de passe à la première connexion**.
- **Changer le rôle** d'un compte :
- **Consultation** — lecture seule (consulte les specs et les annotations, ne peut pas annoter) ;
- **Contributeur** — peut annoter (créer / éditer / supprimer ses propres annotations) ;
- **Désactivé** — connexion refusée (idéal pour couper un accès entre deux ateliers sans le supprimer).
- **Réinitialiser le mot de passe** d'un compte (si l'utilisateur l'a oublié) : un nouveau
mot de passe par défaut est fixé et le changement est de nouveau imposé à la connexion suivante.
- **Supprimer** un compte (pour un usage entre ateliers, préférez **Désactivé**).
Les changements de rôle et les désactivations prennent effet **immédiatement**, sans que
l'utilisateur ait à se reconnecter. Les comptes sont persistés dans `users/users.json`
(mots de passe hachés bcrypt) et conservés entre les ateliers.
> L'administrateur n'apparaît pas dans cette liste : il se configure uniquement dans `.env`
> (`ADMIN_USER` / `ADMIN_PASSWORD`).
## Annotations (retours des utilisateurs)
Pendant l'atelier, chaque utilisateur **contributeur** (ou l'admin) peut annoter les specs
(un compte en **consultation** voit les annotations mais ne peut pas en ajouter) :
1. Dans un document, survoler un titre de section fait apparaître un bouton **💬**.
Cliquer dessus ouvre le panneau d'annotation avec la section préremplie.
2. Choisir un **type** (remarque / ajout / correction / question), saisir le texte, **Ajouter**.
3. Le bouton **💬 Annotations** (barre du haut) ouvre/ferme le panneau latéral qui liste
toutes les annotations du document. Un badge indique le nombre d'annotations **ouvertes**.
4. Chaque utilisateur peut **éditer / supprimer ses propres** annotations et basculer leur
statut (ouverte ↔ traitée). Un **administrateur** (`ADMIN_USERS`) peut gérer **toutes**
les annotations.
### Stockage
- Un fichier JSON par document dans `site/annotations/` (ex. `06-prestations.json`).
- Persisté sur l'hôte (volume Docker RW). Les `.json` ne sont pas commités (`.gitignore`).
### Export et transmission (admin)
Dans le panneau d'annotations, un administrateur dispose de deux exports :
- **Markdown** (`annotations-satpro.md`) : synthèse lisible, regroupée par document puis par
section — c'est le format à **transmettre à Kiro** pour mettre à jour les `.md`.
- **JSON** (`annotations-satpro.json`) : données brutes.
Alternative sans l'UI : récupérer directement les fichiers de `site/annotations/*.json` sur
le serveur (ils constituent la source complète des retours).
Le flux de bout en bout : *les utilisateurs annotent → l'admin exporte le Markdown → vous me
le transmettez → je mets à jour les fichiers de `docs/specs-pre-projet/`.*
## Déploiement par archive (tar)
Le `docker-compose.yml` monte `../docs/specs-pre-projet` : l'archive doit donc contenir
**`site/` ET `docs/specs-pre-projet/`** avec la même arborescence relative. On se place à la
racine `DEKRA/SatPRO` :
```bash
cd /home/madjax/KiroProject/DEKRA/SatPRO
tar czf satpro-site.tar.gz \
--exclude='site/frontend/node_modules' \
--exclude='site/backend/node_modules' \
--exclude='site/frontend/dist' \
--exclude='site/frontend/.angular' \
--exclude='site/.env' \
--exclude='site/annotations/*.json' \
--exclude='site/users/*.json' \
site docs/specs-pre-projet
```
> On exclut `site/.env` (identifiants) — à recréer sur le serveur — et les annotations
> `*.json` (données d'exécution). Le dossier `site/annotations/` reste inclus (via `.gitkeep`)
> pour que le volume RW ait son point de montage.
Côté serveur :
```bash
scp satpro-site.tar.gz user@serveur:/chemin/cible/
# puis sur le serveur :
cd /chemin/cible && tar xzf satpro-site.tar.gz
cd site
cp .env.example .env # renseigner JWT_SECRET, ADMIN_USER, ADMIN_PASSWORD
docker compose up -d --build
```
Le site répond sur le port **2002**, prêt à être exposé en HTTPS via Caddy.
> Mise à jour ultérieure des specs sur le serveur : recopier `docs/specs-pre-projet/`
> (pas besoin de rebuilder). Les annotations existantes dans `site/annotations/` sont conservées.
## Points de sécurité
- `.env` n'est **jamais** commité (`.gitignore`).
- Le backend refuse de démarrer sans `JWT_SECRET` (≥ 32 caractères) ni comptes.
- Les specs sont montées **en lecture seule** : le site ne peut pas modifier les fichiers.
- Les annotations sont écrites dans un volume **séparé** (`/annotations`), jamais dans les specs.
- Protection contre la traversée de répertoire sur `/api/specs/:cle` et `/api/annotations/:cle`.
- Modification/suppression d'une annotation réservée à son **auteur** ou à un **admin** ;
export global réservé aux **admins**.
- Contenu non indexable (robots.txt + meta + `X-Robots-Tag`) **et** protégé par login.
## Vérifications effectuées
- Build frontend production : OK (`dist/satpro-specs-frontend/browser`).
- Backend : `/health`, login multi-comptes (succès/échec), liste des 14 documents,
lecture de contenu en direct, en-tête `X-Robots-Tag`, blocage de la traversée de répertoire.
- Annotations : création, édition (auteur), bascule de statut, suppression, droits
auteur/admin, export Markdown et JSON (réservé admin, `403` sinon).
- Gestion des accès : admin unique via `.env`, comptes gérés en JSON (bcrypt), rôles
consultation/contributeur/désactivé appliqués côté serveur, changement de mot de passe
imposé à la 1re connexion et après réinitialisation, effet immédiat des changements de rôle.
- `docker compose config` : port publié `2002`, montages `../docs/specs-pre-projet` → `/specs`
(ro), `./annotations` → `/annotations` (rw) et `./users` → `/users` (rw), `ADMIN_USER` injecté.
site/annotations/.gitkeep
+3
View File
@@ -0,0 +1,3 @@
# Ce dossier reçoit les annotations (un fichier JSON par document), écrites par le
# backend à l'exécution. Les .json ne sont pas versionnés (voir ../.gitignore) ;
# ce .gitkeep garantit que le dossier existe (montage du volume Docker en RW).
site/backend/Dockerfile
+17
View File
@@ -0,0 +1,17 @@
FROM node:22-alpine
WORKDIR /app
# curl pour le healthcheck du compose
RUN apk add --no-cache curl
# Dépendances (couche cache)
COPY package*.json ./
RUN npm ci --omit=dev
# Code source
COPY src ./src
ENV PORT=8080
EXPOSE 8080
CMD ["node", "src/server.js"]
site/backend/package-lock.json
Generated
+988
View File
@@ -0,0 +1,988 @@
{
"name": "satpro-specs-backend",
"version": "1.0.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "satpro-specs-backend",
"version": "1.0.0",
"dependencies": {
"bcryptjs": "^2.4.3",
"cors": "^2.8.5",
"express": "^4.21.2",
"jsonwebtoken": "^9.0.2"
},
"engines": {
"node": ">=20"
}
},
"node_modules/accepts": {
"version": "1.3.8",
"resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
"integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
"license": "MIT",
"dependencies": {
"mime-types": "~2.1.34",
"negotiator": "0.6.3"
},
"engines": {
"node": ">= 0.6"
}
},
"node_modules/array-flatten": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
"integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
"license": "MIT"
},
"node_modules/bcryptjs": {
"version": "2.4.3",
"resolved": "https://registry.npmjs.org/bcryptjs/-/bcryptjs-2.4.3.tgz",
"integrity": "sha512-V/Hy/X9Vt7f3BbPJEi8BdVFMByHi+jNXrYkW3huaybV/kQ0KJg0Y6PkEMbn+zeT+i+SiKZ/HMqJGIIt4LZDqNQ==",
"license": "MIT"
},
"node_modules/body-parser": {
"version": "1.20.8",
"resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.8.tgz",
"integrity": "sha512-JNcyFQ64OiijEkPzUBTCe+hyPXUD/3LEldGQ6iF5LR1w00mx9o7xtDWHXBY2iItjdCFGoilOLNQbH943ut7pHA==",
"license": "MIT",
"dependencies": {
"bytes": "~3.1.2",
"content-type": "~1.0.5",
"debug": "2.6.9",
"depd": "2.0.0",
"destroy": "~1.2.0",
"http-errors": "~2.0.1",
"iconv-lite": "~0.4.24",
"on-finished": "~2.4.1",
"qs": "~6.16.0",
"raw-body": "~2.5.3",
"type-is": "~1.6.18",
"unpipe": "~1.0.0"
},
"engines": {
"node": ">= 0.8",
"npm": "1.2.8000 || >= 1.4.16"
}
},
"node_modules/buffer-equal-constant-time": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz",
"integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==",
"license": "BSD-3-Clause"
},
"node_modules/bytes": {
"version": "3.1.2",
"resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
"integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/call-bind-apply-helpers": {
"version": "1.0.2",
"resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
"integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
"license": "MIT",
"dependencies": {
"es-errors": "^1.3.0",
"function-bind": "^1.1.2"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/call-bound": {
"version": "1.0.4",
"resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
"integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
"license": "MIT",
"dependencies": {
"call-bind-apply-helpers": "^1.0.2",
"get-intrinsic": "^1.3.0"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/content-disposition": {
"version": "0.5.4",
"resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
"integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
"license": "MIT",
"dependencies": {
"safe-buffer": "5.2.1"
},
"engines": {
"node": ">= 0.6"
}
},
"node_modules/content-type": {
"version": "1.0.5",
"resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
"integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/cookie": {
"version": "0.7.2",
"resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
"integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/cookie-signature": {
"version": "1.0.7",
"resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz",
"integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==",
"license": "MIT"
},
"node_modules/cors": {
"version": "2.8.6",
"resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
"integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==",
"license": "MIT",
"dependencies": {
"object-assign": "^4",
"vary": "^1"
},
"engines": {
"node": ">= 0.10"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/express"
}
},
"node_modules/debug": {
"version": "2.6.9",
"resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
"integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
"license": "MIT",
"dependencies": {
"ms": "2.0.0"
}
},
"node_modules/depd": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
"integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/destroy": {
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
"integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
"license": "MIT",
"engines": {
"node": ">= 0.8",
"npm": "1.2.8000 || >= 1.4.16"
}
},
"node_modules/dunder-proto": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
"integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
"license": "MIT",
"dependencies": {
"call-bind-apply-helpers": "^1.0.1",
"es-errors": "^1.3.0",
"gopd": "^1.2.0"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/ecdsa-sig-formatter": {
"version": "1.0.11",
"resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz",
"integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==",
"license": "Apache-2.0",
"dependencies": {
"safe-buffer": "^5.0.1"
}
},
"node_modules/ee-first": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
"integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
"license": "MIT"
},
"node_modules/encodeurl": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
"integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/es-define-property": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
"integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
}
},
"node_modules/es-errors": {
"version": "1.3.0",
"resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
"integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
}
},
"node_modules/es-object-atoms": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
"integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
"license": "MIT",
"dependencies": {
"es-errors": "^1.3.0"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/escape-html": {
"version": "1.0.3",
"resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
"integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
"license": "MIT"
},
"node_modules/etag": {
"version": "1.8.1",
"resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
"integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/express": {
"version": "4.22.3",
"resolved": "https://registry.npmjs.org/express/-/express-4.22.3.tgz",
"integrity": "sha512-Bdcs4+3qlpVlx2NRn6fgX2Ue2/gGRaPeawebgclM0ERSCqDpA+owF1fdPwjJUTAJWMTuAaxjDf+hzb0/4eKvvw==",
"license": "MIT",
"dependencies": {
"accepts": "~1.3.8",
"array-flatten": "1.1.1",
"body-parser": "~1.20.5",
"content-disposition": "~0.5.4",
"content-type": "~1.0.4",
"cookie": "~0.7.1",
"cookie-signature": "~1.0.6",
"debug": "2.6.9",
"depd": "2.0.0",
"encodeurl": "~2.0.0",
"escape-html": "~1.0.3",
"etag": "~1.8.1",
"finalhandler": "~1.3.1",
"fresh": "~0.5.2",
"http-errors": "~2.0.0",
"merge-descriptors": "1.0.3",
"methods": "~1.1.2",
"on-finished": "~2.4.1",
"parseurl": "~1.3.3",
"path-to-regexp": "~0.1.13",
"proxy-addr": "~2.0.7",
"qs": "~6.16.0",
"range-parser": "~1.2.1",
"safe-buffer": "5.2.1",
"send": "~0.19.0",
"serve-static": "~1.16.2",
"setprototypeof": "1.2.0",
"statuses": "~2.0.1",
"type-is": "~1.6.18",
"utils-merge": "1.0.1",
"vary": "~1.1.2"
},
"engines": {
"node": ">= 0.10.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/express"
}
},
"node_modules/finalhandler": {
"version": "1.3.2",
"resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz",
"integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==",
"license": "MIT",
"dependencies": {
"debug": "2.6.9",
"encodeurl": "~2.0.0",
"escape-html": "~1.0.3",
"on-finished": "~2.4.1",
"parseurl": "~1.3.3",
"statuses": "~2.0.2",
"unpipe": "~1.0.0"
},
"engines": {
"node": ">= 0.8"
}
},
"node_modules/forwarded": {
"version": "0.2.0",
"resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
"integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/fresh": {
"version": "0.5.2",
"resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
"integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/function-bind": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
"integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
"license": "MIT",
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/get-intrinsic": {
"version": "1.3.0",
"resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
"integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
"license": "MIT",
"dependencies": {
"call-bind-apply-helpers": "^1.0.2",
"es-define-property": "^1.0.1",
"es-errors": "^1.3.0",
"es-object-atoms": "^1.1.1",
"function-bind": "^1.1.2",
"get-proto": "^1.0.1",
"gopd": "^1.2.0",
"has-symbols": "^1.1.0",
"hasown": "^2.0.2",
"math-intrinsics": "^1.1.0"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/get-proto": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
"integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
"license": "MIT",
"dependencies": {
"dunder-proto": "^1.0.1",
"es-object-atoms": "^1.0.0"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/gopd": {
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
"integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/has-symbols": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
"integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/hasown": {
"version": "2.0.4",
"resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz",
"integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
"license": "MIT",
"dependencies": {
"function-bind": "^1.1.2"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/http-errors": {
"version": "2.0.1",
"resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
"integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
"license": "MIT",
"dependencies": {
"depd": "~2.0.0",
"inherits": "~2.0.4",
"setprototypeof": "~1.2.0",
"statuses": "~2.0.2",
"toidentifier": "~1.0.1"
},
"engines": {
"node": ">= 0.8"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/express"
}
},
"node_modules/iconv-lite": {
"version": "0.4.24",
"resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
"integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
"license": "MIT",
"dependencies": {
"safer-buffer": ">= 2.1.2 < 3"
},
"engines": {
"node": ">=0.10.0"
}
},
"node_modules/inherits": {
"version": "2.0.4",
"resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
"integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
"license": "ISC"
},
"node_modules/ipaddr.js": {
"version": "1.9.1",
"resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
"integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
"license": "MIT",
"engines": {
"node": ">= 0.10"
}
},
"node_modules/jsonwebtoken": {
"version": "9.0.3",
"resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.3.tgz",
"integrity": "sha512-MT/xP0CrubFRNLNKvxJ2BYfy53Zkm++5bX9dtuPbqAeQpTVe0MQTFhao8+Cp//EmJp244xt6Drw/GVEGCUj40g==",
"license": "MIT",
"dependencies": {
"jws": "^4.0.1",
"lodash.includes": "^4.3.0",
"lodash.isboolean": "^3.0.3",
"lodash.isinteger": "^4.0.4",
"lodash.isnumber": "^3.0.3",
"lodash.isplainobject": "^4.0.6",
"lodash.isstring": "^4.0.1",
"lodash.once": "^4.0.0",
"ms": "^2.1.1",
"semver": "^7.5.4"
},
"engines": {
"node": ">=12",
"npm": ">=6"
}
},
"node_modules/jsonwebtoken/node_modules/ms": {
"version": "2.1.3",
"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
"integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
"license": "MIT"
},
"node_modules/jwa": {
"version": "2.0.1",
"resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz",
"integrity": "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg==",
"license": "MIT",
"dependencies": {
"buffer-equal-constant-time": "^1.0.1",
"ecdsa-sig-formatter": "1.0.11",
"safe-buffer": "^5.0.1"
}
},
"node_modules/jws": {
"version": "4.0.1",
"resolved": "https://registry.npmjs.org/jws/-/jws-4.0.1.tgz",
"integrity": "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA==",
"license": "MIT",
"dependencies": {
"jwa": "^2.0.1",
"safe-buffer": "^5.0.1"
}
},
"node_modules/lodash.includes": {
"version": "4.3.0",
"resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz",
"integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==",
"license": "MIT"
},
"node_modules/lodash.isboolean": {
"version": "3.0.3",
"resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz",
"integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==",
"license": "MIT"
},
"node_modules/lodash.isinteger": {
"version": "4.0.4",
"resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz",
"integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==",
"license": "MIT"
},
"node_modules/lodash.isnumber": {
"version": "3.0.3",
"resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz",
"integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==",
"license": "MIT"
},
"node_modules/lodash.isplainobject": {
"version": "4.0.6",
"resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz",
"integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==",
"license": "MIT"
},
"node_modules/lodash.isstring": {
"version": "4.0.1",
"resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz",
"integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==",
"license": "MIT"
},
"node_modules/lodash.once": {
"version": "4.1.1",
"resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz",
"integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==",
"license": "MIT"
},
"node_modules/math-intrinsics": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
"integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
}
},
"node_modules/media-typer": {
"version": "0.3.0",
"resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
"integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/merge-descriptors": {
"version": "1.0.3",
"resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
"integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
"license": "MIT",
"funding": {
"url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/methods": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
"integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/mime": {
"version": "1.6.0",
"resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
"integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
"license": "MIT",
"bin": {
"mime": "cli.js"
},
"engines": {
"node": ">=4"
}
},
"node_modules/mime-db": {
"version": "1.52.0",
"resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
"integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/mime-types": {
"version": "2.1.35",
"resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
"integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
"license": "MIT",
"dependencies": {
"mime-db": "1.52.0"
},
"engines": {
"node": ">= 0.6"
}
},
"node_modules/ms": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
"integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
"license": "MIT"
},
"node_modules/negotiator": {
"version": "0.6.3",
"resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
"integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/object-assign": {
"version": "4.1.1",
"resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
"integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
"license": "MIT",
"engines": {
"node": ">=0.10.0"
}
},
"node_modules/object-inspect": {
"version": "1.13.4",
"resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
"integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/on-finished": {
"version": "2.4.1",
"resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
"integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
"license": "MIT",
"dependencies": {
"ee-first": "1.1.1"
},
"engines": {
"node": ">= 0.8"
}
},
"node_modules/parseurl": {
"version": "1.3.3",
"resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
"integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/path-to-regexp": {
"version": "0.1.13",
"resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.13.tgz",
"integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==",
"license": "MIT"
},
"node_modules/proxy-addr": {
"version": "2.0.8",
"resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.8.tgz",
"integrity": "sha512-5nnx0yGyVUcY6t9RnWcARWtwT9F1D8O9rt08htPvnd49W1IgZtmLkhu9WfMzQj1cFxjHIO6connUNVW5k7AVyQ==",
"license": "MIT",
"dependencies": {
"forwarded": "0.2.0",
"ipaddr.js": "1.9.1"
},
"engines": {
"node": ">= 0.10"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/express"
}
},
"node_modules/qs": {
"version": "6.16.0",
"resolved": "https://registry.npmjs.org/qs/-/qs-6.16.0.tgz",
"integrity": "sha512-h6fhOIaRrID2CbEY2fqs+7t+UXZo+MLAnU5gRIq85uFtdiUPCdsApMlHhXogKVM4HM2DVbIjGNTTYH2OcmP1vA==",
"license": "BSD-3-Clause",
"dependencies": {
"es-define-property": "^1.0.1",
"side-channel": "^1.1.1"
},
"engines": {
"node": ">=0.6"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/range-parser": {
"version": "1.2.1",
"resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
"integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/raw-body": {
"version": "2.5.3",
"resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz",
"integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==",
"license": "MIT",
"dependencies": {
"bytes": "~3.1.2",
"http-errors": "~2.0.1",
"iconv-lite": "~0.4.24",
"unpipe": "~1.0.0"
},
"engines": {
"node": ">= 0.8"
}
},
"node_modules/safe-buffer": {
"version": "5.2.1",
"resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
"integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
"funding": [
{
"type": "github",
"url": "https://github.com/sponsors/feross"
},
{
"type": "patreon",
"url": "https://www.patreon.com/feross"
},
{
"type": "consulting",
"url": "https://feross.org/support"
}
],
"license": "MIT"
},
"node_modules/safer-buffer": {
"version": "2.1.2",
"resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
"integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
"license": "MIT"
},
"node_modules/semver": {
"version": "7.8.5",
"resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
"integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
"license": "ISC",
"bin": {
"semver": "bin/semver.js"
},
"engines": {
"node": ">=10"
}
},
"node_modules/send": {
"version": "0.19.2",
"resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz",
"integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==",
"license": "MIT",
"dependencies": {
"debug": "2.6.9",
"depd": "2.0.0",
"destroy": "1.2.0",
"encodeurl": "~2.0.0",
"escape-html": "~1.0.3",
"etag": "~1.8.1",
"fresh": "~0.5.2",
"http-errors": "~2.0.1",
"mime": "1.6.0",
"ms": "2.1.3",
"on-finished": "~2.4.1",
"range-parser": "~1.2.1",
"statuses": "~2.0.2"
},
"engines": {
"node": ">= 0.8.0"
}
},
"node_modules/send/node_modules/ms": {
"version": "2.1.3",
"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
"integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
"license": "MIT"
},
"node_modules/serve-static": {
"version": "1.16.3",
"resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz",
"integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==",
"license": "MIT",
"dependencies": {
"encodeurl": "~2.0.0",
"escape-html": "~1.0.3",
"parseurl": "~1.3.3",
"send": "~0.19.1"
},
"engines": {
"node": ">= 0.8.0"
}
},
"node_modules/setprototypeof": {
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
"integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
"license": "ISC"
},
"node_modules/side-channel": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz",
"integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==",
"license": "MIT",
"dependencies": {
"es-errors": "^1.3.0",
"object-inspect": "^1.13.4",
"side-channel-list": "^1.0.1",
"side-channel-map": "^1.0.1",
"side-channel-weakmap": "^1.0.2"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/side-channel-list": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz",
"integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==",
"license": "MIT",
"dependencies": {
"es-errors": "^1.3.0",
"object-inspect": "^1.13.4"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/side-channel-map": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
"integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
"license": "MIT",
"dependencies": {
"call-bound": "^1.0.2",
"es-errors": "^1.3.0",
"get-intrinsic": "^1.2.5",
"object-inspect": "^1.13.3"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/side-channel-weakmap": {
"version": "1.0.2",
"resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
"integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
"license": "MIT",
"dependencies": {
"call-bound": "^1.0.2",
"es-errors": "^1.3.0",
"get-intrinsic": "^1.2.5",
"object-inspect": "^1.13.3",
"side-channel-map": "^1.0.1"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/statuses": {
"version": "2.0.2",
"resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
"integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/toidentifier": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
"integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
"license": "MIT",
"engines": {
"node": ">=0.6"
}
},
"node_modules/type-is": {
"version": "1.6.18",
"resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
"integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
"license": "MIT",
"dependencies": {
"media-typer": "0.3.0",
"mime-types": "~2.1.24"
},
"engines": {
"node": ">= 0.6"
}
},
"node_modules/unpipe": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
"integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/utils-merge": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
"integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
"license": "MIT",
"engines": {
"node": ">= 0.4.0"
}
},
"node_modules/vary": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
"integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
}
}
}
site/backend/package.json
+20
View File
@@ -0,0 +1,20 @@
{
"name": "satpro-specs-backend",
"version": "1.0.0",
"description": "API Node servant les specs markdown SatPRO (lecture en direct) avec authentification multi-comptes.",
"type": "module",
"main": "src/server.js",
"scripts": {
"start": "node src/server.js",
"dev": "node --watch src/server.js"
},
"engines": {
"node": ">=20"
},
"dependencies": {
"bcryptjs": "^2.4.3",
"cors": "^2.8.5",
"express": "^4.21.2",
"jsonwebtoken": "^9.0.2"
}
}
site/backend/src/annotations.js
+237
View File
@@ -0,0 +1,237 @@
// Stockage des annotations : un fichier JSON par document, dans ANNOTATIONS_DIR.
// Format d'un fichier (ex. annotations/06-prestations.json) :
// { "cle": "06-prestations", "annotations": [ { ...annotation... }, ... ] }
//
// Une annotation :
// {
// id: "a1b2c3", // identifiant court unique
// docCle: "06-prestations", // document concerné
// ancre: "4-1-decoupage", // id de section (slug du titre) ou "" (doc entier)
// titreSection: "4.1 Découpage", // libellé de section au moment de l'annotation
// type: "correction", // ajout | correction | question | remarque
// texte: "…", // contenu libre
// auteur: "invite1", // login de l'auteur
// statut: "ouverte", // ouverte | traitee
// creeLe: "2026-10-04T…Z",
// modifieLe: "2026-10-04T…Z"
// }
import fs from 'node:fs/promises';
import path from 'node:path';
import crypto from 'node:crypto';
import { ANNOTATIONS_DIR } from './config.js';
const CLE_VALIDE = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i;
const TYPES = new Set(['ajout', 'correction', 'question', 'remarque']);
const STATUTS = new Set(['ouverte', 'traitee']);
/** Garantit l'existence du dossier d'annotations. */
async function assurerDossier() {
await fs.mkdir(ANNOTATIONS_DIR, { recursive: true });
}
/** Chemin sûr du fichier JSON d'un document. */
function cheminFichier(docCle) {
if (!CLE_VALIDE.test(docCle)) {
return null;
}
const chemin = path.resolve(ANNOTATIONS_DIR, `${docCle}.json`);
const racine = path.resolve(ANNOTATIONS_DIR) + path.sep;
if (!chemin.startsWith(racine)) {
return null;
}
return chemin;
}
/** Lit les annotations d'un document (tableau, éventuellement vide). */
export async function lireAnnotations(docCle) {
const chemin = cheminFichier(docCle);
if (!chemin) {
return [];
}
try {
const brut = await fs.readFile(chemin, 'utf8');
const data = JSON.parse(brut);
return Array.isArray(data.annotations) ? data.annotations : [];
} catch {
return [];
}
}
/** Écrit (atomiquement) les annotations d'un document. */
async function ecrireAnnotations(docCle, annotations) {
const chemin = cheminFichier(docCle);
if (!chemin) {
throw new Error('Clé de document invalide.');
}
await assurerDossier();
const contenu = JSON.stringify({ cle: docCle, annotations }, null, 2);
const tmp = `${chemin}.tmp-${process.pid}`;
await fs.writeFile(tmp, contenu, 'utf8');
await fs.rename(tmp, chemin); // rename atomique
}
/** Normalise/valide les champs d'entrée. Retourne { ok, valeur|erreur }. */
function validerEntree({ type, texte, ancre, titreSection, statut }) {
const texteNet = typeof texte === 'string' ? texte.trim() : '';
if (!texteNet) {
return { ok: false, erreur: 'Le texte de l’annotation est requis.' };
}
if (texteNet.length > 5000) {
return { ok: false, erreur: 'Texte trop long (5000 caractères max).' };
}
const typeNet = TYPES.has(type) ? type : 'remarque';
const statutNet = STATUTS.has(statut) ? statut : 'ouverte';
return {
ok: true,
valeur: {
type: typeNet,
texte: texteNet,
ancre: typeof ancre === 'string' ? ancre.slice(0, 200) : '',
titreSection: typeof titreSection === 'string' ? titreSection.slice(0, 300) : '',
statut: statutNet
}
};
}
/** Crée une annotation sur un document. */
export async function creerAnnotation(docCle, auteur, entree) {
if (!CLE_VALIDE.test(docCle)) {
throw new Error('Clé de document invalide.');
}
const v = validerEntree(entree);
if (!v.ok) {
return { erreur: v.erreur };
}
const maintenant = new Date().toISOString();
const annotation = {
id: crypto.randomBytes(5).toString('hex'),
docCle,
ancre: v.valeur.ancre,
titreSection: v.valeur.titreSection,
type: v.valeur.type,
texte: v.valeur.texte,
auteur,
statut: 'ouverte',
creeLe: maintenant,
modifieLe: maintenant
};
const liste = await lireAnnotations(docCle);
liste.push(annotation);
await ecrireAnnotations(docCle, liste);
return { annotation };
}
/**
* Met à jour une annotation (texte/type/statut).
* Autorisé si l'appelant est l'auteur OU administrateur.
*/
export async function majAnnotation(docCle, id, appelant, estAdminAppelant, maj) {
const liste = await lireAnnotations(docCle);
const idx = liste.findIndex((a) => a.id === id);
if (idx === -1) {
return { erreur: 'introuvable' };
}
const annotation = liste[idx];
if (annotation.auteur !== appelant && !estAdminAppelant) {
return { erreur: 'interdit' };
}
if (typeof maj.texte === 'string') {
const t = maj.texte.trim();
if (!t) return { erreur: 'Le texte ne peut pas être vide.' };
if (t.length > 5000) return { erreur: 'Texte trop long (5000 caractères max).' };
annotation.texte = t;
}
if (TYPES.has(maj.type)) {
annotation.type = maj.type;
}
if (STATUTS.has(maj.statut)) {
annotation.statut = maj.statut;
}
annotation.modifieLe = new Date().toISOString();
liste[idx] = annotation;
await ecrireAnnotations(docCle, liste);
return { annotation };
}
/** Supprime une annotation (auteur ou admin). */
export async function supprimerAnnotation(docCle, id, appelant, estAdminAppelant) {
const liste = await lireAnnotations(docCle);
const idx = liste.findIndex((a) => a.id === id);
if (idx === -1) {
return { erreur: 'introuvable' };
}
if (liste[idx].auteur !== appelant && !estAdminAppelant) {
return { erreur: 'interdit' };
}
liste.splice(idx, 1);
await ecrireAnnotations(docCle, liste);
return { ok: true };
}
/** Liste TOUTES les annotations (tous documents), triées par document puis date. */
export async function listerToutes() {
await assurerDossier();
let fichiers = [];
try {
fichiers = await fs.readdir(ANNOTATIONS_DIR);
} catch {
return [];
}
const toutes = [];
for (const nom of fichiers.filter((f) => /\.json$/i.test(f))) {
const docCle = nom.replace(/\.json$/i, '');
const liste = await lireAnnotations(docCle);
toutes.push(...liste);
}
toutes.sort((a, b) => {
if (a.docCle !== b.docCle) return a.docCle.localeCompare(b.docCle, 'fr', { numeric: true });
return a.creeLe.localeCompare(b.creeLe);
});
return toutes;
}
/** Construit un markdown de synthèse regroupé par document puis par section. */
export function construireExportMarkdown(toutes) {
const lignes = [];
lignes.push('# Annotations des specs SatPRO — synthèse');
lignes.push('');
lignes.push(`> Export généré le ${new Date().toISOString()}.`);
lignes.push(`> ${toutes.length} annotation(s). À transmettre à Kiro pour mise à jour des .md.`);
lignes.push('');
const parDoc = new Map();
for (const a of toutes) {
if (!parDoc.has(a.docCle)) parDoc.set(a.docCle, []);
parDoc.get(a.docCle).push(a);
}
const emoji = { ajout: '➕', correction: '✏️', question: '❓', remarque: '💬' };
for (const [docCle, liste] of parDoc) {
lignes.push(`## ${docCle}`);
lignes.push('');
// Regroupe par section (titreSection), les annotations "document entier" en tête.
const parSection = new Map();
for (const a of liste) {
const cle = a.titreSection || '(document entier)';
if (!parSection.has(cle)) parSection.set(cle, []);
parSection.get(cle).push(a);
}
for (const [section, annos] of parSection) {
lignes.push(`### ${section}`);
lignes.push('');
for (const a of annos) {
const type = emoji[a.type] || '💬';
const etat = a.statut === 'traitee' ? ' _(traitée)_' : '';
lignes.push(`- ${type} **${a.type}** — _${a.auteur}_, ${a.creeLe}${etat}`);
for (const l of a.texte.split(/\r?\n/)) {
lignes.push(` > ${l}`);
}
lignes.push('');
}
}
}
return lignes.join('\n');
}
site/backend/src/auth.js
+118
View File
@@ -0,0 +1,118 @@
// Authentification : vérification des identifiants et émission/validation des JWT.
import jwt from 'jsonwebtoken';
import {
JWT_SECRET,
JWT_EXPIRATION_MINUTES,
ADMIN_USER,
ADMIN_PASSWORD,
estAdmin
} from './config.js';
import { verifierConnexion, trouverUtilisateur } from './users.js';
/**
* Vérifie les identifiants.
* Ordre : d'abord l'ADMIN du .env, puis les comptes gérés (store users.json).
*
* Retourne un objet décrivant le résultat :
* - { ok:true, login, role, admin, doitChangerMdp }
* - { ok:false, raison } avec raison ∈ 'identifiants' | 'desactive'
*/
export async function verifierIdentifiants(login, motDePasse) {
if (typeof login !== 'string' || typeof motDePasse !== 'string') {
return { ok: false, raison: 'identifiants' };
}
// 1) Compte administrateur (défini dans le .env, hors store).
if (ADMIN_USER && login === ADMIN_USER) {
if (motDePasse === ADMIN_PASSWORD) {
return { ok: true, login, role: 'admin', admin: true, doitChangerMdp: false };
}
return { ok: false, raison: 'identifiants' };
}
// 2) Comptes gérés via le site.
const res = await verifierConnexion(login, motDePasse);
if (res.ok) {
return {
ok: true,
login: res.utilisateur.login,
role: res.utilisateur.role,
admin: false,
doitChangerMdp: res.utilisateur.doitChangerMdp
};
}
if (res.raison === 'desactive') {
return { ok: false, raison: 'desactive' };
}
return { ok: false, raison: 'identifiants' };
}
/**
* Émet un JWT signé. Le token ne porte que le login (`sub`) : le rôle est relu à
* chaque requête depuis le store, pour que tout changement de rôle ou désactivation
* décidé par l'admin prenne effet immédiatement, sans attendre une reconnexion.
*/
export function emettreJeton(login) {
return jwt.sign({ sub: login }, JWT_SECRET, {
expiresIn: `${JWT_EXPIRATION_MINUTES}m`
});
}
/**
* Middleware Express : exige un JWT valide (Authorization: Bearer <token>).
* Renseigne req.utilisateur = { login, role, admin }. Le rôle est relu en direct :
* - admin du .env -> role 'admin' ;
* - sinon rôle courant du store ; un compte supprimé ou désactivé est refusé (401/403).
*/
export async function exigerAuth(req, res, next) {
const entete = req.headers.authorization || '';
const [schema, jeton] = entete.split(' ');
if (schema !== 'Bearer' || !jeton) {
return res.status(401).json({ erreur: 'Authentification requise.' });
}
let charge;
try {
charge = jwt.verify(jeton, JWT_SECRET);
} catch {
return res.status(401).json({ erreur: 'Session invalide ou expirée.' });
}
const login = charge.sub;
if (estAdmin(login)) {
req.utilisateur = { login, role: 'admin', admin: true };
return next();
}
// Rôle relu depuis le store à chaque requête.
const u = await trouverUtilisateur(login);
if (!u) {
return res.status(401).json({ erreur: 'Compte introuvable.' });
}
if (u.role === 'desactive') {
return res.status(403).json({ erreur: 'Ce compte est désactivé.' });
}
req.utilisateur = { login, role: u.role, admin: false };
return next();
}
/** Middleware : réservé à l'administrateur. */
export function exigerAdmin(req, res, next) {
if (!req.utilisateur?.admin) {
return res.status(403).json({ erreur: 'Réservé à l’administrateur.' });
}
return next();
}
/**
* Middleware : exige un rôle autorisé à contribuer (annoter).
* Admin et contributeur passent ; consultation est refusé (403).
*/
export function exigerContributeur(req, res, next) {
const role = req.utilisateur?.role;
if (role === 'admin' || role === 'contributeur') {
return next();
}
return res.status(403).json({ erreur: 'Votre accès est en lecture seule.' });
}
site/backend/src/config.js
+69
View File
@@ -0,0 +1,69 @@
// Configuration du backend, lue depuis les variables d'environnement.
// Aucune valeur sensible n'est codée en dur : tout vient de l'environnement (.env via docker-compose).
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const __dirname = path.dirname(fileURLToPath(import.meta.url));
/**
* Répertoire contenant les fichiers .md à présenter.
* Par défaut, en conteneur, les specs sont montées en lecture seule sur /specs.
* En dev local, on retombe sur le dossier docs/specs-pre-projet du dépôt.
*/
export const SPECS_DIR =
process.env.SPECS_DIR ||
path.resolve(__dirname, '../../../docs/specs-pre-projet');
/**
* Répertoire d'écriture des annotations (un fichier JSON par document).
* En conteneur, monté en lecture-écriture sur /annotations (volume dédié).
* En dev local, retombe sur site/annotations.
*/
export const ANNOTATIONS_DIR =
process.env.ANNOTATIONS_DIR ||
path.resolve(__dirname, '../../annotations');
/**
* Répertoire d'écriture des comptes utilisateurs gérés via le site (users.json).
* En conteneur, monté en lecture-écriture sur /users (volume dédié).
* En dev local, retombe sur site/users.
*/
export const USERS_DIR =
process.env.USERS_DIR ||
path.resolve(__dirname, '../../users');
/** Port d'écoute HTTP du backend. */
export const PORT = Number(process.env.PORT || 8080);
/** Secret de signature des JWT. OBLIGATOIRE : le serveur refuse de démarrer sans. */
export const JWT_SECRET = process.env.JWT_SECRET || '';
/** Durée de validité d'un jeton de session, en minutes. */
export const JWT_EXPIRATION_MINUTES = Number(process.env.JWT_EXPIRATION_MINUTES || 720);
/**
* Compte ADMINISTRATEUR unique, défini dans le .env (hors du store géré par le site).
* C'est le seul compte qui ne vit pas dans users.json. Il gère les accès et les exports.
* ADMIN_USER=madjax
* ADMIN_PASSWORD=Change-moi
*/
export const ADMIN_USER = (process.env.ADMIN_USER || '').trim();
export const ADMIN_PASSWORD = process.env.ADMIN_PASSWORD || '';
/** Vrai si le login correspond à l'administrateur du .env. */
export function estAdmin(login) {
return !!ADMIN_USER && login === ADMIN_USER;
}
/** Validation de la configuration au démarrage : échec rapide si incohérent. */
export function validerConfig() {
const erreurs = [];
if (!JWT_SECRET || JWT_SECRET.length < 32) {
erreurs.push('JWT_SECRET est requis et doit faire au moins 32 caractères.');
}
if (!ADMIN_USER || !ADMIN_PASSWORD) {
erreurs.push('ADMIN_USER et ADMIN_PASSWORD sont requis (compte administrateur).');
}
return erreurs;
}
site/backend/src/server.js
+263
View File
@@ -0,0 +1,263 @@
// Point d'entrée du backend : API Express.
// GET /health -> sonde de santé (publique)
// POST /api/auth/login -> { login, motDePasse } -> { token, login, role, admin, doitChangerMdp }
// POST /api/auth/change-password -> { ancien, nouveau } (protégé)
// GET /api/specs[/:cle] -> documents markdown (protégé)
// GET/POST/PUT/DELETE /api/annotations -> annotations (contrib. pour l'écriture)
// GET/POST/PUT/DELETE /api/users -> gestion des comptes (admin)
import express from 'express';
import cors from 'cors';
import { PORT, SPECS_DIR, validerConfig } from './config.js';
import {
verifierIdentifiants,
emettreJeton,
exigerAuth,
exigerAdmin,
exigerContributeur
} from './auth.js';
import { listerDocuments, obtenirDocument } from './specs.js';
import {
lireAnnotations,
creerAnnotation,
majAnnotation,
supprimerAnnotation,
listerToutes,
construireExportMarkdown
} from './annotations.js';
import {
listerUtilisateurs,
creerUtilisateur,
definirRole,
reinitialiserMotDePasse,
changerMotDePasse,
supprimerUtilisateur,
amorcerSiVide
} from './users.js';
// --- Validation de configuration : échec rapide au démarrage ---
const erreursConfig = validerConfig();
if (erreursConfig.length > 0) {
for (const e of erreursConfig) {
console.error(`[config] ${e}`);
}
process.exit(1);
}
// --- Amorçage des comptes initiaux (une seule fois, si le store est vide) ---
// Les 3 comptes repris de l'ancien .env, en contributeur, avec changement de mot de
// passe imposé à la première connexion. Le seed est modifiable via SEED_USERS
// ("login:mdp:role,...") mais possède une valeur par défaut.
function parserSeed() {
const brut = (process.env.SEED_USERS || '').trim();
if (!brut) {
return [
{ login: 'nikolaz.stephan', motDePasse: 'A251365', role: 'contributeur' },
{ login: 'philippe.courivaud', motDePasse: 'A252750', role: 'contributeur' },
{ login: 'bruno.peyraud', motDePasse: 'A251992', role: 'contributeur' }
];
}
return brut.split(',').map((t) => {
const [login, motDePasse, role] = t.split(':');
return { login: (login || '').trim(), motDePasse, role: (role || 'contributeur').trim() };
});
}
await amorcerSiVide(parserSeed()).then((r) => {
if (r.amorce) {
console.log(`[satpro-specs] ${r.nombre} compte(s) initial(aux) amorcé(s).`);
}
});
const app = express();
app.use(express.json({ limit: '256kb' }));
app.use(cors());
// Empêche l'indexation côté API également.
app.use((req, res, next) => {
res.setHeader('X-Robots-Tag', 'noindex, nofollow');
next();
});
// --- Santé (publique) ---
app.get('/health', (req, res) => {
res.json({ statut: 'ok' });
});
// --- Authentification ---
app.post('/api/auth/login', async (req, res) => {
const { login, motDePasse } = req.body || {};
const r = await verifierIdentifiants(login, motDePasse);
if (!r.ok) {
if (r.raison === 'desactive') {
return res.status(403).json({ erreur: 'Ce compte est désactivé.' });
}
return res.status(401).json({ erreur: 'Identifiants invalides.' });
}
const token = emettreJeton(r.login);
return res.json({
token,
login: r.login,
role: r.role,
admin: r.admin,
doitChangerMdp: r.doitChangerMdp
});
});
// Changement de mot de passe par l'utilisateur lui-même (comptes gérés).
app.post('/api/auth/change-password', exigerAuth, async (req, res) => {
if (req.utilisateur.admin) {
return res.status(400).json({ erreur: "Le compte administrateur se gère via le fichier .env." });
}
const { ancien, nouveau } = req.body || {};
const r = await changerMotDePasse(req.utilisateur.login, ancien, nouveau);
if (r.erreur === 'introuvable') {
return res.status(404).json({ erreur: 'Compte introuvable.' });
}
if (r.erreur === 'mauvais_ancien') {
return res.status(400).json({ erreur: 'Ancien mot de passe incorrect.' });
}
if (r.erreur) {
return res.status(400).json({ erreur: r.erreur });
}
res.json({ ok: true });
});
// --- Specs (protégées) ---
app.get('/api/specs', exigerAuth, async (req, res) => {
const docs = await listerDocuments();
res.json(docs.map(({ cle, titre }) => ({ cle, titre, disponible: true })));
});
app.get('/api/specs/:cle', exigerAuth, async (req, res) => {
const doc = await obtenirDocument(req.params.cle);
if (!doc) {
return res.status(404).json({ erreur: 'Document introuvable.' });
}
res.json(doc);
});
// --- Gestion des comptes (admin uniquement) ---
app.get('/api/users', exigerAuth, exigerAdmin, async (req, res) => {
res.json(await listerUtilisateurs());
});
app.post('/api/users', exigerAuth, exigerAdmin, async (req, res) => {
const { login, motDePasse, role } = req.body || {};
const r = await creerUtilisateur({ login, motDePasse, role });
if (r.erreur) {
return res.status(400).json({ erreur: r.erreur });
}
res.status(201).json(r.utilisateur);
});
app.put('/api/users/:login/role', exigerAuth, exigerAdmin, async (req, res) => {
const r = await definirRole(req.params.login, (req.body || {}).role);
if (r.erreur === 'introuvable') {
return res.status(404).json({ erreur: 'Compte introuvable.' });
}
if (r.erreur) {
return res.status(400).json({ erreur: r.erreur });
}
res.json(r.utilisateur);
});
app.post('/api/users/:login/reset-password', exigerAuth, exigerAdmin, async (req, res) => {
const r = await reinitialiserMotDePasse(req.params.login, (req.body || {}).motDePasse);
if (r.erreur === 'introuvable') {
return res.status(404).json({ erreur: 'Compte introuvable.' });
}
if (r.erreur) {
return res.status(400).json({ erreur: r.erreur });
}
res.json(r.utilisateur);
});
app.delete('/api/users/:login', exigerAuth, exigerAdmin, async (req, res) => {
const r = await supprimerUtilisateur(req.params.login);
if (r.erreur === 'introuvable') {
return res.status(404).json({ erreur: 'Compte introuvable.' });
}
res.status(204).end();
});
// --- Annotations ---
// Export global (admin). Placé AVANT /api/annotations/:cle.
app.get('/api/annotations/export.md', exigerAuth, exigerAdmin, async (req, res) => {
const toutes = await listerToutes();
const md = construireExportMarkdown(toutes);
res.setHeader('Content-Type', 'text/markdown; charset=utf-8');
res.setHeader('Content-Disposition', 'attachment; filename="annotations-satpro.md"');
res.send(md);
});
app.get('/api/annotations/export.json', exigerAuth, exigerAdmin, async (req, res) => {
const toutes = await listerToutes();
res.setHeader('Content-Disposition', 'attachment; filename="annotations-satpro.json"');
res.json(toutes);
});
// Liste de toutes les annotations (admin).
app.get('/api/annotations', exigerAuth, exigerAdmin, async (req, res) => {
res.json(await listerToutes());
});
// Annotations d'un document (tout utilisateur authentifié, y compris consultation en lecture).
app.get('/api/annotations/:cle', exigerAuth, async (req, res) => {
const liste = await lireAnnotations(req.params.cle);
res.json(liste);
});
// Création — réservé aux contributeurs (et admin).
app.post('/api/annotations/:cle', exigerAuth, exigerContributeur, async (req, res) => {
const resultat = await creerAnnotation(req.params.cle, req.utilisateur.login, req.body || {});
if (resultat.erreur) {
return res.status(400).json({ erreur: resultat.erreur });
}
res.status(201).json(resultat.annotation);
});
// Mise à jour — contributeur/admin, et seulement auteur ou admin.
app.put('/api/annotations/:cle/:id', exigerAuth, exigerContributeur, async (req, res) => {
const resultat = await majAnnotation(
req.params.cle,
req.params.id,
req.utilisateur.login,
req.utilisateur.admin,
req.body || {}
);
if (resultat.erreur === 'introuvable') {
return res.status(404).json({ erreur: 'Annotation introuvable.' });
}
if (resultat.erreur === 'interdit') {
return res.status(403).json({ erreur: 'Vous ne pouvez modifier que vos annotations.' });
}
if (resultat.erreur) {
return res.status(400).json({ erreur: resultat.erreur });
}
res.json(resultat.annotation);
});
// Suppression — contributeur/admin, et seulement auteur ou admin.
app.delete('/api/annotations/:cle/:id', exigerAuth, exigerContributeur, async (req, res) => {
const resultat = await supprimerAnnotation(
req.params.cle,
req.params.id,
req.utilisateur.login,
req.utilisateur.admin
);
if (resultat.erreur === 'introuvable') {
return res.status(404).json({ erreur: 'Annotation introuvable.' });
}
if (resultat.erreur === 'interdit') {
return res.status(403).json({ erreur: 'Vous ne pouvez supprimer que vos annotations.' });
}
res.status(204).end();
});
app.listen(PORT, () => {
console.log(`[satpro-specs] backend à l'écoute sur :${PORT}`);
console.log(`[satpro-specs] specs lues depuis : ${SPECS_DIR}`);
});
site/backend/src/specs.js
+102
View File
@@ -0,0 +1,102 @@
// Lecture des fichiers de specs Markdown depuis le disque, EN DIRECT.
// Aucune mise en cache du contenu : chaque requête relit le fichier, de sorte que
// les éditions faites dans l'IDE sont immédiatement visibles après rafraîchissement.
import fs from 'node:fs/promises';
import path from 'node:path';
import { SPECS_DIR } from './config.js';
/**
* Clé d'un document = nom de fichier sans extension (ex. "05-initialisation-contrat").
* On n'autorise que ce format pour empêcher toute traversée de répertoire.
*/
const CLE_VALIDE = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i;
/** Convertit un nom de fichier en clé (retire l'extension .md). */
function fichierVersCle(nomFichier) {
return nomFichier.replace(/\.md$/i, '');
}
/**
* Dérive un titre lisible :
* - priorité au premier titre de niveau 1 (# ...) du contenu ;
* - sinon, à partir du nom de fichier (préfixe numérique retiré, tirets -> espaces).
*/
function deriverTitre(cle, contenu) {
const ligneTitre = contenu
.split(/\r?\n/)
.find((l) => /^#\s+/.test(l.trim()));
if (ligneTitre) {
return ligneTitre.trim().replace(/^#\s+/, '').trim();
}
// Repli : "05-initialisation-contrat" -> "Initialisation contrat"
const sansPrefixe = cle.replace(/^\d+[-_]?/, '');
const mots = sansPrefixe.replace(/[-_]+/g, ' ').trim();
return mots.charAt(0).toUpperCase() + mots.slice(1);
}
/** Résout de façon sûre le chemin d'un fichier .md à partir d'une clé. */
function cheminSur(cle) {
if (!CLE_VALIDE.test(cle)) {
return null;
}
const chemin = path.resolve(SPECS_DIR, `${cle}.md`);
// Garde-fou anti-traversée : le chemin résolu doit rester sous SPECS_DIR.
const racine = path.resolve(SPECS_DIR) + path.sep;
if (!chemin.startsWith(racine)) {
return null;
}
return chemin;
}
/**
* Liste les documents disponibles, triés par nom de fichier (préfixes 00, 01, …).
* Retourne [{ cle, titre, ordre }].
*/
export async function listerDocuments() {
let entrees;
try {
entrees = await fs.readdir(SPECS_DIR, { withFileTypes: true });
} catch {
return [];
}
const fichiersMd = entrees
.filter((e) => e.isFile() && /\.md$/i.test(e.name))
.map((e) => e.name)
.sort((a, b) => a.localeCompare(b, 'fr', { numeric: true }));
const docs = [];
for (const nom of fichiersMd) {
const cle = fichierVersCle(nom);
if (!CLE_VALIDE.test(cle)) continue;
let contenu = '';
try {
contenu = await fs.readFile(path.join(SPECS_DIR, nom), 'utf8');
} catch {
// ignore le fichier illisible
continue;
}
docs.push({ cle, titre: deriverTitre(cle, contenu), fichier: nom });
}
return docs;
}
/**
* Retourne le contenu Markdown d'un document par sa clé, ou null si introuvable.
* { cle, titre, markdown }
*/
export async function obtenirDocument(cle) {
const chemin = cheminSur(cle);
if (!chemin) {
return null;
}
let markdown;
try {
markdown = await fs.readFile(chemin, 'utf8');
} catch {
return null;
}
return { cle, titre: deriverTitre(cle, markdown), markdown };
}
site/backend/src/users.js
+211
View File
@@ -0,0 +1,211 @@
// Gestion des comptes utilisateurs gérés via le site (hors admin, défini dans .env).
// Stockage : un unique fichier JSON { "users": [ ... ] } dans USERS_DIR/users.json.
//
// Un utilisateur :
// {
// login: "nikolaz.stephan",
// motDePasseHash: "$2a$10$...", // bcrypt, jamais en clair
// role: "contributeur", // consultation | contributeur | desactive
// doitChangerMdp: true, // force le changement à la prochaine connexion
// creeLe, modifieLe
// }
import fs from 'node:fs/promises';
import path from 'node:path';
import bcrypt from 'bcryptjs';
import { USERS_DIR } from './config.js';
export const ROLES = ['consultation', 'contributeur', 'desactive'];
const LOGIN_VALIDE = /^[a-zA-Z0-9._-]{2,64}$/;
const FICHIER = () => path.join(USERS_DIR, 'users.json');
async function assurerDossier() {
await fs.mkdir(USERS_DIR, { recursive: true });
}
/** Lit la liste brute des utilisateurs (avec hash). Usage interne. */
async function lireTous() {
try {
const brut = await fs.readFile(FICHIER(), 'utf8');
const data = JSON.parse(brut);
return Array.isArray(data.users) ? data.users : [];
} catch {
return [];
}
}
/** Écrit (atomiquement) la liste des utilisateurs. */
async function ecrireTous(users) {
await assurerDossier();
const contenu = JSON.stringify({ users }, null, 2);
const tmp = `${FICHIER()}.tmp-${process.pid}`;
await fs.writeFile(tmp, contenu, 'utf8');
await fs.rename(tmp, FICHIER());
}
/** Projection publique (sans le hash de mot de passe). */
function versPublic(u) {
return {
login: u.login,
role: u.role,
doitChangerMdp: !!u.doitChangerMdp,
creeLe: u.creeLe,
modifieLe: u.modifieLe
};
}
/** Liste publique de tous les comptes (sans hash). */
export async function listerUtilisateurs() {
const users = await lireTous();
return users
.sort((a, b) => a.login.localeCompare(b.login, 'fr'))
.map(versPublic);
}
/** Récupère un utilisateur par login (objet brut avec hash) ou null. */
export async function trouverUtilisateur(login) {
const users = await lireTous();
return users.find((u) => u.login === login) || null;
}
/**
* Vérifie les identifiants d'un compte géré.
* Retourne { ok, raison, utilisateur } :
* - raison = 'inconnu' | 'desactive' | 'mauvais_mdp'
* - utilisateur = projection publique si ok.
*/
export async function verifierConnexion(login, motDePasse) {
const u = await trouverUtilisateur(login);
if (!u) {
return { ok: false, raison: 'inconnu' };
}
if (u.role === 'desactive') {
return { ok: false, raison: 'desactive' };
}
const correspond = bcrypt.compareSync(motDePasse, u.motDePasseHash);
if (!correspond) {
return { ok: false, raison: 'mauvais_mdp' };
}
return { ok: true, utilisateur: versPublic(u) };
}
/** Crée un compte. role par défaut 'contributeur', doitChangerMdp=true. */
export async function creerUtilisateur({ login, motDePasse, role }) {
const loginNet = (login || '').trim();
if (!LOGIN_VALIDE.test(loginNet)) {
return { erreur: 'Login invalide (2 à 64 caractères : lettres, chiffres, . _ -).' };
}
if (!motDePasse || String(motDePasse).length < 4) {
return { erreur: 'Mot de passe par défaut requis (4 caractères minimum).' };
}
const roleNet = ROLES.includes(role) ? role : 'contributeur';
const users = await lireTous();
if (users.some((u) => u.login === loginNet)) {
return { erreur: 'Ce login existe déjà.' };
}
const maintenant = new Date().toISOString();
const u = {
login: loginNet,
motDePasseHash: bcrypt.hashSync(String(motDePasse), 10),
role: roleNet,
doitChangerMdp: true,
creeLe: maintenant,
modifieLe: maintenant
};
users.push(u);
await ecrireTous(users);
return { utilisateur: versPublic(u) };
}
/** Met à jour le rôle d'un compte. */
export async function definirRole(login, role) {
if (!ROLES.includes(role)) {
return { erreur: 'Rôle invalide.' };
}
const users = await lireTous();
const u = users.find((x) => x.login === login);
if (!u) return { erreur: 'introuvable' };
u.role = role;
u.modifieLe = new Date().toISOString();
await ecrireTous(users);
return { utilisateur: versPublic(u) };
}
/**
* Réinitialise le mot de passe d'un compte (admin). Impose le changement à la
* prochaine connexion.
*/
export async function reinitialiserMotDePasse(login, motDePasseParDefaut) {
if (!motDePasseParDefaut || String(motDePasseParDefaut).length < 4) {
return { erreur: 'Mot de passe par défaut requis (4 caractères minimum).' };
}
const users = await lireTous();
const u = users.find((x) => x.login === login);
if (!u) return { erreur: 'introuvable' };
u.motDePasseHash = bcrypt.hashSync(String(motDePasseParDefaut), 10);
u.doitChangerMdp = true;
u.modifieLe = new Date().toISOString();
await ecrireTous(users);
return { utilisateur: versPublic(u) };
}
/**
* Change le mot de passe par l'utilisateur lui-même (après vérification de l'ancien).
* Retire le flag doitChangerMdp.
*/
export async function changerMotDePasse(login, ancien, nouveau) {
if (!nouveau || String(nouveau).length < 4) {
return { erreur: 'Le nouveau mot de passe doit faire au moins 4 caractères.' };
}
const users = await lireTous();
const u = users.find((x) => x.login === login);
if (!u) return { erreur: 'introuvable' };
if (!bcrypt.compareSync(String(ancien), u.motDePasseHash)) {
return { erreur: 'mauvais_ancien' };
}
if (String(nouveau) === String(ancien)) {
return { erreur: 'Le nouveau mot de passe doit être différent de l’ancien.' };
}
u.motDePasseHash = bcrypt.hashSync(String(nouveau), 10);
u.doitChangerMdp = false;
u.modifieLe = new Date().toISOString();
await ecrireTous(users);
return { ok: true };
}
/** Supprime un compte. */
export async function supprimerUtilisateur(login) {
const users = await lireTous();
const idx = users.findIndex((u) => u.login === login);
if (idx === -1) return { erreur: 'introuvable' };
users.splice(idx, 1);
await ecrireTous(users);
return { ok: true };
}
/**
* Amorce les comptes initiaux au premier démarrage si le store est vide.
* `seed` = [{ login, motDePasse, role }]. Ne fait rien si des comptes existent déjà.
*/
export async function amorcerSiVide(seed) {
const users = await lireTous();
if (users.length > 0 || !Array.isArray(seed) || seed.length === 0) {
return { amorce: false };
}
const maintenant = new Date().toISOString();
const nouveaux = seed
.filter((s) => LOGIN_VALIDE.test((s.login || '').trim()) && s.motDePasse)
.map((s) => ({
login: s.login.trim(),
motDePasseHash: bcrypt.hashSync(String(s.motDePasse), 10),
role: ROLES.includes(s.role) ? s.role : 'contributeur',
doitChangerMdp: true,
creeLe: maintenant,
modifieLe: maintenant
}));
if (nouveaux.length > 0) {
await ecrireTous(nouveaux);
}
return { amorce: nouveaux.length > 0, nombre: nouveaux.length };
}
site/docker-compose.yml
+53
View File
@@ -0,0 +1,53 @@
services:
backend:
build:
context: ./backend
dockerfile: Dockerfile
environment:
- PORT=8080
# Les specs sont lues depuis /specs (monté en lecture seule, voir volumes).
- SPECS_DIR=/specs
# Les annotations sont écrites dans /annotations (monté en lecture-écriture).
- ANNOTATIONS_DIR=/annotations
# Les comptes gérés via le site sont écrits dans /users (monté en lecture-écriture).
- USERS_DIR=/users
# --- Authentification ---
# :? fait échouer le démarrage si le secret est absent (jamais de clé vide).
- JWT_SECRET=${JWT_SECRET:?JWT_SECRET requis (>= 32 caracteres)}
- JWT_EXPIRATION_MINUTES=${JWT_EXPIRATION_MINUTES:-720}
# Compte ADMINISTRATEUR unique (seul compte défini hors du site). Les autres
# comptes se gèrent dans l'application (page « Gestion des accès »).
- ADMIN_USER=${ADMIN_USER:?ADMIN_USER requis}
- ADMIN_PASSWORD=${ADMIN_PASSWORD:?ADMIN_PASSWORD requis}
# Amorçage facultatif des comptes initiaux au 1er démarrage (si le store est vide) :
# "login:mdp:role,...". Laissé vide = pas d'amorçage personnalisé (défaut interne).
- SEED_USERS=${SEED_USERS:-}
volumes:
# Specs montées EN LECTURE SEULE depuis le dépôt. Les éditions faites dans l'IDE
# sont donc visibles en direct par le site (après rafraîchissement du navigateur).
# Le ':ro' empêche toute écriture depuis le conteneur.
- ../docs/specs-pre-projet:/specs:ro
# Annotations EN LECTURE-ÉCRITURE : persistées sur l'hôte dans ./annotations
# (un fichier JSON par document). Facile à récupérer/exporter et à transmettre.
- ./annotations:/annotations
# Comptes gérés EN LECTURE-ÉCRITURE : persistés sur l'hôte dans ./users/users.json
# (mots de passe hachés bcrypt). Conservés entre deux ateliers.
- ./users:/users
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
interval: 30s
timeout: 5s
retries: 3
start_period: 15s
frontend:
build:
context: ./frontend
dockerfile: Dockerfile
ports:
- "2002:80" # hôte 2002 -> nginx (frontend). Caddy proxifiera vers ce port.
depends_on:
backend:
condition: service_healthy
restart: unless-stopped
site/frontend/Dockerfile
+23
View File
@@ -0,0 +1,23 @@
# ---- Étape build (Node) ----
FROM node:22-alpine AS build
WORKDIR /app
# Dépendances (couche cache indépendante du code source)
COPY package*.json ./
RUN npm ci
# Code source + build production (utilise environment.prod.ts via fileReplacements)
COPY . .
RUN npm run build -- --configuration production
# ---- Étape serve (nginx) ----
FROM nginx:1.27-alpine AS serve
# Configuration nginx : SPA Angular + reverse-proxy /api + en-têtes anti-indexation
COPY nginx.conf /etc/nginx/conf.d/default.conf
# Le builder @angular-devkit/build-angular:application (Angular 22) émet les fichiers
# statiques dans dist/<projet>/browser.
COPY --from=build /app/dist/satpro-specs-frontend/browser /usr/share/nginx/html
EXPOSE 80
site/frontend/angular.json
+74
View File
@@ -0,0 +1,74 @@
{
"version": 1,
"newProjectRoot": "projects",
"projects": {
"satpro-specs-frontend": {
"projectType": "application",
"root": "",
"sourceRoot": "src",
"prefix": "app",
"architect": {
"build": {
"builder": "@angular-devkit/build-angular:application",
"options": {
"outputPath": "dist/satpro-specs-frontend",
"index": "src/index.html",
"browser": "src/main.ts",
"polyfills": ["zone.js"],
"tsConfig": "tsconfig.app.json",
"assets": [
{
"glob": "**/*",
"input": "public"
}
],
"styles": ["src/styles.scss"],
"scripts": []
},
"configurations": {
"production": {
"budgets": [
{
"type": "initial",
"maximumWarning": "1mb",
"maximumError": "3mb"
},
{
"type": "anyComponentStyle",
"maximumWarning": "8kb",
"maximumError": "16kb"
}
],
"outputHashing": "all",
"fileReplacements": [
{
"replace": "src/environments/environment.ts",
"with": "src/environments/environment.prod.ts"
}
]
},
"development": {
"optimization": false,
"extractLicenses": false,
"sourceMap": true,
"namedChunks": true
}
},
"defaultConfiguration": "production"
},
"serve": {
"builder": "@angular-devkit/build-angular:dev-server",
"configurations": {
"production": {
"buildTarget": "satpro-specs-frontend:build:production"
},
"development": {
"buildTarget": "satpro-specs-frontend:build:development"
}
},
"defaultConfiguration": "development"
}
}
}
}
}
site/frontend/nginx.conf
+37
View File
@@ -0,0 +1,37 @@
server {
listen 80;
server_name _;
root /usr/share/nginx/html;
index index.html;
# Anti-indexation : en-tête ajouté à TOUTES les réponses servies par nginx.
# Combiné à la balise <meta robots> et au robots.txt, et au login applicatif.
add_header X-Robots-Tag "noindex, nofollow, noarchive, nosnippet" always;
# robots.txt explicite (présent dans les assets, mais on garde la cohérence).
location = /robots.txt {
add_header X-Robots-Tag "noindex, nofollow" always;
try_files $uri =404;
}
# SPA Angular : toute route inconnue retombe sur index.html
location / {
try_files $uri $uri/ /index.html;
}
# Reverse-proxy des appels API vers le backend Node (réseau interne Compose)
location /api/ {
proxy_pass http://backend:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# Sonde de santé exposée via nginx -> backend (utilisée par Caddy et le compose).
location = /health {
proxy_pass http://backend:8080/health;
}
}
site/frontend/package-lock.json
Generated
+13231
View File
File diff suppressed because it is too large Load Diff
site/frontend/package.json
+31
View File
@@ -0,0 +1,31 @@
{
"name": "satpro-specs-frontend",
"version": "1.0.0",
"scripts": {
"ng": "ng",
"start": "ng serve",
"build": "ng build",
"watch": "ng build --watch --configuration development"
},
"private": true,
"dependencies": {
"@angular/common": "^22.1.6",
"@angular/compiler": "^22.1.6",
"@angular/core": "^22.1.6",
"@angular/forms": "^22.1.6",
"@angular/platform-browser": "^22.1.6",
"@angular/router": "^22.1.6",
"dompurify": "^3.4.15",
"marked": "^18.0.13",
"mermaid": "^12.0.0",
"rxjs": "~7.8.0",
"tslib": "^2.3.0",
"zone.js": "~0.15.0"
},
"devDependencies": {
"@angular-devkit/build-angular": "^22.1.8",
"@angular/cli": "^22.1.8",
"@angular/compiler-cli": "^22.1.6",
"typescript": "~6.0.0"
}
}
site/frontend/public/robots.txt
+2
View File
@@ -0,0 +1,2 @@
User-agent: *
Disallow: /
site/frontend/src/app/app.component.html
+30
View File
@@ -0,0 +1,30 @@
@if (enteteVisible()) {
<header class="entete">
<a class="entete__marque" routerLink="/specs/00-sommaire" title="Retour aux specifications">
<span class="entete__logo" aria-hidden="true">▶</span>
<span class="entete__titre">SatPRO — Specs pré-projet</span>
</a>
<div class="entete__compte">
@if (estAdmin()) {
<a class="entete__lien" routerLink="/acces" title="Gérer les comptes et accès">Gestion des accès</a>
<div class="entete__export" title="Exporter TOUTES les annotations (tous les documents)">
<span class="entete__export-label">Export annotations :</span>
<button type="button" (click)="exporter('md')" [disabled]="exportEnCours()">Markdown</button>
<button type="button" (click)="exporter('json')" [disabled]="exportEnCours()">JSON</button>
</div>
<span class="entete__role" title="Vous êtes administrateur">admin</span>
}
<span class="entete__user">{{ login() }}</span>
<button type="button" class="entete__deconnexion" (click)="seDeconnecter()">
Se déconnecter
</button>
</div>
@if (exportMessage()) {
<span class="entete__export-msg" role="alert">{{ exportMessage() }}</span>
}
</header>
}
<main class="contenu">
<router-outlet />
</main>
site/frontend/src/app/app.component.scss
+136
View File
@@ -0,0 +1,136 @@
:host {
display: flex;
flex-direction: column;
min-height: 100vh;
}
.entete {
display: flex;
align-items: center;
justify-content: space-between;
padding: 0 1.25rem;
height: 56px;
background: var(--dekra-vert);
color: #fff;
box-shadow: 0 1px 4px rgba(0, 0, 0, 0.15);
}
.entete__marque {
display: flex;
align-items: center;
gap: 0.6rem;
color: inherit;
text-decoration: none;
cursor: pointer;
}
.entete__marque:hover .entete__titre {
text-decoration: underline;
}
.entete__logo {
font-size: 1.2rem;
}
.entete__titre {
font-weight: 600;
letter-spacing: 0.2px;
}
.entete__compte {
display: flex;
align-items: center;
gap: 0.9rem;
font-size: 0.9rem;
}
.entete__user {
opacity: 0.9;
}
.entete__lien {
color: #fff;
text-decoration: none;
font-size: 0.85rem;
padding: 0.3rem 0.6rem;
border: 1px solid rgba(255, 255, 255, 0.4);
border-radius: 6px;
}
.entete__lien:hover {
background: rgba(255, 255, 255, 0.2);
}
.entete__export {
display: flex;
align-items: center;
gap: 0.35rem;
padding-right: 0.75rem;
margin-right: 0.25rem;
border-right: 1px solid rgba(255, 255, 255, 0.3);
}
.entete__export-label {
font-size: 0.8rem;
opacity: 0.85;
}
.entete__export button {
background: rgba(255, 255, 255, 0.15);
color: #fff;
border: 1px solid rgba(255, 255, 255, 0.4);
border-radius: 6px;
padding: 0.3rem 0.6rem;
cursor: pointer;
font-size: 0.8rem;
}
.entete__export button:hover:not(:disabled) {
background: rgba(255, 255, 255, 0.3);
}
.entete__export button:disabled {
opacity: 0.6;
cursor: default;
}
.entete__role {
background: var(--ds-yellow-200);
color: var(--ds-yellow-700);
border-radius: 999px;
padding: 0.05rem 0.5rem;
font-size: 0.72rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.04em;
}
.entete__export-msg {
position: absolute;
top: 56px;
right: 1rem;
background: var(--ds-danger-500);
color: var(--ds-white);
padding: 0.3rem 0.6rem;
border-radius: 0 0 6px 6px;
font-size: 0.8rem;
}
.entete__deconnexion {
background: rgba(255, 255, 255, 0.15);
color: #fff;
border: 1px solid rgba(255, 255, 255, 0.4);
border-radius: 6px;
padding: 0.35rem 0.75rem;
cursor: pointer;
font-size: 0.85rem;
}
.entete__deconnexion:hover {
background: rgba(255, 255, 255, 0.28);
}
.contenu {
flex: 1;
min-height: 0;
}
site/frontend/src/app/app.component.ts
+61
View File
@@ -0,0 +1,61 @@
import { ChangeDetectionStrategy, Component, inject, signal } from '@angular/core';
import { NavigationEnd, Router, RouterLink, RouterOutlet } from '@angular/router';
import { filter } from 'rxjs';
import { AuthService } from './core/services/auth.service';
import { AnnotationService } from './core/services/annotation.service';
@Component({
selector: 'app-root',
standalone: true,
imports: [RouterOutlet, RouterLink],
changeDetection: ChangeDetectionStrategy.OnPush,
templateUrl: './app.component.html',
styleUrl: './app.component.scss'
})
export class AppComponent {
private readonly auth = inject(AuthService);
private readonly annotations = inject(AnnotationService);
private readonly router = inject(Router);
readonly login = this.auth.login;
readonly estConnecte = this.auth.estConnecte;
readonly estAdmin = this.auth.estAdmin;
readonly exportEnCours = signal(false);
readonly exportMessage = signal<string | null>(null);
/** URL courante, suivie via les événements du routeur (pour masquer l'en-tête sur /login). */
private readonly urlCourante = signal<string>(this.router.url);
/**
* L'en-tête est affichée uniquement si l'utilisateur est connecté ET hors page de login.
* Un jeton résiduel sur /login ne doit pas faire réapparaître la barre.
*/
readonly enteteVisible = () =>
this.estConnecte() &&
!this.urlCourante().startsWith('/login') &&
!this.urlCourante().startsWith('/changer-mot-de-passe');
constructor() {
this.router.events
.pipe(filter((e): e is NavigationEnd => e instanceof NavigationEnd))
.subscribe((e) => this.urlCourante.set(e.urlAfterRedirects));
}
/** Export global de toutes les annotations (admin), depuis l'en-tête. */
async exporter(format: 'md' | 'json'): Promise<void> {
this.exportEnCours.set(true);
this.exportMessage.set(null);
const ok = await this.annotations.telechargerExport(format, this.auth.obtenirToken());
this.exportEnCours.set(false);
if (!ok) {
this.exportMessage.set("Échec de l'export.");
setTimeout(() => this.exportMessage.set(null), 4000);
}
}
seDeconnecter(): void {
this.auth.seDeconnecter();
void this.router.navigate(['/login']);
}
}
site/frontend/src/app/app.config.ts
+14
View File
@@ -0,0 +1,14 @@
import { ApplicationConfig, provideZoneChangeDetection } from '@angular/core';
import { provideRouter } from '@angular/router';
import { provideHttpClient, withInterceptors } from '@angular/common/http';
import { routes } from './app.routes';
import { authInterceptor } from './core/interceptors/auth.interceptor';
export const appConfig: ApplicationConfig = {
providers: [
provideZoneChangeDetection({ eventCoalescing: true }),
provideRouter(routes),
provideHttpClient(withInterceptors([authInterceptor]))
]
};
site/frontend/src/app/app.routes.ts
+36
View File
@@ -0,0 +1,36 @@
import { Routes } from '@angular/router';
import { authGuard, adminGuard, sessionGuard } from './core/guards/auth.guard';
import { LoginComponent } from './features/auth/login.component';
import { ChangePasswordComponent } from './features/auth/change-password.component';
/**
* Routes de l'application.
* - `login` : publique.
* - `changer-mot-de-passe` : session requise (imposé à la 1re connexion / après reset).
* - `specs/:cle` : viewer markdown, protégé par authGuard (+ changement mdp éventuel).
* - `acces` : gestion des comptes, réservée à l'administrateur.
*/
export const routes: Routes = [
{ path: '', redirectTo: 'specs/00-sommaire', pathMatch: 'full' },
{ path: 'login', component: LoginComponent },
{ path: 'changer-mot-de-passe', component: ChangePasswordComponent, canActivate: [sessionGuard] },
{ path: 'specs', redirectTo: 'specs/00-sommaire', pathMatch: 'full' },
{
path: 'specs/:cle',
loadComponent: () =>
import('./features/specs/specs.component').then((m) => m.SpecsComponent),
canActivate: [authGuard]
},
{
path: 'acces',
loadComponent: () =>
import('./features/admin/users.component').then((m) => m.UsersComponent),
canActivate: [adminGuard]
},
{ path: '**', redirectTo: 'specs/00-sommaire' }
];
site/frontend/src/app/core/guards/auth.guard.ts
+46
View File
@@ -0,0 +1,46 @@
import { inject } from '@angular/core';
import { CanActivateFn, Router } from '@angular/router';
import { AuthService } from '../services/auth.service';
/**
* Garde de route : exige une session active ET que le mot de passe n'ait pas à être
* changé. Si un changement est imposé (première connexion / reset), redirige vers
* l'écran dédié. Sinon, renvoie vers /login.
*/
export const authGuard: CanActivateFn = (route, state) => {
const auth = inject(AuthService);
const router = inject(Router);
if (!auth.estConnecte()) {
return router.createUrlTree(['/login'], { queryParams: { retour: state.url } });
}
if (auth.doitChangerMdp()) {
return router.createUrlTree(['/changer-mot-de-passe']);
}
return true;
};
/** Garde réservée à l'administrateur. */
export const adminGuard: CanActivateFn = () => {
const auth = inject(AuthService);
const router = inject(Router);
if (!auth.estConnecte()) {
return router.createUrlTree(['/login']);
}
if (!auth.estAdmin()) {
return router.createUrlTree(['/specs/00-sommaire']);
}
return true;
};
/** Garde de l'écran de changement de mot de passe : nécessite seulement une session. */
export const sessionGuard: CanActivateFn = (route, state) => {
const auth = inject(AuthService);
const router = inject(Router);
if (!auth.estConnecte()) {
return router.createUrlTree(['/login'], { queryParams: { retour: state.url } });
}
return true;
};
site/frontend/src/app/core/interceptors/auth.interceptor.ts
+33
View File
@@ -0,0 +1,33 @@
import { HttpInterceptorFn, HttpErrorResponse } from '@angular/common/http';
import { inject } from '@angular/core';
import { Router } from '@angular/router';
import { catchError, throwError } from 'rxjs';
import { AuthService } from '../services/auth.service';
/**
* Intercepteur HTTP :
* - ajoute l'en-tête Authorization: Bearer <token> aux appels /api (hors login) ;
* - sur réponse 401, purge la session et renvoie vers /login.
*/
export const authInterceptor: HttpInterceptorFn = (req, next) => {
const auth = inject(AuthService);
const router = inject(Router);
const token = auth.obtenirToken();
const estLogin = req.url.includes('/auth/login');
const requete =
token && !estLogin
? req.clone({ setHeaders: { Authorization: `Bearer ${token}` } })
: req;
return next(requete).pipe(
catchError((err: HttpErrorResponse) => {
if (err.status === 401 && !estLogin) {
auth.seDeconnecter();
void router.navigate(['/login']);
}
return throwError(() => err);
})
);
};
site/frontend/src/app/core/services/annotation.service.ts
+99
View File
@@ -0,0 +1,99 @@
import { HttpClient } from '@angular/common/http';
import { Injectable, inject } from '@angular/core';
import { Observable } from 'rxjs';
import { environment } from '../../../environments/environment';
export type TypeAnnotation = 'ajout' | 'correction' | 'question' | 'remarque';
export type StatutAnnotation = 'ouverte' | 'traitee';
export interface Annotation {
id: string;
docCle: string;
ancre: string;
titreSection: string;
type: TypeAnnotation;
texte: string;
auteur: string;
statut: StatutAnnotation;
creeLe: string;
modifieLe: string;
}
export interface NouvelleAnnotation {
type: TypeAnnotation;
texte: string;
ancre: string;
titreSection: string;
}
export interface MajAnnotation {
texte?: string;
type?: TypeAnnotation;
statut?: StatutAnnotation;
}
/** Service d'accès aux annotations (protégé par l'authentification). */
@Injectable({ providedIn: 'root' })
export class AnnotationService {
private readonly http = inject(HttpClient);
private readonly baseUrl = `${environment.apiUrl}/annotations`;
/** Annotations d'un document. */
lister(docCle: string): Observable<Annotation[]> {
return this.http.get<Annotation[]>(`${this.baseUrl}/${docCle}`);
}
/** Crée une annotation sur un document. */
creer(docCle: string, annotation: NouvelleAnnotation): Observable<Annotation> {
return this.http.post<Annotation>(`${this.baseUrl}/${docCle}`, annotation);
}
/** Met à jour une annotation (auteur ou admin). */
mettreAJour(docCle: string, id: string, maj: MajAnnotation): Observable<Annotation> {
return this.http.put<Annotation>(`${this.baseUrl}/${docCle}/${id}`, maj);
}
/** Supprime une annotation (auteur ou admin). */
supprimer(docCle: string, id: string): Observable<void> {
return this.http.delete<void>(`${this.baseUrl}/${docCle}/${id}`);
}
/** URL d'export markdown (admin). */
urlExportMarkdown(): string {
return `${this.baseUrl}/export.md`;
}
/** URL d'export JSON (admin). */
urlExportJson(): string {
return `${this.baseUrl}/export.json`;
}
/**
* Télécharge l'export GLOBAL (toutes annotations, tous documents) via un fetch
* authentifié, puis déclenche l'enregistrement du fichier. Réservé aux admins
* côté serveur (403 sinon). Retourne false en cas d'échec.
*/
async telechargerExport(format: 'md' | 'json', token: string | null): Promise<boolean> {
const url = format === 'md' ? this.urlExportMarkdown() : this.urlExportJson();
try {
const resp = await fetch(url, {
headers: token ? { Authorization: `Bearer ${token}` } : {}
});
if (!resp.ok) {
return false;
}
const blob = await resp.blob();
const lien = document.createElement('a');
lien.href = URL.createObjectURL(blob);
lien.download = format === 'md' ? 'annotations-satpro.md' : 'annotations-satpro.json';
document.body.appendChild(lien);
lien.click();
lien.remove();
URL.revokeObjectURL(lien.href);
return true;
} catch {
return false;
}
}
}
site/frontend/src/app/core/services/auth.service.ts
+130
View File
@@ -0,0 +1,130 @@
import { HttpClient } from '@angular/common/http';
import { Injectable, computed, inject, signal } from '@angular/core';
import { Observable, tap } from 'rxjs';
import { environment } from '../../../environments/environment';
export type Role = 'admin' | 'contributeur' | 'consultation';
interface ReponseLogin {
token: string;
login: string;
role: Role;
admin: boolean;
doitChangerMdp: boolean;
}
const CLE_TOKEN = 'satpro.token';
const CLE_LOGIN = 'satpro.login';
const CLE_ADMIN = 'satpro.admin';
const CLE_ROLE = 'satpro.role';
const CLE_CHANGE = 'satpro.change';
/**
* Service d'authentification : login, logout, changement de mot de passe,
* conservation du jeton JWT + rôle (localStorage). Le jeton est injecté dans les
* requêtes /api par l'intercepteur HTTP.
*/
@Injectable({ providedIn: 'root' })
export class AuthService {
private readonly http = inject(HttpClient);
private readonly baseUrl = `${environment.apiUrl}/auth`;
private readonly _token = signal<string | null>(this.tokenInitial());
private readonly _login = signal<string | null>(localStorage.getItem(CLE_LOGIN));
private readonly _admin = signal<boolean>(localStorage.getItem(CLE_ADMIN) === '1');
private readonly _role = signal<Role>((localStorage.getItem(CLE_ROLE) as Role) || 'consultation');
private readonly _doitChangerMdp = signal<boolean>(localStorage.getItem(CLE_CHANGE) === '1');
/** Login de l'utilisateur courant (ou null). */
readonly login = this._login.asReadonly();
/** Vrai si l'utilisateur courant est administrateur. */
readonly estAdmin = this._admin.asReadonly();
/** Rôle courant. */
readonly role = this._role.asReadonly();
/** Vrai si l'utilisateur peut contribuer (annoter) : admin ou contributeur. */
readonly peutContribuer = computed(() => this._role() === 'admin' || this._role() === 'contributeur');
/** Vrai si un changement de mot de passe est requis avant d'accéder au contenu. */
readonly doitChangerMdp = this._doitChangerMdp.asReadonly();
/** Vrai si un jeton valide (non expiré) est présent. */
readonly estConnecte = computed(() => this._token() !== null);
private tokenInitial(): string | null {
const token = localStorage.getItem(CLE_TOKEN);
if (token && !AuthService.tokenExpire(token)) {
return token;
}
if (token) {
this.purger();
}
return null;
}
private purger(): void {
for (const c of [CLE_TOKEN, CLE_LOGIN, CLE_ADMIN, CLE_ROLE, CLE_CHANGE]) {
localStorage.removeItem(c);
}
}
private static tokenExpire(token: string): boolean {
try {
const payload = JSON.parse(atob(token.split('.')[1]));
if (typeof payload.exp !== 'number') {
return false;
}
return Date.now() >= payload.exp * 1000;
} catch {
return true;
}
}
/** Jeton courant (utilisé par l'intercepteur). */
obtenirToken(): string | null {
return this._token();
}
/** Authentifie l'utilisateur et mémorise le jeton + rôle. */
seConnecter(login: string, motDePasse: string): Observable<ReponseLogin> {
return this.http.post<ReponseLogin>(`${this.baseUrl}/login`, { login, motDePasse }).pipe(
tap((rep) => {
localStorage.setItem(CLE_TOKEN, rep.token);
localStorage.setItem(CLE_LOGIN, rep.login);
localStorage.setItem(CLE_ADMIN, rep.admin ? '1' : '0');
localStorage.setItem(CLE_ROLE, rep.role);
localStorage.setItem(CLE_CHANGE, rep.doitChangerMdp ? '1' : '0');
this._token.set(rep.token);
this._login.set(rep.login);
this._admin.set(!!rep.admin);
this._role.set(rep.role);
this._doitChangerMdp.set(!!rep.doitChangerMdp);
})
);
}
/** Change le mot de passe du compte courant (comptes gérés). */
changerMotDePasse(ancien: string, nouveau: string): Observable<{ ok: boolean }> {
return this.http
.post<{ ok: boolean }>(`${this.baseUrl}/change-password`, { ancien, nouveau })
.pipe(
tap(() => {
this._doitChangerMdp.set(false);
localStorage.setItem(CLE_CHANGE, '0');
})
);
}
/** Déconnecte (purge du jeton local). */
seDeconnecter(): void {
this.purger();
this._token.set(null);
this._login.set(null);
this._admin.set(false);
this._role.set('consultation');
this._doitChangerMdp.set(false);
}
}
site/frontend/src/app/core/services/spec.service.ts
+37
View File
@@ -0,0 +1,37 @@
import { HttpClient } from '@angular/common/http';
import { Injectable, inject } from '@angular/core';
import { Observable } from 'rxjs';
import { environment } from '../../../environments/environment';
export interface SpecDocument {
cle: string;
titre: string;
disponible: boolean;
}
export interface SpecContenu {
cle: string;
titre: string;
markdown: string;
}
/**
* Accès aux documents de spécification (lecture seule). Les endpoints sont protégés
* par l'authentification (l'intercepteur ajoute le jeton).
*/
@Injectable({ providedIn: 'root' })
export class SpecService {
private readonly http = inject(HttpClient);
private readonly baseUrl = `${environment.apiUrl}/specs`;
/** Liste des documents disponibles (GET /api/specs). */
lister(): Observable<SpecDocument[]> {
return this.http.get<SpecDocument[]>(this.baseUrl);
}
/** Contenu Markdown d'un document (GET /api/specs/{cle}). */
obtenir(cle: string): Observable<SpecContenu> {
return this.http.get<SpecContenu>(`${this.baseUrl}/${cle}`);
}
}
site/frontend/src/app/core/services/user.service.ts
+46
View File
@@ -0,0 +1,46 @@
import { HttpClient } from '@angular/common/http';
import { Injectable, inject } from '@angular/core';
import { Observable } from 'rxjs';
import { environment } from '../../../environments/environment';
import { Role } from './auth.service';
export type RoleGerable = 'consultation' | 'contributeur' | 'desactive';
export interface Utilisateur {
login: string;
role: RoleGerable;
doitChangerMdp: boolean;
creeLe: string;
modifieLe: string;
}
/** Gestion des comptes (réservée à l'administrateur côté backend). */
@Injectable({ providedIn: 'root' })
export class UserService {
private readonly http = inject(HttpClient);
private readonly baseUrl = `${environment.apiUrl}/users`;
lister(): Observable<Utilisateur[]> {
return this.http.get<Utilisateur[]>(this.baseUrl);
}
creer(login: string, motDePasse: string, role: RoleGerable): Observable<Utilisateur> {
return this.http.post<Utilisateur>(this.baseUrl, { login, motDePasse, role });
}
definirRole(login: string, role: RoleGerable): Observable<Utilisateur> {
return this.http.put<Utilisateur>(`${this.baseUrl}/${encodeURIComponent(login)}/role`, { role });
}
reinitialiserMotDePasse(login: string, motDePasse: string): Observable<Utilisateur> {
return this.http.post<Utilisateur>(
`${this.baseUrl}/${encodeURIComponent(login)}/reset-password`,
{ motDePasse }
);
}
supprimer(login: string): Observable<void> {
return this.http.delete<void>(`${this.baseUrl}/${encodeURIComponent(login)}`);
}
}
site/frontend/src/app/features/admin/users.component.html
+97
View File
@@ -0,0 +1,97 @@
<section class="acces" aria-label="Gestion des accès">
<header class="acces__entete">
<h1 class="acces__titre">Gestion des accès</h1>
<button type="button" class="acces__btn" (click)="recharger()">⟳ Rafraîchir</button>
</header>
<p class="acces__note">
L'administrateur se configure dans le fichier <code>.env</code> et n'apparaît pas ici.
Pour un usage entre ateliers, préférez <strong>désactiver / réactiver</strong> un accès
plutôt que le supprimer.
</p>
@if (message()) {
<p class="acces__message" role="status">{{ message() }}</p>
}
@if (erreur()) {
<p class="acces__erreur" role="alert">{{ erreur() }}</p>
}
<!-- Création d'un compte -->
<form class="acces__form" (ngSubmit)="creer()">
<h2 class="acces__sous-titre">Ajouter un accès</h2>
<div class="acces__form-grille">
<label>
<span>Login</span>
<input type="text" name="login" [ngModel]="nLogin()" (ngModelChange)="nLogin.set($event)" placeholder="prenom.nom" />
</label>
<label>
<span>Mot de passe par défaut</span>
<input type="text" name="mdp" [ngModel]="nMdp()" (ngModelChange)="nMdp.set($event)" placeholder="à communiquer à l'utilisateur" />
</label>
<label>
<span>Rôle</span>
<select name="role" [ngModel]="nRole()" (ngModelChange)="nRole.set($event)">
<option value="contributeur">Contributeur (annotations)</option>
<option value="consultation">Consultation (lecture seule)</option>
<option value="desactive">Désactivé</option>
</select>
</label>
<button type="submit" class="acces__ajouter" [disabled]="creationEnCours()">
{{ creationEnCours() ? 'Création…' : 'Ajouter' }}
</button>
</div>
<p class="acces__hint">Le compte créé devra changer son mot de passe à la première connexion.</p>
</form>
<!-- Liste des comptes -->
@if (chargement()) {
<p class="acces__info">Chargement…</p>
}
@if (!chargement()) {
<table class="acces__table">
<thead>
<tr>
<th>Login</th>
<th>Rôle</th>
<th>1re connexion</th>
<th>Actions</th>
</tr>
</thead>
<tbody>
@for (u of comptes(); track u.login) {
<tr [class.acces__ligne--desactive]="u.role === 'desactive'">
<td class="acces__login">{{ u.login }}</td>
<td>
<select
class="acces__role-select"
[ngModel]="u.role"
(ngModelChange)="changerRole(u, $event)"
[attr.aria-label]="'Rôle de ' + u.login"
>
<option value="contributeur">Contributeur</option>
<option value="consultation">Consultation</option>
<option value="desactive">Désactivé</option>
</select>
</td>
<td>
@if (u.doitChangerMdp) {
<span class="acces__badge acces__badge--attente" title="Changement de mot de passe requis à la prochaine connexion">à changer</span>
} @else {
<span class="acces__badge acces__badge--ok">OK</span>
}
</td>
<td class="acces__actions">
<button type="button" (click)="reinitialiser(u)" title="Réinitialiser le mot de passe">Réinitialiser mdp</button>
<button type="button" class="acces__suppr" (click)="supprimer(u)" title="Supprimer le compte">Supprimer</button>
</td>
</tr>
}
@if (comptes().length === 0) {
<tr><td colspan="4" class="acces__vide">Aucun compte géré pour l'instant.</td></tr>
}
</tbody>
</table>
}
</section>
site/frontend/src/app/features/admin/users.component.scss
+194
View File
@@ -0,0 +1,194 @@
.acces {
max-width: 920px;
margin: 0 auto;
padding: 1.5rem 2rem 3rem;
}
.acces__entete {
display: flex;
align-items: center;
justify-content: space-between;
}
.acces__titre {
margin: 0;
color: var(--ds-dark-green-700);
}
.acces__btn {
background: #fff;
border: 1px solid var(--ds-gray-200);
border-radius: 7px;
padding: 0.4rem 0.75rem;
cursor: pointer;
color: var(--ds-dark-green-700);
}
.acces__btn:hover {
background: var(--ds-dark-green-50);
}
.acces__note {
font-size: 0.88rem;
color: var(--ds-gray-600);
background: var(--ds-dark-green-50);
border-left: 3px solid var(--ds-dark-green-300);
padding: 0.5rem 0.8rem;
border-radius: 0 6px 6px 0;
}
.acces__message {
color: var(--ds-dark-green-700);
background: var(--ds-dark-green-50);
padding: 0.4rem 0.7rem;
border-radius: 6px;
font-size: 0.9rem;
}
.acces__erreur {
color: var(--ds-danger-500);
font-size: 0.9rem;
}
.acces__form {
border: 1px solid var(--ds-gray-200);
border-radius: 10px;
padding: 1rem 1.1rem;
margin: 1rem 0 1.5rem;
}
.acces__sous-titre {
margin: 0 0 0.75rem;
font-size: 1.05rem;
color: var(--ds-dark-green-700);
}
.acces__form-grille {
display: grid;
grid-template-columns: 1.2fr 1.2fr 1fr auto;
gap: 0.75rem;
align-items: end;
}
.acces__form-grille label {
display: flex;
flex-direction: column;
gap: 0.3rem;
font-size: 0.82rem;
}
.acces__form-grille input,
.acces__form-grille select {
padding: 0.5rem;
border: 1px solid var(--ds-gray-200);
border-radius: 7px;
font-size: 0.9rem;
font-family: inherit;
}
.acces__ajouter {
background: var(--ds-dark-green-500);
color: #fff;
border: none;
border-radius: 7px;
padding: 0.55rem 1rem;
cursor: pointer;
font-size: 0.9rem;
height: fit-content;
}
.acces__ajouter:disabled {
opacity: 0.6;
cursor: default;
}
.acces__hint {
margin: 0.6rem 0 0;
font-size: 0.78rem;
color: var(--ds-gray-500);
}
.acces__table {
width: 100%;
border-collapse: collapse;
font-size: 0.9rem;
}
.acces__table th,
.acces__table td {
border: 1px solid var(--ds-gray-200);
padding: 0.55rem 0.7rem;
text-align: left;
vertical-align: middle;
}
.acces__table th {
background: var(--ds-dark-green-50);
color: var(--ds-dark-green-700);
}
.acces__login {
font-weight: 600;
}
.acces__ligne--desactive {
opacity: 0.6;
}
.acces__role-select {
padding: 0.35rem 0.5rem;
border: 1px solid var(--ds-gray-200);
border-radius: 6px;
font-family: inherit;
}
.acces__badge {
font-size: 0.74rem;
padding: 0.1rem 0.5rem;
border-radius: 999px;
}
.acces__badge--attente {
background: var(--ds-yellow-200);
color: var(--ds-yellow-700);
}
.acces__badge--ok {
background: var(--ds-dark-green-100);
color: var(--ds-dark-green-700);
}
.acces__actions {
display: flex;
gap: 0.4rem;
flex-wrap: wrap;
}
.acces__actions button {
border: 1px solid var(--ds-gray-200);
background: #fff;
border-radius: 6px;
padding: 0.3rem 0.55rem;
cursor: pointer;
font-size: 0.8rem;
color: var(--ds-gray-800);
}
.acces__actions button:hover {
background: var(--ds-gray-50);
}
.acces__suppr {
color: var(--ds-danger-500) !important;
}
.acces__vide {
text-align: center;
color: var(--ds-gray-500);
}
@media (max-width: 760px) {
.acces__form-grille {
grid-template-columns: 1fr;
}
}
site/frontend/src/app/features/admin/users.component.ts
+144
View File
@@ -0,0 +1,144 @@
import { ChangeDetectionStrategy, Component, OnInit, inject, signal } from '@angular/core';
import { FormsModule } from '@angular/forms';
import {
UserService,
Utilisateur,
RoleGerable
} from '../../core/services/user.service';
/**
* Page « Gestion des accès » (administrateur) : liste des comptes gérés, création,
* changement de rôle (consultation / contributeur / désactivé), réinitialisation de
* mot de passe et suppression.
*/
@Component({
selector: 'app-users',
standalone: true,
imports: [FormsModule],
changeDetection: ChangeDetectionStrategy.OnPush,
templateUrl: './users.component.html',
styleUrl: './users.component.scss'
})
export class UsersComponent implements OnInit {
private readonly userService = inject(UserService);
readonly comptes = signal<Utilisateur[]>([]);
readonly chargement = signal(false);
readonly erreur = signal<string | null>(null);
readonly message = signal<string | null>(null);
// Formulaire de création
readonly nLogin = signal('');
readonly nMdp = signal('');
readonly nRole = signal<RoleGerable>('contributeur');
readonly creationEnCours = signal(false);
ngOnInit(): void {
this.recharger();
}
recharger(): void {
this.chargement.set(true);
this.erreur.set(null);
this.userService.lister().subscribe({
next: (c) => {
this.comptes.set(c);
this.chargement.set(false);
},
error: () => {
this.chargement.set(false);
this.erreur.set('Impossible de charger les comptes.');
}
});
}
private flash(msg: string): void {
this.message.set(msg);
setTimeout(() => this.message.set(null), 3500);
}
creer(): void {
this.erreur.set(null);
const login = this.nLogin().trim();
const mdp = this.nMdp();
if (!login || !mdp) {
this.erreur.set('Login et mot de passe par défaut requis.');
return;
}
this.creationEnCours.set(true);
this.userService.creer(login, mdp, this.nRole()).subscribe({
next: () => {
this.creationEnCours.set(false);
this.nLogin.set('');
this.nMdp.set('');
this.nRole.set('contributeur');
this.flash(`Compte « ${login} » créé.`);
this.recharger();
},
error: (e) => {
this.creationEnCours.set(false);
this.erreur.set(e?.error?.erreur || 'Échec de la création.');
}
});
}
changerRole(u: Utilisateur, role: RoleGerable): void {
if (role === u.role) {
return;
}
this.userService.definirRole(u.login, role).subscribe({
next: () => {
this.flash(`Rôle de « ${u.login} » : ${this.libelleRole(role)}.`);
this.recharger();
},
error: (e) => this.erreur.set(e?.error?.erreur || 'Échec du changement de rôle.')
});
}
reinitialiser(u: Utilisateur): void {
const mdp = prompt(
`Nouveau mot de passe par défaut pour « ${u.login} »\n(l'utilisateur devra le changer à sa prochaine connexion) :`
);
if (mdp === null) {
return;
}
if (mdp.length < 4) {
this.erreur.set('Le mot de passe doit faire au moins 4 caractères.');
return;
}
this.userService.reinitialiserMotDePasse(u.login, mdp).subscribe({
next: () => {
this.flash(`Mot de passe de « ${u.login} » réinitialisé.`);
this.recharger();
},
error: (e) => this.erreur.set(e?.error?.erreur || 'Échec de la réinitialisation.')
});
}
supprimer(u: Utilisateur): void {
if (!confirm(`Supprimer définitivement le compte « ${u.login} » ?\n(pour un usage entre ateliers, préférez « désactiver »)`)) {
return;
}
this.userService.supprimer(u.login).subscribe({
next: () => {
this.flash(`Compte « ${u.login} » supprimé.`);
this.recharger();
},
error: (e) => this.erreur.set(e?.error?.erreur || 'Échec de la suppression.')
});
}
libelleRole(role: RoleGerable): string {
switch (role) {
case 'consultation':
return 'Consultation (lecture seule)';
case 'contributeur':
return 'Contributeur (annotations)';
case 'desactive':
return 'Désactivé';
default:
return role;
}
}
}
site/frontend/src/app/features/auth/change-password.component.html
+53
View File
@@ -0,0 +1,53 @@
<section class="login" aria-label="Changement de mot de passe">
<form class="login__carte" (ngSubmit)="soumettre()">
<h1 class="login__titre">SatPRO</h1>
<p class="login__sous-titre">
@if (impose()) {
Première connexion : définissez votre nouveau mot de passe.
} @else {
Changer votre mot de passe
}
</p>
<label class="login__champ">
<span>Mot de passe actuel</span>
<app-password-input
name="ancien"
autocomplete="current-password"
[ngModel]="ancien()"
(ngModelChange)="ancien.set($event)"
[disabled]="enCours()"
/>
</label>
<label class="login__champ">
<span>Nouveau mot de passe</span>
<app-password-input
name="nouveau"
autocomplete="new-password"
[ngModel]="nouveau()"
(ngModelChange)="nouveau.set($event)"
[disabled]="enCours()"
/>
</label>
<label class="login__champ">
<span>Confirmer le nouveau mot de passe</span>
<app-password-input
name="confirmation"
autocomplete="new-password"
[ngModel]="confirmation()"
(ngModelChange)="confirmation.set($event)"
[disabled]="enCours()"
/>
</label>
@if (erreur()) {
<p class="login__erreur" role="alert">{{ erreur() }}</p>
}
<button type="submit" class="login__bouton" [disabled]="enCours()">
{{ enCours() ? 'Enregistrement…' : 'Changer le mot de passe' }}
</button>
</form>
</section>
site/frontend/src/app/features/auth/change-password.component.ts
+65
View File
@@ -0,0 +1,65 @@
import { ChangeDetectionStrategy, Component, inject, signal } from '@angular/core';
import { FormsModule } from '@angular/forms';
import { Router } from '@angular/router';
import { AuthService } from '../../core/services/auth.service';
import { PasswordInputComponent } from '../../shared/password-input.component';
/**
* Écran de changement de mot de passe. Imposé à la première connexion et après
* une réinitialisation par l'administrateur (flag `doitChangerMdp`).
*/
@Component({
selector: 'app-change-password',
standalone: true,
imports: [FormsModule, PasswordInputComponent],
changeDetection: ChangeDetectionStrategy.OnPush,
templateUrl: './change-password.component.html',
styleUrl: './login.component.scss'
})
export class ChangePasswordComponent {
private readonly auth = inject(AuthService);
private readonly router = inject(Router);
readonly ancien = signal('');
readonly nouveau = signal('');
readonly confirmation = signal('');
readonly erreur = signal<string | null>(null);
readonly enCours = signal(false);
/** Vrai si le changement est imposé (première connexion / reset). */
readonly impose = this.auth.doitChangerMdp;
soumettre(): void {
this.erreur.set(null);
const ancien = this.ancien();
const nouveau = this.nouveau();
if (!ancien || !nouveau) {
this.erreur.set('Renseignez l’ancien et le nouveau mot de passe.');
return;
}
if (nouveau.length < 4) {
this.erreur.set('Le nouveau mot de passe doit faire au moins 4 caractères.');
return;
}
if (nouveau !== this.confirmation()) {
this.erreur.set('La confirmation ne correspond pas.');
return;
}
if (nouveau === ancien) {
this.erreur.set('Le nouveau mot de passe doit être différent de l’ancien.');
return;
}
this.enCours.set(true);
this.auth.changerMotDePasse(ancien, nouveau).subscribe({
next: () => {
this.enCours.set(false);
void this.router.navigateByUrl('/specs/00-sommaire');
},
error: (e) => {
this.enCours.set(false);
this.erreur.set(e?.error?.erreur || 'Échec du changement de mot de passe.');
}
});
}
}
site/frontend/src/app/features/auth/login.component.html
+37
View File
@@ -0,0 +1,37 @@
<section class="login" aria-label="Connexion">
<form class="login__carte" (ngSubmit)="soumettre()">
<h1 class="login__titre">SatPRO</h1>
<p class="login__sous-titre">Specs pré-projet — accès restreint</p>
<label class="login__champ">
<span>Identifiant</span>
<input
type="text"
name="login"
autocomplete="username"
[ngModel]="login()"
(ngModelChange)="login.set($event)"
[disabled]="enCours()"
/>
</label>
<label class="login__champ">
<span>Mot de passe</span>
<app-password-input
name="motDePasse"
autocomplete="current-password"
[ngModel]="motDePasse()"
(ngModelChange)="motDePasse.set($event)"
[disabled]="enCours()"
/>
</label>
@if (erreur()) {
<p class="login__erreur" role="alert">{{ erreur() }}</p>
}
<button type="submit" class="login__bouton" [disabled]="enCours()">
{{ enCours() ? 'Connexion…' : 'Se connecter' }}
</button>
</form>
</section>
site/frontend/src/app/features/auth/login.component.scss
+80
View File
@@ -0,0 +1,80 @@
.login {
display: flex;
align-items: center;
justify-content: center;
min-height: calc(100vh - 56px);
padding: 1.5rem;
}
.login__carte {
width: 100%;
max-width: 360px;
background: #fff;
border: 1px solid var(--gris-bord);
border-radius: 12px;
padding: 2rem 1.75rem;
box-shadow: 0 4px 20px rgba(0, 0, 0, 0.06);
display: flex;
flex-direction: column;
gap: 1rem;
}
.login__titre {
margin: 0;
color: var(--dekra-vert-fonce);
text-align: center;
font-size: 2rem;
}
.login__sous-titre {
margin: 0 0 0.5rem;
text-align: center;
color: var(--gris-doux);
font-size: 0.9rem;
}
.login__champ {
display: flex;
flex-direction: column;
gap: 0.35rem;
font-size: 0.9rem;
}
.login__champ input {
padding: 0.6rem 0.7rem;
border: 1px solid var(--gris-bord);
border-radius: 8px;
font-size: 0.95rem;
}
.login__champ input:focus {
outline: none;
border-color: var(--dekra-vert);
box-shadow: 0 0 0 3px rgba(0, 122, 51, 0.15);
}
.login__erreur {
margin: 0;
color: var(--ds-danger-500);
font-size: 0.85rem;
}
.login__bouton {
margin-top: 0.25rem;
background: var(--dekra-vert);
color: #fff;
border: none;
border-radius: 8px;
padding: 0.7rem;
font-size: 0.95rem;
cursor: pointer;
}
.login__bouton:hover:not(:disabled) {
background: var(--dekra-vert-fonce);
}
.login__bouton:disabled {
opacity: 0.65;
cursor: default;
}
site/frontend/src/app/features/auth/login.component.ts
+58
View File
@@ -0,0 +1,58 @@
import { ChangeDetectionStrategy, Component, inject, signal } from '@angular/core';
import { FormsModule } from '@angular/forms';
import { ActivatedRoute, Router } from '@angular/router';
import { AuthService } from '../../core/services/auth.service';
import { PasswordInputComponent } from '../../shared/password-input.component';
/** Page de connexion : login + mot de passe, vers les comptes configurés côté backend. */
@Component({
selector: 'app-login',
standalone: true,
imports: [FormsModule, PasswordInputComponent],
changeDetection: ChangeDetectionStrategy.OnPush,
templateUrl: './login.component.html',
styleUrl: './login.component.scss'
})
export class LoginComponent {
private readonly auth = inject(AuthService);
private readonly router = inject(Router);
private readonly route = inject(ActivatedRoute);
readonly login = signal('');
readonly motDePasse = signal('');
readonly erreur = signal<string | null>(null);
readonly enCours = signal(false);
soumettre(): void {
this.erreur.set(null);
const identifiant = this.login().trim();
const mdp = this.motDePasse();
if (!identifiant || !mdp) {
this.erreur.set('Renseigne un identifiant et un mot de passe.');
return;
}
this.enCours.set(true);
this.erreur.set(null);
this.auth.seConnecter(identifiant, mdp).subscribe({
next: () => {
this.enCours.set(false);
if (this.auth.doitChangerMdp()) {
// Première connexion ou après réinitialisation : changement imposé.
void this.router.navigateByUrl('/changer-mot-de-passe');
return;
}
const retour = this.route.snapshot.queryParamMap.get('retour');
void this.router.navigateByUrl(retour || '/specs/00-sommaire');
},
error: (e) => {
this.enCours.set(false);
if (e?.status === 403) {
this.erreur.set('Ce compte est désactivé. Contactez l’administrateur.');
} else {
this.erreur.set('Identifiants invalides.');
}
}
});
}
}
site/frontend/src/app/features/specs/specs.component.html
+176
View File
@@ -0,0 +1,176 @@
<section class="specs" aria-label="Documents de spécification">
<aside class="specs__menu" aria-label="Liste des documents">
<h2 class="specs__menu-titre">Documents</h2>
<nav class="specs__liens">
@for (doc of documents(); track doc.cle) {
<a
class="specs__lien"
[routerLink]="['/specs', doc.cle]"
routerLinkActive="specs__lien--actif"
>
{{ doc.titre }}
</a>
}
</nav>
</aside>
<article class="specs__contenu">
<div class="specs__barre">
<button type="button" class="specs__btn" (click)="rafraichir()" title="Recharger la dernière version du document">
⟳ Rafraîchir
</button>
<button type="button" class="specs__btn specs__btn--annot" (click)="basculerPanneau()" title="Afficher / masquer les annotations">
💬 Annotations
@if (nbOuvertes() > 0) {
<span class="specs__badge">{{ nbOuvertes() }}</span>
}
</button>
</div>
@if (chargement()) {
<p class="specs__info">Chargement du document…</p>
}
@if (erreur()) {
<p class="specs__erreur" role="alert">{{ erreur() }}</p>
}
@if (!chargement() && !erreur() && contenuHtml()) {
<div #markdownHost class="specs__markdown markdown-body" [innerHTML]="contenuHtml()"></div>
}
</article>
<!-- Panneau latéral des annotations -->
@if (panneauOuvert()) {
<aside class="annot" aria-label="Annotations du document">
<!-- Zone haute figée : titre, export, formulaire, filtre -->
<div class="annot__haut">
<header class="annot__entete">
<h2 class="annot__titre">Annotations</h2>
<button type="button" class="annot__fermer" (click)="basculerPanneau()" title="Fermer">✕</button>
</header>
@if (!peutContribuer()) {
<p class="annot__lecture-seule">
Votre accès est en <strong>lecture seule</strong> : vous pouvez consulter les
annotations mais pas en ajouter. Contactez l'administrateur pour un accès contributeur.
</p>
}
<!-- Formulaire création / édition (contributeurs et admin uniquement) -->
@if (peutContribuer()) {
<div class="annot__form-bloc">
<button
type="button"
class="annot__form-toggle"
(click)="formReplie.set(!formReplie())"
[attr.aria-expanded]="!formReplie()"
[title]="formReplie() ? 'Déplier la saisie' : 'Replier la saisie'"
>
<span class="annot__form-chevron">{{ formReplie() ? '▸' : '▾' }}</span>
{{ editionId() ? 'Modifier l’annotation' : 'Ajouter une annotation' }}
</button>
@if (!formReplie()) {
<form class="annot__form" (ngSubmit)="soumettreForm()">
<p class="annot__form-cible">
@if (fTitreSection()) {
Section : <strong>{{ fTitreSection() }}</strong>
} @else {
Nouvelle annotation
}
@if (editionId()) { <em>(édition)</em> }
</p>
<label class="annot__champ">
<span>Type</span>
<select [ngModel]="fType()" (ngModelChange)="fType.set($event)" name="type">
<option value="remarque">Remarque</option>
<option value="ajout">Ajout</option>
<option value="correction">Correction</option>
<option value="question">Question</option>
</select>
</label>
<label class="annot__champ">
<span>Texte</span>
<textarea
rows="5"
name="texte"
[ngModel]="fTexte()"
(ngModelChange)="fTexte.set($event)"
placeholder="Votre remarque, ajout ou correction…"
></textarea>
</label>
@if (erreurForm()) {
<p class="annot__erreur" role="alert">{{ erreurForm() }}</p>
}
<div class="annot__form-actions">
<button type="submit" class="annot__valider" [disabled]="envoiEnCours()">
{{ editionId() ? 'Enregistrer' : 'Ajouter' }}
</button>
@if (editionId()) {
<button type="button" class="annot__annuler" (click)="annulerForm()">Annuler</button>
}
</div>
<p class="annot__hint">
Astuce : cliquez sur 💬 à côté d'un titre de section pour préremplir la cible.
</p>
</form>
}
</div>
}
<!-- Barre de filtre -->
<div class="annot__filtre">
<span class="annot__filtre-compte">
{{ nbOuvertes() }} ouverte(s) · {{ nbTraitees() }} traitée(s)
</span>
<label class="annot__toggle" title="Afficher ou masquer les annotations traitées">
<input
type="checkbox"
[checked]="masquerTraitees()"
(change)="masquerTraitees.set($any($event.target).checked)"
/>
Masquer les traitées
</label>
</div>
</div>
<!-- Liste des annotations du document (défile sous la zone haute) -->
<div class="annot__liste">
@if (annotations().length === 0) {
<p class="annot__vide">Aucune annotation sur ce document pour l'instant.</p>
} @else if (annotationsAffichees().length === 0) {
<p class="annot__vide">Toutes les annotations sont traitées (filtre actif).</p>
}
@for (a of annotationsAffichees(); track a.id) {
<div class="annot__item" [class.annot__item--traitee]="a.statut === 'traitee'">
<div class="annot__item-tete">
<span class="annot__type annot__type--{{ a.type }}">{{ a.type }}</span>
<span class="annot__auteur">{{ a.auteur }}</span>
@if (a.statut === 'traitee') {
<span class="annot__statut">traitée</span>
}
</div>
@if (a.titreSection) {
<div class="annot__section">↳ {{ a.titreSection }}</div>
}
<p class="annot__texte">{{ a.texte }}</p>
@if (peutModifier(a)) {
<div class="annot__actions">
<button type="button" (click)="ouvrirEdition(a)">Éditer</button>
<button type="button" (click)="basculerStatut(a)">
{{ a.statut === 'ouverte' ? 'Marquer traitée' : 'Rouvrir' }}
</button>
<button type="button" class="annot__suppr" (click)="supprimer(a)">Supprimer</button>
</div>
}
</div>
}
</div>
</aside>
}
</section>
site/frontend/src/app/features/specs/specs.component.scss
+460
View File
@@ -0,0 +1,460 @@
.specs {
display: grid;
grid-template-columns: 280px 1fr;
align-items: start;
}
/* Quand le panneau d'annotations est ouvert, 3 colonnes. */
.specs:has(.annot) {
grid-template-columns: 280px 1fr 360px;
}
.specs__menu {
background: #fff;
border-right: 1px solid var(--gris-bord);
padding: 1.25rem 0.75rem;
/* Reste visible au défilement, scroll interne si la liste est longue. */
position: sticky;
top: 0;
align-self: start;
height: calc(100vh - 56px);
overflow-y: auto;
}
.specs__menu-titre {
margin: 0 0.5rem 0.75rem;
font-size: 0.8rem;
text-transform: uppercase;
letter-spacing: 0.06em;
color: var(--gris-doux);
}
.specs__liens {
display: flex;
flex-direction: column;
gap: 0.15rem;
}
.specs__lien {
display: block;
padding: 0.5rem 0.65rem;
border-radius: 7px;
color: var(--gris-texte);
text-decoration: none;
font-size: 0.9rem;
border-left: 3px solid transparent;
}
.specs__lien:hover {
background: var(--gris-fond);
}
.specs__lien--actif {
background: #eef7f0;
border-left-color: var(--dekra-vert);
color: var(--dekra-vert-fonce);
font-weight: 600;
}
.specs__contenu {
padding: 1.5rem 2rem 3rem;
min-width: 0; /* évite le débordement horizontal des tableaux/pre larges */
}
.specs__barre {
display: flex;
justify-content: flex-end;
gap: 0.5rem;
margin-bottom: 0.75rem;
/* Reste accessible pendant la lecture (bouton Rafraîchir / Annotations). */
position: sticky;
top: 0;
z-index: 2;
padding: 0.5rem 0;
background: linear-gradient(var(--gris-fond) 70%, transparent);
}
.specs__btn {
display: inline-flex;
align-items: center;
gap: 0.4rem;
background: #fff;
border: 1px solid var(--gris-bord);
border-radius: 7px;
padding: 0.4rem 0.75rem;
font-size: 0.85rem;
cursor: pointer;
color: var(--dekra-vert-fonce);
}
.specs__btn:hover {
background: #eef7f0;
border-color: var(--dekra-vert-clair);
}
.specs__badge {
background: var(--dekra-vert);
color: #fff;
border-radius: 999px;
padding: 0 0.4rem;
font-size: 0.72rem;
line-height: 1.5;
}
.specs__info,
.specs__erreur {
font-size: 0.95rem;
}
.specs__erreur {
color: var(--ds-danger-500);
}
/* Bouton « annoter » accolé aux titres (injecté dans le HTML rendu). */
.specs__markdown :is(h2, h3, h4) .btn-annoter {
border: none;
background: transparent;
cursor: pointer;
font-size: 0.85em;
opacity: 0;
transition: opacity 0.12s ease-in-out;
padding: 0 0.25rem;
}
.specs__markdown :is(h2, h3, h4):hover .btn-annoter {
opacity: 0.65;
}
.specs__markdown .btn-annoter:hover {
opacity: 1;
}
/* ----- Panneau latéral des annotations ----- */
.annot {
background: #fff;
border-left: 1px solid var(--gris-bord);
padding: 1rem;
display: flex;
flex-direction: column;
gap: 0.75rem;
/* Suit le défilement de la page : reste visible en haut de la fenêtre. */
position: sticky;
top: 0;
align-self: start;
height: calc(100vh - 56px); /* 56px = hauteur de l'en-tête */
overflow: hidden; /* le scroll est délégué à .annot__liste */
}
/* Zone haute figée : titre, export, formulaire, filtre. Ne défile pas. */
.annot__haut {
flex: 0 0 auto;
display: flex;
flex-direction: column;
gap: 0.6rem;
padding-bottom: 0.6rem;
border-bottom: 1px solid var(--ds-gray-200);
}
.annot__entete {
display: flex;
align-items: center;
justify-content: space-between;
}
.annot__titre {
margin: 0;
font-size: 1.1rem;
color: var(--dekra-vert-fonce);
}
.annot__fermer {
border: none;
background: transparent;
cursor: pointer;
font-size: 1rem;
color: var(--gris-doux);
}
.annot__export {
display: flex;
align-items: center;
gap: 0.4rem;
font-size: 0.8rem;
color: var(--gris-doux);
flex-wrap: wrap;
}
.annot__export button {
border: 1px solid var(--gris-bord);
background: #fff;
border-radius: 6px;
padding: 0.25rem 0.5rem;
cursor: pointer;
font-size: 0.8rem;
color: var(--dekra-vert-fonce);
}
.annot__export button:hover {
background: #eef7f0;
}
.annot__form-bloc {
display: flex;
flex-direction: column;
gap: 0.4rem;
}
.annot__form-toggle {
display: flex;
align-items: center;
gap: 0.4rem;
width: 100%;
text-align: left;
background: var(--ds-dark-green-50);
border: 1px solid var(--ds-gray-200);
border-radius: 8px;
padding: 0.5rem 0.7rem;
cursor: pointer;
font-size: 0.9rem;
font-weight: 600;
color: var(--ds-dark-green-700);
}
.annot__form-toggle:hover {
background: var(--ds-dark-green-100);
}
.annot__form-chevron {
font-size: 0.8rem;
}
.annot__form {
border: 1px solid var(--gris-bord);
border-radius: 8px;
padding: 0.75rem;
background: var(--gris-fond);
display: flex;
flex-direction: column;
gap: 0.5rem;
}
.annot__form-cible {
margin: 0;
font-size: 0.82rem;
color: var(--gris-doux);
}
.annot__champ {
display: flex;
flex-direction: column;
gap: 0.25rem;
font-size: 0.82rem;
}
.annot__champ select,
.annot__champ textarea {
border: 1px solid var(--gris-bord);
border-radius: 6px;
padding: 0.4rem;
font-size: 0.88rem;
font-family: inherit;
}
.annot__champ textarea {
resize: vertical;
min-height: 11rem; /* zone de saisie 2x plus haute */
}
.annot__form-actions {
display: flex;
gap: 0.5rem;
}
.annot__valider {
background: var(--dekra-vert);
color: #fff;
border: none;
border-radius: 6px;
padding: 0.45rem 0.8rem;
cursor: pointer;
font-size: 0.85rem;
}
.annot__valider:disabled {
opacity: 0.6;
cursor: default;
}
.annot__annuler {
background: #fff;
border: 1px solid var(--gris-bord);
border-radius: 6px;
padding: 0.45rem 0.8rem;
cursor: pointer;
font-size: 0.85rem;
}
.annot__hint {
margin: 0;
font-size: 0.74rem;
color: var(--gris-doux);
}
.annot__erreur {
margin: 0;
color: var(--ds-danger-500);
font-size: 0.8rem;
}
.annot__liste {
display: flex;
flex-direction: column;
gap: 0.6rem;
/* Seule la liste défile, sous la zone haute figée. */
flex: 1 1 auto;
overflow-y: auto;
padding-top: 0.6rem;
}
.annot__filtre {
display: flex;
align-items: center;
justify-content: space-between;
gap: 0.5rem;
flex-wrap: wrap;
font-size: 0.8rem;
color: var(--ds-gray-600);
}
.annot__filtre-compte {
white-space: nowrap;
}
.annot__toggle {
display: inline-flex;
align-items: center;
gap: 0.35rem;
cursor: pointer;
user-select: none;
}
.annot__toggle input {
cursor: pointer;
}
.annot__vide {
color: var(--gris-doux);
font-size: 0.85rem;
}
.annot__lecture-seule {
font-size: 0.84rem;
color: var(--ds-gray-600);
background: var(--ds-gray-50);
border: 1px solid var(--ds-gray-200);
border-radius: 7px;
padding: 0.6rem 0.75rem;
}
.annot__item {
border: 1px solid var(--gris-bord);
border-left: 3px solid var(--dekra-vert-clair);
border-radius: 7px;
padding: 0.6rem;
}
.annot__item--traitee {
opacity: 0.6;
border-left-color: var(--gris-doux);
}
.annot__item-tete {
display: flex;
align-items: center;
gap: 0.5rem;
margin-bottom: 0.3rem;
}
.annot__type {
font-size: 0.72rem;
text-transform: uppercase;
letter-spacing: 0.04em;
padding: 0.05rem 0.4rem;
border-radius: 999px;
color: #fff;
background: var(--gris-doux);
}
.annot__type--ajout { background: var(--ds-success-500); }
.annot__type--correction { background: var(--ds-warning-400); }
.annot__type--question { background: var(--ds-info-500); }
.annot__type--remarque { background: var(--ds-dark-green-500); }
.annot__auteur {
font-size: 0.8rem;
color: var(--gris-doux);
}
.annot__statut {
margin-left: auto;
font-size: 0.72rem;
color: var(--dekra-vert-fonce);
}
.annot__section {
font-size: 0.76rem;
color: var(--gris-doux);
margin-bottom: 0.25rem;
}
.annot__texte {
margin: 0.25rem 0;
font-size: 0.88rem;
white-space: pre-wrap;
}
.annot__actions {
display: flex;
gap: 0.4rem;
flex-wrap: wrap;
margin-top: 0.4rem;
}
.annot__actions button {
border: 1px solid var(--gris-bord);
background: #fff;
border-radius: 6px;
padding: 0.25rem 0.5rem;
cursor: pointer;
font-size: 0.78rem;
color: var(--gris-texte);
}
.annot__actions button:hover {
background: var(--gris-fond);
}
.annot__suppr {
color: var(--ds-danger-500) !important;
}
@media (max-width: 980px) {
.specs,
.specs:has(.annot) {
grid-template-columns: 1fr;
}
/* En colonne unique, on désactive le sticky/hauteur plein écran. */
.specs__menu,
.annot {
position: static;
height: auto;
}
.specs__menu {
border-right: none;
border-bottom: 1px solid var(--gris-bord);
}
.annot {
border-left: none;
border-top: 1px solid var(--gris-bord);
}
}
site/frontend/src/app/features/specs/specs.component.ts
+511
View File
@@ -0,0 +1,511 @@
import {
ChangeDetectionStrategy,
ChangeDetectorRef,
Component,
ElementRef,
OnDestroy,
OnInit,
ViewChild,
computed,
inject,
signal
} from '@angular/core';
import { FormsModule } from '@angular/forms';
import { ActivatedRoute, Router, RouterLink, RouterLinkActive } from '@angular/router';
import { ViewportScroller } from '@angular/common';
import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
import { Subscription } from 'rxjs';
import { marked } from 'marked';
import DOMPurify from 'dompurify';
import { SpecDocument, SpecService } from '../../core/services/spec.service';
import { AuthService } from '../../core/services/auth.service';
import {
Annotation,
AnnotationService,
StatutAnnotation,
TypeAnnotation
} from '../../core/services/annotation.service';
/**
* `SpecsComponent` — consultation des specs (Markdown rendu en direct) + annotations.
*
* Chaque titre de section reçoit un identifiant (slug) et un bouton « 💬 » permettant
* d'annoter la section. Les annotations sont listées dans un panneau latéral droit ;
* leur création/édition/suppression passe par l'API (droits : auteur ou admin).
*/
@Component({
selector: 'app-specs',
standalone: true,
imports: [FormsModule, RouterLink, RouterLinkActive],
changeDetection: ChangeDetectionStrategy.OnPush,
templateUrl: './specs.component.html',
styleUrl: './specs.component.scss'
})
export class SpecsComponent implements OnInit, OnDestroy {
private readonly specService = inject(SpecService);
private readonly annotationService = inject(AnnotationService);
private readonly auth = inject(AuthService);
private readonly route = inject(ActivatedRoute);
private readonly router = inject(Router);
private readonly scroller = inject(ViewportScroller);
private readonly sanitizer = inject(DomSanitizer);
private readonly cdr = inject(ChangeDetectorRef);
@ViewChild('markdownHost') private markdownHost?: ElementRef<HTMLElement>;
readonly documents = signal<SpecDocument[]>([]);
readonly cleCourante = signal<string | null>(null);
readonly titreCourant = signal<string>('');
readonly contenuHtml = signal<SafeHtml | null>(null);
readonly chargement = signal(false);
readonly erreur = signal<string | null>(null);
// --- Annotations ---
readonly annotations = signal<Annotation[]>([]);
readonly panneauOuvert = signal(false);
readonly login = this.auth.login;
readonly estAdmin = this.auth.estAdmin;
/** L'utilisateur peut-il annoter (admin/contributeur) ? Sinon lecture seule. */
readonly peutContribuer = this.auth.peutContribuer;
/** Nombre d'annotations ouvertes sur le document courant (badge). */
readonly nbOuvertes = computed(
() => this.annotations().filter((a) => a.statut === 'ouverte').length
);
/** Nombre d'annotations traitées sur le document courant. */
readonly nbTraitees = computed(
() => this.annotations().filter((a) => a.statut === 'traitee').length
);
/** Filtre d'affichage : masquer les annotations traitées. */
readonly masquerTraitees = signal(false);
/** Repli du formulaire de saisie/édition (pour agrandir la liste). */
readonly formReplie = signal(false);
/** Annotations réellement affichées dans la liste, selon le filtre. */
readonly annotationsAffichees = computed(() =>
this.masquerTraitees()
? this.annotations().filter((a) => a.statut !== 'traitee')
: this.annotations()
);
// Formulaire de création/édition
readonly editionId = signal<string | null>(null); // null = création
readonly fTexte = signal('');
readonly fType = signal<TypeAnnotation>('remarque');
readonly fAncre = signal('');
readonly fTitreSection = signal('');
readonly envoiEnCours = signal(false);
readonly erreurForm = signal<string | null>(null);
private listeSub?: Subscription;
private contenuSub?: Subscription;
private paramSub?: Subscription;
private readonly souscriptions: Subscription[] = [];
private readonly markedInstance = this.creerMarked();
/**
* Gestionnaire de clic délégué sur le contenu rendu :
* - boutons « annoter » (.btn-annoter) -> ouvre le formulaire d'annotation ;
* - liens internes vers un autre document (.lien-interne) -> navigation SPA ;
* - liens d'ancre pure (#section) -> défilement vers la section.
*/
private readonly onClicContenu = (ev: Event) => {
const el = ev.target as HTMLElement;
// 1) Bouton d'annotation
const btn = el?.closest('.btn-annoter') as HTMLElement | null;
if (btn) {
ev.preventDefault();
this.ouvrirCreation(btn.getAttribute('data-ancre') || '', btn.getAttribute('data-titre') || '');
return;
}
// 2) Lien (document interne ou ancre)
const lien = el?.closest('a') as HTMLAnchorElement | null;
if (!lien) {
return;
}
// Lien interne vers un autre document de specs (réécrit par le renderer).
const cleCible = lien.getAttribute('data-cle');
if (cleCible) {
ev.preventDefault();
const fragment = lien.getAttribute('data-fragment') || undefined;
void this.router.navigate(['/specs', cleCible], { fragment });
if (fragment) {
setTimeout(() => this.scroller.scrollToAnchor(fragment), 50);
} else {
this.scroller.scrollToPosition([0, 0]);
}
return;
}
// Lien d'ancre pure (#id) dans le document courant.
const href = lien.getAttribute('href') || '';
if (href.startsWith('#')) {
ev.preventDefault();
this.scroller.scrollToAnchor(href.slice(1));
}
};
ngOnInit(): void {
this.listeSub = this.specService.lister().subscribe({
next: (docs) => {
this.documents.set(docs);
this.cdr.markForCheck();
},
error: () => {
this.erreur.set('Impossible de charger la liste des documents.');
this.cdr.markForCheck();
}
});
this.paramSub = this.route.paramMap.subscribe((params) => {
const cle = params.get('cle');
if (cle) {
this.chargerDocument(cle);
this.chargerAnnotations(cle);
}
});
}
ngOnDestroy(): void {
this.listeSub?.unsubscribe();
this.contenuSub?.unsubscribe();
this.paramSub?.unsubscribe();
this.souscriptions.forEach((s) => s.unsubscribe());
this.markdownHost?.nativeElement.removeEventListener('click', this.onClicContenu);
}
rafraichir(): void {
const cle = this.cleCourante();
if (cle) {
this.chargerDocument(cle);
this.chargerAnnotations(cle);
}
}
// ------------------------------------------------------------------ Document
private chargerDocument(cle: string): void {
this.contenuSub?.unsubscribe();
this.cleCourante.set(cle);
this.chargement.set(true);
this.erreur.set(null);
this.contenuHtml.set(null);
this.cdr.markForCheck();
this.contenuSub = this.specService.obtenir(cle).subscribe({
next: (doc) => {
this.titreCourant.set(doc.titre);
const html = this.markedInstance.parse(doc.markdown, { async: false }) as string;
const propre = DOMPurify.sanitize(html, {
ADD_ATTR: [
'class',
'id',
'data-ancre',
'data-titre',
'data-cle',
'data-fragment',
'title',
'type',
'target',
'rel'
]
});
this.contenuHtml.set(this.sanitizer.bypassSecurityTrustHtml(propre));
this.chargement.set(false);
this.cdr.markForCheck();
setTimeout(() => {
void this.rendreMermaid();
// (Ré)attache le gestionnaire de clic délégué sur le conteneur injecté.
const hote = this.markdownHost?.nativeElement;
if (hote) {
hote.removeEventListener('click', this.onClicContenu);
hote.addEventListener('click', this.onClicContenu);
}
}, 0);
},
error: () => {
this.chargement.set(false);
this.erreur.set("Ce document est introuvable ou n'a pas pu être chargé.");
this.cdr.markForCheck();
}
});
}
// --------------------------------------------------------------- Annotations
private chargerAnnotations(cle: string): void {
const sub = this.annotationService.lister(cle).subscribe({
next: (liste) => {
this.annotations.set(liste);
this.cdr.markForCheck();
},
error: () => {
// Silencieux : l'absence d'annotations ne doit pas bloquer la lecture.
this.annotations.set([]);
this.cdr.markForCheck();
}
});
this.souscriptions.push(sub);
}
basculerPanneau(): void {
this.panneauOuvert.update((v) => !v);
}
/** Annotations à afficher pour une ancre donnée (regroupées sous chaque section). */
annotationsPourAncre(ancre: string): Annotation[] {
return this.annotations().filter((a) => a.ancre === ancre);
}
/** Ouvre le formulaire en création pour une section. */
ouvrirCreation(ancre: string, titreSection: string): void {
this.editionId.set(null);
this.fTexte.set('');
this.fType.set('remarque');
this.fAncre.set(ancre);
this.fTitreSection.set(titreSection);
this.erreurForm.set(null);
this.panneauOuvert.set(true);
this.formReplie.set(false); // déplie le formulaire pour saisir
this.cdr.markForCheck();
}
/** Ouvre le formulaire en édition d'une annotation existante. */
ouvrirEdition(a: Annotation): void {
this.editionId.set(a.id);
this.fTexte.set(a.texte);
this.fType.set(a.type);
this.fAncre.set(a.ancre);
this.fTitreSection.set(a.titreSection);
this.erreurForm.set(null);
this.panneauOuvert.set(true);
this.formReplie.set(false); // déplie le formulaire pour éditer
this.cdr.markForCheck();
}
annulerForm(): void {
this.editionId.set(null);
this.fTexte.set('');
this.erreurForm.set(null);
}
/** Droit de modifier/supprimer : admin, ou auteur ayant un accès contributeur. */
peutModifier(a: Annotation): boolean {
if (this.estAdmin()) {
return true;
}
return this.peutContribuer() && a.auteur === this.login();
}
soumettreForm(): void {
const cle = this.cleCourante();
if (!cle) {
return;
}
const texte = this.fTexte().trim();
if (!texte) {
this.erreurForm.set('Le texte est requis.');
return;
}
this.envoiEnCours.set(true);
this.erreurForm.set(null);
const id = this.editionId();
if (id) {
// Édition
const sub = this.annotationService
.mettreAJour(cle, id, { texte, type: this.fType() })
.subscribe({
next: (maj) => {
this.annotations.update((l) => l.map((a) => (a.id === maj.id ? maj : a)));
this.envoiEnCours.set(false);
this.annulerForm();
this.cdr.markForCheck();
},
error: () => {
this.envoiEnCours.set(false);
this.erreurForm.set("Échec de l'enregistrement.");
this.cdr.markForCheck();
}
});
this.souscriptions.push(sub);
} else {
// Création
const sub = this.annotationService
.creer(cle, {
texte,
type: this.fType(),
ancre: this.fAncre(),
titreSection: this.fTitreSection()
})
.subscribe({
next: (creee) => {
this.annotations.update((l) => [...l, creee]);
this.envoiEnCours.set(false);
this.annulerForm();
this.cdr.markForCheck();
},
error: () => {
this.envoiEnCours.set(false);
this.erreurForm.set("Échec de l'enregistrement.");
this.cdr.markForCheck();
}
});
this.souscriptions.push(sub);
}
}
basculerStatut(a: Annotation): void {
const cle = this.cleCourante();
if (!cle) {
return;
}
const nouveau: StatutAnnotation = a.statut === 'ouverte' ? 'traitee' : 'ouverte';
const sub = this.annotationService.mettreAJour(cle, a.id, { statut: nouveau }).subscribe({
next: (maj) => {
this.annotations.update((l) => l.map((x) => (x.id === maj.id ? maj : x)));
this.cdr.markForCheck();
},
error: () => this.cdr.markForCheck()
});
this.souscriptions.push(sub);
}
supprimer(a: Annotation): void {
const cle = this.cleCourante();
if (!cle) {
return;
}
const sub = this.annotationService.supprimer(cle, a.id).subscribe({
next: () => {
this.annotations.update((l) => l.filter((x) => x.id !== a.id));
this.cdr.markForCheck();
},
error: () => this.cdr.markForCheck()
});
this.souscriptions.push(sub);
}
// L'export des annotations est désormais accessible uniquement depuis l'en-tête du
// site (composant racine), pour l'administrateur. Il a donc été retiré de ce panneau.
// ------------------------------------------------------------------- Mermaid
private async rendreMermaid(): Promise<void> {
const hote = this.markdownHost?.nativeElement;
if (!hote) {
return;
}
const blocs = hote.querySelectorAll<HTMLElement>('pre.mermaid');
if (blocs.length === 0) {
return;
}
try {
const mermaid = (await import('mermaid')).default;
mermaid.initialize({ startOnLoad: false, theme: 'default', securityLevel: 'loose' });
await mermaid.run({ nodes: Array.from(blocs) });
} catch {
// Repli : le bloc de code brut reste visible si le rendu échoue.
}
}
// -------------------------------------------------------------------- marked
private creerMarked(): typeof marked {
const slugs = this.compteurSlugs();
// Lu à chaque rendu : masque le bouton « annoter » pour les comptes en lecture seule.
const peutContribuer = () => this.peutContribuer();
marked.use({
renderer: {
code(this: unknown, { text, lang }: { text: string; lang?: string }): string {
if ((lang ?? '').trim().toLowerCase() === 'mermaid') {
return `<pre class="mermaid">${SpecsComponent.echapper(text)}</pre>`;
}
const langue = (lang ?? '').trim();
const classe = langue ? ` class="language-${SpecsComponent.echapper(langue)}"` : '';
return `<pre><code${classe}>${SpecsComponent.echapper(text)}</code></pre>`;
},
link({ href, title, text }: { href: string; title?: string | null; text: string }): string {
// `text` est le libellé déjà rendu (HTML inline) du lien.
const texte = text;
const t = title ? ` title="${SpecsComponent.echapper(title)}"` : '';
// Lien interne vers un autre document de specs : "06-prestations.md" ou
// "06-prestations.md#4-1" ou "./06-prestations.md". On réécrit en route SPA.
const interne = /^(?:\.\/)?([a-z0-9][a-z0-9-]*)\.md(?:#([^)]*))?$/i.exec(href || '');
if (interne) {
const cle = interne[1];
const fragment = interne[2] || '';
const dataFragment = fragment ? ` data-fragment="${SpecsComponent.echapper(fragment)}"` : '';
return `<a href="/specs/${SpecsComponent.echapper(cle)}" class="lien-interne" data-cle="${SpecsComponent.echapper(
cle
)}"${dataFragment}${t}>${texte}</a>`;
}
// Lien externe : ouvre dans un nouvel onglet, sécurisé.
const estExterne = /^https?:\/\//i.test(href || '');
const rel = estExterne ? ' target="_blank" rel="noopener noreferrer"' : '';
return `<a href="${SpecsComponent.echapper(href || '#')}"${t}${rel}>${texte}</a>`;
},
heading({ text, depth, tokens }: { text: string; depth: number; tokens?: unknown }): string {
// `text` peut contenir du HTML inline déjà rendu ; on dérive un libellé propre.
const brut = SpecsComponent.texteBrut(text);
const ancre = slugs(brut);
// Bouton d'annotation : pas sur le H1 (titre du document), et seulement si
// l'utilisateur peut contribuer (masqué en lecture seule).
const bouton =
depth === 1 || !peutContribuer()
? ''
: ` <button type="button" class="btn-annoter" data-ancre="${SpecsComponent.echapper(
ancre
)}" data-titre="${SpecsComponent.echapper(brut)}" title="Annoter cette section">💬</button>`;
return `<h${depth} id="${SpecsComponent.echapper(ancre)}">${text}${bouton}</h${depth}>`;
}
}
});
return marked;
}
/** Fabrique un générateur de slugs uniques (gère les doublons par suffixe -n). */
private compteurSlugs(): (texte: string) => string {
const vus = new Map<string, number>();
return (texte: string) => {
const base =
texte
.toLowerCase()
.normalize('NFD')
.replace(/[\u0300-\u036f]/g, '') // accents
.replace(/[^a-z0-9]+/g, '-')
.replace(/^-+|-+$/g, '') || 'section';
const n = vus.get(base) ?? 0;
vus.set(base, n + 1);
return n === 0 ? base : `${base}-${n}`;
};
}
private static texteBrut(html: string): string {
return html
.replace(/<[^>]+>/g, '')
.replace(/&amp;/g, '&')
.replace(/&lt;/g, '<')
.replace(/&gt;/g, '>')
.replace(/&quot;/g, '"')
.trim();
}
private static echapper(valeur: string): string {
return valeur
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;');
}
}
site/frontend/src/app/shared/password-input.component.ts
+123
View File
@@ -0,0 +1,123 @@
import { ChangeDetectionStrategy, Component, Input, forwardRef, signal } from '@angular/core';
import { ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms';
/**
* Champ de saisie de mot de passe avec bouton afficher/masquer (œil).
* Implémente ControlValueAccessor pour être utilisable avec [(ngModel)].
*
* Usage :
* <app-password-input name="mdp" autocomplete="current-password"
* [(ngModel)]="motDePasse" [disabled]="enCours()" />
*/
@Component({
selector: 'app-password-input',
standalone: true,
changeDetection: ChangeDetectionStrategy.OnPush,
providers: [
{
provide: NG_VALUE_ACCESSOR,
useExisting: forwardRef(() => PasswordInputComponent),
multi: true
}
],
template: `
<div class="mdp-champ">
<input
[type]="visible() ? 'text' : 'password'"
[attr.name]="name"
[attr.autocomplete]="autocomplete"
[value]="valeur()"
[disabled]="desactive()"
(input)="surSaisie($event)"
(blur)="onTouched()"
/>
<button
type="button"
class="mdp-oeil"
(click)="basculer()"
[attr.aria-label]="visible() ? 'Masquer le mot de passe' : 'Afficher le mot de passe'"
[attr.aria-pressed]="visible()"
[title]="visible() ? 'Masquer' : 'Afficher'"
[disabled]="desactive()"
>
{{ visible() ? '🙈' : '👁' }}
</button>
</div>
`,
styles: [
`
.mdp-champ {
position: relative;
display: flex;
align-items: center;
}
.mdp-champ input {
flex: 1;
width: 100%;
padding: 0.6rem 2.4rem 0.6rem 0.7rem;
border: 1px solid var(--ds-gray-200);
border-radius: 8px;
font-size: 0.95rem;
font-family: inherit;
}
.mdp-champ input:focus {
outline: none;
border-color: var(--ds-dark-green-500);
box-shadow: 0 0 0 3px rgba(0, 107, 82, 0.15);
}
.mdp-oeil {
position: absolute;
right: 0.3rem;
border: none;
background: transparent;
cursor: pointer;
font-size: 1rem;
line-height: 1;
padding: 0.3rem;
border-radius: 6px;
}
.mdp-oeil:hover:not(:disabled) {
background: var(--ds-gray-100);
}
.mdp-oeil:disabled {
cursor: default;
opacity: 0.5;
}
`
]
})
export class PasswordInputComponent implements ControlValueAccessor {
@Input() name = '';
@Input() autocomplete = 'current-password';
readonly valeur = signal('');
readonly visible = signal(false);
readonly desactive = signal(false);
private onChange: (v: string) => void = () => {};
onTouched: () => void = () => {};
basculer(): void {
this.visible.update((v) => !v);
}
surSaisie(ev: Event): void {
const v = (ev.target as HTMLInputElement).value;
this.valeur.set(v);
this.onChange(v);
}
// --- ControlValueAccessor ---
writeValue(v: string | null): void {
this.valeur.set(v ?? '');
}
registerOnChange(fn: (v: string) => void): void {
this.onChange = fn;
}
registerOnTouched(fn: () => void): void {
this.onTouched = fn;
}
setDisabledState(estDesactive: boolean): void {
this.desactive.set(estDesactive);
}
}
site/frontend/src/environments/environment.prod.ts
+6
View File
@@ -0,0 +1,6 @@
// Environnement de production : le front est servi par nginx, qui proxifie /api
// vers le backend sur la même origine. L'URL d'API est donc relative.
export const environment = {
production: true,
apiUrl: '/api'
};
site/frontend/src/environments/environment.ts
+5
View File
@@ -0,0 +1,5 @@
// Environnement de développement : le front (ng serve, :4200) adresse le backend Node (:8080).
export const environment = {
production: false,
apiUrl: 'http://localhost:8080/api'
};
site/frontend/src/index.html
+15
View File
@@ -0,0 +1,15 @@
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8" />
<title>SatPRO — Specs pré-projet</title>
<base href="/" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<!-- Non indexable : combiné au robots.txt et à l'en-tête X-Robots-Tag (nginx). -->
<meta name="robots" content="noindex, nofollow, noarchive, nosnippet" />
<link rel="icon" href="favicon.ico" />
</head>
<body>
<app-root></app-root>
</body>
</html>
site/frontend/src/main.ts
+6
View File
@@ -0,0 +1,6 @@
import { bootstrapApplication } from '@angular/platform-browser';
import { AppComponent } from './app/app.component';
import { appConfig } from './app/app.config';
bootstrapApplication(AppComponent, appConfig).catch((err) => console.error(err));
site/frontend/src/styles.scss
+216
View File
@@ -0,0 +1,216 @@
/* =====================================================================
Thème global — Design system KiwUI (DEKRA)
Référence : docs/design-system-kiwui.md — tokens extraits de Figma.
IMPORTANT : ne pas coder de couleur en dur ; utiliser les tokens --ds-*.
===================================================================== */
@import url('https://fonts.googleapis.com/css2?family=Noto+Sans:wght@400;500;600;700&display=swap');
:root {
/* --- Vert logo (identité) --- */
--ds-logo-green-500: #008143;
/* --- Dark green (primaire d'interface) --- */
--ds-dark-green-50: #f2f8f6;
--ds-dark-green-100: #cce1dc;
--ds-dark-green-200: #b3d3cb;
--ds-dark-green-300: #80b5a9;
--ds-dark-green-400: #4d9786;
--ds-dark-green-500: #006b52;
--ds-dark-green-600: #01604a;
--ds-dark-green-700: #015642;
--ds-dark-green-800: #014031;
--ds-dark-green-900: #002019;
/* --- Bright green (accent) --- */
--ds-bright-green-300: #9ee46c;
--ds-bright-green-400: #7bb154;
--ds-bright-green-500: #527638;
/* --- Jaune (secondaire) --- */
--ds-yellow-100: #ffe066;
--ds-yellow-200: #ffcc00;
--ds-yellow-700: #594700;
/* --- Gris (neutres) --- */
--ds-gray-50: #f8f8f8;
--ds-gray-100: #ededed;
--ds-gray-200: #d2d2d2;
--ds-gray-300: #b4b4b4;
--ds-gray-400: #9d9d9d;
--ds-gray-500: #696969;
--ds-gray-600: #595959;
--ds-gray-700: #444444;
--ds-gray-800: #353535;
--ds-gray-1000: #1e1e1e;
--ds-neutral-50: #fafafa;
--ds-white: #ffffff;
/* --- Sémantiques --- */
--ds-success-400: #64b32c;
--ds-success-500: #467d1f;
--ds-success-700: #2b4d13;
--ds-info-500: #4d6d88;
--ds-info-800: #002e55;
--ds-warning-400: #ef7d02;
--ds-warning-700: #733c00;
--ds-danger-400: #e36666;
--ds-danger-500: #d10000;
--ds-danger-700: #9d0000;
/* --- Rôles sémantiques --- */
--ds-text-primary: #1e1e1e;
--ds-text-on-primary: #ffffff;
--ds-text-btn-secondary-neutral: #006b52;
--ds-surface-primary: #ffffff;
--ds-surface-secondary-bold: #006b52;
--ds-border-primary: #696969;
--ds-border-secondary: #d2d2d2;
/* --- Effets --- */
--ds-shadow-soft: #1e1e1e26;
--ds-shadow-card: 0 0 10px 0 var(--ds-shadow-soft);
/* --- Typographie --- */
--ds-font-family: 'Noto Sans', 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
/* =====================================================================
Alias de compatibilité : les variables historiques du site pointent
désormais vers les tokens KiwUI (re-thématise tout le site sans
réécrire chaque composant).
===================================================================== */
--dekra-vert: var(--ds-dark-green-500);
--dekra-vert-clair: var(--ds-bright-green-400);
--dekra-vert-fonce: var(--ds-dark-green-700);
--gris-fond: var(--ds-gray-50);
--gris-bord: var(--ds-gray-200);
--gris-texte: var(--ds-text-primary);
--gris-doux: var(--ds-gray-500);
}
* {
box-sizing: border-box;
}
html,
body {
margin: 0;
padding: 0;
height: 100%;
}
body {
font-family: var(--ds-font-family);
color: var(--ds-text-primary);
background: var(--ds-gray-50);
line-height: 1.55;
}
/* ----- Rendu du Markdown ----- */
.markdown-body {
font-size: 15px;
color: var(--ds-text-primary);
}
.markdown-body h1,
.markdown-body h2,
.markdown-body h3,
.markdown-body h4 {
color: var(--ds-dark-green-700);
line-height: 1.25;
margin-top: 1.6em;
margin-bottom: 0.6em;
}
.markdown-body h1 {
font-size: 1.9rem;
border-bottom: 2px solid var(--ds-dark-green-500);
padding-bottom: 0.3em;
margin-top: 0;
}
.markdown-body h2 {
font-size: 1.45rem;
border-bottom: 1px solid var(--ds-gray-200);
padding-bottom: 0.25em;
}
.markdown-body h3 {
font-size: 1.2rem;
}
.markdown-body p,
.markdown-body ul,
.markdown-body ol {
margin: 0.6em 0;
}
.markdown-body a {
color: var(--ds-dark-green-500);
text-decoration: none;
}
.markdown-body a:hover {
text-decoration: underline;
}
.markdown-body code {
background: var(--ds-gray-100);
border-radius: 4px;
padding: 0.1em 0.35em;
font-family: 'Fira Code', Consolas, monospace;
font-size: 0.9em;
}
.markdown-body pre {
background: var(--ds-dark-green-900);
color: #e6e9ef;
padding: 1em;
border-radius: 8px;
overflow-x: auto;
}
.markdown-body pre code {
background: transparent;
color: inherit;
padding: 0;
}
.markdown-body pre.mermaid {
background: var(--ds-white);
border: 1px solid var(--ds-gray-200);
color: inherit;
text-align: center;
}
.markdown-body blockquote {
margin: 0.8em 0;
padding: 0.4em 1em;
border-left: 4px solid var(--ds-bright-green-400);
background: var(--ds-dark-green-50);
color: var(--ds-gray-600);
}
.markdown-body table {
border-collapse: collapse;
width: 100%;
margin: 1em 0;
font-size: 0.92em;
}
.markdown-body th,
.markdown-body td {
border: 1px solid var(--ds-gray-200);
padding: 0.5em 0.7em;
text-align: left;
vertical-align: top;
}
.markdown-body th {
background: var(--ds-dark-green-50);
color: var(--ds-dark-green-700);
}
.markdown-body tr:nth-child(even) td {
background: var(--ds-gray-50);
}
site/frontend/tsconfig.app.json
+9
View File
@@ -0,0 +1,9 @@
{
"extends": "./tsconfig.json",
"compilerOptions": {
"outDir": "./out-tsc/app",
"types": []
},
"files": ["src/main.ts"],
"include": ["src/**/*.d.ts"]
}
site/frontend/tsconfig.json
+26
View File
@@ -0,0 +1,26 @@
{
"compileOnSave": false,
"compilerOptions": {
"outDir": "./dist/out-tsc",
"strict": true,
"noImplicitOverride": true,
"noPropertyAccessFromIndexSignature": true,
"noImplicitReturns": true,
"noFallthroughCasesInSwitch": true,
"skipLibCheck": true,
"esModuleInterop": true,
"sourceMap": true,
"declaration": false,
"experimentalDecorators": true,
"moduleResolution": "bundler",
"importHelpers": true,
"target": "ES2022",
"module": "ES2022"
},
"angularCompilerOptions": {
"enableI18nLegacyMessageIdFormat": false,
"strictInjectionParameters": true,
"strictInputAccessModifiers": true,
"strictTemplates": true
}
}
site/run-dev.sh
Executable
+142
View File
@@ -0,0 +1,142 @@
#!/usr/bin/env bash
# Lance en mode développement le backend Node (port 8080) et le frontend Angular
# (port 4200), qui lit les specs directement dans ../docs/specs-pre-projet.
# À utiliser hors Docker, pour le développement / la préparation d'atelier en local.
#
# Usage : ./run-dev.sh
# Arrêt : Ctrl+C (les deux processus sont arrêtés ensemble).
set -uo pipefail
RACINE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# --- Lecture facultative du .env (comptes + secret JWT) ---------------------
# On lit JWT_SECRET et AUTH_USERS depuis .env s'ils existent, sans l'exporter en bloc
# (le .env peut contenir des commentaires). Variables déjà présentes dans
# l'environnement prioritaires.
lire_env() {
local cle="$1"
[[ -f "$RACINE/.env" ]] || return 0
grep -E "^${cle}=" "$RACINE/.env" | head -n1 | cut -d= -f2- || true
}
# --- Secret JWT -------------------------------------------------------------
# Priorité : variable d'environnement > .env > secret de dev aléatoire.
# Un placeholder copié tel quel depuis .env.example est ignoré.
if [[ -z "${JWT_SECRET:-}" ]]; then
JWT_FROM_ENV="$(lire_env JWT_SECRET)"
PLACEHOLDER="change-me-generer-une-longue-chaine-aleatoire-de-32-caracteres-min"
if [[ -n "$JWT_FROM_ENV" && "$JWT_FROM_ENV" != "$PLACEHOLDER" ]]; then
export JWT_SECRET="$JWT_FROM_ENV"
echo "→ Secret JWT chargé depuis .env."
else
if command -v openssl >/dev/null 2>&1; then
export JWT_SECRET="$(openssl rand -base64 48)"
else
export JWT_SECRET="$(head -c 48 /dev/urandom | base64)"
fi
echo "⚠ Aucun secret JWT exploitable dans .env : secret de dev aléatoire généré"
echo " (les sessions sont invalidées à chaque relance du script)."
fi
fi
# --- Compte administrateur --------------------------------------------------
# Priorité : variable d'environnement > .env > défaut dev (admin/admin).
if [[ -z "${ADMIN_USER:-}" ]]; then
ADMIN_USER_ENV="$(lire_env ADMIN_USER)"
export ADMIN_USER="${ADMIN_USER_ENV:-admin}"
fi
if [[ -z "${ADMIN_PASSWORD:-}" ]]; then
ADMIN_PWD_ENV="$(lire_env ADMIN_PASSWORD)"
export ADMIN_PASSWORD="${ADMIN_PWD_ENV:-admin}"
fi
echo "→ Administrateur : ${ADMIN_USER}."
# Amorçage des comptes initiaux (facultatif, repris du .env).
if [[ -z "${SEED_USERS:-}" ]]; then
SEED_ENV="$(lire_env SEED_USERS)"
[[ -n "$SEED_ENV" ]] && export SEED_USERS="$SEED_ENV"
fi
# Dossier des specs lues en direct (chemin absolu pour être indépendant du cwd).
export SPECS_DIR="${SPECS_DIR:-$RACINE/../docs/specs-pre-projet}"
# Dossier d'écriture des annotations en dev local.
export ANNOTATIONS_DIR="${ANNOTATIONS_DIR:-$RACINE/annotations}"
# Dossier d'écriture des comptes gérés en dev local.
export USERS_DIR="${USERS_DIR:-$RACINE/users}"
export PORT="${PORT:-8080}"
# --- Backend (Node) ---------------------------------------------------------
if [[ ! -d "$RACINE/backend/node_modules" ]]; then
echo "→ Installation des dépendances backend (npm install)…"
( cd "$RACINE/backend" && npm install --no-audit --no-fund )
fi
echo "→ Démarrage du backend sur http://localhost:${PORT} (specs : $SPECS_DIR)"
( cd "$RACINE/backend" && node src/server.js ) &
PID_BACK=$!
# --- Frontend (Angular) -----------------------------------------------------
if [[ ! -d "$RACINE/frontend/node_modules" ]]; then
echo "→ Installation des dépendances frontend (npm install)…"
( cd "$RACINE/frontend" && npm install --no-audit --no-fund )
fi
echo "→ Nettoyage du cache Angular (.angular/cache)"
rm -rf "$RACINE/frontend/.angular/cache"
echo "→ Démarrage du frontend sur http://localhost:4200 (première compilation : patiente…)"
( cd "$RACINE/frontend" && npm start ) &
PID_FRONT=$!
# --- Arrêt propre des deux processus ----------------------------------------
cleanup() {
echo ""
echo "→ Arrêt…"
kill "$PID_BACK" "$PID_FRONT" 2>/dev/null || true
}
trap cleanup EXIT INT TERM
# --- Attente active : ng serve prêt à répondre en HTTP 200 ------------------
attendre_frontend() {
local url="http://localhost:4200/"
local max=120 # secondes
local t=0
printf "→ Compilation du frontend"
while [ "$t" -lt "$max" ]; do
if ! kill -0 "$PID_FRONT" 2>/dev/null; then
echo ""
echo "✗ Le frontend s'est arrêté avant d'être prêt (voir les logs ci-dessus)."
return 1
fi
local code
code=$(curl -s -o /dev/null -w "%{http_code}" "$url" 2>/dev/null || echo 000)
if [ "$code" = "200" ]; then
echo " prêt."
return 0
fi
printf "."
sleep 2
t=$((t + 2))
done
echo ""
echo "✗ Le frontend n'a pas répondu 200 au bout de ${max}s. Vérifie les logs ng serve."
return 1
}
if attendre_frontend; then
echo ""
echo "======================================================================"
echo " Site des specs SatPRO prêt."
echo " Backend : http://localhost:${PORT}/api"
echo " Frontend : http://localhost:4200 ← ouvre cette URL maintenant"
echo ""
echo " Admin : ${ADMIN_USER} (gère les accès via « Gestion des accès »)."
echo " Autres comptes : amorcés au 1er démarrage puis gérés dans l'application."
echo " Les specs sont lues en direct dans : $SPECS_DIR"
echo " Comptes gérés : $USERS_DIR/users.json"
echo " Après édition d'un .md, clique « Rafraîchir » dans la page."
echo "======================================================================"
echo ""
fi
wait
site/users/.gitkeep
+3
View File
@@ -0,0 +1,3 @@
# Ce dossier reçoit users.json (comptes gérés via le site, mots de passe hachés bcrypt),
# écrit par le backend à l'exécution. Le .json n'est pas versionné (voir ../.gitignore) ;
# ce .gitkeep garantit que le dossier existe (point de montage du volume Docker en RW).