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}'

Développement

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%