提交 70fa66af authored 作者: yujiejie's avatar yujiejie

学生端答辩页面

上级 f8de1583
......@@ -10,73 +10,94 @@
PRD 回答"**要做什么**",原型图回答"**长什么样**"。但技术开发、测试验收时,还需要 4 类信息:
| 技术团队的问题 | 需要的文档 |
| --- | --- |
| ------------------------ | --------- |
| 流程到底怎么一步一步走?有分支、有异常吗? | 业务流程图(细化) |
| 每个环节归谁负责?角色之间在哪儿交接? | 泳道图 |
| 入项申请、部署任务这类数据对象,状态是怎么变的? | 状态机 |
| 系统由哪些模块组成?怎么分层? | 功能架构图 |
| 页面之间怎么跳?什么条件下能跳?不满足怎么办? | 页面交互梳理表 |
下面这张表是五类文档的定位速查:
| 文档 | 回答的核心问题 | 主要读者 | 产出形态 |
| --- | --- | --- | --- |
| --------------------- | ------------------------- | --------- | --------- |
| 业务流程图(细化) | 业务是怎么一步步完成的?有哪些判断分支和异常? | 产品、开发、测试 | 流程图 |
| 泳道图 | 每个角色在流程里负责哪一段?交接点在哪? | 产品、开发、测试 | 分泳道的流程图 |
| 状态机 | 一个业务对象有哪些状态?什么事件触发状态迁移? | 后端开发、测试 | 状态图 + 状态表 |
| 状态机(原型阶段)状态流转在PRD里加起来 | 一个业务对象有哪些状态?什么事件触发状态迁移? | 后端开发、测试 | 状态图 + 状态表 |
| 功能架构图 | 系统分哪些模块/功能?如何分层? | 架构师、前后端开发 | 树状/分层结构图 |
| 页面交互梳理表 | 每个页面的入口/出口在哪?跳转条件?失败怎么处理? | 前端开发、测试 | 表格 |
| 页面交互梳理表(原型阶段) | 每个页面的入口/出口在哪?跳转条件?失败怎么处理? | 前端开发、测试 | 表格 |
---
## 二、每种文档怎么读、怎么写(方法论)
### 1. 业务流程图(细化版)
**基本要素:**
| 图形 | 含义 |
| --- | --- |
| ------------ | ------------- |
| 圆角矩形 / 胶囊 | 流程起止点 |
| 矩形 | 活动/任务 |
| 菱形 | 判断分支 |
| 箭头 | 流转方向(箭头旁标注条件) |
| 带波浪线矩形 / 文档形 | 数据、文档、交付物 |
**写法顺序(重要):**
1. 先画**主干**:正常情况下的主路径(从登录到毕业全链路);
2. 再补**分支**:每个菱形判断的"不通过"路径;
3. 最后补**异常**:失败、驳回、重新提交、流程终止等。
**新手常见坑:**
- 只画理想路径,不画"不通过"分支;
- 忘记给箭头标注判定条件(开发无法落库/落页面);
- 环节粒度不一致(有的画到页面级,有的画到按钮级)。
### 2. 泳道图
**核心思想:泳道 = 参与者。** 每个泳道里放这个角色"自己做的事",跨泳道的箭头就是**交接点**,交接点必须伴随"交付物"(数据/文档/通知)。
**写法顺序:**
1. 列出参与者(本项目的角色:学生/导师/管理员/企业/院校/系统);
2. 把细化流程图中的每个环节归到对应泳道;
3. 检查每个跨泳道箭头:它传递了什么交付物?数据字段是否有人负责生成、有人负责消费?
### 3. 状态机
**核心四要素:**
- **对象(Entity)**:要管理生命周期的数据,如"入项申请""部署任务""实操报告";
- **状态(State)**:对象所处阶段,如"待审核""已通过";
- **事件(Event)**:触发迁移的动作,如"学生提交""导师通过";
- **迁移(Transition)**:`状态A --事件--> 状态B`,迁移要写明条件。
**写法顺序:**
1. 先定对象(一个流程通常有 1 个核心对象,如入项申请);
2. 列出该对象的**状态全集**(含初始态、终态);
3. 画状态迁移图;
4. 对每个迁移补上:触发事件、条件、系统副作用(发通知/改门禁/写日志)。
### 4. 功能架构图
**思路:系统 → 模块 → 子功能 → 页面/接口。** 自上而下分层,先按"角色+业务域"分模块,再往下拆功能点。注意不要按页面机械堆叠,要按业务能力归类。
......@@ -85,25 +106,33 @@ PRD 回答"**要做什么**",原型图回答"**长什么样**"。但技术开
**本质:把"原型图上每个按钮的跳转关系"转成表格。** 字段建议:
| 来源页面 | 触发操作 | 目标页面 | 前置条件/门禁 | 数据/参数 | 异常/拒绝处理 | 备注 |
| --- | --- | --- | --- | --- | --- | --- |
| ---- | ---- | ---- | ------- | ----- | ------- | --- |
开发拿着这张表 + 原型,就可以直接做路由和门禁开发。
---
## 三、工具选择
| 用途 | 工具 |
| --- | --- |
| ----------------------- | ------------------------------------------------- |
| 快速产出、可放进 Git 版本化、支持多人协作 | Mermaid(本套文档全部使用,GitHub/GitLab/语雀/Obsidian 均原生渲染) |
| 正式交付、需要标准泳道/跨页大图 | draw.io / ProcessOn / FigJam |
| 会议演示 | Figma 演示模式 |
> 说明:Mermaid 原生不支持"横向泳道"的画法,本套文档用 `subgraph` 按角色分块近似表达泳道,结构清晰且可直接进 Git。如果公司评审需要更正式的效果,可把每张 Mermaid 图在 draw.io 里手动转成标准泳道图。
---
## 四、建议的产出顺序(和开发实施顺序一致)
1. 先细化**业务流程图**(主流程 + 子流程)→ 明确业务环节;
......
差异被折叠。
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论