这次在花椒做「呱呱乐」,我这个前端,把服务端和运营后台的主要开发也一起做了。房间页面用 Vue,服务端沿用已有的 PHP 体系,三个仓库分别通过不同的 AI 会话推进。
呱呱乐是一个直播间九宫格玩法。主持可以把唱歌、真心话、绕口令等内容填进格子,揭晓后大家一起参与,也可以加入惊喜盲盒。
先看一段实际运行的演示。
页面上的操作很简单,主持选中一格,再点揭晓。沿着这个动作往下做,就得回答一些具体问题。请求重复提交会不会再次开奖?后台改了配置,已经生成的卡按哪一版处理?数据库已经提交,房间同步暂时失败,结果还算不算数?
我和 AI 把这些规则逐步落实到接口、数据和测试里。花椒已有的主持身份、房间同步等能力继续复用,我负责把新玩法的行为讲清楚,再检查不同仓库里的实现是否一致。
- 先跑通交互,把页面状态与业务状态分开
拿到需求后,我先让 AI 结合现有房间入口做可运行的原型。配置九格、揭晓、换卡、查看记录和盲盒演示,都能在原型中操作。
这一阶段使用本地模拟数据,身份和奖励相关流程也只是交互演示。它能帮助我确认配置完成后怎么返回、取消编辑是否保留原卡,以及普通指令和盲盒分别在哪里展示。
从前端往服务端继续做,首先要说清楚哪些变化需要保存。
| 状态 | 具体内容 | 由谁维护 |
|---|---|---|
| 页面临时状态 | 选中的格子、弹窗开关、未提交的编辑草稿 | 前端组件 |
| 房间业务状态 | 已保存的九格配置、当前卡片、揭晓结果 | 服务端保存,前端按权限读取,公开卡面变化通过房间同步更新 |
| 运营配置 | 后台发布的玩法设置 | 运营后台维护,服务端按已发布配置处理 |
点击格子只改变选中项,执行揭晓才提交业务操作。保存模板和应用配置也分开处理,编辑卡片库不能直接改变直播中正在使用的卡。
我让 AI 补页面和接口时,就沿用这些区别。这样,同一个“保存”按钮究竟只保存模板,还是会影响当前房间,前后端都有明确的处理依据。
视觉设计也分几步完成。先围绕主界面试风格,选定紫色卡通方向,再扩展到配置、模板编辑、历史记录和结果弹窗。整套 UI 确认后,才分别生成角色、格子底图和装饰,装配进 Vue 组件。
下面是当时比较的四种视觉方向。紫色卡通图依据最终采用的风格重新生成,用于统一主图尺寸与构图。
| 月光紫晶 | 冰蓝极光 |
|---|---|
|  |  |
| 紫色卡通(采用的风格) | 暖黄复古 |
|  |  |
图 1|四种主界面视觉方向对比,均为设计示意。
风格确定后,再把配置、模板编辑和记录等页面放在一起检查。
图 2|统一风格后的多页 UI 设计预览,图内为模拟内容。
进度、格号和奖品名称仍由代码显示。这些内容会随业务数据变化,把它们留在组件里,素材才能继续复用。页面接入模拟房间数据后,我再检查窄屏标题、长文案、记录滚动和弹窗位置。
- 三个仓库,先把同一份接口约定写清楚
开始写 PHP 前,我先让 AI 读已有玩法从开启、揭晓到结束的调用过程,找出可以复用的房间能力,以及新玩法需要增加的逻辑。
随后,我和 AI 沿着主持的操作讨论数据。保存配置后要留下什么,换卡后怎样查到之前的记录,房间状态、卡片内容和历史记录分别负责什么,都在这一步确定。
其中一条规则影响了后面的实现和测试。卡片保留生成时的配置快照,后台后续修改配置,只影响之后生成的新卡。揭晓旧卡时,服务端需要读取这张卡保存的配置。
房间前端、服务端、运营后台分属三个仓库,我在不同的 AI 会话中推进开发。为了让它们接得起来,我按配置保存、揭晓和换卡等操作整理接口清单,把请求内容、返回结构和错误含义写在一起,交给各个会话使用。
以揭晓操作为例,前后端需要对下面这些业务含义保持一致,具体字段名已省略。
| 接口涉及的内容 | 实现时要回答的问题 |
|---|---|
| 当前玩法、卡片和版本 | 请求操作的是哪一轮、哪张卡,页面持有的版本是否仍然有效 |
| 操作资格与卡片归属 | 当前操作是否由允许执行的主持发起,目标卡是否属于当前玩法 |
| 重复操作的含义 | 同一个格子已经揭晓时,后续请求不能再次开奖 |
| 返回内容和错误含义 | 前端与服务端如何理解当前卡片状态,以及请求未被执行的原因 |
实现以后,我再从页面调用开始往后追,检查传出的参数能否被服务端正确理解,返回的数据能否支撑页面状态更新。
运营后台也使用这份约定。输入项的含义和单位要与服务端一致;查询失败时,页面清掉上一次查到的资料,并阻止确认,避免把旧结果带进当前操作。
- 揭晓一格,先保存结果,再更新房间
接口收到请求后,要检查主持权限、卡片归属和当前版本,处理页面状态滞后及重复提交。已经揭晓的格子不会再次开奖。
通过这些业务处理之后,一次揭晓会同时改变卡面结果和揭晓进度。我先和 AI 列出需要一起修改的记录,再把它们放进同一个数据库事务。全部写入成功才提交,中途出错就一起回滚。
下图把事务内的数据写入与提交后的缓存、房间同步分开。绿色分支提交后继续执行,写入失败则整体回滚。

