@indos/bibliotheque 4.2.0 → 4.4.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 +154 -153
- package/README.md +2 -2
- package/bin/bibliotheque.d.ts +1 -0
- package/bin/bibliotheque.js +63 -0
- package/bin/page-de-l-espace.js +2 -2
- 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 +52 -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 +112 -0
- package/modeles/app-du-client/tsconfig.json +22 -0
- package/package.json +3 -2
- package/src/app.js +4 -4
- package/src/appeler.js +1 -1
- package/src/base-d-essai.d.ts +3 -0
- package/src/base-d-essai.js +17 -1
- package/src/faux-core.js +10 -10
- package/src/flux.js +1 -1
- package/src/liens.js +1 -1
- package/src/mcp.d.ts +3 -0
- package/src/mcp.js +20 -2
- package/src/partage.js +6 -7
- package/src/session.js +3 -4
- package/src/theme.js +1 -1
- package/src/vite.js +33 -22
|
@@ -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]*(-[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
|
@@ -4,8 +4,8 @@
|
|
|
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
|
-
// `INDOS_PORT`, 5173 par défaut, reliée au core de `INDOS_CORE`
|
|
8
|
-
// en local à `INDOS_APP`, à l'écoute de `INDOS_HOTE` (localhost par défaut, `0.0.0.0` dans un conteneur) ;
|
|
7
|
+
// `INDOS_PORT`, 5173 par défaut, reliée au core de `INDOS_CORE` (pour le core, le core lancé en
|
|
8
|
+
// local) et, pour une app, à l'app lancée 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);
|
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 la CI du dépôt 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 : 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,52 @@
|
|
|
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
|
+
titre: 'Ajouter une entrée',
|
|
15
|
+
sorte: 'ecriture',
|
|
16
|
+
description: 'Ajoute une entrée, un texte court de 500 caractères au plus, à celles de la personne. Rend l\'entrée ajoutée.',
|
|
17
|
+
schema: {
|
|
18
|
+
type: 'object',
|
|
19
|
+
properties: { texte: { type: 'string', minLength: 1, maxLength: 500, description: 'Le texte de l\'entrée.' } },
|
|
20
|
+
required: ['texte'],
|
|
21
|
+
},
|
|
22
|
+
executer: async ({ texte }, personne) => {
|
|
23
|
+
const { rows: [entree] } = await base.query<Entree>(
|
|
24
|
+
'insert into entree (auteur, texte) values ($1, $2) returning id, texte, cree_le',
|
|
25
|
+
[personne.id, String(texte).trim()],
|
|
26
|
+
);
|
|
27
|
+
return JSON.stringify(entree);
|
|
28
|
+
},
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
nom: 'lister',
|
|
32
|
+
titre: 'Lister ses entrées',
|
|
33
|
+
sorte: 'lecture',
|
|
34
|
+
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.',
|
|
35
|
+
schema: {
|
|
36
|
+
type: 'object',
|
|
37
|
+
properties: { page: { type: 'integer', minimum: 1, description: 'La page de la liste, à partir de 1 ; 1 sans elle.' } },
|
|
38
|
+
},
|
|
39
|
+
executer: async ({ page }, personne) => {
|
|
40
|
+
const rang = typeof page === 'number' ? page : 1;
|
|
41
|
+
const [lignes, total] = await Promise.all([
|
|
42
|
+
base.query<Entree>(
|
|
43
|
+
'select id, texte, cree_le from entree where auteur = $1 order by cree_le desc, id limit $2 offset $3',
|
|
44
|
+
[personne.id, lignesParPage, (rang - 1) * lignesParPage],
|
|
45
|
+
),
|
|
46
|
+
base.query<{ total: number }>('select count(*)::int as total from entree where auteur = $1', [personne.id]),
|
|
47
|
+
]);
|
|
48
|
+
return JSON.stringify({ lignes: lignes.rows, total: total.rows[0].total });
|
|
49
|
+
},
|
|
50
|
+
},
|
|
51
|
+
];
|
|
52
|
+
}
|
|
@@ -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; // manifeste.json, que l'image porte : son nom, sa version, ses écrans
|
|
15
|
+
instructions: string; // GUIDE.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 de l'OS, 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,58 @@
|
|
|
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 { ecrans as ecransDuManifeste, nom, titre } from '../../manifeste.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: ecransDuManifeste })], { 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
|
+
// Chaque onglet porte le titre de son écran : celui des entrées, actif, est le `<h1>` de la ligne
|
|
20
|
+
// du haut.
|
|
21
|
+
expect((await screen.findByRole('heading', { level: 1 })).textContent).toBe('Entrées');
|
|
22
|
+
await screen.findByText('Appeler le notaire');
|
|
23
|
+
expect(screen.getByText('28.10.2026 10:00')).toBeTruthy();
|
|
24
|
+
expect(appels).toContainEqual({ chemin: `/${nom}/outils/lister`, methode: 'POST', corps: { page: 2 } });
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
test('ajouter une entrée appelle l\'outil, puis relit la liste', async () => {
|
|
28
|
+
const entrees: { id: string; texte: string; cree_le: string }[] = [];
|
|
29
|
+
const appels = servir({
|
|
30
|
+
'/espace/session': () => [200, ada],
|
|
31
|
+
[`/${nom}/outils/ajouter`]: (corps) => {
|
|
32
|
+
const entree = { id: `e${entrees.length + 1}`, texte: String(corps.texte), cree_le: '2026-10-28T09:00:00.000Z' };
|
|
33
|
+
entrees.unshift(entree);
|
|
34
|
+
return [200, resultat(entree)];
|
|
35
|
+
},
|
|
36
|
+
[`/${nom}/outils/lister`]: () => [200, resultat({ lignes: entrees, total: entrees.length })],
|
|
37
|
+
});
|
|
38
|
+
ouvrirLaPage(chemin, ecrans);
|
|
39
|
+
await screen.findByText('Aucune entrée.');
|
|
40
|
+
await userEvent.type(screen.getByLabelText('Nouvelle entrée'), 'Relancer le devis');
|
|
41
|
+
await userEvent.click(screen.getByRole('button', { name: 'Ajouter' }));
|
|
42
|
+
await screen.findByText('Relancer le devis');
|
|
43
|
+
expect(appels).toContainEqual({ chemin: `/${nom}/outils/ajouter`, methode: 'POST', corps: { texte: 'Relancer le devis' } });
|
|
44
|
+
expect((screen.getByLabelText('Nouvelle entrée') as HTMLInputElement).value).toBe('');
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
test('un ajout refusé se lit sous le champ, mot pour mot', async () => {
|
|
48
|
+
servir({
|
|
49
|
+
'/espace/session': () => [200, ada],
|
|
50
|
+
[`/${nom}/outils/ajouter`]: () => [422, resultat('Le texte est trop long.', true)],
|
|
51
|
+
[`/${nom}/outils/lister`]: () => [200, resultat({ lignes: [], total: 0 })],
|
|
52
|
+
});
|
|
53
|
+
ouvrirLaPage(chemin, ecrans);
|
|
54
|
+
await screen.findByText('Aucune entrée.');
|
|
55
|
+
await userEvent.type(screen.getByLabelText('Nouvelle entrée'), 'Trop long');
|
|
56
|
+
await userEvent.click(screen.getByRole('button', { name: 'Ajouter' }));
|
|
57
|
+
expect((await screen.findByRole('alert')).textContent).toContain('Le texte est trop long.');
|
|
58
|
+
});
|