html/client-web

Files

T

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

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

- 统一四段式：路径基准 / 页面与入口表 / 关键边界 / 验证入口
- 补明“页面 -> store -> API”的调用链路，避免只给目录
- 仅索引文档，未改动业务代码

2026-10-20 12:42:07 +08:00

1.1 KiB

Raw Blame History

Client 工作台模块指引

路径基准与读取顺序

本文件适用于 src/modules/dashboard/，代码路径相对本目录；应用公共规则见 ../../../AGENTS.md。
只有 views/DashboardView.vue 与 overview.ts；路由为空路径（登录后默认页）。
后端按卡片来源分别查 order/、firstleg/、lastleg-service/；本模块只做聚合展示。

页面与入口

目标	页面/入口	API 与后端
业务总览卡片与快捷入口	`views/DashboardView.vue`	`overview.ts`；按卡片对应的服务
卡片数据映射与跳转	`overview.ts`	各业务模块的公开 API

关键边界

只展示服务端或既有模块返回的数据，不在首页二次统计或补算。
快捷入口跳转带明确业务筛选，不用标题文字反推状态。
首页不新增跨客户对比或内部经营指标；客户只能看到本企业数据。
卡片加载失败要单卡片降级，不阻塞整页。

验证

定向：pnpm test src/modules/dashboard/<目标测试>。
本文件或索引变更后，从后端根运行 ./scripts/agents-index-contract.ps1。