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.6 KiB

Raw Blame History

Admin PDA 版本发布模块指引

路径基准与读取顺序

本文件适用于 src/modules/pda-releases/，代码路径相对本目录；应用公共规则见 ../../../AGENTS.md。
只有 pages/PdaReleasesView.vue 与 api/pdaReleases.ts；上传草稿、发布与停发都在同一页。
后端归 file/（PdaReleaseController、PdaReleaseService、pda-releases-v1.yaml），接口经 /platform/v1/files/pda-releases；设备端更新逻辑在两端 PDA 的 app-update 工具里。

页面与入口

目标	页面/入口	API 与后端
国内/海外 APK、WGT 版本列表与上传	`pages/PdaReleasesView.vue`	`api/pdaReleases.ts`；`file/`
发布与停发	列表行操作	`api/pdaReleases.ts`；权限 `platform:pda-release:manage`
匿名清单与包下载（设备侧）	不在本页	`file/` 匿名入口，只暴露当前已发布与历史未停发文件

关键边界

上传只创建草稿，不自动发布；发布与停发必须二次确认，并展示影响端（国内/海外）。
国内与海外按 domestic/overseas 分开查询与操作，AppID、包名、签名与版本序列不得混用。
列表权限 platform:pda-release:list，上传/发布/停发权限 platform:pda-release:manage。
停发只影响后续下载，不追回已安装设备；强更与 WGT 安装重启由设备端策略决定，本模块不越权。

验证

定向：pnpm test src/modules/pda-releases/<目标测试>；接口变化同时核对 file/ 的 pda-releases-v1.yaml。
本文件或索引变更后，从后端根运行 ./scripts/agents-index-contract.ps1。

1.6 KiB Raw Blame History Unescape Escape

Admin PDA 版本发布模块指引

路径基准与读取顺序

页面与入口

关键边界

验证

1.6 KiB

Raw Blame History