Skip to content
项目
群组
代码片段
帮助
当前项目
正在载入...
登录 / 注册
切换导航面板
S
studyweb_pmfile
项目
项目
详情
活动
周期分析
仓库
仓库
文件
提交
分支
标签
贡献者
图表
比较
统计图
议题
0
议题
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
CI / CD
CI / CD
流水线
作业
日程
统计图
Wiki
Wiki
代码片段
代码片段
成员
成员
折叠边栏
关闭边栏
活动
图像
聊天
创建新问题
作业
提交
问题看板
Open sidebar
yujiejie
studyweb_pmfile
Commits
70fa66af
提交
70fa66af
authored
9月 08, 2026
作者:
yujiejie
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
学生端答辩页面
上级
f8de1583
全部展开
显示空白字符变更
内嵌
并排
正在显示
3 个修改的文件
包含
36 行增加
和
7 行删除
+36
-7
00_关键文档导读(学习方法篇).md
docs/00_关键文档导读(学习方法篇).md
+36
-7
05_页面交互梳理表.md
docs/05_页面交互梳理表.md
+0
-0
student-defense.html
student-defense.html
+0
-0
没有找到文件。
docs/00_关键文档导读(学习方法篇).md
浏览文件 @
70fa66af
...
...
@@ -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.
先细化
**业务流程图**
(主流程 + 子流程)→ 明确业务环节;
...
...
docs/05_页面交互梳理表.md
浏览文件 @
70fa66af
差异被折叠。
点击展开。
student-defense.html
0 → 100644
浏览文件 @
70fa66af
差异被折叠。
点击展开。
编写
预览
Markdown
格式
0%
重试
或
添加新文件
添加附件
取消
您添加了
0
人
到此讨论。请谨慎行事。
请先完成此评论的编辑!
取消
请
注册
或者
登录
后发表评论