Favicon par défaut (static/favicon.svg) ; tant que /api/timer renvoie une entrée en cours, il alterne chaque seconde entre un point rouge plein et pâle, sur toutes les pages. État relu au chargement, après chaque requête htmx, au retour sur l'onglet et toutes les 20 s. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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
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.
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.
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) :
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.
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.