Commit 9869e7b7 authored by Kourser's avatar Kourser
Browse files

La documentation dit ce que l'instance fait aujourd'hui 

Quatre pages étaient restées en arrière du lot précédent. L'installation
annonçait six cents garanties, et taisait qu'une relance de l'installateur
répare l'adresse du serveur média après un changement de réseau — le geste à
faire devant un appel sans son. La licence ne nommait pas les polices
désormais servies par l'instance, sous SIL Open Font License 1.1.

La configuration affirmait que sans Redis le temps réel se dégrade : c'était
faux, et avant même ce lot. Une instance seule propage sur-le-champ ; Redis
ne sert qu'à partir de deux, et les entrées de main courante s'annoncent par
la base dans tous les cas.

L'exploitation prévient désormais qu'une sonde de visio verte ne dit pas que
les flux passent : la signalisation répond, l'appel se tient, et personne ne
s'entend.

Co-Authored-By: default avatarClaude Opus 5 <noreply@anthropic.com>
parent 7b2e575e

site/docs/configuration.md

+5 −2
Changes for site/docs/configuration.md: 5 added lines, 2 removed lines.
Original line number Diff line number Diff line
@@ -121,8 +121,11 @@ Voir [Licence](./licence.md). 
`DATABASE_URL`, `REDIS_URL`, `S3_ENDPOINT`, `S3_BUCKET`, `S3_ACCESS`,

`S3_SECRET`, `S3_REGION`.



Sans Redis, le flux temps réel se dégrade : chaque écran se met à jour à

l'action, sans propagation immédiate. L'instance reste utilisable.

Sans Redis, le temps réel reste immédiat tant qu'**une seule instance** sert les

écrans. Redis n'est nécessaire qu'à partir de deux : il porte les messages, la

présence et les appels d'une instance à l'autre. Les entrées de main courante,

elles, s'annoncent par la base et atteignent toutes les instances dans les deux

cas.



### Visioconférence

site/docs/exploitation.md

+9 −0
Changes for site/docs/exploitation.md: 9 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -61,6 +61,15 @@ sonde antivirale présente le fichier d'essai EICAR et exige le verdict 
« infectée » : un analyseur qui répond « saine » à tout est plus dangereux qu'un

analyseur absent, puisqu'il rassure.



:::warning Un appel sans son, et une visio « opérationnelle »

La sonde du média interroge sa signalisation, pas le chemin des flux. Si le

serveur média annonce une adresse que la machine n'a plus — un portable qui a

changé de réseau, un bail DHCP renouvelé —, l'appel s'établit, la sonde reste

verte, et personne ne s'entend. Sur une instance locale, relancer

`sh outils/installer.sh` corrige l'adresse. `pnpm banc` éprouve le vrai chemin :

une voix entre dans une salle, et la réunion s'enregistre.

:::



## Montée de version



```bash

site/docs/installation.md

+14 −5
Changes for site/docs/installation.md: 14 added lines, 5 removed lines.
Original line number Diff line number Diff line
@@ -25,8 +25,16 @@ notification — écrit `.env` en **tirant au sort tous les secrets**, puis lèv 
composition et attend que l'instance réponde.



Un `.env` existant n'est jamais écrasé sans votre accord : le script propose de

le garder tel quel, ou de le sauvegarder à côté avant d'en écrire un neuf. Ce

fichier porte peut-être les secrets d'une instance en service.

le compléter — vos valeurs gardées, ce qui manque ajouté —, de le garder tel

quel, ou de le sauvegarder à côté avant d'en écrire un neuf. Ce fichier porte

peut-être les secrets d'une instance en service.



Relancer le script est sans risque, et c'est le geste à faire quand un poste a

changé de réseau. Sur une instance locale, le serveur média annonce l'adresse

que la machine avait à l'installation ; une fois cette adresse perdue, l'appel

se tient sans un son. Le script la compare à l'adresse actuelle, la corrige et

relance le serveur média — quel que soit le choix fait pour le `.env`. Une

adresse que vous avez posée vous-même dans l'URL publique n'est jamais touchée.



:::tip Pourquoi il n'appelle ni pnpm ni node

L'artefact est construit dans l'image, et les migrations sont jouées par
@@ -105,9 +113,10 @@ pnpm logs 
pnpm verif

```



Plus de six cents garanties, jouées contre une **base dédiée** (`…_verif`, créée

au besoin) qui n'est jamais celle de développement. Voir

[Vérifier](./verifier.md).

Près de mille sept cents garanties, jouées contre une **base dédiée** (`…_verif`,

créée au besoin) qui n'est jamais celle de développement ; les parcours dans un

vrai navigateur (`pnpm e2e`) et les essais de charge (`pnpm charge`) s'éprouvent

à part. Voir [Vérifier](./verifier.md).



## Sans Docker

site/docs/licence.md

+1 −0
Changes for site/docs/licence.md: 1 added line, 0 removed lines.
Original line number Diff line number Diff line
@@ -61,6 +61,7 @@ de celui qui la revendique ne garantit rien. 
| LiveKit | Apache-2.0 | Serveur média |

| Excalidraw | MIT | Canevas des tableaux blancs |

| PostgreSQL, Redis | Licences permissives | Persistance, temps réel |

| Archivo, Source Serif 4, JetBrains Mono | SIL Open Font License 1.1 | Polices de l'interface, servies par l'instance |



MinIO est sous AGPL-3.0 — sans conséquence ici : Kastell dialogue avec un

stockage objet par l'API S3, derrière un adaptateur, et n'incorpore aucun code

site/i18n/en/docusaurus-plugin-content-docs/current/configuration.md

+4 −2
Changes for site/i18n/en/docusaurus-plugin-content-docs/current/configuration.md: 4 added lines, 2 removed lines.
Original line number Diff line number Diff line
@@ -69,8 +69,10 @@ See [Licence](./licence.md). 
`DATABASE_URL`, `REDIS_URL`, `S3_ENDPOINT`, `S3_BUCKET`, `S3_ACCESS`,

`S3_SECRET`, `S3_REGION`.



Without Redis the real-time feed degrades: each screen refreshes on action,

without immediate propagation. The instance stays usable.

Without Redis, real time stays immediate as long as **a single instance** serves

the screens. Redis is only needed from two instances up: it carries messages,

presence and calls from one instance to another. Log entries are announced

through the database and reach every instance either way.



### Video