Files

T

ouyangxq b34626bd4b docs(admin): add module-level AGENTS indexes for all 33 modules

新增 29 个模块级 AGENTS.md，补齐入口表指向，使 33 个业务模块均可从入口直达页面与接口。

- 每个模块指引统一为：路径基准 / 页面与入口表 / 关键边界 / 验证入口
- 入口表 35 行改为指向 modules 下的 AGENTS.md，补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条
- 详细索引最长行从 1315 字符压缩到 699 字符，规则正文移入新增的“货柜工作台规则”小节
- 仅索引文档，未改动业务代码

2026-10-20 12:45:00 +08:00

1.8 KiB

Raw Blame History

Admin 消息中心模块指引

路径基准与读取顺序

本文件适用于 src/modules/notifications/，代码路径相对本目录；应用公共规则见 ../../../AGENTS.md。
消息中心只在顶部入口，不进入左侧菜单；模板维护在系统设置下，两者共用同一套通知契约。
后端只查 iam/ 的 notification/ 子域；不读其他服务。

页面与入口

目标	页面/路由	API 与后端
消息收件箱与已读	`pages/PlatformNotificationsView.vue`；`notifications`	`api/notificationCenter.ts`；`iam/` notification
消息管理（发送与记录）	`pages/MessageManagementView.vue`、`components/MessageComposerDialog.vue`；`notifications/messages`	`api/notificationCenter.ts`；`iam/` notification
消息模板维护	`pages/MessageTemplatesView.vue`、`components/TemplateEditorDialog.vue`；`notifications/templates`	`api/notificationCenter.ts`；`iam/` notification
展示文案与类型映射	`presentation.ts`、`types.ts`	服务端模板变量

关键边界

消息只展示服务端返回的业务文案与业务编号，不把内部数据库 ID 作为标题或链接参数回退。
模板变量必须来自服务端模板定义，前端不硬编码业务字段名或补默认值。
发送类操作需要确认、处理中与失败反馈；失败保留用户输入，不静默清空草稿。
未读计数与已读状态以服务端为准，不在本地累加或乐观改写后不回读。
顶部入口不擅自扩展到左侧菜单，也不为单条消息新增独立路由页。

验证

定向：pnpm test src/modules/notifications/<目标测试>；模板变量或发送字段变更同时核对 iam 通知契约。
本文件或索引变更后，从后端根运行 ./scripts/agents-index-contract.ps1。

1.8 KiB Raw Blame History Unescape Escape

Admin 消息中心模块指引

路径基准与读取顺序

页面与入口

关键边界

验证

1.8 KiB

Raw Blame History