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

项目设计与 AI 协作

以「用户点击生成后看到的结果属于哪份大纲」为起点做设计。服务端接受任务时,将用户有权使用的版本固定下来。即使之后大纲又被编辑,worker 也能用相同输入重跑。这个决定同时影响表结构、API、前端提示和面试时的取舍说明。

本篇目录

最小架构和技术栈

浏览器 → 应用 API → PostgreSQL。Worker 从任务表领取工作,经模型适配器访问生成服务,再写回状态。资料入库后增加分块和检索索引。助手通过受控的业务工具访问同一套服务端逻辑。

关注点 练习中的选择 一次检查
前端 沿用 Vue 或 React 等熟悉技术;列表、编辑、任务状态/问答可以复用页面 刷新详情后仍能依据 URL 恢复任务,错误提示说明下一步
后端 熟悉的语言和框架;一个代码库,API 和 worker 两种启动入口 两者独立启动,worker 挂掉时 API 还能查已有任务
存储 PostgreSQL、文件卷、按需使用 pgvector 重启服务后教案和文件仍可读取
模型 统一方法包装生成、向量化调用;支持真实和模拟两种实现 测试可以稳定制造一次超时,真实运行记录模型标识和用量
部署 本机开发与隔离的 Compose 项目,可复用同一台机器 在新项目名及独立卷下从零初始化并验收,原环境可继续使用

如暂时无法启用 pgvector,小语料实验可以先把向量保存在数据库,在应用层做精确余弦检索。记录行数、维度、耗时和选择理由。精确检索也适合作为以后评估近似索引的参照。服务器容量要根据并发和实测峰值调整。本练习的小样本、单 worker 和远程模型允许从现有电脑开始。

一个请求贯穿哪些层

  1. 浏览器保存大纲,携带它读到的版本。服务端确保当前版本匹配,并在同一事务里记录新版本。冲突时,前端保留用户输入并提示重新加载。
  2. 浏览器提交生成,附大纲版本和本次操作的幂等键。服务端校验归属、确认版本存在,写入任务并返回 job_id。相同用户相同键重放时核对请求内容。
  3. Worker 领取一条 queued 任务,提交事务后再请求外部模型。执行期间退出时,用租约过期等机制重新领取。结果写回必须核对本轮执行身份,防止旧 worker 覆盖新结果。
  4. 任务详情按 job_id 查状态,进入终态后停止轮询。助手查状态时也走同一归属校验。一次新重试与原提交的网络重放有不同业务语义。
  5. 资料检索先限制用户可见范围。回答引用的段落携带资料版本与段落标识,审阅者可以回到当时的依据。
例子 期望行为 看哪里
提交成功后响应在网络中丢失 客户端用原键重试,获得原任务 ID 同一用户、同一键的任务和请求摘要
模型已经返回,worker 写库前退出 可以重调外部模型;最终只发布一个有效结果 尝试号、供应商请求 ID、最终写入条件和用量
已显示重试提议,任务状态随后改变 确认时服务器重新检查状态,过期提议不能执行 工具轨迹、确认记录、任务状态
用户 B 问到用户 A 私有规范 检索阶段排除该资料,引用下载也验证归属 实际进入上下文的段落 ID、下载用例

拆需求的示范

以「刷新后继续看生成进度」为例,先确定状态归属。URL 保存 job_id。数据库保存权威状态。前端组件保存 loading、请求错误和定时器。页面卸载后停止轮询;网络中断时保留最后状态并提示重新连接。切换 A、B 两个任务时,较晚抵达的 A 响应不能覆盖当前 B 页面,可通过请求取消或比较当前 ID 避免。

动手验证。 将 A 接口响应延迟 2 秒,先打开 A 再马上切到 B。期待最终显示 B 的状态;刷新 B 后仍显示 B;B 到达终态后观察网络面板,确认轮询停止。把正常和延迟场景各留一段网络记录。这也是一次具体的高级前端面试素材。

让 AI 参与,但保留自己的判断

时机 可以直接复制的提问 你负责的决定
开始功能前 「我用现有栈实现绑定大纲版本的生成。先读相关代码,列出最少要改的入口、三个失败窗口和验收用例,等待我选方案。」 选业务语义、接口和可接受的失败
开始编码 「按这三个验收条件实现,沿用现有接口。列出事务边界,跑测试,给出实际命令和结果。」 看 diff;确认验证走过真实入口
排障 「预期是 X,实测 Y。这里是脱敏日志和最小输入。按可能性列两条假设,各给一个最小验证动作。」 一次改变一个条件,自己重跑并记录
复习 「充当面试官。先问一个关于本次取舍的问题,一次一题,根据我的回答追问失败场景。结束后指出我漏了哪份证据。」 合上代码讲 90 秒,再回去对照

每周至少留一次 20 分钟自己写或画的练习。可以选版本条件更新、检索评分、Agent 停止逻辑或慢查询分析。AI 写出的测试先看断言,再故意破坏一个条件;如果测试照样通过,就补一个能抓住该错误的用例。

设计决定记录示范

问题:只有一个 worker,任务重复提交和旧 worker 写回都可能产生重复结果。选择:在数据层留下唯一键,结果更新按执行身份做条件写入。取舍:数据库表队列部署简单;吞吐提高后要关注锁竞争、轮询成本与任务表增长。证据:跑两次并发提交,并模拟租约过期后的迟到写入。把实际更新行数、日志和测试链接填到记录模板。待验证:当前实验可检查最终写入的唯一性,外部模型发生重复计费需另查调用记录。

上线检查的三个观察点