@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
package/CLAUDE.md
CHANGED
|
@@ -2,54 +2,39 @@
|
|
|
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 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
|
-
|
|
7
|
-
## Commandes
|
|
8
|
-
|
|
9
|
-
```sh
|
|
10
|
-
# dans ind-os/sources, depuis bibliotheque/, avant toute app du catalogue
|
|
11
|
-
npm ci
|
|
12
|
-
# depuis la racine du dépôt d'un OS : créer une app du client à partir du modèle
|
|
13
|
-
node bibliotheque/bin/bibliotheque.ts creer-une-app <nom>
|
|
14
|
-
# depuis le dossier de l'app (apps/<nom>/ ou code/<nom>/)
|
|
15
|
-
npm install # la première fois, puis commiter package-lock.json
|
|
16
|
-
npm test # construit la page, vérifie les types, tests de Node puis de la page
|
|
17
|
-
npm run build # la page dans dist/
|
|
18
|
-
npm run dev # la page à chaud sur localhost:5173
|
|
19
|
-
```
|
|
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 (`apps/CLAUDE.md`) ; 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 »).
|
|
20
6
|
|
|
21
7
|
## La forme d'une app
|
|
22
8
|
|
|
23
9
|
Le dossier de l'app porte :
|
|
24
10
|
|
|
25
11
|
- `manifeste.json` :
|
|
26
|
-
- `nom` : celui du dossier, `^[a-z][a-z0-9-]
|
|
27
|
-
- `titre` ; `description`, la phrase de sa carte, pour
|
|
28
|
-
- `dependances` :
|
|
12
|
+
- `nom` : celui du dossier, en minuscules, chiffres et tirets simples (`^[a-z][a-z0-9]*(-[a-z0-9]+)*$`), son chemin `https://<domaine>/<nom>` et son entrée dans `os.json`. Il ne prend ni un chemin du core ni le nom d'une app d'Indos, et ne change plus une fois l'app installée.
|
|
13
|
+
- `titre` ; `description`, la phrase de sa carte, pour la personne, sans mot technique ; `famille`, facultative ; `version`, `<majeure>.<mineure>.<correctif>`.
|
|
14
|
+
- `dependances` : pour chaque pièce que l'app demande, dont le core, une borne `>=a.b[.c]`, suivie ou non de ` <x[.y[.z]]` : `"core": ">=2.9 <3"` pour une app à page. Le kit refuse de poser l'app sur un core qui ne tient pas sa borne, et de monter le core au-delà.
|
|
29
15
|
- `appelle` : les apps dont elle appelle les outils (`["fichiers"]`). Une app appelée n'est pas une dépendance : sans elle, l'app dit ce qu'elle n'a pas pu faire.
|
|
30
16
|
- `pour`, `ecrans`, `reglages` (« Qui ouvre une app », « Les pages d'une app »).
|
|
31
17
|
- Une app du client ne déclare pas `sousDomaine` : le kit le refuse.
|
|
32
18
|
- `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 ;
|
|
34
|
-
- elle ne prend aucun fichier de `bibliotheque/tests/`, absent chez un client (la CI le vérifie) ;
|
|
19
|
+
- 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 ;
|
|
35
20
|
- l'étape `tests` lance `npm test` et l'image prend `dist/` de cette étape : un test qui échoue arrête la construction ;
|
|
36
|
-
-
|
|
37
|
-
-
|
|
21
|
+
- l'image de Node est citée par sa version et son empreinte ; un seul `EXPOSE`, `USER node` ;
|
|
22
|
+
- une app du client a de plus un `HEALTHCHECK` sur `/sante`, et ses étapes de tests à la plateforme du poste (`FROM --platform=$BUILDPLATFORM <image de Node>`), l'image à celle du serveur.
|
|
38
23
|
- `package.json` et `package-lock.json` : un paquet autonome, chaque outil à une version exacte, sans espace de travail npm. Le serveur est en TypeScript exécuté par Node, sans build.
|
|
39
24
|
- `src/` (le serveur), `migrations/` (`.sql`), `tests/`, `espace/` (la page), `dist/` (hors de git).
|
|
40
25
|
- `GUIDE.md` : le texte d'usage pour Claude, les instructions MCP de l'app. Son premier paragraphe la présente dans les instructions du core ; le texte entier est rendu par l'outil `guide` du core.
|
|
41
26
|
- `DOCUMENTATION.md`, facultatif : pour la personne, rendu à `/documentation/<nom>` en Markdown restreint (`##`, `###`, paragraphes, listes, étapes, gras, code, liens).
|
|
42
27
|
- `logo.svg`, facultatif : 24×24, l'objet en graphite `currentColor`, en formes simples, le geste de l'agent tracé à la main au jaune `#F0B429` (entouré, coche, gribouillis, souligné, flèche), le même geste pour une même fonction. Sans logo, la carte porte l'initiale du titre.
|
|
43
28
|
|
|
44
|
-
Une app écoute sur `PORT`, répond 200 sur `GET /sante`, s'arrête en huit secondes au plus sur `docker stop`, et garde tout dans sa base, sans volume. Elle reçoit `DATABASE_URL`, `CLE` (32 octets en base64), `ADRESSE` (`https://<domaine>/<nom>`), `CORE_ADRESSE` et `CLE_D_APPEL`.
|
|
29
|
+
Une app écoute sur `PORT`, répond 200 sur `GET /sante`, s'arrête en huit secondes au plus sur `docker stop`, et garde tout dans sa base ou au bucket de l'OS, sans volume. Elle reçoit `DATABASE_URL`, `CLE` (32 octets en base64), `ADRESSE` (`https://<domaine>/<nom>`), `CORE_ADRESSE` et `CLE_D_APPEL`.
|
|
45
30
|
|
|
46
|
-
Ce que le kit lit d'une app du client, au commit publié et poussé, jamais depuis les fichiers du poste : son dépôt
|
|
31
|
+
Ce que le kit lit d'une app du client, au commit publié et poussé, jamais depuis les fichiers du poste : son `manifeste.json`, son `logo.svg`, sa `DOCUMENTATION.md`, et l'image que la CI de son dépôt a poussée pour ce commit. Il refuse un manifeste dont le `nom` n'est pas celui de l'app ou qui déclare `sousDomaine`, et une image sans `HEALTHCHECK` ou qui n'expose pas un seul port.
|
|
47
32
|
|
|
48
|
-
|
|
33
|
+
### Qui ouvre une app
|
|
49
34
|
|
|
50
35
|
Le core tient l'accès à une app. Sans `pour`, elle s'ouvre à toute l'équipe à sa première déclaration ; `"pour": "proprietaire"` la ferme au propriétaire seul jusqu'à ce qu'il l'ouvre dans « Équipe ». Une montée ne change pas ce réglage. Une app fermée à une personne n'existe pas pour elle : ni barre, ni outils, ni `/outils`, et ses pages lui répondent introuvables. L'app ne refait pas ce contrôle. Dans une app ouverte, `pour` sur un outil ou un écran réserve ce geste au propriétaire.
|
|
51
36
|
|
|
52
|
-
|
|
37
|
+
### Les pages d'une app
|
|
53
38
|
|
|
54
39
|
- `ecrans` : `[{ nom, titre, pour }]`, dans l'ordre de la barre et des onglets. `nom` est le chemin sous l'app : non vide, sans `/` au début ni à la fin, sans segment vide, `.`, `..`, espace, `?`, `#`, `\` ni `%` ; son premier segment n'est ni `reglages`, `outils`, `mcp`, `sante` ni `espace`. `pour: "proprietaire"` : le core ne le montre qu'au propriétaire, l'app reste juge sur sa page.
|
|
55
40
|
- `reglages: true`, ou `{ "pour": "proprietaire" }` : l'écran `/<app>/reglages`. Celui d'une app à comptes branchés est `EcranDesComptes`.
|
|
@@ -57,7 +42,23 @@ Le core tient l'accès à une app. Sans `pour`, elle s'ouvre à toute l'équipe
|
|
|
57
42
|
- Les scripts et les feuilles sont servis par l'app, de son chemin : aucun script en ligne, jamais un script qu'elle n'a pas écrit.
|
|
58
43
|
- Une page sans coquille se sert sous le chemin de l'app sans rien déclarer.
|
|
59
44
|
|
|
60
|
-
|
|
45
|
+
### Comment une app s'en sert
|
|
46
|
+
|
|
47
|
+
Une app du client cite le paquet publié à une version exacte : `"@indos/bibliotheque": "<version>"`. npm installe ses dépendances d'exécution et ses dépendances de pair (React, TanStack, Tailwind, Vite, Vitest, leurs types) ; l'image ne garde aucune dépendance de pair (`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.
|
|
48
|
+
|
|
49
|
+
### Une app du client
|
|
50
|
+
|
|
51
|
+
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 sa forme (« La forme d'une app »), et se lance avant toute installation.
|
|
52
|
+
|
|
53
|
+
Les gestes sont ceux du kit, par ses skills `indos-creer-une-app` et `indos-publier-une-app`. 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` (`kit publier <app>`) : ni `os.json` ni `apps/` ne se modifient à la main.
|
|
54
|
+
|
|
55
|
+
### La note des versions
|
|
56
|
+
|
|
57
|
+
`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.
|
|
58
|
+
|
|
59
|
+
## Le serveur
|
|
60
|
+
|
|
61
|
+
### Le démarrage et l'arrêt d'une app
|
|
61
62
|
|
|
62
63
|
`src/demarrer.ts` est un appel à `demarrerLApp({ dossier, migrations, traiter, chemin })` (`@indos/bibliotheque/app`), sur le modèle de `modeles/app-du-client/src/demarrer.ts`.
|
|
63
64
|
|
|
@@ -68,29 +69,33 @@ Le core tient l'accès à une app. Sans `pour`, elle s'ouvre à toute l'équipe
|
|
|
68
69
|
- Une erreur d'un traitement s'écrit au journal ; la requête reçoit la page simple en 500 pour une navigation, `{ "erreur": … }` en 500 sinon.
|
|
69
70
|
- Sur `SIGTERM` ou `SIGINT` : le serveur cesse d'accepter, flux et connexions se coupent, puis `avantDeQuitter` écrit les choses ouvertes. Aucune requête ne reçoit de réponse pendant ou après `avantDeQuitter` : une écriture confirmée est une écriture qu'il enregistre. Au-delà de huit secondes, l'app quitte en échec.
|
|
70
71
|
|
|
71
|
-
|
|
72
|
+
### Les entrées de la bibliothèque
|
|
72
73
|
|
|
73
|
-
Une entrée de `exports` par fonction (`package.json`), nommée par ce qu'elle fait : `@indos/bibliotheque/<entrée>`. Le serveur est dans les `.ts` de la racine de `src/`, le navigateur dans `src/ui/` et `src/
|
|
74
|
+
Une entrée de `exports` par fonction (`package.json`), nommée par ce qu'elle fait : `@indos/bibliotheque/<entrée>`. Le serveur est dans les `.ts` de la racine de `src/`, le navigateur dans `src/ui/`, `src/espace/` et `src/direct/page.ts`.
|
|
74
75
|
|
|
75
|
-
- Le code que l'image lance n'importe aucune dépendance de développement : `faux-core`, `base-d-essai`, `espace-d-essai`, `src/vite.ts` et le code du navigateur restent hors des autres entrées du serveur.
|
|
76
76
|
- `deriver(cle, contexte)` (HKDF-SHA256, 32 octets) et les liens signés de `liens` (`signerUnLien(cle, sorte, charge)`, dix minutes, rien en base) ont des formats figés : le kit refait la même dérivation sans importer la bibliothèque, et un lien déjà donné se lit toujours.
|
|
77
77
|
- Des octets servis en pièce jointe prennent `enTetesDUnTelechargement` (`sandbox`, `nosniff`).
|
|
78
78
|
- `identifiant(id)` rend l'UUID en minuscules, ou rien : l'app répond alors « absente » sans demander à la base.
|
|
79
79
|
- Le type d'un fichier qui entre se lit par `typeDuFichier`.
|
|
80
80
|
- Le jeton du core (`jeton`) est vérifié en Ed25519 seul, pour l'app visée, une minute.
|
|
81
81
|
|
|
82
|
-
|
|
82
|
+
### Le MCP d'une app
|
|
83
83
|
|
|
84
|
-
`creerLeMcp({ app, version, instructions, outils, adresse })` sert `/mcp` (Streamable HTTP sans état) et `POST /outils/<nom>`. Chaque outil déclare son schéma d'entrée et, s'il n'est pas pour tous, `pour`. Le jeton du core se vérifie à chaque requête (401 sinon, 503 sans `CORE_ADRESSE` ou si le core ne répond pas) ; l'app ne montre et n'exécute que les outils permis à la personne. Des arguments hors schéma donnent un résultat en erreur.
|
|
84
|
+
`creerLeMcp({ app, version, instructions, outils, adresse, adresseDuCore })` sert `/mcp` (Streamable HTTP sans état) et `POST /outils/<nom>`. Chaque outil déclare son schéma d'entrée et, s'il n'est pas pour tous, `pour`. Le jeton du core se vérifie à chaque requête (401 sinon, 503 sans `CORE_ADRESSE` ou si le core ne répond pas) ; l'app ne montre et n'exécute que les outils permis à la personne. Des arguments hors schéma donnent un résultat en erreur.
|
|
85
85
|
|
|
86
|
+
- Chaque outil déclare son `titre`, court, à l'infinitif, dans les mots de la personne (« Supprimer un lien »), et sa `sorte` (`SorteDUnOutil`), que `tools/list` rend en `title` et en annotations MCP, d'où le client de Claude range les outils et décide de l'accord :
|
|
87
|
+
- `lecture`, il ne change rien : `readOnlyHint: true` ;
|
|
88
|
+
- `ecriture`, il crée ou modifie, et cela se reprend : `readOnlyHint: false`, `destructiveHint: false` ;
|
|
89
|
+
- `definitif`, il supprime, émet, envoie, publie, élargit un partage ou donne : `readOnlyHint: false`, `destructiveHint: true`.
|
|
90
|
+
Un outil qui porte plusieurs gestes déclare la sorte la plus forte. Un outil sans titre ni sorte se liste sans `title` ni annotations.
|
|
86
91
|
- Un geste définitif (supprimer, publier, émettre, annuler) prend `confirmer: true` ; sans lui, un `Refus` qui dit quoi demander à la personne.
|
|
87
92
|
- Un argument manquant ou un choix à faire est un refus qui nomme les choix (« Préciser `compte` parmi : … ») ; un choix unique se prend sans demander.
|
|
88
93
|
|
|
89
|
-
|
|
94
|
+
#### Un écran appelle ses outils
|
|
90
95
|
|
|
91
96
|
L'app route `POST /outils/<nom>` vers `creerLeMcp`, comme `/mcp`. Les contrôles d'un geste d'écran s'appliquent (méthode, `Origin`, personne, corps), puis : outil hors de portée 403, inconnu 404, arguments hors schéma 400, refus 422 avec son texte, échec 500 sans sa cause, sinon 200 et le résultat MCP. L'outil reçoit la personne de la session, ses groupes compris.
|
|
92
97
|
|
|
93
|
-
|
|
98
|
+
### Un refus
|
|
94
99
|
|
|
95
100
|
Un outil qui ne fait pas ce qu'on lui demande ne rend jamais un succès.
|
|
96
101
|
|
|
@@ -99,30 +104,23 @@ Un outil qui ne fait pas ce qu'on lui demande ne rend jamais un succès.
|
|
|
99
104
|
- Un geste qui rattrape une erreur pour la reformuler laisse passer un `Refus` tel quel.
|
|
100
105
|
- `appeler` rend le résultat d'une autre app sans lever : `isError` dit qu'il n'a pas abouti, `estUnRefus` que c'est un refus. L'app qui appelle en fait un échec à elle, par `Error`, en citant le texte reçu.
|
|
101
106
|
|
|
102
|
-
|
|
107
|
+
### Un outil qui montre une image
|
|
103
108
|
|
|
104
109
|
`executer` rend un texte ou un contenu MCP `{ content: [...] }` (`ResultatDOutil`), texte et images en base64, passé tel quel. Un écran n'en lit que le texte (`texteDe`). Un fichier entre et sort par un lien de dix minutes : seule une image réduite passe par MCP.
|
|
105
110
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
`enTransaction(base, geste, { verrou })` : tout ou rien, `geste(client)` lit et écrit par `client`, jamais par le pool, qui peut n'avoir qu'une connexion. Une erreur annule tout et passe telle quelle. `verrou`, une clé ou une liste, se prend d'abord, plusieurs clés dans l'ordre de leur nom ; c'est `pg_advisory_xact_lock(hashtextextended(<clé>, 0))`, la même clé que prend un déclencheur de la base pour la même chose.
|
|
109
|
-
|
|
110
|
-
## La recherche sans accents
|
|
111
|
-
|
|
112
|
-
Un texte cherché ignore accents et casse, par la même normalisation en SQL (`sansAccentsEnSql(expression)`, `motifSansAccents(texte)` pour `like`) et en JavaScript (`sansAccents`). L'expression SQL est écrite par l'app, jamais par la personne. La base est en UTF-8.
|
|
113
|
-
|
|
114
|
-
## Les formats
|
|
111
|
+
### Les gestes d'écran
|
|
115
112
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
- `jour` (« 28.10.2026 »), `jourEtHeure`, `tempsEcoule`, `nombre` (« 1'234 »).
|
|
119
|
-
- `montant` (« CHF 12'400.00 ») et `montantRond` écrivent « **** » quand la page masque les montants ; `montantEnClair` ne masque jamais, pour un formulaire et la question d'un geste. Un serveur ne masque jamais.
|
|
113
|
+
Un geste d'écran est un appel de la page à sa pièce, en JSON, avec la session : l'appel d'un outil, ou un geste que Claude ne doit pas voir (un secret), `POST /<app>/espace/<geste>`, sans extension, routé avant `/espace/…`. Il ne passe ni par le core ni par son journal. `traiterUnGesteDEcran(requete, reponse, { origine, personneDe, executer })` vérifie dans l'ordre :
|
|
120
114
|
|
|
121
|
-
|
|
115
|
+
1. la méthode : 405 hors de `POST` ;
|
|
116
|
+
2. l'`Origin`, celle de la page : 403, avant toute question au core ;
|
|
117
|
+
3. la personne (`personneDuGeste`) : 401 sans session, 403 si l'app lui est fermée, 503 si le core ne répond pas ;
|
|
118
|
+
4. le corps : 415 hors de JSON, 413 au-delà de 4 Mio, 400 si ce n'est pas un objet ;
|
|
119
|
+
5. `executer` : 200 et sa valeur ; un `Refus` en 422 avec son texte ; toute autre erreur en 500 sans sa cause, écrite au journal de l'app.
|
|
122
120
|
|
|
123
|
-
|
|
121
|
+
`executer` n'écrit jamais la réponse lui-même. Un fichier passe en base64 dans le corps (`fichierEnBase64`).
|
|
124
122
|
|
|
125
|
-
|
|
123
|
+
### Les fichiers
|
|
126
124
|
|
|
127
125
|
Une app qui dépose un fichier dans les fichiers d'une personne, ou en lit un, passe par `@indos/bibliotheque/fichiers`, déclare `appelle: ["fichiers"]` et lui donne l'appel de `creerLAppel`. Aucun octet ne passe par l'appel : `televerser` et `telecharger` rendent un lien signé de dix minutes.
|
|
128
126
|
|
|
@@ -131,28 +129,33 @@ Une app qui dépose un fichier dans les fichiers d'une personne, ou en lit un, p
|
|
|
131
129
|
- L'app lit la fiche pour ses propres règles avant les octets : la taille contre son plafond, `publie` avant de montrer le fichier à d'autres.
|
|
132
130
|
- Le refus de fichiers lève `RefusDeFichiers`, qui ne dérive pas de `Refus` : c'est un échec de l'app qui appelle. Elle l'enveloppe dans son erreur, qui dit ce qu'elle n'a pas fait et que le reste marche.
|
|
133
131
|
|
|
134
|
-
|
|
132
|
+
### Les transactions
|
|
135
133
|
|
|
136
|
-
|
|
134
|
+
`enTransaction(base, geste, { verrou })` : tout ou rien, `geste(client)` lit et écrit par `client`, jamais par le pool, qui peut n'avoir qu'une connexion. Une erreur annule tout et passe telle quelle. `verrou`, une clé ou une liste, se prend d'abord, plusieurs clés dans l'ordre de leur nom ; c'est `pg_advisory_xact_lock(hashtextextended(<clé>, 0))`, la même clé que prend un déclencheur de la base pour la même chose.
|
|
137
135
|
|
|
138
|
-
|
|
136
|
+
### La recherche sans accents
|
|
139
137
|
|
|
140
|
-
|
|
138
|
+
Un texte cherché ignore accents et casse, par la même normalisation en SQL (`sansAccentsEnSql(expression)`, `motifSansAccents(texte)` pour `like`) et en JavaScript (`sansAccents`). L'expression SQL est écrite par l'app, jamais par la personne. La base est en UTF-8.
|
|
141
139
|
|
|
142
|
-
|
|
140
|
+
### Les formats
|
|
143
141
|
|
|
144
|
-
`
|
|
142
|
+
`@indos/bibliotheque/format`, jamais `Intl` ni `toLocaleString` : l'écran, un PDF et un courrier écrivent la même chose. Les jours et les heures sont à l'heure de `Europe/Zurich` ; les milliers prennent l'apostrophe droite.
|
|
143
|
+
|
|
144
|
+
- `jour` (« 28.10.2026 »), `jourEtHeure`, `tempsEcoule`, `nombre` (« 1'234 »).
|
|
145
|
+
- `montant` (« CHF 12'400.00 ») et `montantRond` écrivent « **** » quand la page masque les montants ; `montantEnClair` ne masque jamais, pour un formulaire et la question d'un geste. Un serveur ne masque jamais.
|
|
146
|
+
|
|
147
|
+
### La pagination
|
|
145
148
|
|
|
146
|
-
|
|
149
|
+
Un outil ou un geste paginé reçoit `page`, un entier à partir de 1 (1 s'il manque), et rend `{ "lignes": [...], "total": <nombre> }`, 25 lignes au plus (`lignesParPage`). Une page au-delà du total rend des lignes vides et le total.
|
|
147
150
|
|
|
148
|
-
|
|
151
|
+
## Les choses
|
|
149
152
|
|
|
150
|
-
|
|
153
|
+
### Le partage
|
|
151
154
|
|
|
152
|
-
Une chose est toujours à une personne et s'ouvre à des personnes, à des groupes ou à toute l'équipe, en lecture ou en modification. Le core tient l'accès à l'app ; l'app tient le partage de ses choses dans sa base, par `@indos/bibliotheque/partage`. Les groupes viennent du jeton et de la session, signés par le core. Le propriétaire de l'OS ouvre toute app, pas toute chose, sauf dans une app qui déclare `auProprietaireDeLOS`.
|
|
155
|
+
Une chose est toujours à une personne et s'ouvre à des personnes, à des groupes ou à toute l'équipe, en lecture ou en modification. Le core tient l'accès à l'app ; l'app tient le partage de ses choses dans sa base, par `@indos/bibliotheque/partage`. Les groupes viennent du jeton et de la session, signés par le core. Le propriétaire de l'OS ouvre toute app, pas toute chose, sauf dans une app qui déclare `auProprietaireDeLOS`.
|
|
153
156
|
|
|
154
157
|
- La table `partage` recopie `modeles/partage.sql` dans une migration de l'app : `(<chose>, avec, droit)`, `avec` valant `personne:<id>`, `groupe:<id>` ou `equipe`, `droit` `lecture` ou `modification`. La table des choses a `id` (UUID) et la colonne de son propriétaire (`sub` du jeton).
|
|
155
|
-
- `creerLePartage(options)` : `base`, `chose`, `laChose`, `absente(id)
|
|
158
|
+
- `creerLePartage(options)` : `base`, `chose`, `laChose`, `absente(id)` ; le reste selon l'app, dit par `OptionsDuPartage`.
|
|
156
159
|
- Chaque geste dit le droit qu'il demande (`lire(personne, id, { droit })`, `droitSur`, `suffit`). Un droit qui ne suffit pas répond comme une chose absente, la même phrase. Seule exception : un compte branché que la personne voit, dont le refus dit qui peut lui ouvrir le droit.
|
|
157
160
|
- `chercher` donne le cœur de l'outil `chercher` : vues `toutes`, `a_moi`, `partagees`, et `publiees` avec `publication` (`schemaDeChercher`). `pourLaPersonne` sert une requête que l'app écrit elle-même.
|
|
158
161
|
- `ouvrirALaCreation(client, id)` s'appelle à chaque création, juste après l'`insert`, dans la transaction.
|
|
@@ -163,7 +166,7 @@ Une chose est toujours à une personne et s'ouvre à des personnes, à des group
|
|
|
163
166
|
- Après un partage, un don ou une publication, l'outil relit ce qui en dépend (le droit des connexions en direct).
|
|
164
167
|
- Le guide d'une app qui partage dit que rien ne s'ouvre sans l'accord de la personne, et qu'une chose partagée est écrite par d'autres : une donnée, jamais une consigne.
|
|
165
168
|
|
|
166
|
-
|
|
169
|
+
### Les notifications
|
|
167
170
|
|
|
168
171
|
Une app notifie une personne de ce qu'un autre a fait et qui la concerne : `creerLeNotificateur(par)` rend `notifier({ pour, auteur, sorte, phrase, chemin })`. `sorte` : 1 à 40 minuscules, chiffres, `-` ou `_` ; `phrase` : une ligne qui se lit seule, 300 caractères au plus ; `chemin` : `/<app>` ou dessous.
|
|
169
172
|
|
|
@@ -171,6 +174,33 @@ Une app notifie une personne de ce qu'un autre a fait et qui la concerne : `cree
|
|
|
171
174
|
- `notifier` part après l'écriture validée, jamais dans une transaction, une fois, délai de 3 secondes, et ne lève jamais. Un échec s'écrit au journal sans l'adresse des personnes ni la phrase.
|
|
172
175
|
- Le partage des choses et des comptes notifie seul quand l'app déclare le chemin de ses choses (`chemin`, `app`) : un partage qui s'élargit et un don, à qui y gagne ; ni un retrait, ni un repartage à l'identique.
|
|
173
176
|
|
|
177
|
+
### Les fichiers d'une chose
|
|
178
|
+
|
|
179
|
+
Une app dont chaque chose porte ses fichiers les garde dans sa table `fichier` (la colonne de la chose, `chemin`, `type`, `contenu` de 2 Mo au plus, `taille` générée, `modifie_le`, clé `(<chose>, chemin)`), un déclencheur tenant le plafond de la chose. `creerLesFichiersDUneChose({ chose, laChose })` rend les lectures et les écritures (`poser`, `copier`, `retirer`), qui passent par `enTransaction` sous le verrou de la chose. Un chemin : des segments de lettres, chiffres, `.`, `_`, `-`, aucun ne commençant par un point ou un tiret, 300 caractères au plus (`estUnChemin`).
|
|
180
|
+
|
|
181
|
+
### Les remplacements
|
|
182
|
+
|
|
183
|
+
`appliquerLesRemplacements(contenu, [{ avant, apres }])` applique tout ou rien : un « avant » absent ou présent plusieurs fois lève une erreur qui montre le passage le plus proche. `schemaDesRemplacements` : 1 à 100. L'app les applique à ce qu'elle lit sous le verrou de la chose, dans la transaction qui écrit.
|
|
184
|
+
|
|
185
|
+
### Les signaux d'une chose
|
|
186
|
+
|
|
187
|
+
`creerLesSignaux<Quoi>()` rend `signaler(id, quoi)` et `ecouter(id, rappel)`. Les signaux vivent en mémoire de l'app : toute écriture d'une chose passe par elle et donne son signal.
|
|
188
|
+
|
|
189
|
+
### Un flux d'événements
|
|
190
|
+
|
|
191
|
+
`ouvrirUnFlux(requete, reponse, { duree, entetes })` : `text/event-stream`, un battement toutes les 25 secondes, qui garde la connexion ouverte à travers le proxy. Il se ferme à `duree`, quand la page part, quand plus d'un Mio attend, et à l'arrêt de l'app ; `surLaFermeture(geste)` défait ce que l'app a posé (un écouteur, une présence).
|
|
192
|
+
|
|
193
|
+
### Le direct Yjs
|
|
194
|
+
|
|
195
|
+
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.
|
|
196
|
+
|
|
197
|
+
- Une seule copie de Yjs, celle de la bibliothèque : une app du client ne cite ni `yjs` ni `y-protocols`, et aucune app ne cite Hocuspocus.
|
|
198
|
+
- 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`.
|
|
199
|
+
- 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.
|
|
200
|
+
- `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).
|
|
201
|
+
- `ecrire(chose, geste, { avant, garder })`, une écriture de Claude, passe à côté du contrôle, ce que l'outil a vérifié avant ; un état qui passerait la `limite` n'écrit rien.
|
|
202
|
+
- `fermer()` dans `avantDeQuitter`.
|
|
203
|
+
|
|
174
204
|
## Un compte branché
|
|
175
205
|
|
|
176
206
|
L'accès d'une personne à un service extérieur (une boîte mail, un agenda, un carnet, un kDrive), gardé dans une table de l'app, son secret chiffré. Claude ne voit jamais le secret, ni personne d'autre que qui l'a branché. La bibliothèque donne le chiffrement, le secret gardé, les gestes d'écran, l'écran commun et le partage ; l'app garde la table, la vérification des valeurs et l'essai du compte auprès du service.
|
|
@@ -185,7 +215,7 @@ L'accès d'une personne à un service extérieur (une boîte mail, un agenda, un
|
|
|
185
215
|
|
|
186
216
|
### Les gestes des comptes
|
|
187
217
|
|
|
188
|
-
`creerLesGestesDesComptes(
|
|
218
|
+
`creerLesGestesDesComptes(options)` (`@indos/bibliotheque/compte`) sert `/espace/comptes/<geste>` (`decrire`, `lister`, `brancher`, `modifier`, `retirer`, et avec `partage` : `partage`, `partager`, `ne-plus-partager`, `donner`), chacun par `traiterUnGesteDEcran`. L'app le route avant `/espace/…`. Le contrat est typé dans `src/description-des-comptes.ts`.
|
|
189
219
|
|
|
190
220
|
- Un secret ne revient dans aucune réponse : `lister` retire tout champ `secret`.
|
|
191
221
|
- Les gestes de l'app ne voient que les comptes de la personne : `modifier` et `retirer` gardent leur `where proprietaire = $1`.
|
|
@@ -196,15 +226,15 @@ L'accès d'une personne à un service extérieur (une boîte mail, un agenda, un
|
|
|
196
226
|
|
|
197
227
|
### L'écran des comptes
|
|
198
228
|
|
|
199
|
-
`EcranDesComptes` (`@indos/bibliotheque/espace`), déclaré à la route `/<app>/reglages`, se dessine depuis `decrire` et `lister`. L'app déclare ses `textes` (
|
|
229
|
+
`EcranDesComptes` (`@indos/bibliotheque/espace`), déclaré à la route `/<app>/reglages`, se dessine depuis `decrire` et `lister`. L'app déclare ses `textes` (dont `presentation`, en deux phrases : ce que Claude fait avec ces comptes, puis qui les voit) et ses `champs`. Une route de l'app qui ramène à l'écran passe `?fait=<code>`, un code de `faits` ; aucun texte ne vient de l'adresse.
|
|
200
230
|
|
|
201
231
|
### Le partage des comptes
|
|
202
232
|
|
|
203
|
-
`creerLePartageDesComptes(
|
|
233
|
+
`creerLePartageDesComptes(options)` donne à la table des comptes le partage de toute chose ; `comptesVisibles`, `choisirLeCompte(personne, compte, { droit, aucun })`, `personneDuLien`, `quiRebranche`. La lecture consulte, la modification agit aussi, la propriété seule modifie le branchement, le retire, le partage, le donne et publie un lien chez le fournisseur ; le propriétaire de l'OS n'a aucun droit de plus. Partager et donner un compte ne sont que des gestes d'écran : aucun outil ne les offre. Au départ d'une personne, `donner_les_choses` ne passe que les comptes ouverts à quelqu'un et `donnable`.
|
|
204
234
|
|
|
205
235
|
## La page de l'espace
|
|
206
236
|
|
|
207
|
-
Une app à page a sa page en React dans `espace/`, construite dans `dist/` (`dist/index.html`, ses fichiers sous `dist/espace/` nommés par leur empreinte). `servirLaPage({ dist, session, cadre, entetes })` la sert, `GET` et `HEAD` seuls : sur le chemin de chaque écran et sur `/espace/…`. Sans `dist/index.html`, l'app ne démarre pas. Sans session, la page mène à la connexion du core ; à une personne à qui l'app est fermée, la page simple en 404. La session est dans `<meta name="indos-session">`. Une app à choses lui confie aussi les chemins que reconnaît `estUnEcranDesChoses` (`/liste`, `/<id>`, `/<id>/seule`).
|
|
237
|
+
Une app à page a sa page en React dans `espace/`, construite dans `dist/` (`dist/index.html`, ses fichiers sous `dist/espace/` nommés par leur empreinte). `servirLaPage({ dist, session, cadre, entetes })` la sert, `GET` et `HEAD` seuls : sur le chemin de chaque écran et sur `/espace/…`. Sans `dist/index.html`, l'app ne démarre pas. Sans session, la page mène à la connexion du core ; à une personne à qui l'app est fermée, la page simple en 404. La session est dans `<meta name="indos-session">`. Une app à choses lui confie aussi les chemins que reconnaît `estUnEcranDesChoses` (`/liste`, `/<id>`, `/<id>/seule`), et ceux de ses autres listes.
|
|
208
238
|
|
|
209
239
|
### L'hôte public d'une app
|
|
210
240
|
|
|
@@ -214,32 +244,20 @@ Une app dont les choses se publient sert leur lien sur son hôte public (`ADRESS
|
|
|
214
244
|
- Une chose absente, une chose fermée, une adresse inconnue et toute autre méthode reçoivent la même page introuvable en 404.
|
|
215
245
|
- Sa politique est `entetesDeLaPagePublique` : `default-src 'none'`, le reste à `'self'` et au thème du core, puis les `sources` de l'app.
|
|
216
246
|
|
|
217
|
-
|
|
247
|
+
### Les pages rendues par le serveur
|
|
218
248
|
|
|
219
249
|
Les pages d'auth du core et la page simple (`@indos/bibliotheque/ecran` : `pageDAuth`, `pageSimple`, `envoyerLaPage`) sont rendues par le serveur, sans script, sur les classes de `/theme/console.css` : une page n'en invente pas. Un paramètre de texte est échappé ; un paramètre de HTML l'est par l'appelant (`echapper`). Le message après un formulaire passe par un code fixe (`?fait=<code>`, `messageDuGeste`) : aucun texte ne vient de l'adresse.
|
|
220
250
|
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
Un geste d'écran est un appel de la page à sa pièce, en JSON, avec la session : l'appel d'un outil, ou un geste que Claude ne doit pas voir (un secret), `POST /<app>/espace/<geste>`, sans extension, routé avant `/espace/…`. Il ne passe ni par le core ni par son journal. `traiterUnGesteDEcran(requete, reponse, { origine, personneDe, executer })` vérifie dans l'ordre :
|
|
224
|
-
|
|
225
|
-
1. la méthode : 405 hors de `POST` ;
|
|
226
|
-
2. l'`Origin`, celle de la page : 403, avant toute question au core ;
|
|
227
|
-
3. la personne (`personneDuGeste`) : 401 sans session, 403 si l'app lui est fermée, 503 si le core ne répond pas ;
|
|
228
|
-
4. le corps : 415 hors de JSON, 413 au-delà de 4 Mio, 400 si ce n'est pas un objet ;
|
|
229
|
-
5. `executer` : 200 et sa valeur ; un `Refus` en 422 avec son texte ; toute autre erreur en 500 sans sa cause, écrite au journal de l'app.
|
|
251
|
+
### Écrire une page
|
|
230
252
|
|
|
231
|
-
`
|
|
253
|
+
`espace/` porte `index.html` (le même pour chaque pièce, sans script en ligne), `page.tsx` (`lancerLaPage`, et les routes, là ou dans `routes.ts`), `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/`.
|
|
232
254
|
|
|
233
|
-
|
|
234
|
-
|
|
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
|
-
|
|
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
|
-
- 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.
|
|
255
|
+
- 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, que npm installe avec le paquet.
|
|
256
|
+
- Ses scripts npm lancent la commande de la page, `page-de-l-espace` (`construire`, `developper`, `tester`), comme le modèle.
|
|
239
257
|
- `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
|
|
258
|
+
- `npm run dev` sert la page à chaud : `INDOS_CORE` (le core d'un OS, ou un core local), `INDOS_APP` (l'app lancée en local, `http://localhost:3000`, avec `ADRESSE=http://localhost:5173/<app>`), `INDOS_PORT`, `INDOS_HOTE` (l'hôte d'écoute, localhost par défaut, `0.0.0.0` dans un conteneur). Reliée à un OS en HTTPS, la session passe dans Chrome et Firefox, pas dans Safari.
|
|
241
259
|
|
|
242
|
-
|
|
260
|
+
### La coquille
|
|
243
261
|
|
|
244
262
|
`lancerLaPage({ piece, base, ecrans })` (`@indos/bibliotheque/espace`) rend la page : la barre de l'OS à gauche, à droite le cadre de l'écran. Le cadre se dessine depuis la session et le chemin : l'app n'y déclare rien.
|
|
245
263
|
|
|
@@ -248,27 +266,34 @@ Un geste d'écran est un appel de la page à sa pièce, en JSON, avec la session
|
|
|
248
266
|
- La ligne du haut est au cadre : les onglets de l'app, ou le fil d'Ariane, à gauche ; à droite, sur une chose seulement, le bloc de l'accès et le ⋯. Aucun geste d'une app, aucune épingle n'y entre : on épingle par l'édition de la barre.
|
|
249
267
|
- Les appels : `appeler(outil, arguments)` et `useAppel(outil)` vers ses outils, `faireUnGeste(chemin, corps)` vers un geste d'écran, `appelerUneApp(app, outil, arguments)` vers une autre app. Toute réponse autre que 200 lève `ErreurDUnAppel`, son texte mot pour mot (`refus` pour un 422) ; `RefusDUnAppel({ appel, verbe, sorte })` le montre et, avec `verbe`, rappelle l'outil avec `confirmer: true` : l'accord est ce clic. Une lecture en panne (5xx) se réessaie deux fois, un refus jamais.
|
|
250
268
|
- Un écran paginé prend `validateSearch: rechercheDUnePage` et `usePageDeLAdresse()` : la page est dans l'adresse.
|
|
251
|
-
- Un geste fait s'annonce par `useAnnoncer()`.
|
|
252
269
|
- Les montants masqués sont un masque d'écran, pas une protection : les données arrivent entières dans la page.
|
|
253
270
|
|
|
254
|
-
|
|
271
|
+
### Une app à choses
|
|
255
272
|
|
|
256
|
-
|
|
273
|
+
Une app dont la personne liste et ouvre des choses (pages, documents, contacts, factures…) prend la liste, l'écran d'une chose, l'aperçu, le ⋯ et le panneau du partage de la bibliothèque ; elle les déclare et les nourrit par ses outils. Une app neuve naît dans cette liste et cet écran ; un écran à elle vient après, quand l'usage le demande.
|
|
257
274
|
|
|
258
|
-
-
|
|
259
|
-
- Un
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
275
|
+
- Son manifeste déclare un écran par liste : `liste` pour la première sorte de choses, puis un écran par autre sorte (`mandats`).
|
|
276
|
+
- Un outil par liste : `chercher` pour `liste`, `chercher_des_<écran>` pour les autres (un tiret devenant `_`), que l'édition de la barre appelle.
|
|
277
|
+
- `chercher`, le même pour Claude et pour l'écran, prend `{ texte?, vue?, page? }` et rend `{ lignes, total }` en JSON, 25 par page, le texte sans accents ni casse. Sans `vue`, il trouve tout ce que la personne voit ; la liste passe toujours sa vue.
|
|
278
|
+
- Chaque ligne (`ChoseTrouvee`) porte `id`, `nom`, `chemin` (`/<app>/<id>`), puis, quand l'app les a, `droit`, `auteur`, `partagee`, `publiee`, `adresse_publique`, `droit_public`, `modifie_le`, et ses champs propres. Une app dont d'autres chemins sont à la racine met ses choses sous `liste/`.
|
|
279
|
+
- Ses autres outils (`lire`, `creer`, `modifier`, `partager`, `ne_plus_partager`, `donner`, `supprimer`, le renommage, la publication) gardent ces noms ; ceux qui rendent une chose portent son `id`.
|
|
280
|
+
- La page déclare `DeclarationDesChoses` (`src/espace/choses.ts`) : `app`, `une`, `lire` et `corps` obligatoires, le reste selon l'app. Ce qu'elle ne déclare pas ne se montre pas.
|
|
281
|
+
- `espace/routes.ts` : `routesDesChoses(declaration)`. Une route écrite à la main suit la même forme (`validateSearch: rechercheDeLaListe` et `ListeDesChoses` pour la liste ; `staticData: { ecranDUneChose: true, choses }` pour la chose).
|
|
282
|
+
- Une fiche (un contact, une facture) s'écrit dans `formulaire` (`FormulaireDUneFiche`) ; `modifier` n'envoie que ce qui a changé. Une chose qu'on écrit naît vide par `nouveau`.
|
|
283
|
+
- Un geste propre qui change les choses les relit par `useRelireLesChoses(app)`.
|
|
284
|
+
- Un geste définitif passe par `ConfirmationDUnGeste`. Quand seul le serveur connaît sa portée, l'écran appelle sans accord ; le refus qui demande l'accord (`demandeLAccord`) devient la question, en mots de la personne, et le verbe rappelle avec `confirmer: true`. Le texte du refus, écrit pour Claude, ne se montre jamais. Un autre refus se lit mot pour mot.
|
|
285
|
+
- Supprimer est toujours dans le ⋯. Une chose rangée dans une autre n'a pas « Partager… » : elle suit sa racine.
|
|
286
|
+
- `useDansLApercu()` dit qu'un corps est rendu dans l'aperçu.
|
|
287
|
+
|
|
288
|
+
### Le direct à l'écran
|
|
289
|
+
|
|
290
|
+
Une chose écrite à plusieurs montre son direct de la même façon partout : la bibliothèque écrit l'état, les présences, la couleur et l'étiquette d'une personne ; l'app garde la forme de ce que fait un autre (un curseur, une cellule).
|
|
291
|
+
|
|
292
|
+
- Le corps déclare son direct par `useDeclarerLeDirect({ etat, personnes, lecture })` ; le cadre le dessine dans le bloc de l'accès.
|
|
293
|
+
- `couleurDe(id)` tire la couleur d'une personne de son identifiant, la même partout ; elle dit qui est là, rien d'autre.
|
|
294
|
+
- Le nom d'une autre personne passe par React (`EtiquetteDuNom`) ou par `elementDeLEtiquetteDuNom`, en texte : jamais en HTML.
|
|
295
|
+
- Une page hors de l'espace pose `EtatEtPresences`, ou `EtatSansPresence` en lecture publique.
|
|
296
|
+
- `useAnnoncerLeDroitQuiBaisse`, `useMontrerLaChoseIntrouvable`, `rechargerLaPage` pour une session fermée.
|
|
272
297
|
|
|
273
298
|
## Les règles d'écran
|
|
274
299
|
|
|
@@ -298,64 +323,40 @@ Chaque écran prend de la bibliothèque ce qui se dessine pareil partout. Quatre
|
|
|
298
323
|
- rien ne s'y remplit par déduction (des serveurs tirés du domaine d'un courriel), et chaque app branche ses propres comptes.
|
|
299
324
|
- Un compte en panne le dit sur sa ligne : l'app retient le dernier refus de son service et l'efface au premier appel qui réussit ; la ligne le dit en rouge, dans les mots de la personne, avec le geste qui répare ; un compte sain ne porte aucune étiquette de plus.
|
|
300
325
|
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
Une app dont la personne liste et ouvre des choses (pages, documents, contacts, factures…) prend la liste, l'écran d'une chose, l'aperçu, le ⋯ et le panneau du partage de la bibliothèque ; elle les déclare et les nourrit par ses outils. Une app neuve naît dans cette liste et cet écran ; un écran à elle vient après, quand l'usage le demande.
|
|
326
|
+
### Les composants d'une page
|
|
304
327
|
|
|
305
|
-
|
|
306
|
-
- Un outil par liste : `chercher` pour `liste`, `chercher_des_<écran>` pour les autres (un tiret devenant `_`), que l'édition de la barre appelle.
|
|
307
|
-
- `chercher`, le même pour Claude et pour l'écran, prend `{ texte?, vue?, page? }` et rend `{ lignes, total }` en JSON, 25 par page, le texte sans accents ni casse. Sans `vue`, il trouve tout ce que la personne voit ; la liste passe toujours sa vue.
|
|
308
|
-
- Chaque ligne (`ChoseTrouvee`) porte `id`, `nom`, `chemin` (`/<app>/<id>`), puis, quand l'app les a, `droit`, `auteur`, `partagee`, `publiee`, `adresse_publique`, `droit_public`, `modifie_le`, et ses champs propres. Une app dont d'autres chemins sont à la racine met ses choses sous `liste/`.
|
|
309
|
-
- Ses autres outils (`lire`, `creer`, `modifier`, `partager`, `ne_plus_partager`, `donner`, `supprimer`, le renommage, la publication) gardent ces noms ; ceux qui rendent une chose portent son `id`.
|
|
310
|
-
- La page déclare `DeclarationDesChoses` : `app`, `une`, `lire` et `corps` obligatoires ; puis selon l'app `feminin`, `ecran`, `sorte`, `nouvelle`, `colonnes`, `vues` (`vuesDuPartage`), `etat`, `date`, `plein`, `publication`, `motsDeLaSuppression`, `consequenceDeLaSuppression`, `vide`, `formulaire`, `ancetres`, `gestesDuMenu` (groupes `ouvrir`, `changer`, `copie`, `clore`), `etatDeLaChose`, `gestes`, `rendu`, `aPart`, `renommer`, `donner`, `peutDonner`, `supprimer`, `peutSupprimer`, `lirePartage`, `partager`, `nePlusPartager`, `publier`, `nouveau`, `gestesDeLaListe`. Ce qu'elle ne déclare pas ne se montre pas.
|
|
311
|
-
- `espace/routes.ts` : `routesDesChoses(declaration)`. Une route écrite à la main suit la même forme (`validateSearch: rechercheDeLaListe` et `ListeDesChoses` pour la liste ; `staticData: { ecranDUneChose: true, choses }` pour la chose).
|
|
312
|
-
- Le serveur sert la page sur les chemins de `estUnEcranDesChoses`, et ceux de ses autres listes.
|
|
313
|
-
- Une fiche (un contact, une facture) s'écrit dans `formulaire` (`FormulaireDUneFiche`) ; `modifier` n'envoie que ce qui a changé. Une chose qu'on écrit naît vide par `nouveau`.
|
|
314
|
-
- Un geste propre qui change les choses les relit par `useRelireLesChoses(app)`.
|
|
315
|
-
- Un geste définitif passe par `ConfirmationDUnGeste`. Quand seul le serveur connaît sa portée, l'écran appelle sans accord ; le refus qui demande l'accord (`demandeLAccord`) devient la question, en mots de la personne, et le verbe rappelle avec `confirmer: true`. Le texte du refus, écrit pour Claude, ne se montre jamais. Un autre refus se lit mot pour mot.
|
|
316
|
-
- Supprimer est toujours dans le ⋯. Une chose rangée dans une autre n'a pas « Partager… » : elle suit sa racine.
|
|
317
|
-
- `useDansLApercu()` dit qu'un corps est rendu dans l'aperçu.
|
|
318
|
-
|
|
319
|
-
## Le direct à l'écran
|
|
320
|
-
|
|
321
|
-
Une chose écrite à plusieurs montre son direct de la même façon partout : la bibliothèque écrit l'état, les présences, la couleur et l'étiquette d'une personne ; l'app garde la forme de ce que fait un autre (un curseur, une cellule).
|
|
322
|
-
|
|
323
|
-
- Le corps déclare son direct par `useDeclarerLeDirect({ etat, personnes, lecture })` ; le cadre le dessine dans le bloc de l'accès.
|
|
324
|
-
- `couleurDe(id)` tire la couleur d'une personne de son identifiant, la même partout ; elle dit qui est là, rien d'autre.
|
|
325
|
-
- Le nom d'une autre personne passe par React (`EtiquetteDuNom`) ou par `elementDeLEtiquetteDuNom`, en texte : jamais en HTML.
|
|
326
|
-
- Une page hors de l'espace pose `EtatEtPresences`, ou `EtatSansPresence` en lecture publique.
|
|
327
|
-
- `useAnnoncerLeDroitQuiBaisse`, `useMontrerLaChoseIntrouvable`, `rechargerLaPage` pour une session fermée.
|
|
328
|
-
|
|
329
|
-
## Le direct Yjs
|
|
328
|
+
`@indos/bibliotheque/ui` : les composants de shadcn/ui copiés dans `src/ui/`, sur Radix, au style Indos, en français et accessibles. Leurs propriétés sont dans leurs types.
|
|
330
329
|
|
|
331
|
-
|
|
330
|
+
- La feuille `@indos/bibliotheque/ui/theme.css` (Tailwind v4), importée après `/theme/variables.css`, ne déclare aucune couleur ni police : elle lit celles du core (`--papier`, `--encre`, `--accent`, `--gris`, `--erreur`, `--surface`, `--trait`…), les seules couleurs de Tailwind (`bg-surface`, `text-gris`). Les polices sont `font-sans`, `font-titre`, `font-mono`.
|
|
331
|
+
- Un rôle, un composant :
|
|
332
|
+
- `Bouton` (`principal`, `secondaire`, `detruit`, `discret`) ;
|
|
333
|
+
- `Champ`, `Saisie`, `ZoneDeTexte`, `CaseACocher`, `ChoixParmiPlusieurs`, `Suggestions` ;
|
|
334
|
+
- `Choix`, la seule liste déroulante, jamais un `<select>` ;
|
|
335
|
+
- `Section`, `TitreDeSection`, `Etiquette`, `Message`, `Lignes`, `Etapes`, `AdresseACopier` ;
|
|
336
|
+
- `Fenetre`, une question ou un formulaire court ; `Panneau`, un réglage de la chose ; `PanneauEnDeuxTemps`, un branchement ; `Confirmation`, un geste définitif ;
|
|
337
|
+
- `Tableau`, `Vues`, `Recherche`, `MenuDUneLigne` (le ⋯), `LignesDeReglages`, `SecretGarde`, `ValeurMontreeUneFois` ;
|
|
338
|
+
- `EtatDeLecture`, « Chargement… » ; `SansResultat`, la recherche vide ; `ChosePleine` ;
|
|
339
|
+
- `GesteDeLaSection`, `GesteAuBoutDeLaLigne`, `GesteApresLaValeur` ;
|
|
340
|
+
- `Colonnes` et `Barres`, les graphiques, dessinés en HTML, sans paquet de graphiques ;
|
|
341
|
+
- les icônes communes (`IconeDeLOeil` ne veut dire qu'« aperçu »).
|
|
342
|
+
- Une valeur montrée une fois (un mot de passe d'application, un lien, des codes) se lit à la dernière étape de la `Fenetre` qui l'a créée (`derniereEtape`), qui ne se ferme que par « Fermer » : ni Échap ni le voile.
|
|
332
343
|
|
|
333
|
-
|
|
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
|
-
- 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
|
-
- `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).
|
|
337
|
-
- `ecrire(chose, geste, { avant, garder })`, une écriture de Claude, passe à côté du contrôle, ce que l'outil a vérifié avant ; un état qui passerait la `limite` n'écrit rien.
|
|
338
|
-
- `fermer()` dans `avantDeQuitter`.
|
|
344
|
+
## Les essais
|
|
339
345
|
|
|
340
|
-
|
|
346
|
+
### Les données d'essai
|
|
341
347
|
|
|
342
|
-
|
|
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.
|
|
343
349
|
|
|
344
|
-
|
|
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
|
|
|
348
356
|
Les tests de chaque app reposent sur ces aides ; ce qui reste dans ses tests lui est propre.
|
|
349
357
|
|
|
350
|
-
- Node :
|
|
358
|
+
- Node :
|
|
359
|
+
- `lancerLeFauxCore` : sessions, annuaire, apps déclarées, notifications, `fabriquerUnJeton`. Une app qu'il ne déclare pas est fermée à tous, comme au core : le test d'une app qui reconnaît la personne à sa session (une page, un geste d'écran, `POST /outils`) la déclare.
|
|
360
|
+
- `ouvrirLaBaseDUnTest(t, migrations)` : la base d'un test, PGlite jointe par un pool d'une connexion, ses migrations appliquées, fermée à la fin du test. `ouvrirUneBaseDEssai` rend la base seule, à un test qui ouvre ses connexions lui-même (`ouvrirLaBase(adresse, 1)`).
|
|
361
|
+
- `servirLApp`, `connecter` (un client MCP, comme le core qui relaie Claude), `appeler` (rend `{ erreur, refus, texte, json }`).
|
|
351
362
|
- Page, dans jsdom (Vitest) : `sessionDEssai`, `appDEssai`, `servir(routes)` à la place de `fetch`, `ouvrirLaPage`, `testerLEcranDesComptes`. Un test choisit dans un `Choix` par un clic sur le `combobox`, puis sur l'`option`.
|
|
352
|
-
|
|
353
|
-
## Une app du client
|
|
354
|
-
|
|
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 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
|
-
|
|
357
|
-
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
|
-
|
|
359
|
-
## La note des versions
|
|
360
|
-
|
|
361
|
-
`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,9 +1,9 @@
|
|
|
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 se publie sur npm sous `@indos/bibliotheque`, à la version de `manifeste.json` ; `CHANGELOG.md` dit ce que change chaque version.
|
|
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. 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 le publie.
|
|
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 `
|
|
6
|
+
- `modeles/app-du-client/` : le modèle d'une app, que copie `npx --package @indos/bibliotheque@<version> bibliotheque creer-une-app <nom>`.
|
|
7
7
|
|
|
8
8
|
Avant toute app, et après chaque nouvelle version : `npm ci` dans `bibliotheque/`.
|
|
9
9
|
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|