高级全栈与 FDE 工程学习手册四周 · 88 小时

第 1 周 · 从一个编辑框走到可恢复的生成任务

本周投入 22 小时。 你会写 API 和 SQL,可以把熟悉的框架当起点。先做一条窄而完整的流程。用户编辑教案大纲、提交生成、离开页面再回来,仍能拿到对应版本的结果。这个星期使用可控的模拟生成器,让大部分时间花在系统行为上。

开始前准备一个练习仓库、一个空 PostgreSQL 数据库和两个测试身份 A、B。把 API、worker、前端放在同一仓库即可。沿用熟悉的测试工具。下面的路由名是练习示例,SQL 中的冒号参数需要由数据库驱动绑定。

本篇目录

本周样例与三个约束

使用一份《水循环》教案。大纲第一版包含“蒸发、凝结”,第二版加入“降水”。让模拟器返回“教案标题 + 输入大纲 + 版本号”,这样肉眼就能看出它用了哪版输入。

对象 最少记录 需要维持的关系
教案 lessons id、owner_id、title、current_revision、updated_at 一个账号只能访问自己的教案
大纲版本 outlines lesson_id、revision、content 每次成功保存追加一版,组合键唯一
生成任务 jobs id、owner_id、lesson_id、outline_revision、status、attempt、input_key、request_hash、created_at、result、error_code 输入绑定指定版本,提交键按用户唯一,结果归属于任务
上传资料 materials id、owner_id、display_name、storage_key、size 下载时再校验归属,显示名称与实际存储键分开

先写三句业务约定。两个并发编辑只能有一个基于旧版本保存成功。用户重复发送同一次提交只能得到一个任务。任务生成的内容始终来自当时选中的大纲。数据库约束、接口响应和前端提示都围绕这三句来设计。

第 1 天 · 启动并写出第一份接口契约(2 小时)

分配 20 分钟画流程,55 分钟建表与种子数据,30 分钟打通读取,15 分钟记录启动步骤。

  1. 用纸画出“编辑 → 保存版本 → 创建任务 → 查询结果”,标出哪次请求应该立刻返回,哪段工作在后台继续。
  2. 建立教案和版本两张表。给 A、B 各创建一份教案,再给《水循环》写入第一版。其他表等到用时创建。
  3. 先打通详情读取。请求返回标题、版本号和大纲内容,前端能展示同一组数据。只在本地测试数据上工作。

今天留下 一条成功响应、能重复执行的种子步骤和一张四步草图。遇到环境问题时,先用数据库客户端直接查出一行,再从后端取同一行,最后接前端。面试时试着解释“为什么需要单独存历史版本”。

第 2 天 · 列表、表单与错误状态(2 小时)

分配 15 分钟定契约,55 分钟列表与表单,35 分钟验证边界,15 分钟复盘。

做教案新建、详情、编辑、列表查询。实现分页与一个关键词筛选。列表按更新时间和唯一 ID 稳定排序,同一时间写入两条记录也有固定先后。用第 1 页、末页、空结果三组数据跑一遍。表单包含提交中、已保存、校验失败和网络失败反馈,出错后保留输入。

手动验收 输入空标题应由服务端返回字段级错误。断开模拟网络后点保存,恢复网络后可以继续提交。切换关键词时让旧查询晚到,核对新列表没有被旧响应覆盖。可用请求序号或取消旧请求解决。保存两张截图和一个 API 测试。面试追问“大量数据持续写入后,页码分页会出现什么现象,什么时候换游标”。

第 3 天 · 并发保存和版本冲突(2 小时)

分配 20 分钟复现覆盖,55 分钟实现条件更新,30 分钟跑并发用例,15 分钟整理结果。

A 在两个标签页同时打开第一版。左页添加“降水”并保存,右页仍基于第一版修改。客户端回传读取时的 base_revision。服务端在一个事务中执行如下操作,驱动绑定所有参数。

UPDATE lessons
SET current_revision = current_revision + 1
WHERE id = :lesson_id
  AND owner_id = :owner_id
  AND current_revision = :base_revision
RETURNING current_revision;

使用返回的新版本号插入 outlines,再提交事务。写入版本失败时回滚两次修改。若更新为零行,在当前用户的可见范围内区分资源缺失和版本冲突。版本冲突返回 HTTP 409,前端保留当前草稿,显示重新加载最新版本的入口。

今天留下 两次都带相同 base_revision 的请求记录、一个成功、一个冲突,以及数据库里新增的唯一版本。排查时先比对请求里的版本和响应行数。面试追问“只有前端禁用按钮,如何处理第二个标签页”。

第 4 天 · 两个测试身份与资源授权(2 小时)

分配 20 分钟画资源归属,55 分钟接入已有认证机制,30 分钟做权限回归,15 分钟整理。

用熟悉框架的会话或认证模块。owner_id 来自服务端解析后的身份。读取、修改和列表查询统一添加归属条件。给 A 和 B 各写一个集成测试夹具。会话模式沿用框架的 CSRF 防护,令牌模式沿用框架的校验机制。

