Files
tempus/README.md
T
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

3.7 KiB

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.