Paquet YunoHost pour Vèy Lalwa — v1.0.1~ynh1
Format de paquetage 2, helpers 2.1, sur le modèle de jwe_ynh. Ce que l'installation fait, dans cet ordre : extraire l'archive, rendre le .env depuis les réponses d'installation, construire l'application web (npm ci, polices, build, prune), monter l'environnement Python, puis remplir la base depuis le corpus de recherche embarqué. Trois choix qui méritent d'être dits : - La base, le cache et l'export vivent dans data_dir, jamais dans le répertoire d'installation. « ynh_setup_source --full_replace » efface celui-ci intégralement à chaque mise à jour : y laisser la base effacerait tout le travail de veille accumulé. Vérifié en simulant la mise à jour — 59 textes, 367 sources et 3 passages survivent à l'effacement. - Un domaine dédié, sans question « path ». Les liens internes sont absolus et SvelteKit demanderait une recompilation avec « paths.base » pour tenir sur un sous-chemin. Mieux vaut une contrainte annoncée qu'un sous-chemin à moitié fonctionnel. - Les identifiants Légifrance sont facultatifs, et les tests s'exécutent sans : cela vérifie au passage le mode dégradé documenté. Le rapport de passage affiche alors « legifrance ignoré — repli sur … », et les deux autres collecteurs détectent quand même les 7 ajouts et les 4 changements de décision. Un minuteur systemd distinct porte le passage de collecte, le helper « ynh_config_add_systemd » ne gérant que l'unité principale. Il est arrêté avant toute mise à jour : un passage qui démarrerait pendant le remplacement des fichiers travaillerait sur un arbre à moitié écrit. Vérifié avant publication, pas après : séquence npm complète depuis l'archive publiée, environnement Python, remplissage, démarrage du service lisant la base de data_dir, origine déduite des en-têtes du proxy, passage en mode dégradé, et simulation d'effacement du répertoire d'installation. shellcheck sans avertissement, TOML valides. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Cyber Mawonaj
Claude Opus 5
@@ -0,0 +1,94 @@
|
||||
# Administration de Vèy Lalwa
|
||||
|
||||
## Où sont les choses
|
||||
|
||||
| Quoi | Où |
|
||||
|---|---|
|
||||
| Code et application construite | `__INSTALL_DIR__` |
|
||||
| Base de veille, cache, export JSON | `__DATA_DIR__` |
|
||||
| Configuration (identifiants compris) | `__INSTALL_DIR__/.env`, mode 600 |
|
||||
| Journal de l'application web | `/var/log/__APP__/__APP__.log` |
|
||||
| Journal des passages de collecte | `/var/log/__APP__/pipeline.log` |
|
||||
|
||||
Tout ce qui compte vit dans `__DATA_DIR__` : le répertoire d'installation est **intégralement remplacé** à chaque mise à jour.
|
||||
|
||||
## Le pipeline
|
||||
|
||||
Deux passages par jour, à 6 h et 18 h, plus un le dimanche à 9 h pour rattraper le Journal officiel de fin de semaine. Une dispersion de quinze minutes évite de frapper Légifrance en même temps que tout le monde.
|
||||
|
||||
```bash
|
||||
# Déclencher un passage tout de suite
|
||||
systemctl start __APP__-pipeline.service
|
||||
|
||||
# Suivre ce qu'il fait
|
||||
journalctl -u __APP__-pipeline -f
|
||||
|
||||
# Voir la prochaine échéance
|
||||
systemctl list-timers __APP__-pipeline.timer
|
||||
```
|
||||
|
||||
### Voir ce que le pipeline changerait, sans rien écrire
|
||||
|
||||
```bash
|
||||
cd __INSTALL_DIR__
|
||||
sudo -u __APP__ bash -c 'set -a; . ./.env; set +a; \
|
||||
./venv/bin/python -m pipeline.update --dry-run'
|
||||
```
|
||||
|
||||
(`set -a` exporte automatiquement ce que le fichier définit ; `xargs` échouerait
|
||||
sur les valeurs contenant des espaces.)
|
||||
|
||||
Le rapport liste chaque écart avec son ancienne et sa nouvelle valeur. **Commencez toujours par là** avant de soupçonner un problème.
|
||||
|
||||
## Identifiants Légifrance
|
||||
|
||||
L'application fonctionne sans. Le rapport de passage indique alors :
|
||||
|
||||
```
|
||||
legifrance ignoré — LEGIFRANCE_CLIENT_ID absent de .env — repli sur
|
||||
l'Assemblée nationale, le Sénat et le Conseil constitutionnel
|
||||
```
|
||||
|
||||
Pour les ajouter, éditez `__INSTALL_DIR__/.env`, puis `systemctl start __APP__-pipeline.service`.
|
||||
|
||||
**Le piège** : une application PISTE affiche deux couples de valeurs.
|
||||
|
||||
| Ce que PISTE affiche | À utiliser |
|
||||
|---|---|
|
||||
| **Client ID** / **Client secret** | ✅ oui |
|
||||
| API key / API key secret | ❌ non — `invalid_client` |
|
||||
|
||||
Second piège : les identifiants de production ne fonctionnent pas en bac à sable, qui exige une application distincte.
|
||||
|
||||
## Sauvegarde
|
||||
|
||||
La sauvegarde YunoHost couvre la base et la configuration. À la main :
|
||||
|
||||
```bash
|
||||
sqlite3 __DATA_DIR__/veille.db ".backup /sauvegardes/veille-$(date +%F).db"
|
||||
```
|
||||
|
||||
N'utilisez jamais `cp` pendant un passage : le mode WAL laisse des fichiers annexes que `.backup` gère correctement.
|
||||
|
||||
## Diagnostic
|
||||
|
||||
| Symptôme | Piste |
|
||||
|---|---|
|
||||
| Page blanche, 502 | `systemctl status __APP__` puis `tail /var/log/__APP__/__APP__.log` |
|
||||
| « Base introuvable » | La base a disparu de `__DATA_DIR__`. Rejouez le remplissage (voir plus bas). |
|
||||
| Formulaire de recherche refusé | `ORIGIN` dans `.env` ne correspond plus au domaine servi |
|
||||
| Aucun texte nouveau depuis des semaines | Normal hors session parlementaire. Vérifiez avec `--dry-run`. |
|
||||
| `invalid_client` dans le journal | Clé d'API utilisée au lieu du couple OAuth, ou application non abonnée à l'API Légifrance |
|
||||
|
||||
### Reconstruire la base depuis le corpus
|
||||
|
||||
Le corpus de recherche est embarqué dans l'archive : la base peut toujours être reconstruite, sans réseau.
|
||||
|
||||
```bash
|
||||
cd __INSTALL_DIR__
|
||||
sudo -u __APP__ bash -c 'set -a; . ./.env; set +a; \
|
||||
./venv/bin/python -m pipeline.seed_from_research --repartir-de-zero'
|
||||
systemctl restart __APP__
|
||||
```
|
||||
|
||||
Vous perdrez l'historique des passages, pas les 52 textes du corpus.
|
||||
@@ -0,0 +1,94 @@
|
||||
# Administration de Vèy Lalwa
|
||||
|
||||
## Où sont les choses
|
||||
|
||||
| Quoi | Où |
|
||||
|---|---|
|
||||
| Code et application construite | `__INSTALL_DIR__` |
|
||||
| Base de veille, cache, export JSON | `__DATA_DIR__` |
|
||||
| Configuration (identifiants compris) | `__INSTALL_DIR__/.env`, mode 600 |
|
||||
| Journal de l'application web | `/var/log/__APP__/__APP__.log` |
|
||||
| Journal des passages de collecte | `/var/log/__APP__/pipeline.log` |
|
||||
|
||||
Tout ce qui compte vit dans `__DATA_DIR__` : le répertoire d'installation est **intégralement remplacé** à chaque mise à jour.
|
||||
|
||||
## Le pipeline
|
||||
|
||||
Deux passages par jour, à 6 h et 18 h, plus un le dimanche à 9 h pour rattraper le Journal officiel de fin de semaine. Une dispersion de quinze minutes évite de frapper Légifrance en même temps que tout le monde.
|
||||
|
||||
```bash
|
||||
# Déclencher un passage tout de suite
|
||||
systemctl start __APP__-pipeline.service
|
||||
|
||||
# Suivre ce qu'il fait
|
||||
journalctl -u __APP__-pipeline -f
|
||||
|
||||
# Voir la prochaine échéance
|
||||
systemctl list-timers __APP__-pipeline.timer
|
||||
```
|
||||
|
||||
### Voir ce que le pipeline changerait, sans rien écrire
|
||||
|
||||
```bash
|
||||
cd __INSTALL_DIR__
|
||||
sudo -u __APP__ bash -c 'set -a; . ./.env; set +a; \
|
||||
./venv/bin/python -m pipeline.update --dry-run'
|
||||
```
|
||||
|
||||
(`set -a` exporte automatiquement ce que le fichier définit ; `xargs` échouerait
|
||||
sur les valeurs contenant des espaces.)
|
||||
|
||||
Le rapport liste chaque écart avec son ancienne et sa nouvelle valeur. **Commencez toujours par là** avant de soupçonner un problème.
|
||||
|
||||
## Identifiants Légifrance
|
||||
|
||||
L'application fonctionne sans. Le rapport de passage indique alors :
|
||||
|
||||
```
|
||||
legifrance ignoré — LEGIFRANCE_CLIENT_ID absent de .env — repli sur
|
||||
l'Assemblée nationale, le Sénat et le Conseil constitutionnel
|
||||
```
|
||||
|
||||
Pour les ajouter, éditez `__INSTALL_DIR__/.env`, puis `systemctl start __APP__-pipeline.service`.
|
||||
|
||||
**Le piège** : une application PISTE affiche deux couples de valeurs.
|
||||
|
||||
| Ce que PISTE affiche | À utiliser |
|
||||
|---|---|
|
||||
| **Client ID** / **Client secret** | ✅ oui |
|
||||
| API key / API key secret | ❌ non — `invalid_client` |
|
||||
|
||||
Second piège : les identifiants de production ne fonctionnent pas en bac à sable, qui exige une application distincte.
|
||||
|
||||
## Sauvegarde
|
||||
|
||||
La sauvegarde YunoHost couvre la base et la configuration. À la main :
|
||||
|
||||
```bash
|
||||
sqlite3 __DATA_DIR__/veille.db ".backup /sauvegardes/veille-$(date +%F).db"
|
||||
```
|
||||
|
||||
N'utilisez jamais `cp` pendant un passage : le mode WAL laisse des fichiers annexes que `.backup` gère correctement.
|
||||
|
||||
## Diagnostic
|
||||
|
||||
| Symptôme | Piste |
|
||||
|---|---|
|
||||
| Page blanche, 502 | `systemctl status __APP__` puis `tail /var/log/__APP__/__APP__.log` |
|
||||
| « Base introuvable » | La base a disparu de `__DATA_DIR__`. Rejouez le remplissage (voir plus bas). |
|
||||
| Formulaire de recherche refusé | `ORIGIN` dans `.env` ne correspond plus au domaine servi |
|
||||
| Aucun texte nouveau depuis des semaines | Normal hors session parlementaire. Vérifiez avec `--dry-run`. |
|
||||
| `invalid_client` dans le journal | Clé d'API utilisée au lieu du couple OAuth, ou application non abonnée à l'API Légifrance |
|
||||
|
||||
### Reconstruire la base depuis le corpus
|
||||
|
||||
Le corpus de recherche est embarqué dans l'archive : la base peut toujours être reconstruite, sans réseau.
|
||||
|
||||
```bash
|
||||
cd __INSTALL_DIR__
|
||||
sudo -u __APP__ bash -c 'set -a; . ./.env; set +a; \
|
||||
./venv/bin/python -m pipeline.seed_from_research --repartir-de-zero'
|
||||
systemctl restart __APP__
|
||||
```
|
||||
|
||||
Vous perdrez l'historique des passages, pas les 52 textes du corpus.
|
||||
@@ -0,0 +1,20 @@
|
||||
**Vèy Lalwa** tracks French legislation — acts, bills, ordinances, Constitutional Council decisions — through one specific lens: what it changes for the **freedoms of individuals, associations and businesses**, with a focus on Guadeloupe and the French overseas territories.
|
||||
|
||||
Laws restricting or extending freedoms rarely arrive in one piece. They come as an article buried in a simplification act, a rider struck down in a budget act, an implementing decree six months later. Following that takes time few associations and small organisations have.
|
||||
|
||||
### What it does
|
||||
|
||||
- **Full-text search** with combinable facets — status, topic, Guadeloupe relevance, effect on freedoms — whose state lives in the URL, so it can be shared.
|
||||
- **Detailed records**: summary, key points, dated parliamentary history, effects per audience, and the **list of sources with verbatim excerpts**.
|
||||
- **Calendar** of expected decisions, entries into force and parliamentary deadlines.
|
||||
- **Open API**, no key required, to reuse the data elsewhere.
|
||||
|
||||
### What it does not do
|
||||
|
||||
- No invented legislative data. Every fact carries its source, date and confidence level; anything unestablished is flagged "to be verified", with the reason shown.
|
||||
- No legal advice: a quoted text is no substitute for a lawyer.
|
||||
- No trackers, no analytics cookies, no third-party requests — fonts included.
|
||||
|
||||
### How it stays current
|
||||
|
||||
A pipeline queries Légifrance, the Sénat's list of promulgated acts and the Constitutional Council's docket twice a day. Each source is queried independently: if one is unavailable, the others carry on. A detected status change becomes a dated event in the text's history.
|
||||
@@ -0,0 +1,20 @@
|
||||
**Vèy Lalwa** suit la production législative française — lois, projets et propositions de loi, ordonnances, décisions du Conseil constitutionnel — et la lit sous un angle précis : ce qu'elle change aux **libertés des individus, des associations et des entreprises**, avec un zoom Guadeloupe et outre-mer.
|
||||
|
||||
Les textes qui restreignent ou étendent des libertés arrivent rarement d'un bloc. Ils passent par un article dans une loi de simplification, un cavalier censuré dans une loi de finances, un décret d'application six mois plus tard. Suivre cela demande un temps que peu d'associations et de petites structures ont.
|
||||
|
||||
### Ce que fait l'application
|
||||
|
||||
- **Recherche plein texte** avec filtres combinables — statut, thème, pertinence Guadeloupe, effet sur les libertés — dont l'état vit dans l'URL, donc se partage.
|
||||
- **Fiches détaillées** : résumé, points clés, parcours parlementaire daté, effets par public, et la **liste des sources avec leurs extraits verbatim**.
|
||||
- **Calendrier** des décisions attendues, entrées en vigueur et échéances parlementaires.
|
||||
- **Interface de programmation** ouverte, sans clé, pour reprendre les données ailleurs.
|
||||
|
||||
### Ce qu'elle ne fait pas
|
||||
|
||||
- Aucune donnée législative inventée. Chaque fait porte sa source, sa date et son niveau de confiance ; ce qui n'est pas établi est marqué « à vérifier », avec son motif affiché.
|
||||
- Aucun conseil juridique : un texte cité ne remplace pas un avocat.
|
||||
- Aucun traceur, aucun cookie de mesure, aucune requête vers un service tiers — polices comprises.
|
||||
|
||||
### Comment elle se tient à jour
|
||||
|
||||
Un pipeline interroge deux fois par jour Légifrance, la liste des lois promulguées du Sénat et le registre des affaires du Conseil constitutionnel. Chaque source est interrogée séparément : si l'une est indisponible, les autres continuent. Un changement de statut détecté devient un événement daté dans le parcours du texte.
|
||||
@@ -0,0 +1,14 @@
|
||||
Vèy Lalwa is installed at https://__DOMAIN__
|
||||
|
||||
The database already holds **52 texts and 360 sources** from the research corpus, closed on 25 July 2026. The first collection run happens automatically at 6 am or 6 pm; to trigger it right away:
|
||||
|
||||
```
|
||||
systemctl start __APP__-pipeline.service
|
||||
journalctl -u __APP__-pipeline -f
|
||||
```
|
||||
|
||||
### If you did not provide Légifrance credentials
|
||||
|
||||
That is not a blocker. The Légifrance collector disables itself and says so in the run report; the Sénat and the Constitutional Council take over, which is enough to track promulgations and constitutional decisions.
|
||||
|
||||
To add them later, edit `__INSTALL_DIR__/.env` and trigger a run. **Note**: a PISTE application exposes two pairs of values, and only the **OAuth** pair ("Client ID" / "Client secret") works. The API key is rejected by the token endpoint.
|
||||
@@ -0,0 +1,22 @@
|
||||
Vèy Lalwa est installé sur https://__DOMAIN__
|
||||
|
||||
La base contient déjà **52 textes et 360 sources**, issus du corpus de recherche arrêté au 25 juillet 2026. Le premier passage de collecte a lieu automatiquement à 6 h ou 18 h ; pour le déclencher tout de suite :
|
||||
|
||||
```
|
||||
systemctl start __APP__-pipeline.service
|
||||
journalctl -u __APP__-pipeline -f
|
||||
```
|
||||
|
||||
### Si vous n'avez pas fourni d'identifiants Légifrance
|
||||
|
||||
Ce n'est pas bloquant. Le collecteur Légifrance se désactive et l'annonce dans le rapport de passage ; le Sénat et le Conseil constitutionnel prennent le relais, ce qui suffit à suivre les promulgations et les décisions constitutionnelles. Ce que vous perdez : la confirmation de l'intitulé officiel au Journal officiel et l'identifiant JORF de chaque texte.
|
||||
|
||||
Pour les ajouter plus tard, éditez `__INSTALL_DIR__/.env` puis relancez un passage. **Attention** : une application PISTE expose deux couples de valeurs, et seul le couple **OAuth** (« Client ID » / « Client secret ») fonctionne. La clé d'API est refusée par le point d'accès du jeton.
|
||||
|
||||
### Vérifier que tout tourne
|
||||
|
||||
```
|
||||
systemctl status __APP__
|
||||
systemctl list-timers __APP__-pipeline.timer
|
||||
tail -f /var/log/__APP__/pipeline.log
|
||||
```
|
||||
Reference in New Issue
Block a user