概要
タスクにかけた作業時間を、タイマーと手動ログで記録し、見積との差をサマリーで返す機能である。コアの機能に依存する。作業記録の合計は、山積みの残工数の計算に使う。タスク詳細は見積(estimated_minutes)を表示する。
振る舞い
タイマー
同じ利用者が同じタスクに同時に起動できるタイマーは 1 つである。
タイマーを停止すると task_timers の行を消し、経過時間を time_logs へ 1 行入れる。この 2 つは同じトランザクションで行う。
logged_minutesは経過秒数を分へ切り上げた値で、最低 1 分であるlogged_atは停止時刻を UTC+9 に固定して取った日付である。利用者のタイムゾーンは見ないnoteは NULL で入る。停止時にメモを受け取る引数は無いので、後からPUTで足す
工数サマリー
actual_minutes は担当者以外の記録も含むタスク単位の合計である。スケジュールの logged_minutes も同じ定義にしている。
estimated_minutes が無いタスクでは remaining_minutes が null、is_over が false になる。remaining_minutes は実績が見積を超えると負の値になる。
データ
time_logs
| 列 | 型 | 制約 | 説明 |
|---|---|---|---|
id |
UUID | PK | |
task_id |
UUID | NOT NULL, FK→tasks CASCADE | |
user_id |
UUID | NOT NULL, FK→users CASCADE | |
logged_minutes |
INT | NOT NULL CHECK (> 0) | 分単位で保持し、表示時に h/m へ変換する |
logged_at |
DATE | NOT NULL | 作業日 |
note |
TEXT | NULLABLE | |
created_at |
TIMESTAMPTZ | NOT NULL DEFAULT now() |
task_timers
動いているタイマーの表である。
| 列 | 型 | 制約 | 説明 |
|---|---|---|---|
task_id |
UUID | NOT NULL, FK→tasks CASCADE, PK(task_id, user_id) | |
user_id |
UUID | NOT NULL, FK→users CASCADE, PK(task_id, user_id) | |
started_at |
TIMESTAMPTZ | NOT NULL DEFAULT now() |
列の定義は m20260520000000_initial_schema.rs にある。
API
URL 基底パスは /v1/tenants/{tenant_id}/projects/{project_id} である。
| メソッド | パス | 説明 |
|---|---|---|
GET |
/tasks/{id}/time-logs |
ログ一覧(作業日の新しい順) |
POST |
/tasks/{id}/time-logs |
手動ログ追加 |
PUT |
/tasks/{id}/time-logs/{log_id} |
ログ編集(clear_note でメモを消す) |
DELETE |
/tasks/{id}/time-logs/{log_id} |
削除 |
POST |
/tasks/{id}/timer/start |
タイマー開始。既に動いていれば 409 |
POST |
/tasks/{id}/timer/stop |
タイマー停止とログ生成。生成したログ(TimeLogResponse)を返す。動いていなければ 409 |
GET |
/tasks/{id}/timer/status |
呼び出した本人のタイマー状態 |
GET |
/tasks/{id}/time-logs/summary |
工数サマリー(TimeLogSummaryResponse) |
GET /tasks/{id}/timer/status は、タイマーが動いていないとき is_running が false で、started_at と elapsed_minutes は null である。
認可
| 操作 | 誰が | スコープ |
|---|---|---|
| ログ一覧・サマリー・タイマー状態の取得 | プロジェクトに入れる人 | read:task |
| 手動ログ追加・タイマーの開始と停止 | プロジェクトに入れる人 | write:task |
| ログ編集 | 自分のログのみ | write:task |
| ログ削除 | 自分、またはテナントオーナー | write:task |
未実装と既知の制限
タイマーと作業ログの画面が無い。計画している画面は次のとおりである。
- タスク詳細の右ペインにタイマーのウィジェットを置き、見積・実績と、開始ボタンまたは経過時間つきの停止ボタンを出す
- 起動中はリアルタイムの経過時間を表示する
- 停止時に任意のメモを入力してからログを保存する
