Files
tableau-de-bord/README.md
Antoine Van Elstraete bb0e57dbc6 docs: ajout service systemd et instructions de déploiement
- tableau-de-bord-pro.service : service Gunicorn pour www-data
- README : section production avec systemctl edit --full

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-11 20:55:38 +01:00

80 lines
2.4 KiB
Markdown

# Tableau de bord pro
Application web personnelle de suivi du temps de travail et des déplacements professionnels.
> Développée en vibe coding avec [Claude Sonnet 4.6](https://www.anthropic.com/claude) (Anthropic).
## Fonctionnalités
- **Journal de bord** : saisie quotidienne avec type de journée (travail, télétravail, garde, astreinte, formation, RTT, congé, maladie, férié), plages horaires et commentaire
- **Suivi des déplacements** : kilométrage par véhicule, estimation CO₂, calcul des frais réels selon le barème kilométrique fiscal
- **Solde congés / RTT** : suivi des jours posés et du solde restant
- **Rapports annuels** : kilométrage total, frais réels déductibles, répartition par type de journée
- **Véhicules électriques** : majoration de 20 % appliquée automatiquement sur les frais réels
## Installation
### Prérequis
- Python 3.11+
### Développement
```bash
# Cloner le dépôt
git clone ssh://git.antoineve.me/AntoineVe/tableau-de-bord.git
cd tableau-de-bord
# Créer l'environnement virtuel et installer les dépendances
python -m venv .venv
.venv/bin/pip install -r requirements.txt
# Lancer le serveur de développement
.venv/bin/python run.py
```
L'application est accessible sur `http://localhost:5000`.
### Production (systemd + Gunicorn)
Déploiement dans `/var/www/tableau-de-bord-pro/`, service géré par systemd.
```bash
# Copier l'application
sudo rsync -a --exclude='.venv' --exclude='instance' . /var/www/tableau-de-bord-pro/
cd /var/www/tableau-de-bord-pro
sudo python -m venv .venv
sudo .venv/bin/pip install -r requirements.txt
sudo chown -R www-data:www-data /var/www/tableau-de-bord-pro
# Installer le service
sudo cp tableau-de-bord-pro.service /etc/systemd/system/
# Configurer (notamment SECRET_KEY)
sudo systemctl edit --full tableau-de-bord-pro
# Activer et démarrer
sudo systemctl enable --now tableau-de-bord-pro
# Vérifier
sudo systemctl status tableau-de-bord-pro
```
### Configuration
Toute la configuration métier se trouve dans `config.toml` :
- **`[vehicles.*]`** : véhicules avec puissance fiscale, type de carburant et émissions CO₂
- **`[journeys.*]`** : profils de trajet avec distances par véhicule
- **`[bareme_kilometrique.YYYY.*]`** : barème fiscal par année et puissance (à mettre à jour chaque année)
### Tests
```bash
.venv/bin/python -m pytest
```
## Licence
[MIT](LICENSE.md) — Copyright (c) 2026 Antoine Van-Elstraete