项目设计与 AI 协作
以「用户点击生成后看到的结果属于哪份大纲」为起点做设计。服务端接受任务时,将用户有权使用的版本固定下来。即使之后大纲又被编辑,worker 也能用相同输入重跑。这个决定同时影响表结构、API、前端提示和面试时的取舍说明。
最小架构和技术栈
浏览器 → 应用 API → PostgreSQL。Worker 从任务表领取工作,经模型适配器访问生成服务,再写回状态。资料入库后增加分块和检索索引。助手通过受控的业务工具访问同一套服务端逻辑。
| 关注点 | 练习中的选择 | 一次检查 |
|---|---|---|
| 前端 | 沿用 Vue 或 React 等熟悉技术;列表、编辑、任务状态/问答可以复用页面 | 刷新详情后仍能依据 URL 恢复任务,错误提示说明下一步 |
| 后端 | 熟悉的语言和框架;一个代码库,API 和 worker 两种启动入口 | 两者独立启动,worker 挂掉时 API 还能查已有任务 |
| 存储 | PostgreSQL、文件卷、按需使用 pgvector | 重启服务后教案和文件仍可读取 |
| 模型 | 统一方法包装生成、向量化调用;支持真实和模拟两种实现 | 测试可以稳定制造一次超时,真实运行记录模型标识和用量 |
| 部署 | 本机开发与隔离的 Compose 项目,可复用同一台机器 | 在新项目名及独立卷下从零初始化并验收,原环境可继续使用 |
如暂时无法启用 pgvector,小语料实验可以先把向量保存在数据库,在应用层做精确余弦检索。记录行数、维度、耗时和选择理由。精确检索也适合作为以后评估近似索引的参照。服务器容量要根据并发和实测峰值调整。本练习的小样本、单 worker 和远程模型允许从现有电脑开始。
一个请求贯穿哪些层
- 浏览器保存大纲,携带它读到的版本。服务端确保当前版本匹配,并在同一事务里记录新版本。冲突时,前端保留用户输入并提示重新加载。
- 浏览器提交生成,附大纲版本和本次操作的幂等键。服务端校验归属、确认版本存在,写入任务并返回 job_id。相同用户相同键重放时核对请求内容。
- Worker 领取一条 queued 任务,提交事务后再请求外部模型。执行期间退出时,用租约过期等机制重新领取。结果写回必须核对本轮执行身份,防止旧 worker 覆盖新结果。
- 任务详情按 job_id 查状态,进入终态后停止轮询。助手查状态时也走同一归属校验。一次新重试与原提交的网络重放有不同业务语义。
- 资料检索先限制用户可见范围。回答引用的段落携带资料版本与段落标识,审阅者可以回到当时的依据。
| 例子 | 期望行为 | 看哪里 |
|---|---|---|
| 提交成功后响应在网络中丢失 | 客户端用原键重试,获得原任务 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 写回都可能产生重复结果。选择:在数据层留下唯一键,结果更新按执行身份做条件写入。取舍:数据库表队列部署简单;吞吐提高后要关注锁竞争、轮询成本与任务表增长。证据:跑两次并发提交,并模拟租约过期后的迟到写入。把实际更新行数、日志和测试链接填到记录模板。待验证:当前实验可检查最终写入的唯一性,外部模型发生重复计费需另查调用记录。
上线检查的三个观察点
- 数据库并发行为随隔离级别和 SQL 写法而变。先在两条独立连接上复现,再解释读到的值。比较索引前后用同一查询和数据分布,观察实际行数、扫描方式和缓冲访问。PostgreSQL 事务隔离 · PostgreSQL EXPLAIN
- 启动顺序和可接受请求是两个状态。依赖数据库的服务可等待健康检查,应用还要能处理启动后的断连与恢复。Docker Compose 启动顺序
- 用户给定步骤时,固定工作流便于测试;工具选择需要随上下文改变时,比较有限步数的 Agent 和工作流在同一批任务上的表现。Anthropic 工程实践