Colin Maudry
9b124deeea
- Rename project from decp.info to colibre across all codebase - Update domain from https://decp.info to https://colibre.fr - Update GitHub repo references to ColinMaudry/colibre - Rename deployment files: decpinfo-backup.* → colibre-backup.* - Update project configuration and documentation - Rename project assets: decp.info.png → colibre.png - Update environment variables and constants (DOMAIN_NAME, TOKEN_PREFIX, GITHUB_REPO, etc.) - Update URLs in all pages, tests, and configuration files - Keep DECP acronym in text (unchanged per requirements) - Add rebrand note to README.md Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
66 lines
2.0 KiB
Markdown
66 lines
2.0 KiB
Markdown
# colibre
|
|
|
|
> **Note:** Ce projet a été rebaptisé de **decp.info** à **colibre** en 2026.
|
|
|
|
> Outil d'exploration et de téléchargement des données essentielles de la commande publique.
|
|
|
|
=> [colibre.fr](https://colibre.fr)
|
|
|
|
## Installation et lancement
|
|
|
|
```shell
|
|
# Copie et personnalisation du .env
|
|
cp template.env .env
|
|
nano .env
|
|
|
|
# Pour la production
|
|
uv run gunicorn app:server
|
|
|
|
# Pour avoir le debuggage et le hot reload
|
|
uv run run.py
|
|
```
|
|
|
|
## Déploiement
|
|
|
|
- **Production** (branche `main`, [colibre.fr](https://colibre.fr)) : déploiement manuel via un déclenchement de la Github Action [Déploiement](https://github.com/ColinMaudry/colibre/actions/workflows/deploy.yaml)
|
|
- **Test** (branche `dev`, [test.colibre.fr](https://test.colibre.fr)) : déploiement automatique à chaque push sur la branche `dev`, via la même Github Action.
|
|
|
|
Ne pas oublier de mettre à jour les fichier .env.
|
|
|
|
### Sauvegarde de la base utilisateurs
|
|
|
|
`users.sqlite` est sauvegardée toutes les heures sur S3 via un timer systemd. Pour lister les sauvegardes disponibles :
|
|
|
|
```bash
|
|
python -m src.backup list
|
|
```
|
|
|
|
Pour restaurer une sauvegarde, arrêtez le service, restaurez la base, puis redémarrez :
|
|
|
|
```bash
|
|
systemctl stop colibre
|
|
python -m src.backup restore backups/users-YYYYMMDDTHHMMSSZ.sqlite.gz.enc
|
|
systemctl start colibre
|
|
```
|
|
|
|
## Migrations de base de données
|
|
|
|
Les migrations SQLite s'appliquent **automatiquement au démarrage de l'app** — aucune action manuelle requise. Il suffit de redémarrer le service après un déploiement.
|
|
|
|
Pour vérifier quelles migrations ont été appliquées :
|
|
|
|
```bash
|
|
sqlite3 users.sqlite "SELECT id, applied_at FROM schema_migrations ORDER BY applied_at;"
|
|
```
|
|
|
|
Pour ajouter une migration, voir les instructions dans `src/migrations.py`.
|
|
|
|
## Liens connexes
|
|
|
|
- [decp-processing](https://github.com/ColinMaudry/decp-processing) (traitement et publication des données)
|
|
- [colin.maudry.com](https://colin.maudry.com) (blog)
|
|
|
|
## Notes de version
|
|
|
|
Voir [CHANGELOG](https://github.com/ColinMaudry/colibre/blob/main/CHANGELOG.md).
|