@indos/bibliotheque 4.0.0 → 4.3.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/CLAUDE.md +21 -13
- package/README.md +4 -4
- package/bin/bibliotheque.d.ts +1 -0
- package/bin/bibliotheque.js +63 -0
- package/bin/page-de-l-espace.js +3 -3
- package/manifeste.json +5 -0
- package/modeles/app-du-client/.github/workflows/publier-l-image.yml +31 -0
- package/modeles/app-du-client/DOCUMENTATION.md +27 -0
- package/modeles/app-du-client/Dockerfile +34 -0
- package/modeles/app-du-client/Dockerfile.dockerignore +3 -0
- package/modeles/app-du-client/GUIDE.md +3 -0
- package/modeles/app-du-client/README.md +47 -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/essai/poser.sql +6 -0
- package/modeles/app-du-client/logo.svg +1 -0
- package/modeles/app-du-client/manifeste.json +12 -0
- package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +10 -0
- package/modeles/app-du-client/package.json +20 -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 +58 -0
- package/modeles/app-du-client/tests/serveur.test.ts +119 -0
- package/modeles/app-du-client/tsconfig.json +22 -0
- package/package.json +3 -2
- package/src/appeler.js +1 -1
- package/src/compte.js +2 -2
- package/src/direct/page.js +1 -1
- package/src/direct.js +1 -1
- package/src/ecran.js +1 -1
- package/src/espace/apercu.js +1 -1
- package/src/espace/chose-seule.js +1 -1
- package/src/espace/coquille.js +1 -1
- package/src/espace/ecran-d-une-chose.js +1 -1
- package/src/espace/essai.js +2 -2
- package/src/espace/index.js +1 -1
- package/src/faux-core.js +1 -1
- package/src/flux.js +1 -1
- package/src/forme-du-direct.js +1 -1
- package/src/jeton.js +1 -1
- package/src/liens.js +1 -1
- package/src/mcp.js +3 -3
- package/src/notifier.js +1 -1
- package/src/page.js +3 -3
- package/src/presence.js +1 -1
- package/src/sans-accents.js +1 -1
- package/src/session.js +2 -2
- package/src/theme.js +1 -1
- package/src/ui/index.js +1 -1
- package/src/vite.d.ts +2 -0
- package/src/vite.js +7 -6
package/CLAUDE.md
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
#
|
|
1
|
+
# bibliotheque
|
|
2
2
|
|
|
3
3
|
Le code que les apps partagent, intégré à l'image de chaque app au build, et le contrat d'une app : les règles que toute app suit, que le core, la bibliothèque, le kit ou les tests vérifient. À lire en entier avant d'écrire ou de changer une app.
|
|
4
4
|
|
|
5
|
-
Sa version est celle de
|
|
5
|
+
Sa version est celle de son `manifeste.json`, publiée sur npm sous `@indos/bibliotheque` ; `CHANGELOG.md` dit ce que chaque version change pour une app. Une app du catalogue, dans `apps/<nom>/` d'ind-os/sources, la cite par un lien de dossier ; une app du client, son propre dépôt cloné dans `code/<nom>/` du dépôt de l'OS, cite le paquet à une version exacte (« Comment une app s'en sert »).
|
|
6
6
|
|
|
7
7
|
## Commandes
|
|
8
8
|
|
|
9
9
|
```sh
|
|
10
|
-
# dans ind-os/sources, depuis
|
|
10
|
+
# dans ind-os/sources, depuis bibliotheque/, avant toute app du catalogue
|
|
11
11
|
npm ci
|
|
12
12
|
# depuis la racine du dépôt d'un OS : créer une app du client à partir du modèle
|
|
13
|
-
node
|
|
13
|
+
node bibliotheque/bin/bibliotheque.ts creer-une-app <nom>
|
|
14
14
|
# depuis le dossier de l'app (apps/<nom>/ ou code/<nom>/)
|
|
15
15
|
npm install # la première fois, puis commiter package-lock.json
|
|
16
16
|
npm test # construit la page, vérifie les types, tests de Node puis de la page
|
|
@@ -30,8 +30,8 @@ Le dossier de l'app porte :
|
|
|
30
30
|
- `pour`, `ecrans`, `reglages` (« Qui ouvre une app », « Les pages d'une app »).
|
|
31
31
|
- Une app du client ne déclare pas `sousDomaine` : le kit le refuse.
|
|
32
32
|
- `Dockerfile` et `Dockerfile.dockerignore` côte à côte (`**/node_modules`, `**/dist`, `.git`). Aucun `.dockerignore` à la racine du dépôt. Le modèle est `modeles/app-du-client/Dockerfile` :
|
|
33
|
-
- une app du client se construit sur son seul dossier (`docker build .`), la bibliothèque prise du paquet, par la CI de son dépôt (`.github/workflows/publier-l-image.yml`, du modèle), qui pousse l'image sur ghcr.io ; une app du catalogue reproduit l'arbre du dépôt (`/depot/
|
|
34
|
-
- elle ne prend aucun fichier de `
|
|
33
|
+
- une app du client se construit sur son seul dossier (`docker build .`), la bibliothèque prise du paquet, par la CI de son dépôt (`.github/workflows/publier-l-image.yml`, du modèle), qui pousse l'image sur ghcr.io ; une app du catalogue reproduit l'arbre du dépôt (`/depot/bibliotheque`, `/depot/apps/<nom>`) et ne prend, hors de son dossier, que `bibliotheque/` ;
|
|
34
|
+
- elle ne prend aucun fichier de `bibliotheque/tests/`, absent chez un client (la CI le vérifie) ;
|
|
35
35
|
- l'étape `tests` lance `npm test` et l'image prend `dist/` de cette étape : un test qui échoue arrête la construction ;
|
|
36
36
|
- les étapes des tests sont à la plateforme du poste (`FROM --platform=$BUILDPLATFORM <image de Node>`), l'image à celle du serveur ;
|
|
37
37
|
- l'image de Node est citée par sa version et son empreinte ; un seul `EXPOSE`, un `HEALTHCHECK` sur `/sante`, `USER node`.
|
|
@@ -234,10 +234,10 @@ Un geste d'écran est un appel de la page à sa pièce, en JSON, avec la session
|
|
|
234
234
|
|
|
235
235
|
`espace/` porte `index.html` (le même pour chaque pièce, sans script en ligne), `page.tsx` (les routes, puis `lancerLaPage`), `ecrans/` (un écran par fichier, qui n'exporte que son composant), `requetes/`, `tsconfig.json` (qui étend `tsconfig.page.json` de la bibliothèque) ; les tests de la page sont dans `tests/espace/*.test.tsx`. Le modèle est `modeles/app-du-client/espace/`.
|
|
236
236
|
|
|
237
|
-
- La page importe `@indos/bibliotheque/espace`, `@indos/bibliotheque/ui`, React, TanStack, Radix et Yjs tels quels : ils se résolvent depuis la bibliothèque, une seule copie de chacun. Une app du client les reçoit du paquet, dont ils sont les dépendances de pair que npm installe ; une app du catalogue lie `react` et `react-dom` à ceux de la bibliothèque (`file:../../
|
|
237
|
+
- La page importe `@indos/bibliotheque/espace`, `@indos/bibliotheque/ui`, React, TanStack, Radix et Yjs tels quels : ils se résolvent depuis la bibliothèque, une seule copie de chacun. Une app du client les reçoit du paquet, dont ils sont les dépendances de pair que npm installe ; une app du catalogue lie `react` et `react-dom` à ceux de la bibliothèque (`file:../../bibliotheque/node_modules/react`).
|
|
238
238
|
- Ses scripts npm lancent la commande de la page (`construire`, `developper`, `tester`) : `page-de-l-espace` pour une app du client, comme le modèle ; `node node_modules/@indos/bibliotheque/bin/page-de-l-espace.ts` pour une app du catalogue.
|
|
239
239
|
- `npm run build` refuse un script en ligne ; `page-de-l-espace tester` refuse le HTML brut dans `espace/` (`innerHTML`, `dangerouslySetInnerHTML`, `outerHTML`, `insertAdjacentHTML`, `document.write`).
|
|
240
|
-
- `npm run dev` : `INDOS_CORE` (le core de l'espace ou un core local), `INDOS_APP` (l'app lancée en local, `http://localhost:3000`), `INDOS_PORT
|
|
240
|
+
- `npm run dev` : `INDOS_CORE` (le core de l'espace ou un core local), `INDOS_APP` (l'app lancée en local, `http://localhost:3000`), `INDOS_PORT`, `INDOS_HOTE` (l'hôte d'écoute, localhost par défaut, `0.0.0.0` dans un conteneur). L'app est lancée avec `ADRESSE=http://localhost:5173/<app>`. Relié à un espace en HTTPS, la session passe dans Chrome et Firefox, pas dans Safari.
|
|
241
241
|
|
|
242
242
|
## La coquille
|
|
243
243
|
|
|
@@ -330,7 +330,7 @@ Une chose écrite à plusieurs montre son direct de la même façon partout : la
|
|
|
330
330
|
|
|
331
331
|
Une chose écrite à plusieurs en Yjs prend son direct de la bibliothèque : `creerLeDirectYjs` (`@indos/bibliotheque/direct`) au serveur, `ouvrirUnDirectYjs` (`@indos/bibliotheque/direct/page`) à la page. Chaque chose ouverte est un document Yjs en mémoire de l'app, relayé par Hocuspocus, écrit en base par l'app : une seule instance par serveur.
|
|
332
332
|
|
|
333
|
-
- Une seule copie de Yjs, celle de la bibliothèque : une app du catalogue cite `yjs` et `y-protocols` par un lien vers sa copie (`file:../../
|
|
333
|
+
- Une seule copie de Yjs, celle de la bibliothèque : une app du catalogue cite `yjs` et `y-protocols` par un lien vers sa copie (`file:../../bibliotheque/node_modules/yjs`), une app du client ne les cite pas ; aucune ne cite Hocuspocus.
|
|
334
334
|
- L'app donne `droitDe(personne, chose)`, `droitPublic(chose)` pour une chose publiée, `charger`, `enregistrer` (un `UPDATE` seul, qui ne recrée jamais une chose supprimée), `limite` et ses `textes`.
|
|
335
335
|
- Le serveur contrôle à l'ouverture, avant toute donnée, l'`Origin`, la session ou le lien publié, et le droit ; il écrit lui-même la présence de chaque connexion. Un visiteur en lecture sur l'hôte public ne reçoit aucune présence.
|
|
336
336
|
- `relire(...choses)` après un partage, un don, une publication, un changement du droit du lien, un déplacement ou une suppression (et toutes les cinq minutes) : une connexion sans droit est coupée (4403), une dont le droit a changé aussi (4205).
|
|
@@ -341,7 +341,15 @@ Une chose écrite à plusieurs en Yjs prend son direct de la bibliothèque : `cr
|
|
|
341
341
|
|
|
342
342
|
Une app du client cite le paquet publié à une version exacte : `"@indos/bibliotheque": "3.0.0"`. npm installe ses dépendances d'exécution et ses dépendances de pair (React, TanStack, Tailwind, Vite, Vitest, leurs types) ; l'image n'en garde aucune (`npm ci --omit=dev --omit=peer`). Une version publiée ne change plus : l'app ne prend la suivante qu'en changeant ce numéro. Le paquet est compilé, Node n'effaçant pas les types sous `node_modules` : `npm run paquet` l'écrit dans `paquet/` (`scripts/construire-le-paquet.ts`), et la release d'`indos` le publie.
|
|
343
343
|
|
|
344
|
-
Une app du catalogue cite la bibliothèque par un lien de dossier, au même commit : `"@indos/bibliotheque": "file:../../
|
|
344
|
+
Une app du catalogue cite la bibliothèque par un lien de dossier, au même commit : `"@indos/bibliotheque": "file:../../bibliotheque"`. Le lien se résout hors de `node_modules` : ni `install-links` ni `--preserve-symlinks`. Les dépendances de la bibliothèque s'installent par son propre `package-lock.json` ; une version qui en ajoute une demande `npm install` dans chaque app. Ce que les tests d'une app prennent hors de `src/`, comme le Radicale d'essai (`radicale/`), est dans la copie.
|
|
345
|
+
|
|
346
|
+
## Les données d'essai
|
|
347
|
+
|
|
348
|
+
`essai/poser.sql` : les données d'essai de l'app, que `kit local` passe dans sa base neuve, après ses migrations, en une transaction ; elles ne partent sur aucun serveur.
|
|
349
|
+
|
|
350
|
+
- Neutres : des noms « Essai … », des adresses en `exemple.ch`. Elles écrivent au schéma des migrations, ni `begin` ni `commit`.
|
|
351
|
+
- Un compte d'essai se nomme par sa variable de psql, `:'proprietaire'`, `:'bob'` ou `:'eve'` : son identifiant, le `sub` de son jeton. psql ne les remplace pas dans un bloc `do $$ … $$`.
|
|
352
|
+
- Peu de lignes, de quoi voir chaque écran rempli ; un état en octets (un document Yjs, une image) s'écrit par l'app elle-même, pas ici.
|
|
345
353
|
|
|
346
354
|
## Les aides des tests
|
|
347
355
|
|
|
@@ -352,10 +360,10 @@ Les tests de chaque app reposent sur ces aides ; ce qui reste dans ses tests lui
|
|
|
352
360
|
|
|
353
361
|
## Une app du client
|
|
354
362
|
|
|
355
|
-
Le modèle, `modeles/app-du-client/`, est une app à page qui ne prend que la bibliothèque : une migration, deux outils, un écran, ses tests, son `Dockerfile` et son `Dockerfile.dockerignore`, sans `package-lock.json`. `creer-une-app <nom>` le copie dans `code/<nom>/` du dépôt d'un OS, y pose le nom et cite le paquet à la version
|
|
363
|
+
Le modèle, `modeles/app-du-client/`, est une app à page qui ne prend que la bibliothèque : une migration, deux outils, un écran, ses tests, son `Dockerfile` et son `Dockerfile.dockerignore`, sans `package-lock.json`. `creer-une-app <nom>` le copie dans `code/<nom>/` du dépôt d'un OS, y pose le nom et cite le paquet à la version de `manifeste.json` ; elle refuse un dossier qui existe et un nom hors de `^[a-z][a-z0-9-]*$`, et se lance avant toute installation.
|
|
356
364
|
|
|
357
|
-
Les gestes sont les skills `indos-creer-une-app` et `indos-publier-une-app` et la méthode
|
|
365
|
+
Les gestes sont les skills `indos-creer-une-app` et `indos-publier-une-app` et la méthode du kit, `.claude/indos/METHODE.md` dans le dépôt de l'OS. Une app se développe sur une branche de son dépôt ; le clone de l'OS reste sur `main`, d'où elle se publie. La première publication écrit l'entrée de l'app dans `os.json` (`installer <app> <commit>` du kit) : ni `os.json` ni `apps/` ne se modifient à la main.
|
|
358
366
|
|
|
359
367
|
## La note des versions
|
|
360
368
|
|
|
361
|
-
`
|
|
369
|
+
`CHANGELOG.md` s'écrit pour le développeur d'une app du client : une section `## <version>` par version, une rubrique « Ruptures » quand une version demande un geste dans les apps (et, pour une majeure, le core qu'elle demande), et « Pour monter ». Monter une app : sur une branche de son dépôt, les gestes des ruptures de chaque version sautée, puis la version du paquet dans `package.json`, `npm install` et `npm test` dans l'app.
|
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# La bibliothèque d'Indos
|
|
2
2
|
|
|
3
|
-
Le code que les apps d'Indos partagent : le serveur d'une app, son MCP, sa base et ses migrations, la session du core, et la page de l'espace en React, avec sa coquille et ses composants. Elle
|
|
3
|
+
Le code que les apps d'Indos partagent : le serveur d'une app, son MCP, sa base et ses migrations, la session du core, et la page de l'espace en React, avec sa coquille et ses composants. Elle se publie sur npm sous `@indos/bibliotheque`, à la version de `manifeste.json` ; `CHANGELOG.md` dit ce que change chaque version.
|
|
4
4
|
|
|
5
5
|
- `CLAUDE.md` : le contrat d'une app, à lire avant d'en écrire une.
|
|
6
|
-
- `modeles/app-du-client/` : le modèle d'une app, que copie `node
|
|
6
|
+
- `modeles/app-du-client/` : le modèle d'une app, que copie `node bibliotheque/bin/bibliotheque.ts creer-une-app <nom>`.
|
|
7
7
|
|
|
8
|
-
Avant toute app, et après chaque nouvelle version : `npm ci` dans `
|
|
8
|
+
Avant toute app, et après chaque nouvelle version : `npm ci` dans `bibliotheque/`.
|
|
9
9
|
|
|
10
|
-
Licence : tous droits réservés, AVQN (`
|
|
10
|
+
Licence : tous droits réservés, AVQN (`LICENSE`).
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// La commande de la bibliothèque, lancée à la racine du dépôt d'un OS (ou de son worktree ;
|
|
3
|
+
// bibliotheque/CLAUDE.md, « Une app du client ») par le paquet publié :
|
|
4
|
+
//
|
|
5
|
+
// npx --package @indos/bibliotheque@<version> bibliotheque creer-une-app <nom>
|
|
6
|
+
//
|
|
7
|
+
// copie le modèle d'une app (`bibliotheque/modeles/app-du-client/`) dans `code/<nom>/`, où l'app
|
|
8
|
+
// sera le clone de son propre dépôt : le `nom` posé dans `manifeste.json`, dans les liens de
|
|
9
|
+
// `DOCUMENTATION.md` et à la place de chaque `<nom>` du `README.md`, et la bibliothèque citée dans
|
|
10
|
+
// `package.json` au paquet `@indos/bibliotheque` à la version de son manifeste (`bibliotheque/manifeste.json`). La
|
|
11
|
+
// commande refuse un nom qui n'est pas en minuscules, chiffres et tirets, et un dossier qui existe. Elle
|
|
12
|
+
// n'importe que les modules de Node : elle se lance avant toute installation.
|
|
13
|
+
import { cpSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
|
|
14
|
+
import { join } from 'node:path';
|
|
15
|
+
import { fileURLToPath } from 'node:url';
|
|
16
|
+
// Le nom d'une app, comme le kit le demande dans `os.json` : son chemin, `/<nom>`.
|
|
17
|
+
const NOM = /^[a-z][a-z0-9-]*$/;
|
|
18
|
+
const NOM_DU_MODELE = 'app-du-client';
|
|
19
|
+
const USAGE = 'Usage, à la racine du dépôt de l\'OS : npx --package @indos/bibliotheque@<version> bibliotheque creer-une-app <nom>';
|
|
20
|
+
// Le dossier de la bibliothèque, et la racine du dépôt, celle où la commande se lance.
|
|
21
|
+
const bibliotheque = fileURLToPath(new URL('..', import.meta.url));
|
|
22
|
+
const racine = process.cwd();
|
|
23
|
+
function refuser(message) {
|
|
24
|
+
console.error(message);
|
|
25
|
+
process.exit(1);
|
|
26
|
+
}
|
|
27
|
+
// Remplace chaque occurrence de `avant` dans le fichier.
|
|
28
|
+
function remplacer(chemin, avant, apres) {
|
|
29
|
+
writeFileSync(chemin, readFileSync(chemin, 'utf8').replaceAll(avant, apres));
|
|
30
|
+
}
|
|
31
|
+
function creerUneApp(nom) {
|
|
32
|
+
if (!nom) {
|
|
33
|
+
refuser(USAGE);
|
|
34
|
+
}
|
|
35
|
+
if (!NOM.test(nom)) {
|
|
36
|
+
refuser(`Refusé : « ${nom} » n'est pas un nom d'app : des minuscules, des chiffres et des tirets, une lettre d'abord.`);
|
|
37
|
+
}
|
|
38
|
+
const manifeste = join(bibliotheque, 'manifeste.json');
|
|
39
|
+
const { version } = JSON.parse(readFileSync(manifeste, 'utf8'));
|
|
40
|
+
if (!version) {
|
|
41
|
+
refuser(`Refusé : ${manifeste} ne dit pas la version de la bibliothèque.`);
|
|
42
|
+
}
|
|
43
|
+
const dossier = join(racine, 'code', nom);
|
|
44
|
+
if (existsSync(dossier)) {
|
|
45
|
+
refuser(`Refusé : ${dossier} existe déjà. L'app se crée dans un dossier neuf.`);
|
|
46
|
+
}
|
|
47
|
+
cpSync(join(bibliotheque, 'modeles', NOM_DU_MODELE), dossier, { recursive: true });
|
|
48
|
+
remplacer(join(dossier, 'manifeste.json'), `"nom": "${NOM_DU_MODELE}"`, `"nom": "${nom}"`);
|
|
49
|
+
const paquet = JSON.parse(readFileSync(join(dossier, 'package.json'), 'utf8'));
|
|
50
|
+
paquet.dependencies['@indos/bibliotheque'] = version;
|
|
51
|
+
writeFileSync(join(dossier, 'package.json'), `${JSON.stringify(paquet, null, 2)}\n`);
|
|
52
|
+
remplacer(join(dossier, 'DOCUMENTATION.md'), `](/${NOM_DU_MODELE}/`, `](/${nom}/`);
|
|
53
|
+
remplacer(join(dossier, 'README.md'), '<nom>', nom);
|
|
54
|
+
console.log(`L'app ${nom} est créée dans code/${nom}, avec @indos/bibliotheque ${version}.`);
|
|
55
|
+
console.log(`La suite : npm install et npm test dans code/${nom}. Son README.md dit le reste.`);
|
|
56
|
+
}
|
|
57
|
+
const [commande, ...arguments_] = process.argv.slice(2);
|
|
58
|
+
if (commande === 'creer-une-app' && arguments_.length <= 1) {
|
|
59
|
+
creerUneApp(arguments_[0]);
|
|
60
|
+
}
|
|
61
|
+
else {
|
|
62
|
+
refuser(USAGE);
|
|
63
|
+
}
|
package/bin/page-de-l-espace.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
// La page de l'espace d'une pièce, lancée dans le dossier de la pièce par ses commandes npm
|
|
3
|
-
// (
|
|
3
|
+
// (bibliotheque/CLAUDE.md, « Écrire une page »), par le lien de la bibliothèque dans ses
|
|
4
4
|
// `node_modules` (`node node_modules/@indos/bibliotheque/bin/page-de-l-espace.ts <commande>`) :
|
|
5
5
|
// - `construire` (`npm run build`) écrit le dossier construit, `dist/` ;
|
|
6
6
|
// - `developper` (`npm run dev`) la sert à chaud sur http://localhost:<port>, le port de
|
|
7
7
|
// `INDOS_PORT`, 5173 par défaut, reliée au core de `INDOS_CORE` et, pour une app, à l'app lancée
|
|
8
|
-
// en local à `INDOS_APP` ;
|
|
8
|
+
// en local à `INDOS_APP`, à l'écoute de `INDOS_HOTE` (localhost par défaut, `0.0.0.0` dans un conteneur) ;
|
|
9
9
|
// - `tester` lance ses tests de Vitest, `tests/espace/**/*.test.tsx`.
|
|
10
10
|
import { construireLaPage, developperLaPage, portDeDeveloppement, testerLaPage } from '../src/vite.js';
|
|
11
11
|
const [commande] = process.argv.slice(2);
|
|
@@ -24,7 +24,7 @@ else if (commande === 'developper') {
|
|
|
24
24
|
console.error(`INDOS_PORT n'est pas un port : ${process.env.INDOS_PORT}. Un nombre de 1 à 65535, comme 5174.`);
|
|
25
25
|
process.exit(1);
|
|
26
26
|
}
|
|
27
|
-
await developperLaPage(dossier, { core, app: process.env.INDOS_APP ?? 'http://localhost:3000', port });
|
|
27
|
+
await developperLaPage(dossier, { core, app: process.env.INDOS_APP ?? 'http://localhost:3000', port, hote: process.env.INDOS_HOTE });
|
|
28
28
|
}
|
|
29
29
|
else if (commande === 'tester') {
|
|
30
30
|
await testerLaPage(dossier);
|
package/manifeste.json
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# L'image de l'app à chaque commit de main : construite sur le dépôt, ses tests compris (le Dockerfile
|
|
2
|
+
# les lance), pour la plateforme du serveur, puis poussée dans l'entrepôt GitHub du dépôt,
|
|
3
|
+
# ghcr.io/<compte>/<dépôt>:<commit>, d'où le serveur la tire à la publication (par le kit). Le jeton de GitHub de l'exécution suffit : aucun secret.
|
|
4
|
+
name: Publier l'image
|
|
5
|
+
|
|
6
|
+
on:
|
|
7
|
+
push:
|
|
8
|
+
branches: [main]
|
|
9
|
+
|
|
10
|
+
permissions:
|
|
11
|
+
contents: read
|
|
12
|
+
packages: write
|
|
13
|
+
|
|
14
|
+
jobs:
|
|
15
|
+
image:
|
|
16
|
+
name: Construire et pousser l'image
|
|
17
|
+
runs-on: ubuntu-24.04
|
|
18
|
+
timeout-minutes: 30
|
|
19
|
+
steps:
|
|
20
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
21
|
+
with:
|
|
22
|
+
persist-credentials: false
|
|
23
|
+
- name: L'image, dans l'entrepôt GitHub
|
|
24
|
+
env:
|
|
25
|
+
JETON: ${{ github.token }}
|
|
26
|
+
run: |
|
|
27
|
+
image="ghcr.io/${GITHUB_REPOSITORY,,}:${GITHUB_SHA}"
|
|
28
|
+
printf '%s' "$JETON" | docker login ghcr.io -u "$GITHUB_ACTOR" --password-stdin
|
|
29
|
+
docker build --platform linux/amd64 --build-arg GIT_SHA="$GITHUB_SHA" -t "$image" .
|
|
30
|
+
docker push "$image"
|
|
31
|
+
echo "Image poussée : $image"
|
|
@@ -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,34 @@
|
|
|
1
|
+
# L'image de l'app, construite sur son dépôt seul (docker build .), la bibliothèque prise sur npm à la
|
|
2
|
+
# version de package-lock.json : par la CI de son dépôt, comme par le kit sur le poste. Les tests de l'app
|
|
3
|
+
# font partie de la construction : un test qui échoue arrête le build, et l'app ne se publie pas.
|
|
4
|
+
ARG NODE=node:24.21.0-slim@sha256:d6aa754f16b3197301076f047b5def2f02ea1dbbc2ca920407d46d7ec7f87b20
|
|
5
|
+
|
|
6
|
+
# Les tests, à la plateforme du poste, sans émulation, avec toutes les dépendances, celles de pair
|
|
7
|
+
# de la bibliothèque comprises (React, TanStack, Tailwind, Vite, Vitest) : `npm test` construit la
|
|
8
|
+
# page dans dist/, puis vérifie les types et lance les tests du serveur et de l'écran. L'image prend
|
|
9
|
+
# dist/, le même sur toute plateforme, de cette étape : elle en dépend, et Docker ne la saute jamais.
|
|
10
|
+
FROM --platform=$BUILDPLATFORM $NODE AS tests
|
|
11
|
+
WORKDIR /app
|
|
12
|
+
COPY package.json package-lock.json ./
|
|
13
|
+
RUN npm ci
|
|
14
|
+
COPY . .
|
|
15
|
+
RUN npm test
|
|
16
|
+
|
|
17
|
+
# L'image : le serveur, ses migrations et la page construite, sans aucune dépendance de pair ni de
|
|
18
|
+
# développement.
|
|
19
|
+
FROM $NODE
|
|
20
|
+
WORKDIR /app
|
|
21
|
+
ENV NODE_ENV=production
|
|
22
|
+
COPY package.json package-lock.json ./
|
|
23
|
+
RUN npm ci --omit=dev --omit=peer
|
|
24
|
+
COPY --from=tests /app/manifeste.json /app/GUIDE.md ./
|
|
25
|
+
COPY --from=tests /app/src ./src
|
|
26
|
+
COPY --from=tests /app/migrations ./migrations
|
|
27
|
+
COPY --from=tests /app/dist ./dist
|
|
28
|
+
ARG GIT_SHA
|
|
29
|
+
LABEL org.opencontainers.image.revision=$GIT_SHA
|
|
30
|
+
USER node
|
|
31
|
+
EXPOSE 3000
|
|
32
|
+
HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --start-interval=2s \
|
|
33
|
+
CMD ["node", "-e", "fetch('http://127.0.0.1:3000/sante').then((r) => process.exit(r.ok ? 0 : 1), () => process.exit(1))"]
|
|
34
|
+
CMD ["node", "src/demarrer.ts"]
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# <nom>
|
|
2
|
+
|
|
3
|
+
Une app de l'OS, son propre dépôt, cloné dans `code/<nom>/` du dépôt de l'OS, servie à `https://<domaine>/<nom>`. Elle suit le contrat d'une app, `bibliotheque/CLAUDE.md`.
|
|
4
|
+
|
|
5
|
+
Ce que fait le modèle : des entrées en texte court, à chaque personne les siennes. Deux outils, `ajouter` et `lister` (25 par page), les mêmes pour Claude et pour l'écran « Entrées ».
|
|
6
|
+
|
|
7
|
+
## Le dossier
|
|
8
|
+
|
|
9
|
+
- `manifeste.json` : le nom, le titre, la description, la version, les écrans.
|
|
10
|
+
- `src/` : le serveur (`demarrer.ts`, `serveur.ts`, `outils.ts`) ; `migrations/` : la base ; `essai/poser.sql` : ses données d'essai.
|
|
11
|
+
- `espace/` : la page, en React ; `tests/` : le serveur et l'écran.
|
|
12
|
+
- `GUIDE.md` : le texte d'usage pour Claude ; `DOCUMENTATION.md` et `logo.svg` : pour la personne.
|
|
13
|
+
- `Dockerfile` et `Dockerfile.dockerignore` : l'image, ses tests compris ; `.github/workflows/publier-l-image.yml` la construit à chaque commit de `main` et la pousse sur ghcr.io.
|
|
14
|
+
|
|
15
|
+
## Commandes
|
|
16
|
+
|
|
17
|
+
Dans `code/<nom>/`, où `package.json` cite la bibliothèque, le paquet `@indos/bibliotheque` :
|
|
18
|
+
|
|
19
|
+
```sh
|
|
20
|
+
npm install # la première fois ; commiter package-lock.json
|
|
21
|
+
npm test # la page construite, les types, les tests du serveur et de l'écran
|
|
22
|
+
npm run build # la page dans dist/
|
|
23
|
+
npm start # l'app seule, sur PORT (3000), avec DATABASE_URL, ADRESSE, CORE_ADRESSE
|
|
24
|
+
npm run dev # la page à chaud
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
L'image telle que le kit la construira, sur le seul dossier de l'app, commitée :
|
|
28
|
+
|
|
29
|
+
```sh
|
|
30
|
+
c="$(mktemp -d)" && git archive HEAD | tar -x -C "$c" && docker build --build-arg GIT_SHA=local "$c"; rm -rf "$c"
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Voir l'app en local
|
|
34
|
+
|
|
35
|
+
À la racine du dépôt de l'OS, avec Docker sur le poste (skill `indos-preparer-mon-poste`) :
|
|
36
|
+
|
|
37
|
+
```sh
|
|
38
|
+
npx kit local travailler <nom> # l'OS entier, l'app en direct : son serveur relancé à chaque changement, sa page à chaud
|
|
39
|
+
npx kit local voir # l'OS tel que le serveur le fera tourner, l'app construite avec ses tests
|
|
40
|
+
npx kit local repartir # des bases neuves, avec les données d'essai
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
L'OS est à `http://localhost:8400`, la boîte d'essai à `http://localhost:8401`, avec trois comptes d'essai que `kit local` donne.
|
|
44
|
+
|
|
45
|
+
## Publier
|
|
46
|
+
|
|
47
|
+
Sur une branche du dépôt de l'app ; son clone revient sur `main` pour publier. L'app se publie une fois fusionnée, par la skill `indos-publier-une-app`.
|
|
@@ -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 '../manifeste.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 '../manifeste.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, 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,6 @@
|
|
|
1
|
+
-- Les données d'essai de l'app (@indos/bibliotheque/CLAUDE.md, « Les données d'essai ») : quelques
|
|
2
|
+
-- entrées du propriétaire et de Bob, que kit local pose sur une base neuve.
|
|
3
|
+
insert into entree (auteur, texte) values
|
|
4
|
+
(:'proprietaire', 'Essai : une première entrée du propriétaire'),
|
|
5
|
+
(:'proprietaire', 'Essai : une deuxième entrée du propriétaire'),
|
|
6
|
+
(:'bob', 'Essai : une entrée de Bob');
|
|
@@ -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,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.9 <3"
|
|
8
|
+
},
|
|
9
|
+
"ecrans": [
|
|
10
|
+
{ "nom": "entrees", "titre": "Entrées" }
|
|
11
|
+
]
|
|
12
|
+
}
|
|
@@ -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,20 @@
|
|
|
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
|
+
"dependencies": {
|
|
14
|
+
"@indos/bibliotheque": "0.0.0"
|
|
15
|
+
},
|
|
16
|
+
"devDependencies": {
|
|
17
|
+
"@types/node": "24.19.2",
|
|
18
|
+
"typescript": "7.0.2"
|
|
19
|
+
}
|
|
20
|
+
}
|
|
@@ -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('../manifeste.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 manifeste.json et GUIDE.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
|
+
}
|