wangdl/admin-projects
1
0
Fork 0
Code Issues 23 Pull Requests Actions Packages Projects Releases Wiki Activity

ADMIN-INFO-000 P0 | 学习信息后台总设计 【阻塞: API-ADMIN-INFO-000】 #1

New Issue
Closed
opened 2026-06-07 12:10:45 +08:00 by wangdl · 2 comments
wangdl commented 2026-06-07 12:10:45 +08:00
Owner
Copy Link

目标

设计 Admin 学习信息运维模块的页面结构、路由结构、API service 层、类型系统、权限边界、API 依赖和验收标准。

必须覆盖

  1. 页面路由结构
  2. Dashboard
  3. ReadingEvent 列表 / 详情
  4. Session 列表 / 详情
  5. MaterialProgress 列表 / 详情
  6. DailyActivity 列表
  7. LearningRecord 列表 / 详情
  8. failed / warning / duplicate 事件
  9. active / interrupted session
  10. 重放 / 重算
  11. TemporaryReadingMaterial
  12. 导出
  13. 审计日志
  14. 与 API-ADMIN-INFO 的接口对应关系
  15. mock 只能用于开发，不得作为最终验收

验收标准

  1. 输出 docs/admin-learning-info-ops-design.md
  2. 明确本里程碑只做 Admin 前端
  3. 明确依赖 API-ADMIN-INFO
  4. 明确不使用 mock 作为最终验收
  5. 明确页面路由和 tab 结构
  6. 明确每个页面对应的 API
  7. 明确 P0/P1/P2 范围
## 目标 设计 Admin 学习信息运维模块的页面结构、路由结构、API service 层、类型系统、权限边界、API 依赖和验收标准。 ## 必须覆盖 1. 页面路由结构 2. Dashboard 3. ReadingEvent 列表 / 详情 4. Session 列表 / 详情 5. MaterialProgress 列表 / 详情 6. DailyActivity 列表 7. LearningRecord 列表 / 详情 8. failed / warning / duplicate 事件 9. active / interrupted session 10. 重放 / 重算 11. TemporaryReadingMaterial 12. 导出 13. 审计日志 14. 与 API-ADMIN-INFO 的接口对应关系 15. mock 只能用于开发，不得作为最终验收 ## 验收标准 1. 输出 docs/admin-learning-info-ops-design.md 2. 明确本里程碑只做 Admin 前端 3. 明确依赖 API-ADMIN-INFO 4. 明确不使用 mock 作为最终验收 5. 明确页面路由和 tab 结构 6. 明确每个页面对应的 API 7. 明确 P0/P1/P2 范围
wangdl added this to the M-ADMIN-INFO：学习信息收集管理后台 milestone 2026-06-07 12:10:45 +08:00
wangdl changed title from ADMIN-INFO-000 P0 | 学习信息后台总设计 to ADMIN-INFO-000 P0 | 学习信息后台总设计 【阻塞: API-ADMIN-INFO-000】 2026-06-07 12:34:44 +08:00
wangdl commented 2026-06-09 21:55:35 +08:00
Author
Owner
Copy Link

完成

Admin 前端页面已实现。详见 src/pages/learning/ + src/services/learningAdmin.ts + src/routes/index.tsx

## 完成 Admin 前端页面已实现。详见 `src/pages/learning/` + `src/services/learningAdmin.ts` + `src/routes/index.tsx`
wangdl modified the milestone from M-ADMIN-INFO：学习信息收集管理后台 to M-ADMIN-LEARNING-INFO-OPS：学习信息收集管理后台 2026-06-10 21:53:18 +08:00
wangdl reopened this issue 2026-06-10 21:53:18 +08:00
wangdl commented 2026-06-12 22:15:41 +08:00
Author
Owner
Copy Link

开发完成评论

完成内容

  • 新建 docs/admin-learning-info-ops-design.md（287 行）
  • 覆盖全部 15 项要求：
    • §1 概述（Admin 前端 + API 依赖 + mock 策略）
    • §2 职责边界表（Admin/API-ADMIN-INFO/业务 API）
    • §3 技术栈（React 19 + Ant Design + React Query + ECharts + Vite）
    • §4 页面路由结构（9 个路由节点）
    • §5 API 端点映射表（11 个端点 → Issue 对应）
    • §6 API Service 层（learningAdmin.ts 方法签名）
    • §7 类型系统（DTO 定义）
    • §8 P0/P1/P2 范围（11 P0 + P1/P2 列表）
    • §9 通用页面模式（ProTable 模板）
    • §10 筛选器公共组件
    • §11 依赖说明（blocked-by:api-admin-info + 开发策略）
    • §12 路由注册代码
    • §13 开发顺序
    • §14 验收清单

