概要
テナントカレンダーに、メンバーごと・日ごとの作業量を棒(山)で出す機能である。積む量は見積ではなく残工数(見積 − 実績)で、複数の担当者がいるタスクは担当者で分ける。カレンダー上で帯の始点を動かして開始予定日を変えられるので、山を見ながら手で崩せる。スケジュールの schedule API とカレンダー画面、コアの planned_start_on / estimated_minutes、作業時間追跡の time_logs の上に作る。範囲外のものは未実装と既知の制限の節に書く。
用語
| 語 | 意味 |
|---|---|
| 山積み | メンバーごと・日ごとに積んだ作業時間の棒 |
| 残工数 | max(estimated_minutes − logged_minutes, 0)。タスク単位 |
| 配分期間 | 残工数を均等に割って積む平日の集合。決め方は配分期間の小節に書く |
| 上限 | 1 日に積める時間。固定 6 時間 |
| 超過 | ある日の山が上限を超えた状態 |
| 山崩し | 開始予定日を変えて山の形を変える操作 |
振る舞い
計算はすべてクライアント側(lib/calendar/load.ts)で行う。サーバーは API の節の 1 項目と 1 引数で材料を渡すだけである。
積む対象
次をすべて満たすタスクを積む。
- アーカイブ済み・削除済みでない(schedule API が返すもの)
- 完了ステータス(
is_done_state = true)でない planned_start_onがある- Soft 締切がある。Hard 締切だけのタスクは積まない
estimated_minutesがあり、残工数が 1 分以上
配分期間
配分期間は次の式で決める。
始点 = max(今日, min(planned_start_on, Soft 締切の日付))
終点 = max(planned_start_on, Soft 締切の日付)
配分期間 = 始点〜終点(両端含む)の平日- 今日より前の日には積まない
- 「今日」は表示タイムゾーン(ブラウザ)での日付である。Soft 締切の日付への落とし方はスケジュールの含める条件と同じである
- 配分期間が空のときは 1 日に全部積む。締切を過ぎているなら今日に積む
- 始点〜終点が土日だけなら、その直前の平日に全部積む。直前の平日が今日より前なら今日に積む
- 開始予定日が締切より後のタスクは、スケジュールの含める条件と同じく両端を入れ替えて扱う
担当者ごと・日ごとの時間
1 人が 1 日に受け持つ時間は次の式で決める。
1 日あたり = 残工数 / 60 ÷ 配分期間の日数
1 人あたり = 1 日あたり ÷ 担当者数- 担当者数は
task_assigneesの件数である。roleは見ず、primaryとassigneeを区別しない - 担当者がいないタスクは積まない。「担当者なし」行に山は出さない
超過
メンバーの 1 日の合計が上限(6 時間)を超えた日を超過とする。ちょうど 6 時間は超過でない。
API
専用のエンドポイントは無い。既存のエンドポイントを次のように使う。
| メソッド | パス | 説明 |
|---|---|---|
| GET | /v1/tenants/{tenant_id}/schedule |
山の材料を取る。山積みのためにある項目は tasks[].logged_minutes、クエリは include_overdue である |
| PUT | /v1/tenants/{tenant_id}/projects/{project_id}/tasks/{id} |
山崩しの確定。planned_start_on だけを載せて送る |
logged_minutes と include_overdue は handler::handlers::schedule にあり、openapi.json にも反映している。項目の定義はスケジュールの APIに書く。
logged_minutes の規則は次のとおりである。
- 集計は SQL 側の相関サブクエリで行う。Rust 側で
time_logsを全件取って足さない - 定義は
GET /tasks/{id}/time-logs/summaryのactual_minutesと同じで、乖離させない ScheduleTaskは CLI が読むのでDeserializeを維持する
include_overdue の規則は次のとおりである。
include_overdueにより期間外から追加する対象は、Soft 締切・開始予定日・見積があり未完了のタスクに限る。期間に重なるタスクはこの条件に関わらず通常どおり返す- 積む対象のうち残工数と担当者は、追加する対象を選ぶときにも見ない
- 表示期間より前に締切を過ぎたタスクは期間判定で返らないので、このクエリが無いと「今日に全部積む」の材料が揃わない
- 画面は表示期間が今日を含むときにだけ
include_overdue=trueを付ける - 締切超過のタスクは期間外なので帯には出ず、山(今日の棒)にだけ積む。期間外のタスクのうち山に積めないものは、画面が受け取った後で捨てる
認可
| 操作 | 誰が | スコープ |
|---|---|---|
| schedule API の取得 | スケジュールの認可と同じ | read:task |
| 山崩しの更新 | タスク更新と同じ。プロジェクトの書き込み権限が要る | write:task |
カレンダーに見えていても更新できないタスクはある。その場合の 403 は画面で処理する(失敗時の小節)。
画面
| 項目 | 値 |
|---|---|
| URL | /{tenant}/calendar |
山の表示
- 各メンバー行の最上段に、棒と数字を出す。棒の高さは上限 6 時間を段の高さとする比率である。超過分は上限の線を越えて描き、警告色にする
- 棒にマウスを乗せると、その日のタスク内訳(
KEY-N、1 人あたりの時間)を出す - 読み上げ文言は
2026-10-14 の残り 7h(上限 6h を超過)の形である - 「担当者なし」行には棒を出さない
- メンバー・プロジェクトの絞り込みはクライアント側で行う。絞り込んでも、山は絞り込み前の全タスクで計算する
手動の山崩し
- 帯(開始予定日のあるタスク)を横にドラッグすると、始点だけが日単位で動く。終点は締切なので動かない
- タッチの横スワイプはスクロールに使うので、タッチではキーボード操作かタスク詳細で変える
- キーボードでは、帯にフォーカスして
←/→で 1 日ずつ動かし、Enterで確定、Escで取消する - ドラッグ中は山をローカルで再計算して追従させる。確定前に結果が見える
- 確定時に
planned_start_onだけを送る。成功したら schedule のクエリを無効化して再取得する - 新しい開始予定日が Soft 締切の日付より後になる位置へは置けず、タスク作成ダイアログと同じ警告を出す。サーバーは検証しないので画面で止める
- Soft 締切の日付への落とし方は、帯の終点と同じくスケジュールの含める条件(表示タイムゾーン)に従う
- 開始予定日の無いタスク(締切の点と Soft〜Hard の帯)は動かせない。開始予定日の設定はタスク詳細から行う
- 開始予定日を元の位置より表示範囲の外へは動かさず、帯が範囲から外れる位置にも置かない。帯が消えると確定も取消もできないためである
- 確定前の移動は、フォーカスを外す・別の帯をドラッグする・ドラッグが途中で切れると取り消す
- 送信中は確定も取消も受け付けない
- 変更は
planned_start_changed履歴に記録される
失敗時
- 403 / 404 は、帯を元の位置に戻し、「このタスクは変更できません」を出す
- その他の失敗は、帯を元の位置に戻し、エラー内容を出す
- 楽観更新はしない。ドラッグ中の追従は見た目だけで、確定前の状態に戻せる
コンポーネント
| 内容 | 場所 |
|---|---|
| 山の計算規則 | lib/calendar/load.ts |
| 棒の表示とドラッグ・キーボードの操作 | components/calendar/CalendarTimeline.vue |
today の受け渡し・include_overdue の付与・期間外タスクの間引き |
pages/@tenant/calendar/+Page.vue |
未実装と既知の制限
この機能の対象外としているものは次のとおりである。
- 人ごとの稼働時間・テナントの休日。上限は 1 日 6 時間・土日非稼働・祝日なしの固定である
- 自動の山崩し(並べ替えの探索)
- 過去の日に実績を描くこと
決定の記録
| 日付 | 決定 | 理由 |
|---|---|---|
| 2026-10-20 | 積む量は残工数にする | 見積の均等割りは「残り何時間か」の近似にすぎないので、作業記録の分を引く |
| 2026-10-20 | logged_minutes は担当者以外の記録も含むタスク単位の合計にする |
残工数はタスクの性質であり、サマリー API の actual_minutes と定義を揃える |
| 2026-10-20 | 過去の日には積まない | 過去に実績を描くには日別の記録が要り、schedule API の応答が膨らむ |
| 2026-10-20 | 締切超過の残工数は今日に全部積む。表示期間より前に締切を過ぎたものは include_overdue で取る |
消すと超過が見えなくなる。表示期間より前に締切を過ぎたものは schedule API が返さない。取得期間を広げる案は 92 日の上限で漏れが残る |
| 2026-10-20 | include_overdue で期間外から追加する対象を、Soft 締切・開始予定日・見積があり未完了のタスクに限る |
締切超過のタスクを毎回すべて取らない |
| 2026-10-20 | 土日だけの期間は直前の平日に積む | 今日に積むと、表示期間より後の土日のタスク(schedule API が返さない)だけが漏れ、見ている週によって今日の山が変わる。表示期間は月曜始まりなので、直前の平日は期間内か期間より後に収まる |
| 2026-10-20 | 開始予定日の無いタスクは積まない | 今日から積むと未着手の全タスクが今日に乗り、山が意味を失う。開始予定日は「いつやるか」の意思表示として入れてもらう |
| 2026-10-20 | 担当者の分け方は均等割りにする。role の正規化もしない |
比率を持つには task_assignees に列が要り、入力の手間に見合う根拠がまだ無い |
| 2026-10-20 | 上限は 6 時間固定を維持する | 人別の稼働時間と休日は別の仕様で扱う |
| 2026-10-20 | 山崩しで動かすのは開始予定日だけにする | 締切をカレンダーから動かすと通知や期限超過の判定に波及する |
| 2026-10-20 | 計算はクライアントに置く | 92 日・500 件の上限内で足り、サーバーに集計エンドポイントを足す理由がまだ無い |
| 2026-10-20 | 山は絞り込み前の全タスクで計算する | プロジェクトで絞ったときに他プロジェクトの負荷が消えると、超過を見落とす |
| 2026-10-20 | 見積を期間で均等に割って積む最初の規則を、現在の規則に置き換える | 最初の規則は積む量が estimated_minutes、期間が開始予定日〜Soft 締切で、過去の日にも積み、締切超過は期間なしとして積まず、primary だけに全額を積んでいた。現在は残工数を今日〜Soft 締切に切り詰めて積み、過去の日には積まず、締切超過は今日に全部積み、全担当者で均等に割る |
| 2026-10-20 | 棒の見た目と数字の規則を分けて置く | 規則を変えると数字が変わるので、見た目の変更と混ぜるとテストで切り分けられない |
