Files
sasedev-knowledge/Web/knowledge-template-lab/README.md
2026-09-28 09:50:20 +02:00

53 lines
1.7 KiB
Markdown

<!-- file: Web/knowledge-template-lab/README.md -->
<!-- version: 2 -->
# 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. À partir d'`alpha.5`, `knowledge-web-lib` résout effectivement les fichiers hashés depuis ce manifest plutôt que coder leurs noms. En développement, la même bibliothèque peut cibler un origin Vite configuré et charger `@vite/client` puis `src/main.ts`.
## 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.