操作 应看到的结果
A 读取自己的教案 200,内容属于 A
B 使用同一个详情地址 采用一致的资源不可见响应,如 404
B 修改请求体里带 A 的 owner_id 服务端仍使用 B 的认证身份,A 的数据保持原值
未登录请求列表 401,响应无任何教案数据

今天留下 自动化通过的四个用例。遇到测试都通过、页面却显示串账号时,先查前端查询缓存键和退出登录时的缓存清理。面试追问“认证成功之后,为什么每个资源入口仍需检查归属”。

第 5 天 · 资料上传和下载(2 小时)

分配 15 分钟定输入范围,60 分钟实现上传下载,30 分钟处理失败,15 分钟留证。

准备一份小型 UTF-8 Markdown《教案编写规范》。给练习设定一个可验证的上限,如 1 MiB。上传端校验大小和可解析文本类型,生成随机存储键,实际读取体积也受限。数据库保存原始文件名供展示。下载接口先按资源及身份查询存储键,再读文件。采用一个本地持久化目录即可。

验收 上传合法资料、同名不同内容、超过上限资料,并用 B 访问 A 的下载链接。额外模拟一次元数据写入失败,记录临时文件如何清理。资料正常进入列表并可作为第二周的样本。卡住时先打通小文本的字节往返,再接网页进度和提示。面试追问“文件写入成功、元数据提交失败,系统如何避免垃圾文件”。

第 6 天 · 串起提交、worker 与进度页(6 小时)

分配 45 分钟定状态与契约,90 分钟提交和领取,75 分钟接模拟器,60 分钟前端轮询,60 分钟联调,30 分钟整理证据。可拆成上下午两段。

  1. 建 jobs 表,让 (lesson_id, outline_revision) 指向现有大纲版本。创建任务先确认教案归属和版本有效。POST /api/jobs 成功后立即返回 202、job_id 和查询地址。
  2. 状态经过 queued、running、succeeded 或 failed。worker 在短事务里原子领取任务并递增 attempt,提交事务后调用模拟器。把生成内容与终态在一次数据库写入中发布。事务结束后再等待外部服务。
  3. 先用单 worker 跑通。若试双 worker,用数据库的行级领取机制,领取和标记 running 同一事务。PostgreSQL 的 SKIP LOCKED 可用于队列式消费,查询跳过已被其他消费者锁住的行。PostgreSQL SELECT 参考
  4. 前端收到 202 后展示任务链接。刷新页面从 URL 的 job_id 重新读取状态。任务进入 succeeded 或 failed 后停止轮询,离开页面时清理定时器,状态切换时保留错误提示。
  5. 在模拟器加入可配置延时,并提供固定失败模式。先提交第一版,再立刻改成第二版。核对第一项结果仍包含“蒸发、凝结”,且记录版本 1。

今天留下 一段完整操作录像或五条连贯的请求日志。卡在 running 时查看事务是否已提交、worker 是否领取成功、结果写回条件是否匹配。面试追问“外部生成用了 30 秒,为什么不在数据库事务内等它完成”。

第 7 天 · 幂等、重试与本周复盘(6 小时)

分配 45 分钟列重复来源,75 分钟写幂等提交,60 分钟加失败重试,90 分钟做集成测试,60 分钟重跑主流程,30 分钟口述复盘。

同一次用户提交生成一个提交键 input_key,网络重试沿用该键。数据库为 (owner_id, input_key) 建唯一约束。服务端对业务输入的规范化表示计算 request_hash,至少包含教案 ID、版本和生成选项。重复键且摘要一致时返回原 job_id。相同键携带不同输入时返回冲突。通过唯一约束处理并发到达的请求,可用 INSERT ... ON CONFLICT DO NOTHING 处理唯一键碰撞;在默认 Read Committed 隔离级别下,再发一条查询读取已提交的原记录并比对摘要。PostgreSQL 唯一约束

重试按钮只允许任务所有者对 failed 执行条件更新,将同一 job_id 重新排队。清理本次错误,保留失败相关的运行记录。worker 再次领取时增加 attempt。重复点击不得创建多个运行中的副本。写清重试上限和达到上限后的前端提示。

情景 查什么证据
同一提交并发到达两次 两个响应指向同一 job_id,数据库记录数为一
同键改了大纲版本 返回冲突,原任务的版本和内容保持原值
任务失败、重试后成功 同一 job_id,下一次领取的 attempt 增加,最终结果唯一
A 提交后退出,B 访问任务 GET 和重试入口都拒绝,B 的列表也无该任务
任务处理中刷新页面 页面恢复到同一任务,最终显示结果

周末口述 给自己 3 分钟,按“请求如何进入、数据库保证什么、失败后界面显示什么、还存在哪个故障窗口”回答。留下一个待解问题“worker 取走任务、调用完成、写库前退出时会怎样”。第四周会用它做恢复演练。

进度调整 若长时段被压缩,保住版本冲突、模拟生成和同键并发测试这三项。把上传进度样式、列表美化和第二个 worker 移到空余时间。周末最值得保存的证据是成功与失败请求,以及对应的数据库变化。