docs(client): add module-level AGENTS indexes for all 11 modules

新增 11 个模块级 AGENTS.md,覆盖企业工作台全部业务模块,入口表统一指向模块指引。

- 统一四段式:路径基准 / 页面与入口表 / 关键边界 / 验证入口
- 补明“页面 -> store -> API”的调用链路,避免只给目录
- 仅索引文档,未改动业务代码
This commit is contained in:
2026-10-20 12:42:07 +08:00
parent 8abc058a65
commit 1e26ddad4b
12 changed files with 336 additions and 14 deletions
+28
View File
@@ -0,0 +1,28 @@
# 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`。