Przeglądaj źródła

docs: update design docs and directory references

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
Sisyphus 5 miesięcy temu
rodzic
commit
685c04d2eb

+ 11 - 2
AGENTS.md

@@ -42,7 +42,10 @@ zxyj/
 └── docs/               # 文档
     ├── superpowers/    # AI 开发工具配置
     ├── specs/          # 设计文档
-    └── plans/          # 实现计划
+    ├── plans/          # 实现计划
+    ├── 需求分析/       # 需求分析文档
+    ├── 系统设计/       # 系统设计文档
+    └── 系统测试/       # 系统测试文档
 ```
 
 ## JAVA LSP 配置
@@ -78,6 +81,9 @@ zxyj/
 | 添加小程序页面 | `zxyj-frontend/pages/` | 需在 pages.json 注册 |
 | 修改页面样式 | `zxyj-frontend/uni.scss` | 全局样式变量 |
 | 数据库配置 | `zxyj-backend/src/main/resources/application.yml` | MySQL 连接 |
+| 需求分析文档 | `docs/需求分析/` | 需求分析与范围说明 |
+| 系统设计文档 | `docs/系统设计/` | 总体/详细设计说明 |
+| 系统测试文档 | `docs/系统测试/` | 测试计划、用例与报告 |
 
 ## CODE MAP
 
@@ -157,7 +163,10 @@ zxyj/
 ├── zxyj-frontend/AGENTS.md        # 小程序前端文档
 ├── zxyj-web/AGENTS.md             # Web管理端文档
 ├── docs/superpowers/AGENTS.md     # AI开发工具配置
+├── docs/需求分析/                # 需求分析文档
+├── docs/系统设计/                # 系统设计文档
+├── docs/系统测试/                # 系统测试文档
 └── tests/AGENTS.md                # 测试策略文档
 ```
 
-每个子目录的AGENTS.md提供该模块的详细信息和特定约定。
+每个子目录的AGENTS.md提供该模块的详细信息和特定约定。

+ 37 - 0
docs/superpowers/specs/2026-03-31-UI交互设计.md

@@ -143,4 +143,41 @@
 
 ---
 
+## 六、补充页面与交互
+
+### 6.1 首次登录角色选择页
+- 用户首次登录后,系统应优先展示角色选择页。
+- 角色选项应包括指导师、家长、孩子三类。
+- 用户完成选择后,应进入对应的资料完善或首页流程。
+
+### 6.2 指导师资料完善页
+- 页面应展示身份证号、性别、照片、证书号等字段。
+- 页面应支持图片上传与表单校验。
+- 提交成功后应跳转至对应首页。
+
+### 6.3 邀请码绑定页
+- 家长应在页面中输入邀请码完成绑定。
+- 系统应展示绑定结果及绑定成功提示。
+- 绑定成功后应进入家庭主页或任务页。
+
+### 6.4 咨询会话页
+- 页面应展示家长与指导师的会话列表。
+- 页面应支持未读状态、消息摘要及历史记录查看。
+- 进入会话后,用户应可发送与回复消息。
+
+### 6.5 任务模板页
+- 页面应展示模板列表、模板详情和模板编辑入口。
+- 页面应支持一键使用模板创建任务。
+
+### 6.6 历史记录与统计页
+- 历史记录页应支持筛选、分页和状态标记。
+- 统计页应展示完成率、超时率、分类分布等图表。
+
+### 6.7 批量操作交互
+- 任务列表应支持多选模式。
+- 用户选择任务后,页面应显示批量删除、批量审核等操作按钮。
+- 执行前应弹出确认弹窗,并提示操作数量与影响范围。
+
+---
+
 *本文档为UI交互设计参考,具体实现时可调整细节。*

+ 101 - 0
docs/superpowers/specs/2026-03-31-功能模块设计-P0核心模块.md

@@ -261,4 +261,105 @@
 
 ---
 
