library-picturebook-activity/docs/design/README.md

# 功能设计文档索引

## 超管端

| 文档 | 模块 | 状态 | 日期 |
|------|------|------|------|
| [统一用户管理](./super-admin/unified-user-management.md) | 用户中心 | 已实现（迭代中） | 2026-03-27 |
| [全部活动优化](./super-admin/activity-list-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
| [报名数据优化](./super-admin/registration-data-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
| [作品数据优化](./super-admin/works-data-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
| [评审进度优化](./super-admin/review-progress-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
| [成果发布优化](./super-admin/results-publish-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
| [内容管理模块](./super-admin/content-management.md) | 内容管理 | P0 已实现并优化 | 2026-03-31 |
| [机构管理优化](./super-admin/org-management.md) | 机构管理 | 已优化 | 2026-03-31 |
| [租户创建自动生成管理员](./super-admin/tenant-auto-create-admin.md) | 机构管理 | 已完成 | 2026-04-02 |

## 租户端（机构管理端）

| 文档 | 模块 | 状态 | 日期 |
|------|------|------|------|
| [租户端全面优化](./org-admin/tenant-portal-optimization.md) | 全模块 | 已优化 | 2026-03-31 |
| [数据统计看板](./org-admin/data-analytics-dashboard.md) | 数据统计 | 已实现 | 2026-03-31 |

## 用户端（公众端）

| 文档 | 模块 | 状态 | 日期 |
|------|------|------|------|
| [UGC社区升级](./public/ugc-platform-upgrade.md) | 整体架构 | 需求已确认 | 2026-03-27 |
| [UGC开发计划](./public/ugc-development-plan.md) | 开发排期 | P0已完成，P1进行中 | 2026-03-31 |
| [点赞&收藏](./public/like-favorite.md) | 社区互动 | 已实现 | 2026-03-31 |

## 评委端

（暂无）
-												Day4: 超管端设计优化 + UGC绘本创作社区P0实现

一、超管端设计优化
- 文档管理SOP体系建立，docs目录重组
- 统一用户管理：跨租户全局视角，合并用户管理+公众用户
- 活动监管全模块重构：全部活动（统计卡片+阶段筛选+SuperDetail详情页）、报名数据/作品数据/评审进度（两层合一扁平列表）、成果发布（去Tab+统计+隐藏写操作）
- 菜单精简：移除评委管理/评审规则/通知管理
- Bug修复：租户编辑丢失隐藏菜单、pageSize限制、主色统一

二、UGC绘本创作社区P0
- 数据库：10张新表（user_works/user_work_pages/work_tags等）
- 子女账号独立化：Child升级为独立User，家长切换+独立登录
- 用户作品库：CRUD+发布审核，8个API
- AI创作流程：提交→生成→保存到作品库，4个API
- 作品广场：首页改造为推荐流，标签+搜索+排序
- 内容审核（超管端）：作品审核+作品管理+标签管理
- 活动联动：WorkSelector作品选择器
- 布局改造：底部5Tab（发现/创作/活动/作品库/我的）

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-27 22:20:25 +08:00
+								# 功能设计文档索引
 								## 超管端
 								| 文档 | 模块 | 状态 | 日期 |
 								|------|------|------|------|
-												Day5: 超管端内容管理模块全面优化 + 广场推荐作品展示

作品审核：
- 批量通过/批量拒绝 + 撤销审核机制
- 默认筛选待审核，表格加描述预览+审核时间列
- 详情Drawer加上一个/下一个导航，审核后自动跳下一个
- 操作日志时间线展示，筛选下拉自动查询

作品管理：
- 修复筛选/排序失效，新增推荐中筛选
- 下架改为弹窗选择原因，取消推荐二次确认
- 详情Drawer补全描述/标签/操作按钮/操作日志
- 统计卡片可点击筛选，下架自动取消推荐

标签管理：
- 按分类分组卡片式展示，分类改为下拉选择
- 新增标签颜色字段（预设色+自定义）
- 上移/下移排序按钮，使用次数可点击跳转作品管理
- 新增/编辑时实时预览用户端标签效果

广场推荐：
- 新增推荐作品列表接口 GET /public/gallery/recommended
- 广场顶部新增「编辑推荐」横向滚动栏

文档更新：内容管理设计文档补充实施记录，UGC开发计划P1-1标记已完成

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-31 15:21:21 +08:00
+								| [统一用户管理](./super-admin/unified-user-management.md) | 用户中心 | 已实现（迭代中） | 2026-03-27 |
-												Day4: 超管端设计优化 + UGC绘本创作社区P0实现

一、超管端设计优化
- 文档管理SOP体系建立，docs目录重组
- 统一用户管理：跨租户全局视角，合并用户管理+公众用户
- 活动监管全模块重构：全部活动（统计卡片+阶段筛选+SuperDetail详情页）、报名数据/作品数据/评审进度（两层合一扁平列表）、成果发布（去Tab+统计+隐藏写操作）
- 菜单精简：移除评委管理/评审规则/通知管理
- Bug修复：租户编辑丢失隐藏菜单、pageSize限制、主色统一

二、UGC绘本创作社区P0
- 数据库：10张新表（user_works/user_work_pages/work_tags等）
- 子女账号独立化：Child升级为独立User，家长切换+独立登录
- 用户作品库：CRUD+发布审核，8个API
- AI创作流程：提交→生成→保存到作品库，4个API
- 作品广场：首页改造为推荐流，标签+搜索+排序
- 内容审核（超管端）：作品审核+作品管理+标签管理
- 活动联动：WorkSelector作品选择器
- 布局改造：底部5Tab（发现/创作/活动/作品库/我的）

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-27 22:20:25 +08:00
+								| [全部活动优化](./super-admin/activity-list-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
 								| [报名数据优化](./super-admin/registration-data-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
 								| [作品数据优化](./super-admin/works-data-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
 								| [评审进度优化](./super-admin/review-progress-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
 								| [成果发布优化](./super-admin/results-publish-optimization.md) | 活动监管 | 已实现（待验收） | 2026-03-27 |
-												Day5: 超管端内容管理模块全面优化 + 广场推荐作品展示

作品审核：
- 批量通过/批量拒绝 + 撤销审核机制
- 默认筛选待审核，表格加描述预览+审核时间列
- 详情Drawer加上一个/下一个导航，审核后自动跳下一个
- 操作日志时间线展示，筛选下拉自动查询

作品管理：
- 修复筛选/排序失效，新增推荐中筛选
- 下架改为弹窗选择原因，取消推荐二次确认
- 详情Drawer补全描述/标签/操作按钮/操作日志
- 统计卡片可点击筛选，下架自动取消推荐

标签管理：
- 按分类分组卡片式展示，分类改为下拉选择
- 新增标签颜色字段（预设色+自定义）
- 上移/下移排序按钮，使用次数可点击跳转作品管理
- 新增/编辑时实时预览用户端标签效果

广场推荐：
- 新增推荐作品列表接口 GET /public/gallery/recommended
- 广场顶部新增「编辑推荐」横向滚动栏

文档更新：内容管理设计文档补充实施记录，UGC开发计划P1-1标记已完成

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-31 15:21:21 +08:00
+								| [内容管理模块](./super-admin/content-management.md) | 内容管理 | P0 已实现并优化 | 2026-03-31 |
-												Day5: 机构管理模块优化 — 隐藏内部租户+后端搜索+快捷操作+新建引导

- 后端过滤系统内部租户（super/public/school等），列表只展示真实机构
- 搜索改为后端分页查询（keyword+tenantType参数），去掉前端过滤
- 表格新增登录地址列，一键复制完整URL
- 新增停用/启用快捷按钮（PATCH /tenants/:id/status）
- 新建机构成功后弹出引导，可直接跳转创建管理员账号
- 修复编辑弹窗因模板访问window导致的渲染崩溃

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-31 15:39:14 +08:00
+								| [机构管理优化](./super-admin/org-management.md) | 机构管理 | 已优化 | 2026-03-31 |
-												feat: 创建租户时自动生成管理员账号、角色和权限

创建租户改为事务化一站式操作：自动复制 gdlib 权限模板 + 补充基础管理权限，
创建 tenant_admin 角色和管理员用户，支持自定义账号密码。
前端表单增加管理员输入区块，成功弹窗展示凭据并支持一键复制。
同步实现 menuIds 菜单分配（消除原 TODO）。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-04-02 18:48:34 +08:00
+								| [租户创建自动生成管理员](./super-admin/tenant-auto-create-admin.md) | 机构管理 | 已完成 | 2026-04-02 |
-												Day4: 超管端设计优化 + UGC绘本创作社区P0实现

一、超管端设计优化
- 文档管理SOP体系建立，docs目录重组
- 统一用户管理：跨租户全局视角，合并用户管理+公众用户
- 活动监管全模块重构：全部活动（统计卡片+阶段筛选+SuperDetail详情页）、报名数据/作品数据/评审进度（两层合一扁平列表）、成果发布（去Tab+统计+隐藏写操作）
- 菜单精简：移除评委管理/评审规则/通知管理
- Bug修复：租户编辑丢失隐藏菜单、pageSize限制、主色统一

二、UGC绘本创作社区P0
- 数据库：10张新表（user_works/user_work_pages/work_tags等）
- 子女账号独立化：Child升级为独立User，家长切换+独立登录
- 用户作品库：CRUD+发布审核，8个API
- AI创作流程：提交→生成→保存到作品库，4个API
- 作品广场：首页改造为推荐流，标签+搜索+排序
- 内容审核（超管端）：作品审核+作品管理+标签管理
- 活动联动：WorkSelector作品选择器
- 布局改造：底部5Tab（发现/创作/活动/作品库/我的）

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-27 22:20:25 +08:00
-												Day5: 租户端全面优化 + 数据统计看板 + 成果发布完善

租户端基础设施：
- 新增工作台首页（欢迎信息/统计/待办/快捷操作/新手引导）
- 新增机构信息管理页（自助查看编辑机构信息）
- 修复403报错（fetchTenants加超管守卫）
- 修复权限（log:read/notice:update/notice:delete/contest:work:read）
- 修复评审规则组件映射

活动管理全模块优化（机构端视角）：
- 活动列表：加统计概览+精简列+筛选自动查询+发布弹窗修复+操作逻辑优化
- 创建/编辑活动：重构布局（去card嵌套+栅格响应式+分区卡片）
- 评委管理：统一主色调+冻结确认+导入导出disabled
- 报名管理：去Tab+统计+审核状态列+批量审核接口
- 报名记录：统计概览+去机构列+撤销审核+返回按钮+去参与方式列
- 作品管理：去Tab+统计+递交进度彩色+筛选修复（assignStatus/submitTime）
- 评审进度：去Tab+统计+实际完成率状态+筛选修复
- 评审规则：表格加评委数/计算方式+描述列修复+删除保护
- 成果发布：去Tab+统计+操作文案优化
- 通知公告：统一主色调+发布确认+操作逻辑+状态筛选+时间范围

成果发布详情功能补全：
- 计算得分/排名/设置奖项三步操作流程
- 排名列（金银铜徽章）+奖项列+奖项筛选
- 自定义奖项（动态添加行替代硬编码一二三等奖）
- 后端AutoSetAwardsDto改为awards数组格式

数据统计看板（新模块）：
- 后端analytics module（overview+review两个接口）
- 运营概览：6指标卡片+报名转化漏斗+ECharts月度趋势+活动对比表
- 评审分析：4效率卡片+评委工作量表+ECharts奖项分布饼图
- 菜单注册：数据统计→运营概览+评审分析

Bug修复：
- 超管重置其他租户用户密码报"用户不存在"
- gdlib登录快捷标签密码不一致
- 分配评委去掉评审时间限制

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-31 20:02:24 +08:00
+								## 租户端（机构管理端）
-												Day4: 超管端设计优化 + UGC绘本创作社区P0实现

一、超管端设计优化
- 文档管理SOP体系建立，docs目录重组
- 统一用户管理：跨租户全局视角，合并用户管理+公众用户
- 活动监管全模块重构：全部活动（统计卡片+阶段筛选+SuperDetail详情页）、报名数据/作品数据/评审进度（两层合一扁平列表）、成果发布（去Tab+统计+隐藏写操作）
- 菜单精简：移除评委管理/评审规则/通知管理
- Bug修复：租户编辑丢失隐藏菜单、pageSize限制、主色统一

二、UGC绘本创作社区P0
- 数据库：10张新表（user_works/user_work_pages/work_tags等）
- 子女账号独立化：Child升级为独立User，家长切换+独立登录
- 用户作品库：CRUD+发布审核，8个API
- AI创作流程：提交→生成→保存到作品库，4个API
- 作品广场：首页改造为推荐流，标签+搜索+排序
- 内容审核（超管端）：作品审核+作品管理+标签管理
- 活动联动：WorkSelector作品选择器
- 布局改造：底部5Tab（发现/创作/活动/作品库/我的）

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-27 22:20:25 +08:00
-												Day5: 租户端全面优化 + 数据统计看板 + 成果发布完善

租户端基础设施：
- 新增工作台首页（欢迎信息/统计/待办/快捷操作/新手引导）
- 新增机构信息管理页（自助查看编辑机构信息）
- 修复403报错（fetchTenants加超管守卫）
- 修复权限（log:read/notice:update/notice:delete/contest:work:read）
- 修复评审规则组件映射

活动管理全模块优化（机构端视角）：
- 活动列表：加统计概览+精简列+筛选自动查询+发布弹窗修复+操作逻辑优化
- 创建/编辑活动：重构布局（去card嵌套+栅格响应式+分区卡片）
- 评委管理：统一主色调+冻结确认+导入导出disabled
- 报名管理：去Tab+统计+审核状态列+批量审核接口
- 报名记录：统计概览+去机构列+撤销审核+返回按钮+去参与方式列
- 作品管理：去Tab+统计+递交进度彩色+筛选修复（assignStatus/submitTime）
- 评审进度：去Tab+统计+实际完成率状态+筛选修复
- 评审规则：表格加评委数/计算方式+描述列修复+删除保护
- 成果发布：去Tab+统计+操作文案优化
- 通知公告：统一主色调+发布确认+操作逻辑+状态筛选+时间范围

成果发布详情功能补全：
- 计算得分/排名/设置奖项三步操作流程
- 排名列（金银铜徽章）+奖项列+奖项筛选
- 自定义奖项（动态添加行替代硬编码一二三等奖）
- 后端AutoSetAwardsDto改为awards数组格式

数据统计看板（新模块）：
- 后端analytics module（overview+review两个接口）
- 运营概览：6指标卡片+报名转化漏斗+ECharts月度趋势+活动对比表
- 评审分析：4效率卡片+评委工作量表+ECharts奖项分布饼图
- 菜单注册：数据统计→运营概览+评审分析

Bug修复：
- 超管重置其他租户用户密码报"用户不存在"
- gdlib登录快捷标签密码不一致
- 分配评委去掉评审时间限制

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-31 20:02:24 +08:00
+								| 文档 | 模块 | 状态 | 日期 |
 								|------|------|------|------|
 								| [租户端全面优化](./org-admin/tenant-portal-optimization.md) | 全模块 | 已优化 | 2026-03-31 |
 								| [数据统计看板](./org-admin/data-analytics-dashboard.md) | 数据统计 | 已实现 | 2026-03-31 |
-												Day4: 超管端设计优化 + UGC绘本创作社区P0实现

一、超管端设计优化
- 文档管理SOP体系建立，docs目录重组
- 统一用户管理：跨租户全局视角，合并用户管理+公众用户
- 活动监管全模块重构：全部活动（统计卡片+阶段筛选+SuperDetail详情页）、报名数据/作品数据/评审进度（两层合一扁平列表）、成果发布（去Tab+统计+隐藏写操作）
- 菜单精简：移除评委管理/评审规则/通知管理
- Bug修复：租户编辑丢失隐藏菜单、pageSize限制、主色统一

二、UGC绘本创作社区P0
- 数据库：10张新表（user_works/user_work_pages/work_tags等）
- 子女账号独立化：Child升级为独立User，家长切换+独立登录
- 用户作品库：CRUD+发布审核，8个API
- AI创作流程：提交→生成→保存到作品库，4个API
- 作品广场：首页改造为推荐流，标签+搜索+排序
- 内容审核（超管端）：作品审核+作品管理+标签管理
- 活动联动：WorkSelector作品选择器
- 布局改造：底部5Tab（发现/创作/活动/作品库/我的）

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-27 22:20:25 +08:00
 								## 用户端（公众端）
 								| 文档 | 模块 | 状态 | 日期 |
 								|------|------|------|------|
 								| [UGC社区升级](./public/ugc-platform-upgrade.md) | 整体架构 | 需求已确认 | 2026-03-27 |
-												Day5: 超管端内容管理模块全面优化 + 广场推荐作品展示

作品审核：
- 批量通过/批量拒绝 + 撤销审核机制
- 默认筛选待审核，表格加描述预览+审核时间列
- 详情Drawer加上一个/下一个导航，审核后自动跳下一个
- 操作日志时间线展示，筛选下拉自动查询

作品管理：
- 修复筛选/排序失效，新增推荐中筛选
- 下架改为弹窗选择原因，取消推荐二次确认
- 详情Drawer补全描述/标签/操作按钮/操作日志
- 统计卡片可点击筛选，下架自动取消推荐

标签管理：
- 按分类分组卡片式展示，分类改为下拉选择
- 新增标签颜色字段（预设色+自定义）
- 上移/下移排序按钮，使用次数可点击跳转作品管理
- 新增/编辑时实时预览用户端标签效果

广场推荐：
- 新增推荐作品列表接口 GET /public/gallery/recommended
- 广场顶部新增「编辑推荐」横向滚动栏

文档更新：内容管理设计文档补充实施记录，UGC开发计划P1-1标记已完成

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-31 15:21:21 +08:00
+								| [UGC开发计划](./public/ugc-development-plan.md) | 开发排期 | P0已完成，P1进行中 | 2026-03-31 |
 								| [点赞&收藏](./public/like-favorite.md) | 社区互动 | 已实现 | 2026-03-31 |
-												Day4: 超管端设计优化 + UGC绘本创作社区P0实现

一、超管端设计优化
- 文档管理SOP体系建立，docs目录重组
- 统一用户管理：跨租户全局视角，合并用户管理+公众用户
- 活动监管全模块重构：全部活动（统计卡片+阶段筛选+SuperDetail详情页）、报名数据/作品数据/评审进度（两层合一扁平列表）、成果发布（去Tab+统计+隐藏写操作）
- 菜单精简：移除评委管理/评审规则/通知管理
- Bug修复：租户编辑丢失隐藏菜单、pageSize限制、主色统一

二、UGC绘本创作社区P0
- 数据库：10张新表（user_works/user_work_pages/work_tags等）
- 子女账号独立化：Child升级为独立User，家长切换+独立登录
- 用户作品库：CRUD+发布审核，8个API
- AI创作流程：提交→生成→保存到作品库，4个API
- 作品广场：首页改造为推荐流，标签+搜索+排序
- 内容审核（超管端）：作品审核+作品管理+标签管理
- 活动联动：WorkSelector作品选择器
- 布局改造：底部5Tab（发现/创作/活动/作品库/我的）

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

											
										
										
											2026-03-27 22:20:25 +08:00
 								## 评委端
 								（暂无）