SKILLπ JOURNAL ↗ 工作流

独立开发预约应用:先交付一个能验收的闭环

把 AI 辅助开发拆成选时段、提交预约和确认结果三个可以独立验证的交付点。

假设你独立开发一个预约应用。先把首版目标写成一条路径:用户看到可用时段,提交预约,读到确认。准备三条测试时段,其中一条已满。每次让 Agent 只修改当前切片涉及的文件,并记录约定的输入和输出。

先把界面和数据约定写下来

用 Frontend Design 草拟时段选择、已满状态与确认页。为时段明确唯一标识、时区和剩余容量。先让前端用固定数据走通流程,再接入服务端接口,便于分辨界面状态与数据错误。

测正常和冲突两条路径

成功时检查确认页与预约记录。冲突时模拟另一名用户抢先占用时段,检查界面能否解释失败并返回选择。用 Webapp Testing 记录浏览器操作和可见结果,并在新会话中复验刷新后读回的预约状态。

每次交付一份交接记录

记录变更文件、测试数据、运行命令和仍未验证的边界。支付、提醒和日历同步作为后续切片,等预约状态的读写稳定后再加。

快速搭建可复现的项目起点

为首版写一页需求,只包含查看时段、创建预约和确认预约。定义使用者与管理者各能看到什么,以及哪些字段必须提供。准备固定的演示日期、时区和三条时段,保证同事在另一台机器能得到同样的初始页面。若已有仓库,先用原有命令跑通并留一个基线提交。新建仓库时先确定运行时、依赖锁文件和本地启动说明,配置模板只写变量名和用途。

让 Agent 先交付路由、静态页面和测试数据,再接数据库。写明每次允许修改的文件、运行命令和预期页面状态。快速搭建的产物是一条能走通的本地路径与复跑说明。第一步只要证明陌生读者按说明能打开选择页,并看到有空、已满和不可约三个状态。

让前端与服务端对同一个预约结果负责

列出最小接口约定。读取时段返回标识、开始时间和可选状态;提交预约接收时段标识与必要的联系字段,成功返回预约编号,冲突返回明确的可识别状态。页面以服务端确认的结果为准。用户点击时先进入提交中状态,失败后保留输入并提示如何恢复。不要在请求尚未成功时把界面标记成已预约。

服务端应在提交时重新判断余量,不能依赖用户打开页面时看到的数字。若最后一个空位被两个用户同时选择,数据库更新与预约记录要在受控的并发规则下写入。用两次受控提交证明只有允许的预约能成功,再核对余量和预约表。双击与网络重试是否复用一次提交,按业务规则写成用例。时间用明确的时区存储与展示,测试时选择一个可能跨日期的时段。

用 Frontend Design 组织时段列表、已满说明与提交反馈,检查选中的日期和时区在手机上可见。用 Webapp Testing 核对整个浏览器路径,准备正常、冲突、非法输入和网络错误四种场景。用服务端测试核对容量和重复写入。验收记录至少有操作前状态、请求、可见结果、读回的预约记录和清理步骤。

从预览环境推到可回滚的发布

先在与线上配置接近的预览环境部署固定版本。使用隔离的数据库和测试通知,核对运行配置、迁移顺序和静态资源。访问预览地址,从选择时段开始走完整流程,刷新后核对预约可读。测试冲突时检查提示和返回选择的入口。记录版本标识与环境,避免把本地检查结果误当成上线证据。

发布前确定回退方式。保存上一版可重新部署的产物,检查数据库迁移是否允许旧版继续工作。若不兼容,提前设计可逆步骤或分阶段迁移。上线后只使用明确授权的测试记录做核对,检查首页、时段读取、预约提交和日志告警。如果出现容量不一致或确认页不可达,按事先约定的条件暂停切换,定位问题后再恢复。把验证时间、范围和需要人工接手的事项写进交付单。

验收发布时可在交付单里留三条记录。第一条验证首页和时段读取,保留访问地址及页面显示的日期。第二条用测试时段提交预约,按编号从独立会话读回确认结果。第三条复现一次无余量的冲突,记录页面提示和数据库余量。核对完清理测试预约,再观察一轮错误日志,确认没有未处理的失败请求。

实操清单与常见问题

如何把一次改动交给 Agent

可以从“在预约选择页显示已满状态,保留现有接口”开始。说明样例数据、目标页面、可修改范围以及检查步骤。要求输出差异和实际运行结果。若 Agent 发现必须改变接口,先让它说明影响与迁移办法,再把这个改动单独列入下一项。

本地正常,预览提交失败先查什么

先核对访问的是哪个版本、表单请求地址、服务端响应和数据库迁移状态。使用同一条测试时段复现,区分配置缺失、跨域请求与真实库存冲突。记录第一处差异,给修复保留可以重放的输入。

怎么判断可以增加支付和提醒

预约链路通过正常、冲突和失败恢复检查后,再写下一项需求。支付和通知都有独立的状态及验收条件,把它们当作新切片。先确认谁负责验证和处理失败,再决定何时接入。

下一版开始前,先用同一份发布清单验证基线,确保新增功能的影响可以单独定位。

分享文章X ↗LinkedIn ↗

CONTINUE YOUR WORKFLOW

把这篇教程,用到下一项任务。

按明确的技能关联与共同专题推荐;使用条件以详情和原始来源为准。