需求和架构(1)

Requirements & architecture, part one

第 06 讲约 7 分钟阅读官方讲义 ↗

从教务业务识别规则,以事件、读写模型和领域边界组织系统。

阅读目标与前置知识3 项目标
  • 将业务叙述转成可追踪的需求
  • 区分事件历史与当前状态
  • 说明 CQRS 与领域边界解决的问题

建议先读 第 5 讲

MVPCQRSDDD事件溯源Event Sourcing
本章关联演示改一条记录,重算整个视图。

一、需求工程从实际工作出发

第 5 讲把软件看成依赖关系。第 6 讲通过教务系统说明实际需求怎样形成。多个角色、不断变化的业务和彼此依赖的规则都会影响需求。软件是精确的逻辑制品,一项看起来很小的变化,可能因为落在关键假设上而影响许多地方。架构决定了变化传播的路径和控制成本。

课上让 Agent 根据观察到的教师功能整理需求说明。说明包含调研方法与证据范围、角色与业务目标、成功标准、用例、功能需求、术语和关联文件。这里的学习方法是把一个已经运行的系统当成材料,观察界面和流程能支持哪些判断,再区分尚需用户确认的业务规则。

二、把屏幕上看到的内容转成需求

一次需求整理可以从角色、目标、情境、规则和验收五部分展开。

问题 教务系统中的例子
谁在操作? 教师、学生、教务人员,或同一人切换身份
想做成什么? 查当前学期课表、处理教材选用、记录课堂缺勤
什么时候发生? 某个学期或业务批次内,不同阶段允许的动作可能不同
哪些限制或例外成立? 权限范围、业务数据上限、先修条件和特批规则
怎样知道已实现? 写出典型成功例、拒绝例、旧数据或用户角色切换的边界例

例如,系统显示可以登记缺勤。课上观察到,登记数可能超过一学期的总课次。界面能保存数据说明有输入路径,是否允许该输入需要规则来回答。需求可记录课程、角色、数据限制和错误反馈,再让对应测试验证边界。

需求追踪的最小形式

给一条需求建立稳定标识,将「来源、业务规则、设计位置、验收用例」连起来。例如,新旧培养方案都要判定毕业资格。业务规则负责说明哪些入学批次适用哪套规则,设计负责表达方案和适用条件,验收覆盖两套方案及明确例外。将来变更方案时,沿关联检查受影响范围。

三、MVP 决定了哪些事可以推迟

MVP 是一条从意图到实现、足以验证核心价值的最小切片。它可以先只覆盖一个角色和一段路径。即便范围小,界面形态、数据持久化、同步方式也会形成早期决定。假设用户需要离线工作,只做一个必须联网的接口,会影响之后怎样重用数据和交互。

选择 应问的问题
先做什么 什么是最能验证价值的一条端到端路径?
哪些细节可暂缓 不做某功能是否影响核心场景的可信度?
哪些架构决定会变得昂贵 上线后是否积累了旧数据、接口调用或用户习惯?
何时需要回看决定 出现第二类用户、第二版本规则或新运行环境时,改动会影响哪里?

技术债可理解为早期取舍留给未来的维护工作。它可能是为了快验证而有意承担的,也可能在不知道需求会变化时形成。把形成债务的条件写清楚,未来才能判断何时偿还。

四、离散数学拆课案例,从例外迫使我们理解规则

原设计可以把毕业要求表示成若干门必修课。课堂中一门离散数学拆成上下学期的课程以后,原有下拉框加一项的界面很难表达新旧规则之间的「或」关系。保研资格和毕业审核也可能随之变化。

可以沿需求、规格和实现三个层次推演影响。

  1. 需求层。先确认哪批学生适用旧课,哪批学生适用新课,是否允许替代或特批。
  2. 规格层。选择能表达必选、组合、替代与适用范围的规则结构,让标准条件和例外都有明确表达。
  3. 实现层。检查界面编辑、资格计算、旧记录查询和验收用例,确认它们依赖同一个规则定义。

估算变更成本时,可以用预期变化给架构做一次试验。如果加入一个「或」要同时改多个互不关联的模块,就值得重新检查模块间的职责和规则来源。

五、汉诺塔怎样展示三种架构表达

同一个非递归汉诺塔需求,讲义给了三条路径。它们把困难放在不同地方,适应的后续变化也不同。

思路 状态里保存什么 怎样推进 适用与代价
利用移动规律 步号和盘子位置 根据规律选择盘子与目标柱 实现紧凑,需要证明步号规律和适用条件
显式保存待办任务 盘数、起点、终点和辅助柱 弹出任务,按逆序压入要执行的子任务 复用递归分解,适合观察任务结构
模拟调用栈 参数和程序计数器等栈帧状态 按执行位置创建新帧、返回或继续 表达一般调用语义,可逐步检查,状态更多

