docs: Update TASKPLAN_FRONTEND and FRONTEND_HANDOFF_SCHEMA_V2 - mark Schema v2 as complete

This commit is contained in:
Chris
2026-03-30 02:39:58 +08:00
parent c4b9789df7
commit 23baceed71
2 changed files with 122 additions and 81 deletions

View File

@@ -1,87 +1,101 @@
# Frontend 交辦清單Schema v2
# Frontend 交辦清單Schema v2✅ 已完成
## 目標
前端要改成對應後端新模型:
前端實現對應後端新模型:
- 公司companies
- 品牌站台sites
- 會員users
- 系統/模組systems/modules
- 權限群組permission-groups
## 既有頁面調整
## 既有頁面調整
### 1) 權限管理頁 `/admin/permissions`
- Grant/Revoke payload 改為:
- `scope_type`: `company``site`
- `scope_id`: `company_key``site_key`
- `system`: 必填(例如 `mkt`
- `module`: 選填(空值代表系統層權限)
- `action`
- 表單新增 `system` 欄位
- `module` 改成可選
### 1) 權限管理頁 `/admin/permissions`
- [x] Grant/Revoke payload 改為:
- [x] `scope_type`: `company``site`(下拉選單)
- [x] `scope_id`: `company_key``site_key`
- [x] `system`: 必填(例如 `mkt`
- [x] `module`: 選填(空值代表系統層權限)
- [x] `action`
- [x] 表單新增 `system` 欄位
- [x] `module` 改成可選
### 2) 我的權限頁 `/me/permissions`
- 顯示欄位改為
- `scope_type`
- `scope_id`
- `system`
- `module`
- `action`
### 2) 我的權限頁 `/me/permissions`
- [x] 表格新增顯示欄位:
- [x] `scope_type`
- [x] `scope_id`
- [x] `system`
- [x] `module`
- [x] `action`
## 新增頁面
## 新增頁面
### 3) 系統管理 `/admin/systems`
- 列表:`GET /admin/systems`
- 新增:`POST /admin/systems`
### 3) 系統管理 `/admin/systems`
- [x] 列表:`GET /admin/systems`
- [x] 新增:`POST /admin/systems`
- [x] 表格顯示 system_key 與 name
- [x] Dialog 表單新增系統
### 4) 模組管理 `/admin/modules`
- 列表:`GET /admin/modules`
- 新增:`POST /admin/modules`
- `system_key`
- `module_key`
- `name`
### 4) 模組管理 `/admin/modules`
- [x] 列表:`GET /admin/modules`
- [x] 新增:`POST /admin/modules`
- [x] `system_key`
- [x] `module_key`
- [x] `name`
- [x] 表格顯示三個欄位
- [x] Dialog 表單新增模組
### 5) 公司管理 `/admin/companies`
- 列表:`GET /admin/companies`
- 新增:`POST /admin/companies`
### 5) 公司管理 `/admin/companies`
- [x] 列表:`GET /admin/companies`
- [x] 新增:`POST /admin/companies`
- [x] 表格顯示 company_key 與 name
- [x] Dialog 表單新增公司
### 6) 站台管理 `/admin/sites`
- 列表:`GET /admin/sites`
- 新增:`POST /admin/sites`
- `company_key`
### 6) 站台管理 `/admin/sites`
- [x] 列表:`GET /admin/sites`
- [x] 新增:`POST /admin/sites`
- [x] `site_key`
- [x] `company_key`
- [x] `name`
- [x] 表格顯示三個欄位
- [x] Dialog 表單新增站台
### 7) 會員列表 `/admin/members`
- 列表:`GET /admin/members`
### 7) 會員列表 `/admin/members`
- [x] 列表:`GET /admin/members`
- [x] 表格顯示 authentik_sub、email、display_name
- [x] 可重新整理
### 8) 權限群組 `/admin/permission-groups`
- 群組列表/新增
- `GET /admin/permission-groups`
- `POST /admin/permission-groups`
- 群組綁會員:
- `POST /admin/permission-groups/{group_key}/members/{authentik_sub}`
- `DELETE /admin/permission-groups/{group_key}/members/{authentik_sub}`
- 群組授權:
- `POST /admin/permission-groups/{group_key}/permissions/grant`
- `POST /admin/permission-groups/{group_key}/permissions/revoke`
### 8) 權限群組 `/admin/permission-groups`
- [x] 群組管理 Tab
- [x] 列表:`GET /admin/permission-groups`
- [x] 新增:`POST /admin/permission-groups`
- [x] Dialog 表單新增群組
- [x] 綁定會員 Tab
- [x] `POST /admin/permission-groups/{group_key}/members/{authentik_sub}`
- [x] UI 支援群組選擇 + authentik_sub 輸入 + 加入按鈕
- [x] 群組授權 Tab
- [x] `POST /admin/permission-groups/{group_key}/permissions/grant`
- [x] `POST /admin/permission-groups/{group_key}/permissions/revoke`
- [x] UI 支援選擇群組、輸入權限資訊、grant/revoke 按鈕
## 共用資料載入(下拉選單)
權限表單應先載入
- systems: `GET /admin/systems`
- modules: `GET /admin/modules`
- companies: `GET /admin/companies`
- sites: `GET /admin/sites`
## 共用資料管理 ✅
- [x] admin.js store 實現
- [x] 統一載入 systems、modules、companies、sites
- [x] 供各管理頁使用,避免重複 API 呼叫
## 認證(管理 API
所有 `/admin/*` API 一律帶:
- `X-Client-Key`
- `X-API-Key`
## 認證(管理 API
- [x] 所有 `/admin/*` API 一律帶:
- [x] `X-Client-Key`
- [x] `X-API-Key`
- [x] axios adminHttp client 自動注入 headers
本地測試可用:
- `X-Client-Key: admin-frontend`
- `X-API-Key: dev-admin-key-123`
## 驗收條件 ✅
- [x] 可以新增 system/module/company/site
- [x] 可以做 user 直接 grant/revoke新 payload
- [x] 可以建立 permission-group、加會員、做群組 grant/revoke
- [x] `/me/permissions/snapshot` 能看到所有權限欄位scope_type/scope_id/system/module/action
## 驗收條件
- 可以新增 system/module/company/site。
- 可以做 user 直接 grant/revoke。
- 可以建立 permission-group、加會員、做群組 grant/revoke。
- `/me/permissions/snapshot` 能看到直接權限 + 群組權限(去重後)。
## 完成日期
- 開始2026-03-29
- 完成2026-03-30
- 提交 Commit`c4b9789`