图 3|揭晓处理的简化流程,省略具体字段、权限实现与并发控制细节。
房间信息会被前端反复读取,因此查询结果放在 Redis 中缓存。发生揭晓后,先完成数据库提交,再失效旧缓存,让后续查询能够获取新的业务状态。
这里还要区分“结果已保存”和“房间已收到同步”。房间同步暂时失败时,数据库中的揭晓结果仍然有效,后续处理不能因此重新开奖。这个区别决定了异常发生后应该检查哪一段,也避免把通知失败理解成业务结果不存在。
公开同步的内容同样需要限定。房间里的其他人需要看到卡面变化,未揭晓的答案和接收用户等信息则保留在各自允许查看的范围内。
- 用真实回包联调,再检查业务记录
接口代码写出来以后,我先检查前后端能否按同一份数据工作。
服务端在隔离环境中执行实际 PHP 接口并导出回包,前端直接使用这些返回结果进行集成验证。默认九格、保存后的配置、卡片版本等内容,都来自后端的实际执行。
这样,前端测试使用的数据与服务端实现有直接联系。字段类型、状态含义或返回结构有偏差时,可以沿着同一份回包排查。组件测试、实际构建和浏览器检查,再继续覆盖请求处理、页面渲染、布局及操作。
接口能接上之后,还要检查业务结果是否遵循前面确定的规则。配置快照就有一条实际执行过的测试过程。
| 操作顺序 | 需要验证的业务结果 |
|---|---|
| 先生成一张卡 | 卡片保存生成时的配置 |
| 在后台修改配置 | 已生成卡片保留原来的配置 |
| 修改后再揭晓这张旧卡 | 旧卡仍按生成时的配置处理 |
| 随后生成新卡 | 新卡采用更新后的配置 |
我让 AI 回查实际业务记录,确认旧卡和新卡分别使用了对应的配置。这里检查的是卡片生成、配置修改和后续处理能否遵守同一条规则,页面显示正确只是其中一部分。
另外几类情况也放进了隔离环境中的测试。
| 验证方式 | 检查内容 |
|---|---|
| 两个 PHP 进程同时执行 | 并发情况下的业务处理 |
| 注入数据库写入异常 | 相关状态能否一起回滚 |
| 重复提交开卡、揭晓和换卡请求 | 重复操作是否按预期处理 |
| 接入真实 Redis | 缓存与锁的行为 |
相关代码还交给独立的 AI 子代理审查。前端使用的回包、数据库里的记录和浏览器中的操作结果,需要能解释同一次业务行为。
- 数据库、后端、前端按依赖顺序部署
开发和联调完成后,我继续让 AI 准备数据库变更,补齐字段注释、默认值和检查信息。按现有审核流程确认执行,再检查字段及原有数据,随后按后端先、前端后的顺序部署。
这个顺序来自页面对接口的依赖。前端启用新的配置流程时,对应字段和后端接口需要已经就绪。
AI 整理变更、准备合入候选、运行检查,并推进测试环境流水线和部署。我还让它读取实际加载的页面、脚本与样式,核对部署产物是否对应通过检查的代码。检查通过的代码与页面真正加载的资源,要在同一环境里对得上。
截至这次实践整理时,呱呱乐已经完成多轮测试环境发布,生产侧配置了单房白名单入口。涉及关键执行、合并和发布,仍按平台已有流程确认。
这次从前端继续做服务端,我能借用的经验很具体。主持点下去后改变了哪些状态,其他人应该看到什么,旧页面还能不能继续操作,都可以从交互一路追到接口和数据。AI 帮我补实现,我也需要跟着把代码为什么这样工作解释清楚。
你用 AI 做项目时,最容易卡在哪一步? 多个会话怎样保持接口一致,生成代码接入现有系统后,联调和测试该从哪里开始?欢迎带着你的场景来技术群交流,也分享你已经走通的做法。关注公众号 「花椒技术部」,回复 「技术群」 获取入群入口。
这篇复盘把AI编码落到接口契约、状态边界和可验证性上,适合前端转全栈、多仓库并行交付及需要真实联调测试的团队参考。