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>
89 lines
3.7 KiB
Markdown
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"?}` |
|
|
| 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.
|
|
|
|
```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.
|