第二种方案的一次三盘任务,可以压入最后搬小盘、移动大盘、最先搬小盘三个动作。栈后进先出,取出时就遵循原顺序。第三种会保存当前帧运行到哪里,被调用任务完成后继续该帧。课上用它说明,架构常常始于重新选择问题的表示。二维码中的中间表示、教务系统中的事件和规则,都是同一思路在较大系统的应用。

六、Excel 案例把易变部分拆出边界

第 1 讲说明硬编码的代价,本讲补充为什么中间表示能减少改动范围。业务逻辑描述二维码计算,公式生成器处理 Excel 版本和布局,Python 路径可执行相同的计算以验证结果。布局往右移动和兼容旧版 Excel 可以分别成为测试场景。

设计过程可以从下面三个问题入手。

  • 什么部分需要在所有目标环境保持同一个含义?
  • 哪些差异属于特定输出格式或部署环境?
  • 可否先验证公共含义,再各自验证翻译和布局?

这种做法也可用于教务规则。先单独表述资格条件,再由不同界面、报表和检查流程分别使用,比在每个出口重新写一遍规则更容易追踪。

七、CRUD、历史和事件溯源

教务系统可以用 CRUD 列出当前学生、课程和选课记录,并通过稳定的标识符关联。问题在于只保留当前状态时,院系改名会让过去的记录套用新名称。例如查询旧毕业证明,若系统直接连接当前院系表,可能呈现一个当时不存在的名称。

需要回答的问题 数据模型应保留的信息
学生当前在哪个单位? 当前关系或能推导当前关系的历史
学生毕业时属于哪个单位? 毕业事实及当时适用的组织关系
院系何时改名或合并? 变化的时间、主体与关系
某项结果为何变化? 相关事件,以及当时用于推导结果的规则

事件溯源记录有含义的业务事件,可以按规则重放得到当前或历史状态。当前状态查询可由快照、缓存或投影加速。已有系统如果从未保存过某些历史,迁移时需要另找证据补齐,架构本身无法恢复缺失事实。课程同时提到 CQRS,并指出它与是否采用事件溯源是两个独立决定。

八、从教务业务理解 CQRS、DDD 和事件溯源

选择 解决的问题 一个可以检验的边界
CQRS 分开业务命令与查询职责 选课命令检查资格和容量,课表和点名册各按用途展示
DDD 让领域概念决定模型和协作边界 课程通过可作为学分认定输入,毕业学分仍有自己的规则
事件溯源 保留业务历史,按照规则重建结果 能追溯成绩更正和原审核的依据

三者可以用在同一项目,也可以独立选择。选课和学分认定都谈「学生」,业务约束不同。将「课程通过」「可认定学分」「满足毕业条件」分别表达,既可以让不同模块按真实含义工作,也能向用户解释为什么过了一门课仍不能计入某项毕业要求。

定义哪项操作需要立即一致

最后一个名额同时遇到两份申请时,检查余量和确认占位需要在共同的并发约束下执行。两个请求都读取旧余量会造成重复占用。事件追加如果采用版本检查,一方追加后,另一方需要重新读取并计算。查询视图若异步更新,可能短时间晚于已确认的选课记录。界面要能表达提交成功与课表更新两个时点,并允许对已提交请求安全重试。

分清历史恢复与按新规则重算

毕业审核可以保存输入记录及版本、规则版本和审批依据。复现旧结论时,使用当时的规则和历史输入。试算新规则时,保持事实来源一致,换用指定规则,再解释差异。当一条豁免已经生效但晚几天录入时,业务有效时间与系统获知时间必须分别记录。它们可以回答「当时实际适用什么」和「系统当时为什么这样判定」两个问题。

迁移既有系统可先从一条审核链开始。把老系统的基准结果和来源保留下来,新系统并行计算,优先核对转专业、课程替代、补考和豁免。差异要按过去数据缺失、规则理解差异、实现错误分开检查。等新链条可信,再决定切换写入入口。

复习与应用

选择一条会随学年、产品版本或组织结构变化的规则。把适用范围、例外、历史查询和典型验收写出来。再画出从规则变更到实现与报表受影响的路径。

第 6 讲官方讲义

停一下,解释给自己听。

更正成绩时,为什么需要保留原来的 58 分记录?

展开答案要点

原记录说明系统曾经接收过什么事实。追加更正记录保留来源与更正关系,当前视图由历史重算,从而能解释结果怎样变化。

为这次阅读留下一个标记。

已读由你决定,不代表自动评估掌握程度。

学习记录,留在这里。

阅读位置、已读章节和实验清单保存在当前浏览器。更换浏览器或清理站点数据后,这些记录不会同步。

0 / 12 讲已标记为已读

Search the course
输入关键词,或从下方开始。
试试 暂存区、CQRS、不变量Esc 关闭 · Tab 选择结果