0.0.1-alpha.4

Web/knowledge-template-lab/README.md

@@ -0,0 +1,52 @@
+<!-- file: Web/knowledge-template-lab/README.md -->
+<!-- version: 1 -->
+
+# Knowledge template lab
+
+Ce package Web est un laboratoire de référence commun aux façades PGR, HOWTOs et snippets.
+
+Il possède :
+
+- les templates HTML statiques utilisés pour concevoir et valider le markup ;
+- les interactions TypeScript nécessaires aux références statiques ;
+- la chaîne Sass/Bootstrap ;
+- le build Vite et son manifest d'assets.
+
+Il ne constitue ni une quatrième application produit, ni le renderer de production.
+
+Le HTML runtime sera adapté en Maud dans les applications Actix Web. Les classes, attributs, composants visuels et clés d'assets validés ici constituent la référence à préserver lors de cette adaptation.
+
+## Toolchain
+
+Le package utilise npm avec `package-lock.json` versionné.
+
+Scripts :
+
+```text
+npm run typecheck
+npm run dev
+npm run build
+npm run preview
+```
+
+`typecheck` reste indépendant du build Vite.
+
+Le cache et les outputs Vite sont placés hors du dépôt sous `../builds/sasedev-knowledge/`.
+
+## Manifest
+
+Le build de production active le manifest Vite.
+
+L'entrée stable de départ est :
+
+```text
+src/main.ts
+```
+
+Cette entrée importe également la chaîne Sass. L'intégration Maud prévue en `alpha.5` devra résoudre les fichiers hashés depuis le manifest plutôt que coder leurs noms.
+
+## Routes et administration
+
+Ce laboratoire ne fixe aucune route runtime.
+
+Les chemins `/admin`, `/login`, `/adminapi` ou autres restent hors de son contrat. Ils appartiendront aux applications Actix lorsque le routage et l'autorisation seront matérialisés.