Files
tempus/README.md
Romulus21andClaude Opus 5.5 a3902c9662 Ajoute le déploiement en prod locale
Makefile (setup, deploy avec sauvegarde de la base, status, logs, dev),
vhost Apache en reverse proxy sur tempus.loc et service systemd
utilisateur, binaire installé dans /var/www/tempus.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 18:27:16 +01:00

89 lines
3.7 KiB
Markdown

# Tempus
Time tracker local pour suivre le temps passé sur chaque projet de chaque client.
Un seul binaire Rust (axum + SQLite) qui sert une interface web et une API JSON.
## Lancer
```sh
cargo run --release
# → http://127.0.0.1:7878
```
| Variable | Défaut | Rôle |
|---------------|------------------------------------------|------------------------------------|
| `TEMPUS_DB` | `~/.local/share/tempus/tempus.db` | Chemin (ou URL `sqlite:`) de la base |
| `TEMPUS_ADDR` | `127.0.0.1:7878` | Adresse d'écoute |
| `RUST_LOG` | `tempus=info,tower_http=info` | Niveau de logs |
Aucune authentification : le service est prévu pour tourner en local.
## Pages
- `/` — timer (démarrer / basculer / arrêter) et entrées du jour
- `/entries` — liste filtrable, saisie manuelle, édition inline (⚠ = chevauchement)
- `/reports` — totaux par client, projet ou jour sur une période
- `/clients` — clients et projets (nom, couleur, archiver, supprimer)
## API JSON (`/api`)
| Méthode | Route |
|--------------|----------------------------------------------------|
| GET, POST | `/clients` (`?archived=true` pour inclure les archivés) — `{"name", "color"?}` |
| PATCH, DELETE| `/clients/{id}` — `{"name"?, "archived"?, "color"?}` |
| GET, POST | `/clients/{id}/projects` — `{"name", "color"?}` |
| PATCH, DELETE| `/projects/{id}` — `"color": null` pour reprendre celle du client |
| GET | `/timer` — entrée en cours ou `null` |
| POST | `/timer/start` `{"project_id", "note"?}` · `/timer/stop` |
| GET, POST | `/entries` (`?from&to&client_id&project_id`) |
| PATCH, DELETE| `/entries/{id}` |
| GET | `/reports?from&to&group_by=client\|project\|day&client_id&project_id` |
Les couleurs sont au format `#rrggbb`. Un client reçoit automatiquement une couleur
de la palette s'il n'en précise pas ; un projet sans couleur utilise celle de son client
(`effective_color` dans les réponses).
Les dates d'entrées sont en RFC 3339 (`2026-10-26T09:00:00+01:00`) ; les périodes
(`from`, `to`, inclusives) sont des dates `YYYY-MM-DD` dans le fuseau local.
```sh
curl -XPOST localhost:7878/api/clients -H 'content-type: application/json' -d '{"name":"Acme"}'
curl -XPOST localhost:7878/api/timer/start -H 'content-type: application/json' -d '{"project_id":1}'
```
## Production locale
Binaire dans `/var/www/tempus`, service systemd utilisateur, vhost Apache
(reverse proxy) sur http://tempus.loc → `127.0.0.1:3110`.
```sh
make setup # une fois (sudo) : dossier, vhost, /etc/hosts, service
make deploy # compile, sauvegarde la base, installe, redémarre
make status # / make logs
```
La base de prod est `/var/www/tempus/tempus.db` ; chaque `make deploy` la copie
dans `/var/www/tempus/backups/` (10 dernières conservées). Variables
surchargeables : `DEPLOY_DIR`, `HOST`, `ADDR`, `SERVICE`.
## Développement
Rechargement automatique (recompile, redémarre et rafraîchit le navigateur) :
```sh
cargo install watchexec-cli # une fois
make dev
```
La feature `livereload` injecte un script dans les pages (pas dans les fragments
htmx) et désactive le cache des assets ; elle n'est jamais active par défaut.
```sh
cargo test
cargo clippy --all-targets -- -D warnings
```
Le schéma est dans `migrations/` (appliqué automatiquement au démarrage).
Les horodatages sont stockés en UTC au format fixe `YYYY-MM-DDTHH:MM:SSZ`
(voir `src/clock.rs`) pour que les comparaisons SQL sur le texte restent valides.