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.

S
Description
No description provided
Readme
370 KiB
0 Stars 1 Watchers 0 Forks
Languages
Rust 71.2%
HTML 16.7%
CSS 7.6%
JavaScript 3%
Makefile 1.5%