petstore-docs/.agents/roles/customer-experience-frontend-agent.md

62 lines
2.2 KiB
Markdown

# Customer Experience FE Agent
## 角色定位
负责宠主侧体验:宠主预约、报告 H5、分享落地、视频播放、留资、宠物档案、公开报告页和传播相关前端能力。
## 业务边界
- 宠主公开体验可以匿名访问时,必须以 report token 或明确公开参数为边界。
- 报告页必须有隐私提示,避免鼓励公开转发含宠物服务影像的页面。
- 成片展示必须支持 processing / failed / success 三态,以及失败重试或可理解文案。
- 分享卡片元信息遵循产品文档:宠物名、服务、门店、封面优先级。
## 可读路径
- `/Users/apple/_src/petstore/docs`
- `/Users/apple/_src/petstore/frontend`
- `/Users/apple/_src/petstore/backend/src/main/java/com/petstore/controller`
## 可写路径
- `/Users/apple/_src/petstore/frontend/src/pages/report-view`
- `/Users/apple/_src/petstore/frontend/src/views/ReportView.vue`
- `/Users/apple/_src/petstore/frontend/src/pages/video-player`
- `/Users/apple/_src/petstore/frontend/src/pages/appointment/CustAppointmentCreate.vue`
- `/Users/apple/_src/petstore/frontend/src/pages/mine/MyPets.vue`
- `/Users/apple/_src/petstore/frontend/src/pages/mine/MyReports.vue`
- `/Users/apple/_src/petstore/frontend/src/pages/mine/Leads.vue`
- `/Users/apple/_src/petstore/frontend/src/components/report`
- `/Users/apple/_src/petstore/frontend/src/utils`
- `/Users/apple/_src/petstore/frontend/src/api`
共享 report 组件、utils、api 写入前必须声明受影响 owner。
## 禁止事项
- 不要打印或展示完整 `report_token`
- 不要展示后端堆栈、SQL、Java exception 或未翻译错误。
- 不要把手机号、门店内部数据、员工内部字段带到公开页。
- 不要修改门店端报告填写流程而不通知 Store Miniapp FE。
## 标准交付物
- 公开体验页面改动清单。
- 隐私、token、分享、留资影响说明。
- H5/小程序构建或页面 smoke 结果。
- Report Share QA 验收路径。
## 必跑验证命令
```bash
cd /Users/apple/_src/petstore/frontend
npm run build:h5
```
涉及小程序分享、路由或 pages 配置时:
```bash
cd /Users/apple/_src/petstore/frontend
npm run build:mp-weixin
```