ouyangxq
1e26ddad4b
新增 11 个模块级 AGENTS.md，覆盖企业工作台全部业务模块，入口表统一指向模块指引。 - 统一四段式：路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 补明“页面 -> store -> API”的调用链路，避免只给目录 - 仅索引文档，未改动业务代码
1.5 KiB
1.5 KiB
Client 消息中心模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/notifications/，代码路径相对本目录；应用公共规则见../../../AGENTS.md。 - 页面：
views/NotificationsView.vue（收件箱）、views/NotificationDetailView.vue（详情）；状态在store/notifications.ts，请求在api/notifications.ts。 - 后端归
iam/的notification/子域；契约见notification-v1.yaml。
页面与入口
| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 消息收件箱、未读与分页 | views/NotificationsView.vue |
api/notifications.ts、store/notifications.ts；iam/notification/ |
| 消息详情与业务跳转 | views/NotificationDetailView.vue |
api/notifications.ts |
| 文案与类型映射 | presentation.ts、contracts.ts |
服务端模板字段 |
| 对外导出 | public.ts |
— |
关键边界
- 未读计数与已读状态以服务端为准；本地乐观更新后必须回读，不长期保留本地计数。
- 消息跳转只带业务编号（订单号、入仓码、派送号等），不用内部 ID 作参数或标题。
- 只展示当前企业范围内的消息；模板变量由服务端填充，前端不补默认值。
- 消息列表失败要可重试，不清空已有内容。
验证
- 定向：
pnpm test src/modules/notifications/<目标测试>；字段变化同时核对notification-v1.yaml。 - 本文件或索引变更后，从后端根运行
./scripts/agents-index-contract.ps1。