跨境电商体验店官网与预约系统
独立探索 · 与 AI 编程 Agent 协作从需求到交付
为线下跨境电商体验店场景独立完成的官网与到店预约系统：纯 Node.js 零依赖实现（店员电脑双击即可运行），预约数据落盘本地 JSON 台账并自动轮换备份，配套店员后台的查询 / 搜索 / CSV 导出；从需求定义、占位信息与上线清单、安全分级到 53 项黑盒自测验收，全程与 AI 编程 Agent 协作完成，v1→v4 四轮迭代全程留档。
- 53/53
- 黑盒自测全量通过
- 零依赖
- Node ≥14 双击即用
- 10 版
- 台账自动轮换备份
- 4 轮
- v1→v4 迭代留档
✦真实界面
01问题定义
小微门店通常没有 IT 运维，官网与预约登记若依赖云端服务，就有成本、部署与数据归属三重顾虑——需要一套店员电脑双击即用、数据完全留在本地的轻量方案；且正式营业前的商品与门店信息必然是占位状态，上线替换路径必须从第一天就设计好。
02策略与路径
- 01
需求与边界定义：官网前台（导航 / 商品 / 地址 / 预约）与店员后台（台账）双端拆分，预约编号（LY-日期-随机码）、状态、来源 IP 等字段随需求一并定义
- 02
上线清单思维：地址 / 电话 / 9 款商品卡 / 顾客评价 / 公告 / 店名全部在 README 占位替换表中逐项列出替换方法——交付即可被任何人接手上线
- 03
数据安全设计：JSON 台账每次写入前自动轮换备份最近 10 版，损坏文件自动保全、服务不崩溃；删除接口必须设置管理密钥，预览模式默认禁用
- 04
防滥用与稳健性：同手机号 1 分钟限提交 1 次、单 IP 每分钟 60 次上限；目录穿越请求返回 403，端口占用、台账损坏等异常路径显式处理
- 05
验收先行：编写 53 项黑盒自测（页面 / 接口 / 异常 / 并发 / 穿越防护全覆盖），以 SUMMARY_JSON 输出机器可读结论并留存验收自检报告
04收获与反思
AI 编程 Agent 把「一个人做出能运行的系统」变成现实之后，产品经理的增量价值进一步转移到需求边界、上线清单与验收标准上——这些恰恰是 AI 最难完全代劳的部分。
口径说明：个人探索项目，为门店场景设计并本地部署验证，未正式上线营业；页面中商品 / 评价 / 门店信息均为 README 占位替换表列明的示意数据，后台台账截图为脚本注入的模拟预约（姓名与手机号均为本地生成的模拟数据）。