用語とステータス
画面仕様とAPI仕様で、同じ言葉を同じ意味で使うための定義です。
用語集
| 用語 | 意味 | 具体例・注意点 |
|---|---|---|
| タスク | チームで共有する作業単位 | 「仕様書レビュー」。タイトルと担当者は必須、期限は任意 |
| 担当者 | タスクの実行責任者 | 画面ではユーザーを選び、APIでは assignee_id で指定 |
| 期限 | 作業を終える予定の日 | 2026-02-15。設定しないタスクもある |
| ステータス | 作業の進捗状態 | 未着手・進行中・完了 |
| 優先度 | 作業の優先順位 | 高・中・低。登録時の既定値は中 |
| フィルタ | 条件に合うタスクに絞る操作 | ステータスが「進行中」のものを表示 |
| 部分一致 | 入力した文字を含むものを探す方法 | 「レビュー」で「仕様書レビュー」を検索 |
| ページネーション | 一覧を複数ページに分ける仕組み | 1ページの表示上限は100件 |
ステータスの意味
| 値 | 状態 | 利用例 |
|---|---|---|
| 未着手 | 作業をまだ始めていない | 担当が決まり、着手を待っている |
| 進行中 | 作業している | 仕様書を読み、指摘を整理している |
| 完了 | 作業が終わっている | 指摘を共有し、レビューが終わった |
状態が変わる例
stateDiagram-v2
state "未着手" as Todo
state "進行中" as Doing
state "完了" as Done
Todo --> Doing: 作業を始める
Doing --> Done: 作業を終える
図は一般的な進捗の流れを示す例です。許可する状態変更をすべて定めた図ではありません。 編集画面では3種類のステータスを選べますが、遷移の制約は未定義です。
実装前に確認すること
登録直後のステータス、未着手から完了への直接変更、完了からの差し戻し条件を決めてください。 完了したタスクは再編集できますが、一覧から除外する条件やアーカイブ操作は未定義です。
次は 機能一覧と確認観点 で、利用者ができる操作を確認します。