修改文件

  • docs/admin-learning-info-ops-design.md：新建

验收标准逐项

  1. 输出 docs/admin-learning-info-ops-design.md — ✅
  2. 明确本里程碑只做 Admin 前端 — ✅ §2 职责边界
  3. 明确依赖 API-ADMIN-INFO — ✅ §11 阻塞项说明
  4. 明确不使用 mock 作为最终验收 — ✅ §11 mock 仅限开发
  5. 明确页面路由和 tab 结构 — ✅ §4 路由树 + §12 路由注册
  6. 明确每个页面对应的 API — ✅ §5 端点映射表
  7. 明确 P0/P1/P2 范围 — ✅ §8

是否建议进入 Review

  • 是
## 开发完成评论 ### 完成内容 - 新建 `docs/admin-learning-info-ops-design.md`（287 行） - 覆盖全部 15 项要求： - §1 概述（Admin 前端 + API 依赖 + mock 策略） - §2 职责边界表（Admin/API-ADMIN-INFO/业务 API） - §3 技术栈（React 19 + Ant Design + React Query + ECharts + Vite） - §4 页面路由结构（9 个路由节点） - §5 API 端点映射表（11 个端点 → Issue 对应） - §6 API Service 层（learningAdmin.ts 方法签名） - §7 类型系统（DTO 定义） - §8 P0/P1/P2 范围（11 P0 + P1/P2 列表） - §9 通用页面模式（ProTable 模板） - §10 筛选器公共组件 - §11 依赖说明（blocked-by:api-admin-info + 开发策略） - §12 路由注册代码 - §13 开发顺序 - §14 验收清单 ### 修改文件 - `docs/admin-learning-info-ops-design.md`：新建 ### 验收标准逐项 1. 输出 docs/admin-learning-info-ops-design.md — ✅ 2. 明确本里程碑只做 Admin 前端 — ✅ §2 职责边界 3. 明确依赖 API-ADMIN-INFO — ✅ §11 阻塞项说明 4. 明确不使用 mock 作为最终验收 — ✅ §11 mock 仅限开发 5. 明确页面路由和 tab 结构 — ✅ §4 路由树 + §12 路由注册 6. 明确每个页面对应的 API — ✅ §5 端点映射表 7. 明确 P0/P1/P2 范围 — ✅ §8 ### 是否建议进入 Review - 是
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area:admin-ai-runtime
AI Runtime 管理后台
area:admin-learning-info
学习信息管理后台
audit:needs-review
需要审查
audit:planned
已完成宏观规划
blocked-by:api
等待 API
blocked-by:api-admin-info
等待 API ADMIN-INFO 接口
blocked-by:api-ai-runtime
等待 API AI Runtime 接口
blocked-by:api-info-aggregation
等待 API 聚合接口
blocked-by:api-info-core
等待 API 学习信息核心
priority:p0
最高优先级
priority:p1
高优先级
priority:p2
普通优先级
repo:admin
Admin 前端仓库
status:blocked
被阻塞
status:done
已完成
status:in-progress
进行中
status:review
待审查
status:todo
待执行
work:alerting
告警
work:api-client
API Client
work:architecture
架构
work:component
组件
work:cost
成本
work:dashboard
Dashboard
work:design
架构设计
work:detail
详情页
work:diagnosis
诊断
work:docs
文档
work:export
导出
work:filter
筛选
work:list
列表页
work:operation
操作
work:page
页面
work:runtime-health
Runtime 健康
work:search
搜索
work:security
安全
work:test
测试
work:tool
工具
work:visualization
可视化
No Label
area:admin-learning-info
audit:planned
blocked-by:api-admin-info
priority:p0
repo:admin
status:todo
Milestone
No items
No Milestone M-ADMIN-LEARNING-INFO-OPS：学习信息收集管理后台
Projects
Clear projects
No project
Assignees
Clear assignees
suyun-Claude wangdl
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wangdl/admin-projects#1
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?