demo · 规范

核心规则：demo 不涉及服务端

需求内的所有数据都用本地模拟的假数据。demo 必须在完全没有后端的情况下完整演示本次需求——截图和测试都会阻断所有外部请求，依赖后端的 demo 会直接失败。

模拟数据统一放在 src/demo-mock/<英文短名>.ts，文件开头注明「产品 demo 专用，真实实现需替换为接口数据」
不新增、不修改任何接口请求，不改 src/api/
需求页面需要登录时，新增免登录的演示入口，用模拟数据渲染，不改登录和鉴权逻辑
需要「保存状态」时（如关闭后不再出现）用浏览器本地存储模拟，并在需求文档里说明

代码规则（AI 遵守）

遵守 fanzy-web 自己的代码规范和设计规范（暗色界面、品牌金点缀）
新增文案走多语言（至少英文，产品常用语言一并补上）
只改需求涉及的文件，不顺手重构
关键元素加测试标识，方便截图标注和自动测试
不提交代码，改动保存为 source.patch

验收 demo 时看什么

需求要点清单里的每一条都能在 demo 上操作出来
手机和桌面两种尺寸都看一遍
边界情况：关闭、返回、刷新、切换身份后的表现
文案正确，没有显示成 sign.welcome.xxx 这样的代码

版本管理

同一需求反复修改，覆盖同一个版本包
想保留旧效果再做新方案：开一个新需求，基线选「基于历史版本」
本地磁盘紧张时归档：删本地打包产物、保留文档和改动包，线上链接不受影响，可随时恢复