フロントエンドの URL と、それを定義する Vike のページファイルの対応を示す。ルートは apps/frontend/src/pages/ のファイルシステムルーティングで決まり、+route は使っていない。ルートパラメータは camelCase で書く(@tenant、@projectKey、@taskId、@fileId、@userId)。
識別子の対応
バックエンド API は UUID ベースのパスを持ち、フロントエンドの URL は人間が読める識別子を使う。
| リソース | バックエンド | フロントエンド | 例 |
|---|---|---|---|
| テナント | UUID (tenant_id) |
display_id(スラグ) |
acme |
| プロジェクト | UUID (project_id) |
key(^[A-Z][A-Z0-9]{1,9}$) |
ENG |
| タスク | UUID または KEY-N |
KEY-N 形式 |
ENG-42 |
| ドキュメント | UUID | UUID(Drive ファイルの ID) | 3fa85f64-... |
| 利用者 | UUID | UUID | 3fa85f64-... |
タスクの KEY-N は seq_id と project.key から組み立てる。GET /v1/tenants/{tenant_id}/projects/{project_id}/tasks/{id} が UUID と KEY-N の両方を受けるので、フロントエンドは URL の値をそのまま渡せる。
テナントの display_id の形式(^[a-z0-9]+(?:-[a-z0-9]+)*$)を検査するのは作成ダイアログだけで、バックエンドは 1 文字以上であることしか検査しない。
URL 一覧
認証(テナント外)
サインイン前に開くページで、共通レイアウトの認証ガードの対象外である(+Layout.vue の isAuthPage)。
| URL | 説明 |
|---|---|
/signin |
サインイン |
/signup |
新規登録 |
/auth/reset-password |
パスワードリセット。?token= が無ければ申請フォーム、あれば再設定フォームを出す(パスワードリセットと変更)。メール内リンクもこの URL を指す |
/verify-email |
メールアドレスの確認。?token= はメール内リンクが付ける |
/desktop/authorize |
Koyori Desktop の承認(アカウント設定)。?port=&code_challenge=&state=&name= を受ける。未ログインならサインイン後に戻る |
/oauth/authorize |
MCP の OAuth の同意画面(MCP サーバー)。MCP クライアントが認可の要求を query に付けて開く。未ログインならサインイン後に戻る |
/invitations/accept?token= |
テナント招待の承諾(テナントとプロジェクトの認可)。未ログインならサインイン後に戻る |
アカウント設定(テナント外)
個人アカウントの設定はテナントに紐づかないため、/{tenant} の外に置く。
| URL | 説明 |
|---|---|
/settings/profile |
プロフィール編集(アカウント設定) |
/settings/security |
認証方法、2 段階認証、Koyori Desktop の端末(アカウント設定) |
/settings/tokens |
パーソナルアクセストークンの発行と取り消し(アカウント設定) |
/settings/apps |
連携中のアプリ(MCP の OAuth で許可した接続)の一覧と解除(アカウント設定) |
/settings/preferences |
環境設定 |
/settings/theme |
テーマ(配色の切り替え) |
/settings/experiments |
実験的機能の設定 |
管理者画面(テナント外)
is_admin = true の利用者だけが使う(サービス管理者)。
| URL | 説明 |
|---|---|
/admin/users |
全利用者の一覧と利用者の作成 |
/admin/users/{id} |
利用者の詳細と、認証の復旧の操作 |
/admin/settings |
一般の利用者登録の有効と無効 |
ルート
| URL | 説明 |
|---|---|
/ |
選択中のテナント(無ければ先頭のテナント)の /{tenant} へ移動する。テナントが一つも無ければワークスペースの作成を案内する |
テナントスコープ
| URL | 説明 |
|---|---|
/{tenant} |
テナントホーム(ダッシュボード)。タスクの絞り込み ?tab=(week・overdue・all。既定は今日)と ?page=(1 始まり)を持ち、既定値は URL から省く。URL は replaceState で書き、履歴を増やさない |
/{tenant}/my-tasks |
自分のタスク。タブ ?tab=(week・no_due_date・overdue・all。既定は今日)と読み込んだ件数 ?shown=(50 件ずつ。復元は API の上限の 200 件まで)を持ち、既定値は URL から省く。URL は replaceState で書き、履歴を増やさない |
/{tenant}/calendar |
テナントのタイムライン(スケジュール)。?from=YYYY-MM-DD(起点の月曜。省略時は今週)、?member= / ?project=(ID。繰り返し指定可)で絞り込み、?selected=KEY-N(詳細のオーバーレイで開いているタスク)を持つ。URL は replaceState で書き、履歴を増やさない |
/{tenant}/gantt |
テナントのガントチャート(スケジュール)。サイドバーの入口は実験的機能の「ガントチャート」(koyoriArcIntegration)を有効にしたときだけ出る。URL からページを開くこと自体は設定に関係なくできる。クエリは ?from=YYYY-MM-DD(範囲の起点。その週の月曜に丸める。省略時は今日の週の月曜から、目盛りに応じて前へ日を残した日)、?member=(担当者の ID。繰り返し指定可。unassigned で担当なし)、`?scale=day |
/{tenant}/settings |
テナント設定 |
/{tenant}/settings/members |
テナントメンバー管理 |
/{tenant}/users/{user_id} |
利用者のプロフィール(閲覧のみ) |
/{tenant}/projects/new |
プロジェクト作成 |
プロジェクトスコープ
{key} はプロジェクトキー(例: ENG)、{KEY-N} はタスク連番(例: ENG-42)である。
| URL | 説明 |
|---|---|
/{tenant}/projects/{key}/tasks |
タスク一覧。?view=table(既定は List)、?page=、?q=条件式、?selected=KEY-N(分割ビューで選択中のタスク)を持ち、既定値は URL から省く。URL は replaceState で書く |
/{tenant}/projects/{key}/tasks/{KEY-N} |
タスク詳細 |
/{tenant}/projects/{key}/docs |
ドキュメント一覧(Driveのドキュメント画面)。?q= でタイトル検索 |
/{tenant}/projects/{key}/docs/{file_id} |
ドキュメント詳細。{file_id} は Drive ファイルの UUID。?edit=1 で編集モード |
/{tenant}/projects/{key}/settings |
プロジェクト設定。メンバー管理もこの画面の節である |
/{tenant}/projects/{key}/gantt |
プロジェクトのガントチャート。テナントのガントと同じ画面を、そのプロジェクトのタスクに絞って出す。サイドバーのプロジェクトの入口は、テナントのガントと同じ実験的機能を有効にしたときだけ出る。クエリはテナントのガントと同じ |
/{tenant}/projects/{key}/reviews |
レビュー指摘の画面。?pr=618、?round=、?severity=、?state=、?finding=、?mine=1、?page=、?q=(PR 一覧の検索語)、?pr_state=(選んだ PR の状態。選んでいなければ載せない)を持つ |
ページファイル
新しい URL を追加または変更するときは、この表も同じ PR で更新する。パスはすべて apps/frontend/src/pages/ からの相対パスである。
| URL パターン | Vike ページファイル |
|---|---|
/ |
index/+Page.vue |
/signin |
signin/+Page.vue |
/signup |
signup/+Page.vue |
/verify-email |
verify-email/+Page.vue |
/auth/reset-password |
auth/reset-password/+Page.vue |
/desktop/authorize |
desktop/authorize/+Page.vue |
/oauth/authorize |
oauth/authorize/+Page.vue |
/invitations/accept |
invitations/accept/+Page.vue |
/settings/profile |
settings/profile/+Page.vue |
/settings/security |
settings/security/+Page.vue |
/settings/tokens |
settings/tokens/+Page.vue |
/settings/apps |
settings/apps/+Page.vue |
/settings/preferences |
settings/preferences/+Page.vue |
/settings/theme |
settings/theme/+Page.vue |
/settings/experiments |
settings/experiments/+Page.vue |
/admin/users |
admin/users/+Page.vue |
/admin/users/{id} |
admin/users/@userId/+Page.vue |
/admin/settings |
admin/settings/+Page.vue |
/{tenant} |
@tenant/+Page.vue |
/{tenant}/my-tasks |
@tenant/my-tasks/+Page.vue |
/{tenant}/calendar |
@tenant/calendar/+Page.vue |
/{tenant}/gantt |
@tenant/gantt/+Page.vue |
/{tenant}/settings |
@tenant/settings/+Page.vue |
/{tenant}/settings/members |
@tenant/settings/members/+Page.vue |
/{tenant}/users/{user_id} |
@tenant/users/@userId/+Page.vue |
/{tenant}/projects/new |
@tenant/projects/new/+Page.vue |
/{tenant}/projects/{key}/tasks |
@tenant/projects/@projectKey/tasks/+Page.vue |
/{tenant}/projects/{key}/tasks/{KEY-N} |
@tenant/projects/@projectKey/tasks/@taskId/+Page.vue |
/{tenant}/projects/{key}/docs |
@tenant/projects/@projectKey/docs/+Page.vue |
/{tenant}/projects/{key}/docs/{file_id} |
@tenant/projects/@projectKey/docs/@fileId/+Page.vue |
/{tenant}/projects/{key}/settings |
@tenant/projects/@projectKey/settings/+Page.vue |
/{tenant}/projects/{key}/gantt |
@tenant/projects/@projectKey/gantt/+Page.vue |
/{tenant}/projects/{key}/reviews |
@tenant/projects/@projectKey/reviews/+Page.vue |
| (エラー) | _error/+Page.vue |
URL を持たないファイルは次のとおりである。
| ファイル | 役割 |
|---|---|
+Layout.vue |
共通レイアウト(認証ガード、ヘッダー、サイドバー、パンくず) |
+Head.vue |
head |
+client.ts |
client 専用 entry |
+config.ts |
Vike の設定 |
@tenant/projects/@projectKey/tasks/@taskId/+data.ts |
説明の KFM 描画(サーバー) |
@tenant/projects/@projectKey/docs/@fileId/+data.ts |
本文の KFM 描画(サーバー) |
+Layout.vue はルート直下の一つだけで、テナント用やプロジェクト用のレイアウトは無い。
移行済みの URL
仮ページの /labels と /tasks はプロジェクトスコープへ移した。その後、プロジェクト配下の表示専用のラベルページは削除した(ラベルの管理は設定のラベル節にある)。いずれもページは残っておらず、転送はしない。
| 旧 URL | 移行先 |
|---|---|
/labels |
/{tenant}/projects/{key}/settings?section=labels |
/tasks |
/{tenant}/projects/{key}/tasks |
/{tenant}/projects/{key}/labels |
/{tenant}/projects/{key}/settings?section=labels |
未実装と既知の制限
次の URL は予定として残しているが、対応するページが無い。開くと _error/+Page.vue のエラーページになる。
| URL | 予定していた内容 | 現状 |
|---|---|---|
/{tenant}/drive、/{tenant}/drive/{folder_id} |
ドライブのファイルブラウザ。フォルダの識別子は UUID | 画面は未実装(Drive)。API はある |
/{tenant}/projects |
プロジェクト一覧 | ページなし。プロジェクトへの入口はサイドバーである |
/{tenant}/projects/{key} |
プロジェクトホーム | ページなし。プロジェクトの入口は /tasks である |
/{tenant}/projects/{key}/milestones |
マイルストーン一覧 | ページなし |
/{tenant}/projects/{key}/members |
プロジェクトメンバー | ページなし。settings の節で扱う |
/admin、/admin/tenants、/admin/audit-logs |
管理者ダッシュボード、テナントの管理、監査ログ(is_admin = true の利用者のみ) |
ページなし(サービス管理者) |
テナント直下のルートと /signin などの固定ルートは同じ階層にある。display_id に予約語の検査は無いので、固定ルートと同じ名前のテナントを作ると、そのテナントのホームと固定ルートが同じ URL になる。
決定の記録
| 日付 | 決定 | 理由 |
|---|---|---|
| 2026-05-31 | テナントの識別子は display_id(スラグ)にする |
UUID より読みやすい |
| 2026-05-31 | プロジェクトの識別子は key(大文字英数)にする |
バックエンドが validate_project_key で形式を固定しており、テナント内で一意である |
| 2026-05-31 | タスクの識別子は KEY-N 形式にする |
API が直接受ける(ENG-42) |
| 2026-05-31 | /projects/ セグメントを保持する |
/{tenant}/settings などのテナント固定ルートとプロジェクトキーが衝突しないよう分離する |
| 2026-05-31 | ドライブのフォルダの識別子は UUID にする | フォルダにスラグが無い |
| 2026-05-31 | 管理者ページは /admin/* に分離する |
is_admin フラグで保護し、テナントスコープから独立させる |
| 2026-08-19 | アカウント設定は /settings/* に分離する |
テナントに紐づかない |
| 2026-11-04 | パスワードリセットの URL を /forgot-password と /reset-password の二つに分けず、/auth/reset-password の一つにまとめる |
記録なし(日付は不明) |
| 2026-11-11 | プロジェクト配下の /labels ページを消し、転送は置かない |
表示専用でラベル管理は設定の節に重複していた。ページへの導線はサイドバーだけで、既存の /labels /tasks の廃止と同じく転送を持たない |
