Colonne projects.repo_url (migration 0003), exposée par l'API (repo_url à la création, "" ou null pour l'effacer) et éditable sur la page clients ; une icône ouvre le repo dans un nouvel onglet. Seules les URL http(s) sont acceptées. 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"?, "repo_url"?} |
| PATCH, DELETE | /projects/{id} — "color": null pour reprendre celle du client, "repo_url": "" pour l'effacer |
| 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.