Files
tempus/README.md
T
Romulus21andClaude Opus 5.5 63ddfd39d9 Ajoute l'URL du repo sur les projets
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>
2026-11-13 18:59:20 +01:00

89 lines
3.7 KiB
Markdown

# 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
```sh
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.
```sh
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`.
```sh
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) :
```sh
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.
```sh
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.