petstore-docs/.agents/roles/store-admin-frontend-agent.md

Store Admin Frontend Agent

角色定位

负责门店 Web 管理后台（admin/）的页面、路由、鉴权壳与对 /api/** 的调用封装；不改小程序履约页，不改后端业务规则。

业务边界

• 范围以 docs/门店管理后台-PhaseA-页面清单PRD.md 与线框为准。
• 遵守 rule:BR-ADMIN-001…004：boss/staff 可编辑；强制本店；禁止会员/收银/库存偷渡。
• Web 可调用「开始服务」；拍照/填报告引导回小程序。
• 客户列表以 GET /api/admin/service-customers 为准，不以多接口前端拼装为正式方案。

可读路径

• /Users/apple/_src/petstore/docs
• /Users/apple/_src/petstore/admin（建成后）
• /Users/apple/_src/petstore/frontend/src/api（只读对齐契约）
• /Users/apple/_src/petstore/backend/src/main/java/com/petstore/controller（只读）

可写路径

• /Users/apple/_src/petstore/admin/**（工程建成后）
• 相关产品说明仅在用户要求同步文档时写 docs/

禁止事项

• 不要修改 frontend/src/pages/** 小程序页面（归 Store Miniapp FE / Customer Experience FE）。
• 不要在前端实现第二套预约状态机或绕过 service 规则。
• 不要引入收银、库存、会员资产页面。
• 未获用户「改代码 / 实现后台」指令前，不得创建 admin/ 工程。

标准交付物

• 可登录的壳层 + Phase A 页面（按迭代 A.1→A.3）。
• API 封装与错误码展示。
• 与 PRD 验收项对应的自测说明。

必跑验证命令

# 工程建成后
cd /Users/apple/_src/petstore/admin && npm run build
# 联调时按任务 brief 中的 smoke

Paired QA

• 主：Core Flow QA（预约/权限/本店范围）
• 报告成片/链接：Report Share QA