+## 五、补充设计:未完全覆盖需求
+
+### 5.1 首次登录与角色选择流程
+
+#### 5.1.1 需求说明
+用户首次登录系统时,应先完成身份角色选择:指导师、家长或孩子。若用户选择指导师角色,则系统应引导其进入资料完善流程,补充必要身份信息后方可继续使用系统。
+
+#### 5.1.2 页面设计
+- 角色选择页:展示三种角色卡片,支持用户完成角色选择后进入后续流程。
+- 资料完善页:指导师专属表单,用于填写身份证号、性别、照片及证书号等信息。
+
+#### 5.1.3 状态流转
+- 未登录 / 首次登录
+- 已完成角色选择
+- 资料完善中
+- 资料已完成
+
+#### 5.1.4 验收标准
+- 首次登录时系统必须展示角色选择页。
+- 用户选择指导师后,系统必须进入资料完善页。
+- 指导师资料未完善时,系统不得直接放行进入功能首页。
+
+### 5.2 指导师-家庭绑定闭环
+
+#### 5.2.1 需求说明
+指导师应通过邀请码与家庭建立绑定关系。绑定成功后,系统应允许指导师查看对应家庭任务,并参与任务审核与调整。
+
+#### 5.2.2 核心规则
+- 指导师应可生成或查看专属邀请码。
+- 家长应通过邀请码完成绑定。
+- 绑定成功后,指导师仅可查看其关联家庭的数据。
+- 指导师对家庭任务进行修改或删除时,系统应保留操作痕迹。
+
+#### 5.2.3 验收标准
+- 指导师可生成并分享邀请码。
+- 家长可通过邀请码完成家庭绑定。
+- 绑定后,指导师可查看该家庭的任务数据。
+- 任务调整操作必须记录操作者与操作时间。
+
+### 5.3 家长咨询/沟通模块
+
+#### 5.3.1 需求说明
+家长应可向指导师发起咨询,指导师可查看、回复相关消息,且双方消息应保留完整历史记录。
+
+#### 5.3.2 核心规则
+- 系统应支持会话列表与会话详情两级结构。
+- 系统应支持消息未读状态管理。
+- 当前阶段优先支持文字消息,图片、语音等扩展能力可在后续版本补充。
+
+#### 5.3.3 验收标准
+- 家长可成功发起咨询。
+- 指导师可查看并回复咨询消息。
+- 消息记录应可追溯且不丢失。
+
+### 5.4 任务模板功能
+
+#### 5.4.1 需求说明
+系统应支持基于模板快速创建任务。模板来源包括系统预设模板、历史任务模板和用户自定义模板。
+
+#### 5.4.2 核心规则
+- 模板应支持查看、复制、新建、编辑与删除。
+- 使用模板创建的任务应允许在创建后继续编辑。
+- 模板应包含任务名称、分类、积分、时长、完成方式、审核方式等核心字段。
+
+#### 5.4.3 验收标准
+- 用户可通过模板快速创建任务。
+- 模板应支持分类管理与列表展示。
+- 模板字段应能够正确回填到任务表单中。
+
+### 5.5 任务历史记录与统计分析
+
+#### 5.5.1 需求说明
+系统应提供任务历史查询能力,并支持按时间、状态、孩子、分类等维度统计任务完成情况。
+
+#### 5.5.2 核心规则
+- 历史记录应支持分页查询。
+- 历史记录应支持按状态、时间范围及孩子维度筛选。
+- 统计数据应与任务状态保持一致。
+
+#### 5.5.3 验收标准
+- 历史记录可按条件进行查询。
+- 统计结果应与任务数据保持一致。
+- 系统应支持多维度统计展示。
+
+### 5.6 批量操作任务
+
+#### 5.6.1 需求说明
+系统应支持对任务进行批量删除、批量审核等操作,以提升管理效率。
+
+#### 5.6.2 核心规则
+- 批量操作前应进行二次确认。
+- 批量操作应记录日志。
+- 无权限用户不得执行批量操作。
+
+#### 5.6.3 验收标准
+- 支持多任务批量选择。
+- 批量操作应提供明确结果提示。
+- 部分失败时应提示失败项。
+
+---
+
 *本文档为P0核心模块功能设计,后续P1增强模块设计将另建文档。*