@indos/bibliotheque 2.0.0 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +22 -0
- package/README.md +7 -1
- package/bin/bibliotheque.d.ts +1 -0
- package/bin/bibliotheque.js +62 -0
- package/modeles/app-du-client/.dockerignore +3 -0
- package/modeles/app-du-client/DOCUMENTATION.md +27 -0
- package/modeles/app-du-client/Dockerfile +36 -0
- package/modeles/app-du-client/README.md +53 -0
- package/modeles/app-du-client/USAGE.md +3 -0
- package/modeles/app-du-client/espace/ecrans/entrees.tsx +57 -0
- package/modeles/app-du-client/espace/index.html +9 -0
- package/modeles/app-du-client/espace/page.tsx +6 -0
- package/modeles/app-du-client/espace/requetes/entrees.ts +16 -0
- package/modeles/app-du-client/espace/routes.ts +12 -0
- package/modeles/app-du-client/espace/tsconfig.json +7 -0
- package/modeles/app-du-client/gitignore +2 -0
- package/modeles/app-du-client/logo.svg +1 -0
- package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +10 -0
- package/modeles/app-du-client/module.json +12 -0
- package/modeles/app-du-client/package.json +17 -0
- package/modeles/app-du-client/src/demarrer.ts +17 -0
- package/modeles/app-du-client/src/outils.ts +48 -0
- package/modeles/app-du-client/src/serveur.ts +46 -0
- package/modeles/app-du-client/tests/espace/entrees.test.tsx +57 -0
- package/modeles/app-du-client/tests/serveur.test.ts +119 -0
- package/modeles/app-du-client/tests/sources-de-la-page.test.ts +23 -0
- package/modeles/app-du-client/tsconfig.json +22 -0
- package/package.json +3 -2
- package/src/direct.d.ts +1 -1
- package/src/direct.js +60 -8
- package/src/espace/cadre.d.ts +1 -0
- package/src/espace/chose-seule.d.ts +13 -0
- package/src/espace/chose-seule.js +43 -0
- package/src/espace/choses.d.ts +17 -5
- package/src/espace/choses.js +19 -6
- package/src/espace/ecran-d-une-chose.js +5 -3
- package/src/espace/index.d.ts +2 -1
- package/src/espace/index.js +2 -1
- package/src/espace/menu-d-une-chose.d.ts +2 -1
- package/src/espace/menu-d-une-chose.js +4 -3
- package/src/espace/panneau-du-partage.js +22 -7
- package/src/espace/routes-des-choses.js +13 -5
- package/src/page.d.ts +1 -0
- package/src/page.js +12 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,28 @@
|
|
|
2
2
|
|
|
3
3
|
Écrit pour le développeur d'une app du client, qui monte la version de la bibliothèque dans son dépôt : une section par version publiée sur npm. Une version qui demande un geste dans l'app a sa rubrique « Ruptures » : le geste, les versions exactes de React, Vite et TanStack à reprendre, et le core que demande la majeure.
|
|
4
4
|
|
|
5
|
+
## 2.2.0
|
|
6
|
+
|
|
7
|
+
Le modèle d'une app dans le paquet, ses tests dans sa construction.
|
|
8
|
+
|
|
9
|
+
- `npx @indos/bibliotheque creer-une-app <nom> [<dossier>]` crée une app dans un dossier neuf, `./<nom>` par défaut : le modèle que porte le paquet, `nom` posé dans `module.json` et dans les liens de `DOCUMENTATION.md`, `@indos/bibliotheque` cité à la version du paquet. Le dossier peut être la racine d'un dépôt ou un dossier du dépôt des apps (`apps/<nom>`). La commande refuse un dossier qui existe et un nom qui n'est pas en minuscules, chiffres et tirets, une lettre d'abord. La suite, dans le dossier : `npm install`, puis `npm test`.
|
|
10
|
+
- Le `Dockerfile` du modèle lance les tests de l'app pendant la construction : une étape, à la plateforme du poste, installe tout et lance `npm test`, qui construit la page, et l'image, à la plateforme demandée (`--platform`), prend la page de cette étape. Un test qui échoue arrête `docker build`, et le journal le nomme. L'image se construit depuis le dossier de l'app, sur le poste : le modèle n'a plus de workflow de CI.
|
|
11
|
+
|
|
12
|
+
Pour monter : `"@indos/bibliotheque": "2.2.0"` dans ses `dependencies`, puis `npm install` et `npm test`. Pour que ses tests arrêtent la construction de son image, une app créée avant reprend le `Dockerfile` du modèle (`node_modules/@indos/bibliotheque/modeles/app-du-client/Dockerfile`), et peut retirer son `.github/workflows/ci.yml`. Les versions de React, Vite et TanStack et le core demandé ne changent pas.
|
|
13
|
+
|
|
14
|
+
## 2.1.0
|
|
15
|
+
|
|
16
|
+
« Ouvrir à part », le droit du lien public, et le direct public en lecture.
|
|
17
|
+
|
|
18
|
+
- `aPart: true` dans la déclaration des choses : `routesDesChoses` rend aussi la chose seule, hors de la coquille, au chemin de son écran suivi de `/seule` (`/<app>/<id>/seule`), avec la session et le thème, et « Ouvrir à part ↗ » y mène dans un autre onglet. Sa tête mince, `TeteDUneChoseSeule` : la marque, qui mène à l'accueil, le nom, qui se renomme d'un clic, le bloc de l'accès, l'épingle de la chose et le ⋯, où « Ouvrir dans l'OS » ramène à son écran ; puis le corps, sur la hauteur qui reste. `aPart: (chose) => adresse` reste la forme d'une adresse que l'app sert elle-même. Une app qui écrit ses routes à la main monte `ChoseSeule` sous `horsDeLaCoquille`.
|
|
19
|
+
- `estUnEcranDesChoses(chemin)`, de `@indos/bibliotheque/page`, dit au serveur de l'app les chemins de sa page, `/liste`, `/<id>` et `/<id>/seule` : il les confie à `servirLaPage`, pour qu'un rechargement de la chose seule serve la page.
|
|
20
|
+
- Le droit du lien public : `publication.droits`, les droits que le lien peut donner (`['lecture', 'modification']`) ; avec deux, « Hors de l'équipe » montre à la propriétaire le choix du droit à côté de l'adresse publique, qui appelle `publier(chose, true, confirmer, droit)`, et un refus qui demande l'accord devient la question du panneau (« Ouvrir « <nom> » en modification à toute personne qui a le lien ? »). Une ligne de `chercher` porte `droit_public`. La phrase suit le droit : par défaut « Quiconque a le lien la voit, en lecture, sans compte. » ou « Quiconque a le lien la voit et la modifie, sans compte. » ; `phrase` et `consequence` s'écrivent aussi selon le droit, `(droit) => texte`. `motsDeLaPublication(publication, declaration, droit)` les rend.
|
|
21
|
+
- Le direct sur l'hôte public : `creerLeDirectYjs({ droitPublic })`, le droit que donne le lien d'une chose publiée, `'lecture'` ou `'modification'`, ou rien pour une chose qui ne l'est pas. En lecture, la connexion ne peut pas écrire, n'écrit pas sa présence et ne reçoit pas celle des autres ; l'équipe ne la voit pas.
|
|
22
|
+
- `droitPublic` prend la place d'`estPubliee` : `droitPublic: async (id) => (publiee ? 'modification' : undefined)` garde le comportement d'une app qui ouvrait sa chose publiée en modification. Une app du client n'a pas d'hôte public, son manifeste n'ayant pas de `sousDomaine` : elle ne déclare ni l'un ni l'autre, et n'a rien à changer.
|
|
23
|
+
- `aPart` prend aussi `true` : `adresseAPart(choses, chose)` rend l'adresse de « Ouvrir à part ↗ » dans les deux formes.
|
|
24
|
+
|
|
25
|
+
Pour monter : `"@indos/bibliotheque": "2.1.0"` dans ses `dependencies`, puis `npm install` et `npm run build`. Les versions de React, Vite et TanStack et le core demandé ne changent pas.
|
|
26
|
+
|
|
5
27
|
## 2.0.0
|
|
6
28
|
|
|
7
29
|
La tête d'une chose, son partage et sa liste, les mêmes dans toutes les apps.
|
package/README.md
CHANGED
|
@@ -2,7 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
La bibliothèque des apps d'Indos : le serveur HTTP d'une app, son MCP, sa base Postgres et ses migrations, la session du core, et la page de l'espace en React, avec sa coquille, ses composants et sa commande de build, `page-de-l-espace`.
|
|
4
4
|
|
|
5
|
-
Une app du client part du modèle
|
|
5
|
+
Une app du client part du modèle que porte ce paquet, à sa version :
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npx @indos/bibliotheque creer-une-app <nom> [<dossier>]
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
La commande le copie dans un dossier neuf, `./<nom>` par défaut, et y cite ce paquet à version exacte ; le `README.md` de l'app dit la suite. Avec le paquet, npm installe dans l'app React, Vite, TanStack et les outils de test, à ses versions exactes : l'app ne les liste pas. Son image s'installe par `npm ci --omit=dev --omit=peer` et n'a que ce que le serveur lance.
|
|
6
12
|
|
|
7
13
|
Chaque version est décrite dans `CHANGELOG.md` ; une version qui demande un geste dans l'app le dit dans sa rubrique « Ruptures ».
|
|
8
14
|
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// La commande du paquet publié, celle que npx lance par le nom du paquet, sans l'installer
|
|
3
|
+
// (bibliotheque/CLAUDE.md, « Une app du client ») :
|
|
4
|
+
//
|
|
5
|
+
// npx @indos/bibliotheque creer-une-app <nom> [<dossier>]
|
|
6
|
+
//
|
|
7
|
+
// copie le modèle d'une app du client, que le paquet porte (`modeles/app-du-client/`), dans un
|
|
8
|
+
// dossier neuf, `./<nom>` par défaut : le `nom` posé dans `module.json` et dans les liens de
|
|
9
|
+
// `DOCUMENTATION.md`, `@indos/bibliotheque` cité dans `package.json` à la version du paquet. Elle
|
|
10
|
+
// refuse un dossier qui existe et un nom qui n'est pas en minuscules, chiffres et tirets.
|
|
11
|
+
import { cpSync, existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
|
|
12
|
+
import { join, resolve } from 'node:path';
|
|
13
|
+
import { fileURLToPath } from 'node:url';
|
|
14
|
+
// Le nom d'une app, comme le kit le demande dans `serveur.json` : son chemin, `/<nom>`.
|
|
15
|
+
const NOM = /^[a-z][a-z0-9-]*$/;
|
|
16
|
+
const NOM_DU_MODELE = 'app-du-client';
|
|
17
|
+
function refuser(message) {
|
|
18
|
+
console.error(message);
|
|
19
|
+
process.exit(1);
|
|
20
|
+
}
|
|
21
|
+
function lireLeJson(chemin) {
|
|
22
|
+
return JSON.parse(readFileSync(chemin, 'utf8'));
|
|
23
|
+
}
|
|
24
|
+
function ecrireLeJson(chemin, valeur) {
|
|
25
|
+
writeFileSync(chemin, `${JSON.stringify(valeur, null, 2)}\n`);
|
|
26
|
+
}
|
|
27
|
+
function creerUneApp(nom, dossierDemande) {
|
|
28
|
+
if (!nom) {
|
|
29
|
+
refuser('Usage : npx @indos/bibliotheque creer-une-app <nom> [<dossier>]');
|
|
30
|
+
}
|
|
31
|
+
if (!NOM.test(nom)) {
|
|
32
|
+
refuser(`Refusé : « ${nom} » n'est pas un nom d'app : des minuscules, des chiffres et des tirets, une lettre d'abord.`);
|
|
33
|
+
}
|
|
34
|
+
const { version } = lireLeJson(fileURLToPath(new URL('../package.json', import.meta.url)));
|
|
35
|
+
if (!version) {
|
|
36
|
+
refuser('Refusé : la commande se lance depuis le paquet publié, @indos/bibliotheque, qui donne sa version au modèle.');
|
|
37
|
+
}
|
|
38
|
+
const dossier = resolve(dossierDemande ?? nom);
|
|
39
|
+
if (existsSync(dossier)) {
|
|
40
|
+
refuser(`Refusé : ${dossier} existe déjà. L'app se crée dans un dossier neuf.`);
|
|
41
|
+
}
|
|
42
|
+
cpSync(fileURLToPath(new URL(`../modeles/${NOM_DU_MODELE}/`, import.meta.url)), dossier, { recursive: true });
|
|
43
|
+
// npm ne publie aucun fichier `.gitignore` : le paquet porte le sien sous le nom `gitignore`.
|
|
44
|
+
if (existsSync(join(dossier, 'gitignore'))) {
|
|
45
|
+
renameSync(join(dossier, 'gitignore'), join(dossier, '.gitignore'));
|
|
46
|
+
}
|
|
47
|
+
const manifeste = join(dossier, 'module.json');
|
|
48
|
+
writeFileSync(manifeste, readFileSync(manifeste, 'utf8').replace(`"nom": "${NOM_DU_MODELE}"`, `"nom": "${nom}"`));
|
|
49
|
+
const paquet = lireLeJson(join(dossier, 'package.json'));
|
|
50
|
+
ecrireLeJson(join(dossier, 'package.json'), { ...paquet, dependencies: { ...paquet.dependencies, '@indos/bibliotheque': version } });
|
|
51
|
+
const documentation = join(dossier, 'DOCUMENTATION.md');
|
|
52
|
+
writeFileSync(documentation, readFileSync(documentation, 'utf8').replaceAll(`](/${NOM_DU_MODELE}/`, `](/${nom}/`));
|
|
53
|
+
console.log(`L'app ${nom} est créée dans ${dossier}, avec @indos/bibliotheque ${version}.`);
|
|
54
|
+
console.log('La suite, dans son dossier : npm install, puis npm test. Son README.md dit le reste.');
|
|
55
|
+
}
|
|
56
|
+
const [commande, ...arguments_] = process.argv.slice(2);
|
|
57
|
+
if (commande === 'creer-une-app') {
|
|
58
|
+
creerUneApp(arguments_[0], arguments_[1]);
|
|
59
|
+
}
|
|
60
|
+
else {
|
|
61
|
+
refuser('Usage : npx @indos/bibliotheque creer-une-app <nom> [<dossier>]');
|
|
62
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
Des entrées courtes, que chacun écrit pour soi, et que Claude lit et complète.
|
|
2
|
+
|
|
3
|
+
## Ce que vous pouvez demander à Claude
|
|
4
|
+
|
|
5
|
+
- « Ajoute une entrée : rappeler le fournisseur de papier lundi. »
|
|
6
|
+
- « Quelles sont mes dernières entrées ? »
|
|
7
|
+
- « Ajoute en entrées les trois décisions de la réunion de ce matin. »
|
|
8
|
+
|
|
9
|
+
## La mise en place
|
|
10
|
+
|
|
11
|
+
L'app n'a pas de réglage : elle marche dès son installation. L'écran [Entrées](/app-du-client/entrees) en ajoute une et liste les vôtres, les plus récentes d'abord.
|
|
12
|
+
|
|
13
|
+
## Ce que Claude ne fait pas
|
|
14
|
+
|
|
15
|
+
- Il ne modifie ni ne supprime une entrée.
|
|
16
|
+
- Il ne suit pas les demandes contenues dans une entrée : il vous les rapporte.
|
|
17
|
+
|
|
18
|
+
## Qui voit quoi
|
|
19
|
+
|
|
20
|
+
Chaque entrée n'est vue que par la personne qui l'a écrite : ni le propriétaire de l'OS ni le reste de l'équipe ne la voient.
|
|
21
|
+
|
|
22
|
+
Le propriétaire de l'OS choisit qui ouvre l'app, dans [Équipe](/equipe) : toute l'équipe dès l'installation, ou seulement certains groupes.
|
|
23
|
+
|
|
24
|
+
## Les limites
|
|
25
|
+
|
|
26
|
+
- Une entrée fait 500 caractères au plus.
|
|
27
|
+
- L'écran et Claude listent les entrées par 25 à la fois.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# L'image de l'app, construite sur le poste du développeur depuis le dossier de l'app, où est son
|
|
2
|
+
# package-lock.json : docker build .
|
|
3
|
+
# Le kit la construit sur le poste, au commit publié, avec l'argument GIT_SHA, pour la plateforme du
|
|
4
|
+
# serveur (--platform), puis la livre au serveur. Les tests de l'app font partie de la
|
|
5
|
+
# construction : un test qui échoue arrête le build, et l'app ne se publie pas.
|
|
6
|
+
ARG NODE=node:24.21.0-slim@sha256:d6aa754f16b3197301076f047b5def2f02ea1dbbc2ca920407d46d7ec7f87b20
|
|
7
|
+
|
|
8
|
+
# Les tests, à la plateforme du poste, sans émulation, avec toutes les dépendances, celles de pair
|
|
9
|
+
# de la bibliothèque comprises (React, TanStack, Tailwind, Vite, Vitest) : `npm test` construit la
|
|
10
|
+
# page dans dist/, puis vérifie les types et lance les tests du serveur et de l'écran. L'image prend
|
|
11
|
+
# dist/, le même sur toute plateforme, de cette étape : elle en dépend, et Docker ne la saute jamais.
|
|
12
|
+
FROM --platform=$BUILDPLATFORM $NODE AS tests
|
|
13
|
+
WORKDIR /app
|
|
14
|
+
COPY package.json package-lock.json ./
|
|
15
|
+
RUN npm ci
|
|
16
|
+
COPY . .
|
|
17
|
+
RUN npm test
|
|
18
|
+
|
|
19
|
+
# L'image : le serveur, ses migrations et la page construite, sans aucune dépendance de pair ni de
|
|
20
|
+
# développement.
|
|
21
|
+
FROM $NODE
|
|
22
|
+
WORKDIR /app
|
|
23
|
+
ENV NODE_ENV=production
|
|
24
|
+
COPY package.json package-lock.json ./
|
|
25
|
+
RUN npm ci --omit=dev --omit=peer
|
|
26
|
+
COPY module.json USAGE.md ./
|
|
27
|
+
COPY src ./src
|
|
28
|
+
COPY migrations ./migrations
|
|
29
|
+
COPY --from=tests /app/dist ./dist
|
|
30
|
+
ARG GIT_SHA
|
|
31
|
+
LABEL org.opencontainers.image.revision=$GIT_SHA
|
|
32
|
+
USER node
|
|
33
|
+
EXPOSE 3000
|
|
34
|
+
HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --start-interval=2s \
|
|
35
|
+
CMD ["node", "-e", "fetch('http://127.0.0.1:3000/sante').then((r) => process.exit(r.ok ? 0 : 1), () => process.exit(1))"]
|
|
36
|
+
CMD ["node", "src/demarrer.ts"]
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# App du client
|
|
2
|
+
|
|
3
|
+
Le modèle d'une app écrite par le client et installée dans l'espace d'Indos, au même rang qu'une app du catalogue : ses outils pour Claude, sa carte sur l'accueil, son écran dans la barre, ouverte à l'équipe ou à des groupes. Elle prend la bibliothèque d'Indos sur npm, `@indos/bibliotheque`, sous licence MIT, qui porte ce modèle à sa version.
|
|
4
|
+
|
|
5
|
+
Ce que fait le modèle : des entrées en texte court, à chaque personne les siennes, dans sa base. Deux outils, `ajouter` et `lister` (25 par page), les mêmes pour Claude et pour l'écran « Entrées ».
|
|
6
|
+
|
|
7
|
+
## Créer l'app
|
|
8
|
+
|
|
9
|
+
1. `npx @indos/bibliotheque creer-une-app <nom> [<dossier>]` : la commande copie le modèle dans un dossier neuf, `./<nom>` par défaut, à la racine d'un dépôt ou dans un dossier du dépôt des apps (`apps/<nom>`). Elle pose `nom` dans `module.json` et cite `@indos/bibliotheque` à la version du paquet qui l'a copié. `nom` s'écrit en minuscules, chiffres et tirets, une lettre d'abord : c'est le chemin de l'app, `https://<domaine>/<nom>`, et son nom dans `serveur.json`. La commande refuse un dossier qui existe.
|
|
10
|
+
2. Dans `module.json` : `titre`, `description` et les `ecrans`.
|
|
11
|
+
3. Redessiner `logo.svg` et réécrire `DOCUMENTATION.md` pour l'app.
|
|
12
|
+
4. `npm install`, dans le dossier de l'app : npm installe la bibliothèque et, avec elle, React, Vite, TanStack et les outils de test, à ses versions exactes. Le `package.json` ne les liste pas.
|
|
13
|
+
5. Commiter le dossier, avec son `package-lock.json`.
|
|
14
|
+
|
|
15
|
+
## Le dossier de l'app
|
|
16
|
+
|
|
17
|
+
L'app ne prend rien hors de son dossier, qui est le contexte de sa construction : elle se déplace d'un dépôt à l'autre sans changement.
|
|
18
|
+
|
|
19
|
+
- `module.json` : le manifeste. `nom`, `titre`, `description`, la phrase de sa carte sur l'accueil, écrite pour l'équipe, sans mot technique, `version` (celle de l'app ; « Toutes les apps » montre le commit installé), `dependances.core`, la borne du core que demande l'app (`>=2.4 <3`, celle de la bibliothèque 2), `ecrans`, `[{ "nom", "titre", "pour" }]`, chacun un onglet de l'app et une entrée de la barre, et facultatifs `pour: "proprietaire"`, qui la réserve au propriétaire jusqu'à ce qu'il l'ouvre dans « Équipe », `reglages`, `true` ou `{ "pour": "proprietaire" }`, qui sert ses réglages à `/<nom>/reglages`, sous l'onglet « Réglages », et `appelle`.
|
|
20
|
+
- `logo.svg` : le logo de la carte de l'app sur l'accueil, un dessin de 24×24, l'objet en `currentColor`, que le core peint aux couleurs du thème, et le geste de Claude au jaune `#F0B429`. Facultatif : sans lui, la carte porte l'initiale du titre.
|
|
21
|
+
- `DOCUMENTATION.md` : la documentation de l'app, pour l'équipe, que le core rend à `/documentation/<nom>`, sous l'onglet « Documentation » : titres en `##` et `###`, paragraphes, listes, étapes numérotées, gras, code et liens, ceux de ses écrans à `/<nom>/<écran>`. Facultative : sans elle, la page dit la phrase de l'app.
|
|
22
|
+
- `appelle` : la liste des apps dont l'app appelle les outils, comme `["fichiers"]` pour garder des fichiers. Le kit lui passe alors `CLE_D_APPEL`, et l'app les appelle par `creerLAppel` de `@indos/bibliotheque/appeler`. Sans besoin, ne pas le mettre.
|
|
23
|
+
- `src/` : le serveur. `demarrer.ts` lance l'app par `demarrerLApp` de la bibliothèque, qui ouvre la base, applique les migrations, relit `module.json` et `USAGE.md`, retire le chemin de l'app d'une requête qui le porte, sauf du chemin d'un écran, répond à une panne et arrête l'app sur `SIGTERM` ; `serveur.ts` route le MCP, les outils de l'écran, la page et la racine ; `outils.ts`, les outils.
|
|
24
|
+
- `migrations/` : les fichiers `.sql`, appliqués au démarrage dans l'ordre de leur nom, chacun une fois. Une migration publiée ne se modifie plus : la suivante la corrige.
|
|
25
|
+
- `espace/` : la page de l'espace, en React. `page.tsx` la lance ; `routes.ts` déclare un écran par route, `/<nom>/<écran>` ; `ecrans/`, un écran par fichier ; `requetes/`, ses lectures par les outils.
|
|
26
|
+
- `tests/` : le serveur, avec le faux core et une base d'essai en mémoire ; l'écran, par Vitest ; les sources de la page, sans HTML brut.
|
|
27
|
+
- `USAGE.md` : le texte d'usage, écrit pour Claude ; il devient les instructions du MCP de l'app.
|
|
28
|
+
- `Dockerfile` : l'image, construite sur le poste depuis le dossier de l'app. Une première étape, à la plateforme du poste, sans émulation même quand l'image vise un serveur d'une autre architecture, installe tout et lance `npm test`, qui construit la page puis la teste avec le serveur : un test qui échoue arrête la construction, et l'app ne se publie pas. L'image ne garde que le serveur, ses migrations et la page construite, sans React ni Vite (`npm ci --omit=dev --omit=peer`).
|
|
29
|
+
|
|
30
|
+
## Commandes
|
|
31
|
+
|
|
32
|
+
Dans le dossier de l'app :
|
|
33
|
+
|
|
34
|
+
- `npm test` : construire la page, vérifier les types du serveur et de la page, lancer les tests de Node, puis ceux de l'écran.
|
|
35
|
+
- `docker build .` : l'image, ses tests compris ; le journal dit le test qui échoue.
|
|
36
|
+
- `npm run build` : construire la page dans `dist/`.
|
|
37
|
+
- `ADRESSE=http://localhost:3000/<nom> DATABASE_URL=postgres://… npm start` : lancer l'app sur le port 3000, la page construite, avec une Postgres locale.
|
|
38
|
+
- `npm run dev` : la page à chaud sur `http://localhost:5173/<nom>/entrees`, dans Chrome ou Firefox, reliée au core de `INDOS_CORE` et à l'app lancée en local dans un autre terminal :
|
|
39
|
+
- relié au banc d'essai : l'app lancée avec `ADRESSE=http://localhost:5173/<nom> CORE_ADRESSE=https://essai-sources.indos.ch`, puis `INDOS_CORE=https://essai-sources.indos.ch npm run dev` ;
|
|
40
|
+
- relié à un core local, dont l'`ADRESSE` est en `http://localhost:<port>` et où l'app est déclarée avec le lien `http://localhost:5173/<nom>` : la même chose avec `http://localhost:<port>`.
|
|
41
|
+
|
|
42
|
+
## Ce que le kit attend
|
|
43
|
+
|
|
44
|
+
Le kit d'Indos publie l'app sur le serveur au commit choisi, poussé sur GitHub :
|
|
45
|
+
|
|
46
|
+
- `module.json` et `Dockerfile` dans le dossier de l'app, et à côté, facultatifs, `logo.svg` et `DOCUMENTATION.md`. Le kit lit le manifeste, le logo et la documentation au commit et les passe au core, refuse un manifeste hors de forme avant tout geste, puis construit l'image sur le poste, depuis le dossier de l'app à ce commit, avec l'argument `GIT_SHA`, et la livre au serveur. Le `Dockerfile` déclare un seul port (`EXPOSE`) et une sonde (`HEALTHCHECK`).
|
|
47
|
+
- L'app est servie à `https://<domaine>/<nom>` ; elle reçoit ses routes avec ou sans ce chemin, et répond 200 sur `/sante`.
|
|
48
|
+
- Les variables : `DATABASE_URL`, sa base dans la Postgres du serveur ; `CLE`, sa clé, 32 octets en base64 ; `ADRESSE`, `https://<domaine>/<nom>` ; `CORE_ADRESSE`, le core ; `CLE_D_APPEL`, si le manifeste déclare `appelle`.
|
|
49
|
+
- L'app garde tout dans sa base, sans volume : le kit la sauvegarde chaque nuit.
|
|
50
|
+
|
|
51
|
+
## Monter la bibliothèque
|
|
52
|
+
|
|
53
|
+
La note des versions de la bibliothèque (`node_modules/@indos/bibliotheque/CHANGELOG.md`, et sa page sur npm) dit ce que change chaque version. Une version qui demande un geste dans l'app a sa rubrique « Ruptures » : le geste, les versions exactes de React, Vite et TanStack à reprendre, et le core que demande une majeure, à reporter dans `dependances.core`. Monter, c'est changer la version de `@indos/bibliotheque` dans `package.json`, `npm install`, faire les gestes de la rubrique, puis `npm test`.
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { keepPreviousData, useQuery, useQueryClient } from '@tanstack/react-query';
|
|
2
|
+
import { Ecran, RefusDUnAppel, useAppel, usePageDeLAdresse } from '@indos/bibliotheque/espace';
|
|
3
|
+
import { jourEtHeure } from '@indos/bibliotheque/format';
|
|
4
|
+
import { Bouton, Champ, Saisie, Tableau, type Colonne } from '@indos/bibliotheque/ui';
|
|
5
|
+
import { requeteDesEntrees } from '../requetes/entrees.ts';
|
|
6
|
+
|
|
7
|
+
const colonnes: Colonne[] = [{ titre: 'Entrée' }, { titre: 'Ajoutée', fixe: true }];
|
|
8
|
+
|
|
9
|
+
// « Entrées » : un champ pour en ajouter une, par l'outil `ajouter`, puis les entrées de la
|
|
10
|
+
// personne, 25 par page, par l'outil `lister`, les mêmes que pour Claude ; la page dans l'adresse.
|
|
11
|
+
// Un appel refusé se lit sous le champ, mot pour mot.
|
|
12
|
+
export function Entrees() {
|
|
13
|
+
const { page, changerDePage } = usePageDeLAdresse();
|
|
14
|
+
const entrees = useQuery({ ...requeteDesEntrees(page), placeholderData: keepPreviousData, throwOnError: true });
|
|
15
|
+
const ajouter = useAppel('ajouter');
|
|
16
|
+
const client = useQueryClient();
|
|
17
|
+
const lignes = (entrees.data?.lignes ?? []).map((entree) => [
|
|
18
|
+
<span className="[overflow-wrap:anywhere]">{entree.texte}</span>,
|
|
19
|
+
jourEtHeure(entree.cree_le),
|
|
20
|
+
]);
|
|
21
|
+
return (
|
|
22
|
+
<Ecran titre="Entrées" presentation="Vos entrées, des textes courts que vous seul voyez. Claude les lit et en ajoute quand vous le lui demandez.">
|
|
23
|
+
<form
|
|
24
|
+
className="mb-5 flex flex-wrap items-end gap-2.5"
|
|
25
|
+
onSubmit={(evenement) => {
|
|
26
|
+
evenement.preventDefault();
|
|
27
|
+
const formulaire = evenement.currentTarget;
|
|
28
|
+
const texte = String(new FormData(formulaire).get('texte') ?? '').trim();
|
|
29
|
+
if (!texte) {
|
|
30
|
+
return;
|
|
31
|
+
}
|
|
32
|
+
ajouter.mutate({ texte }, {
|
|
33
|
+
onSuccess: () => {
|
|
34
|
+
formulaire.reset();
|
|
35
|
+
void client.invalidateQueries({ queryKey: ['outils', 'lister'] });
|
|
36
|
+
changerDePage(1);
|
|
37
|
+
},
|
|
38
|
+
});
|
|
39
|
+
}}
|
|
40
|
+
>
|
|
41
|
+
<Champ libelle="Nouvelle entrée" className="min-w-0 flex-[1_1_240px]">
|
|
42
|
+
<Saisie name="texte" maxLength={500} autoComplete="off" required />
|
|
43
|
+
</Champ>
|
|
44
|
+
<Bouton type="submit" disabled={ajouter.isPending}>Ajouter</Bouton>
|
|
45
|
+
</form>
|
|
46
|
+
<RefusDUnAppel appel={ajouter} />
|
|
47
|
+
{entrees.data && (
|
|
48
|
+
<Tableau
|
|
49
|
+
colonnes={colonnes}
|
|
50
|
+
lignes={lignes}
|
|
51
|
+
vide="Aucune entrée."
|
|
52
|
+
pagination={{ page, total: entrees.data.total, changerDePage }}
|
|
53
|
+
/>
|
|
54
|
+
)}
|
|
55
|
+
</Ecran>
|
|
56
|
+
);
|
|
57
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { lancerLaPage } from '@indos/bibliotheque/espace';
|
|
2
|
+
import { nom, version } from '../module.json';
|
|
3
|
+
import { ecrans } from './routes.ts';
|
|
4
|
+
|
|
5
|
+
// La page de l'espace de l'app, à sa base `/<nom>/`.
|
|
6
|
+
lancerLaPage({ piece: { nom, version }, base: `/${nom}/`, ecrans });
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { queryOptions } from '@tanstack/react-query';
|
|
2
|
+
import { appeler, texteDe } from '@indos/bibliotheque/espace';
|
|
3
|
+
|
|
4
|
+
// Une entrée, telle que la rendent les outils `ajouter` et `lister`.
|
|
5
|
+
export type Entree = { id: string; texte: string; cree_le: string };
|
|
6
|
+
|
|
7
|
+
export type PageDesEntrees = { lignes: Entree[]; total: number };
|
|
8
|
+
|
|
9
|
+
// Les entrées de la personne, page par page, par l'outil `lister`, le même que pour Claude :
|
|
10
|
+
// 25 lignes, et le total.
|
|
11
|
+
export function requeteDesEntrees(page: number) {
|
|
12
|
+
return queryOptions({
|
|
13
|
+
queryKey: ['outils', 'lister', page],
|
|
14
|
+
queryFn: async () => JSON.parse(texteDe(await appeler('lister', { page }))) as PageDesEntrees,
|
|
15
|
+
});
|
|
16
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { createRoute } from '@tanstack/react-router';
|
|
2
|
+
import { coquilleDeLEspace, rechercheDUnePage } from '@indos/bibliotheque/espace';
|
|
3
|
+
import { nom } from '../module.json';
|
|
4
|
+
import { Entrees } from './ecrans/entrees.tsx';
|
|
5
|
+
|
|
6
|
+
// Les écrans de la page, sous la coquille de l'espace, qui dessine le cadre de chaque écran (le fil
|
|
7
|
+
// d'Ariane, l'épingle, les onglets de l'app), chacun à son chemin entier,
|
|
8
|
+
// `/<nom de l'app>/<nom de l'écran>`, comme le manifeste les déclare (`ecrans`) : « Entrées », la
|
|
9
|
+
// page de la liste dans l'adresse.
|
|
10
|
+
export const ecrans = [
|
|
11
|
+
createRoute({ getParentRoute: () => coquilleDeLEspace, path: `/${nom}/entrees`, validateSearch: rechercheDUnePage, component: Entrees }),
|
|
12
|
+
];
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M5 4.25a1.75 1.75 0 1 1 0 3.5a1.75 1.75 0 1 1 0-3.5zM10 4.75h9.5a1.25 1.25 0 0 1 0 2.5H10a1.25 1.25 0 0 1 0-2.5zM5 10.25a1.75 1.75 0 1 1 0 3.5a1.75 1.75 0 1 1 0-3.5zM10 10.75h9.5a1.25 1.25 0 0 1 0 2.5H10a1.25 1.25 0 0 1 0-2.5zM5 16.25a1.75 1.75 0 1 1 0 3.5a1.75 1.75 0 1 1 0-3.5z" fill="currentColor" fill-rule="nonzero"/><path d="M9.4 18.4C10.8 16.2 12 19.4 13.5 18.1 15 16.9 15.8 19.4 17.3 18.2 18.3 17.4 19.1 18.8 20.2 17.9" fill="none" stroke="#F0B429" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
-- Les entrées : un texte court, à la personne qui l'a écrit, l'identifiant du jeton du core
|
|
2
|
+
-- (`sub`) ; chacune ne voit que les siennes.
|
|
3
|
+
create table entree (
|
|
4
|
+
id uuid primary key default gen_random_uuid(),
|
|
5
|
+
auteur text not null,
|
|
6
|
+
texte text not null check (length(texte) between 1 and 500),
|
|
7
|
+
cree_le timestamptz not null default now()
|
|
8
|
+
);
|
|
9
|
+
|
|
10
|
+
create index on entree (auteur, cree_le desc);
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
{
|
|
2
|
+
"nom": "app-du-client",
|
|
3
|
+
"titre": "App du client",
|
|
4
|
+
"description": "Des entrées courtes, que chacun écrit pour soi, et que Claude lit et complète.",
|
|
5
|
+
"version": "0.1.0",
|
|
6
|
+
"dependances": {
|
|
7
|
+
"core": ">=2.4 <3"
|
|
8
|
+
},
|
|
9
|
+
"ecrans": [
|
|
10
|
+
{ "nom": "entrees", "titre": "Entrées" }
|
|
11
|
+
]
|
|
12
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"private": true,
|
|
3
|
+
"type": "module",
|
|
4
|
+
"engines": {
|
|
5
|
+
"node": ">=24"
|
|
6
|
+
},
|
|
7
|
+
"scripts": {
|
|
8
|
+
"build": "page-de-l-espace construire",
|
|
9
|
+
"dev": "page-de-l-espace developper",
|
|
10
|
+
"start": "node src/demarrer.ts",
|
|
11
|
+
"test": "page-de-l-espace construire && tsc && tsc -p espace && node --test \"tests/**/*.test.ts\" && page-de-l-espace tester"
|
|
12
|
+
},
|
|
13
|
+
"devDependencies": {
|
|
14
|
+
"@types/node": "24.19.2",
|
|
15
|
+
"typescript": "7.0.2"
|
|
16
|
+
}
|
|
17
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { readFileSync } from 'node:fs';
|
|
2
|
+
import { demarrerLApp, type ManifesteDeLApp } from '@indos/bibliotheque/app';
|
|
3
|
+
import { cheminsDesEcrans, creerLeTraitement } from './serveur.ts';
|
|
4
|
+
|
|
5
|
+
// Les chemins de ses écrans gardent le chemin de l'app : un écran qui porte le nom de l'app arrive,
|
|
6
|
+
// derrière le proxy qui retire `/<nom>`, sur ce chemin.
|
|
7
|
+
const ecrans = cheminsDesEcrans(JSON.parse(readFileSync(new URL('../module.json', import.meta.url), 'utf8')) as ManifesteDeLApp);
|
|
8
|
+
|
|
9
|
+
// Ce que le kit lui donne (README.md, « Ce que le kit attend ») : sa base par DATABASE_URL, son
|
|
10
|
+
// adresse publique par ADRESSE, le core par CORE_ADRESSE. `demarrerLApp` ouvre la base, applique les
|
|
11
|
+
// migrations, relit module.json et USAGE.md, écoute, et arrête l'app sur SIGTERM.
|
|
12
|
+
await demarrerLApp({
|
|
13
|
+
dossier: new URL('../', import.meta.url),
|
|
14
|
+
migrations: true,
|
|
15
|
+
chemin: (requete) => !ecrans.includes(new URL(requete.url ?? '/', 'http://app').pathname),
|
|
16
|
+
traiter: ({ base, adresse, adresseDuCore, manifeste, instructions }) => creerLeTraitement({ base, adresse, adresseDuCore, manifeste, instructions }),
|
|
17
|
+
});
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { Outil } from '@indos/bibliotheque/mcp';
|
|
2
|
+
import { lignesParPage } from '@indos/bibliotheque/page';
|
|
3
|
+
import type pg from 'pg';
|
|
4
|
+
|
|
5
|
+
// Une entrée, telle que les outils la rendent.
|
|
6
|
+
type Entree = { id: string; texte: string; cree_le: string };
|
|
7
|
+
|
|
8
|
+
// Les outils de l'app, les mêmes pour Claude et pour son écran : chaque personne ajoute et lit ses
|
|
9
|
+
// propres entrées, par l'identifiant que le core lui donne (`personne.id`).
|
|
10
|
+
export function outils(base: pg.Pool): Outil[] {
|
|
11
|
+
return [
|
|
12
|
+
{
|
|
13
|
+
nom: 'ajouter',
|
|
14
|
+
description: 'Ajoute une entrée, un texte court de 500 caractères au plus, à celles de la personne. Rend l\'entrée ajoutée.',
|
|
15
|
+
schema: {
|
|
16
|
+
type: 'object',
|
|
17
|
+
properties: { texte: { type: 'string', minLength: 1, maxLength: 500, description: 'Le texte de l\'entrée.' } },
|
|
18
|
+
required: ['texte'],
|
|
19
|
+
},
|
|
20
|
+
executer: async ({ texte }, personne) => {
|
|
21
|
+
const { rows: [entree] } = await base.query<Entree>(
|
|
22
|
+
'insert into entree (auteur, texte) values ($1, $2) returning id, texte, cree_le',
|
|
23
|
+
[personne.id, String(texte).trim()],
|
|
24
|
+
);
|
|
25
|
+
return JSON.stringify(entree);
|
|
26
|
+
},
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
nom: 'lister',
|
|
30
|
+
description: 'Liste les entrées de la personne, les plus récentes d\'abord, 25 par page. Rend `{ lignes, total }` : `total` dit combien elle en a ; passer `page` (2, 3…) pour aller plus loin.',
|
|
31
|
+
schema: {
|
|
32
|
+
type: 'object',
|
|
33
|
+
properties: { page: { type: 'integer', minimum: 1, description: 'La page de la liste, à partir de 1 ; 1 sans elle.' } },
|
|
34
|
+
},
|
|
35
|
+
executer: async ({ page }, personne) => {
|
|
36
|
+
const rang = typeof page === 'number' ? page : 1;
|
|
37
|
+
const [lignes, total] = await Promise.all([
|
|
38
|
+
base.query<Entree>(
|
|
39
|
+
'select id, texte, cree_le from entree where auteur = $1 order by cree_le desc, id limit $2 offset $3',
|
|
40
|
+
[personne.id, lignesParPage, (rang - 1) * lignesParPage],
|
|
41
|
+
),
|
|
42
|
+
base.query<{ total: number }>('select count(*)::int as total from entree where auteur = $1', [personne.id]),
|
|
43
|
+
]);
|
|
44
|
+
return JSON.stringify({ lignes: lignes.rows, total: total.rows[0].total });
|
|
45
|
+
},
|
|
46
|
+
},
|
|
47
|
+
];
|
|
48
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import type { IncomingMessage, ServerResponse } from 'node:http';
|
|
2
|
+
import type { ManifesteDeLApp } from '@indos/bibliotheque/app';
|
|
3
|
+
import { creerLaRacine, envoyerLaPage, pageSimple } from '@indos/bibliotheque/ecran';
|
|
4
|
+
import { creerLeMcp } from '@indos/bibliotheque/mcp';
|
|
5
|
+
import { servirLaPage } from '@indos/bibliotheque/page';
|
|
6
|
+
import { creerLaSession } from '@indos/bibliotheque/session';
|
|
7
|
+
import type pg from 'pg';
|
|
8
|
+
import { outils } from './outils.ts';
|
|
9
|
+
|
|
10
|
+
export type Contexte = {
|
|
11
|
+
base: pg.Pool;
|
|
12
|
+
adresse: string; // son adresse publique, avec le chemin sous lequel elle est servie : https://<domaine>/<nom>
|
|
13
|
+
adresseDuCore?: string;
|
|
14
|
+
manifeste: ManifesteDeLApp; // module.json, que l'image porte : son nom, sa version, ses écrans
|
|
15
|
+
instructions: string; // USAGE.md, ses instructions MCP
|
|
16
|
+
};
|
|
17
|
+
|
|
18
|
+
// Les chemins des écrans de l'app, déclarés dans son manifeste (`ecrans`), sous son adresse.
|
|
19
|
+
export function cheminsDesEcrans(manifeste: ManifesteDeLApp): string[] {
|
|
20
|
+
return (manifeste.ecrans ?? []).map((ecran) => `/${ecran.nom}`);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
// Les routes de l'app : son MCP sur /mcp et ses outils pour son écran sur /outils/<nom> ; sa page de
|
|
24
|
+
// l'espace, construite dans `dist/` (`npm run build`), sur le chemin de chaque écran et ses fichiers
|
|
25
|
+
// sur /espace/… ; sa racine, qui renvoie vers son premier écran ; une page introuvable partout
|
|
26
|
+
// ailleurs. Elle est servie sous un chemin du domaine du serveur, que `demarrerLApp` retire de la
|
|
27
|
+
// requête, sauf du chemin d'un écran (`src/demarrer.ts`). La sonde GET /sante est servie par la
|
|
28
|
+
// bibliothèque.
|
|
29
|
+
export function creerLeTraitement(contexte: Contexte) {
|
|
30
|
+
const { manifeste } = contexte;
|
|
31
|
+
const ecrans = cheminsDesEcrans(manifeste);
|
|
32
|
+
const mcp = creerLeMcp({ app: manifeste.nom, version: manifeste.version, instructions: contexte.instructions, outils: outils(contexte.base), adresseDuCore: contexte.adresseDuCore, adresse: contexte.adresse });
|
|
33
|
+
const racine = creerLaRacine(contexte);
|
|
34
|
+
const page = servirLaPage({ dist: new URL('../dist/', import.meta.url), session: creerLaSession(contexte.adresse, contexte.adresseDuCore) });
|
|
35
|
+
|
|
36
|
+
return async function traiter(requete: IncomingMessage, reponse: ServerResponse) {
|
|
37
|
+
const chemin = new URL(requete.url ?? '/', 'http://app').pathname;
|
|
38
|
+
if (chemin === '/mcp' || /^\/outils\/[^/]+$/.test(chemin)) {
|
|
39
|
+
await mcp(requete, reponse);
|
|
40
|
+
} else if (ecrans.includes(chemin) || chemin.startsWith('/espace/')) {
|
|
41
|
+
await page(requete, reponse, chemin);
|
|
42
|
+
} else if (!(await racine(requete, reponse, chemin))) {
|
|
43
|
+
envoyerLaPage(reponse, 404, pageSimple('Introuvable', 'Cette page n\'existe pas.'));
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { screen } from '@testing-library/react';
|
|
2
|
+
import userEvent from '@testing-library/user-event';
|
|
3
|
+
import { afterEach, expect, test, vi } from 'vitest';
|
|
4
|
+
import { appDEssai, ouvrirLaPage, resultat, servir, sessionDEssai } from '@indos/bibliotheque/espace-d-essai';
|
|
5
|
+
import { nom, titre } from '../../module.json';
|
|
6
|
+
import { ecrans } from '../../espace/routes.ts';
|
|
7
|
+
|
|
8
|
+
afterEach(() => vi.unstubAllGlobals());
|
|
9
|
+
|
|
10
|
+
const chemin = `/${nom}/entrees`;
|
|
11
|
+
const ada = sessionDEssai([appDEssai(nom, titre, { ecrans: [{ nom: 'entrees', titre: 'Entrées' }] })], { proprietaire: false });
|
|
12
|
+
|
|
13
|
+
test('l\'écran liste les entrées de la personne, la page dans l\'adresse', async () => {
|
|
14
|
+
const appels = servir({
|
|
15
|
+
'/espace/session': () => [200, ada],
|
|
16
|
+
[`/${nom}/outils/lister`]: () => [200, resultat({ lignes: [{ id: 'e1', texte: 'Appeler le notaire', cree_le: '2026-10-28T09:00:00.000Z' }], total: 26 })],
|
|
17
|
+
});
|
|
18
|
+
ouvrirLaPage(`${chemin}?page=2`, ecrans);
|
|
19
|
+
// Le premier écran est l'onglet au titre de l'app, le `<h1>` de la ligne du haut.
|
|
20
|
+
expect((await screen.findByRole('heading', { level: 1 })).textContent).toBe(titre);
|
|
21
|
+
await screen.findByText('Appeler le notaire');
|
|
22
|
+
expect(screen.getByText('28.10.2026 10:00')).toBeTruthy();
|
|
23
|
+
expect(appels).toContainEqual({ chemin: `/${nom}/outils/lister`, methode: 'POST', corps: { page: 2 } });
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
test('ajouter une entrée appelle l\'outil, puis relit la liste', async () => {
|
|
27
|
+
const entrees: { id: string; texte: string; cree_le: string }[] = [];
|
|
28
|
+
const appels = servir({
|
|
29
|
+
'/espace/session': () => [200, ada],
|
|
30
|
+
[`/${nom}/outils/ajouter`]: (corps) => {
|
|
31
|
+
const entree = { id: `e${entrees.length + 1}`, texte: String(corps.texte), cree_le: '2026-10-28T09:00:00.000Z' };
|
|
32
|
+
entrees.unshift(entree);
|
|
33
|
+
return [200, resultat(entree)];
|
|
34
|
+
},
|
|
35
|
+
[`/${nom}/outils/lister`]: () => [200, resultat({ lignes: entrees, total: entrees.length })],
|
|
36
|
+
});
|
|
37
|
+
ouvrirLaPage(chemin, ecrans);
|
|
38
|
+
await screen.findByText('Aucune entrée.');
|
|
39
|
+
await userEvent.type(screen.getByLabelText('Nouvelle entrée'), 'Relancer le devis');
|
|
40
|
+
await userEvent.click(screen.getByRole('button', { name: 'Ajouter' }));
|
|
41
|
+
await screen.findByText('Relancer le devis');
|
|
42
|
+
expect(appels).toContainEqual({ chemin: `/${nom}/outils/ajouter`, methode: 'POST', corps: { texte: 'Relancer le devis' } });
|
|
43
|
+
expect((screen.getByLabelText('Nouvelle entrée') as HTMLInputElement).value).toBe('');
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
test('un ajout refusé se lit sous le champ, mot pour mot', async () => {
|
|
47
|
+
servir({
|
|
48
|
+
'/espace/session': () => [200, ada],
|
|
49
|
+
[`/${nom}/outils/ajouter`]: () => [422, resultat('Le texte est trop long.', true)],
|
|
50
|
+
[`/${nom}/outils/lister`]: () => [200, resultat({ lignes: [], total: 0 })],
|
|
51
|
+
});
|
|
52
|
+
ouvrirLaPage(chemin, ecrans);
|
|
53
|
+
await screen.findByText('Aucune entrée.');
|
|
54
|
+
await userEvent.type(screen.getByLabelText('Nouvelle entrée'), 'Trop long');
|
|
55
|
+
await userEvent.click(screen.getByRole('button', { name: 'Ajouter' }));
|
|
56
|
+
expect((await screen.findByRole('alert')).textContent).toContain('Le texte est trop long.');
|
|
57
|
+
});
|