优化构架

AGENTS.md

@@ -16,20 +16,25 @@
 
 ## 目录与职责
 
-- `src/views/`：路由级页面和业务编排；复杂、可复用的展示或交互下沉到组件。
-- `src/components/`：无路由依赖的复用组件，输入输出应有明确类型。
-- `src/layouts/`：应用壳层、导航和全局页面结构。
-- `src/router/`：路由、标题、登录保护和权限元数据；新增模块时同步维护导航与路由配置。
-- `src/stores/`：跨页面状态和业务动作；仅页面局部使用的状态留在组件内。
-- `src/api/`：HTTP 客户端和接口适配；页面与组件不得散落创建 Axios 实例。
+- `src/app/`：应用装配层，包含布局、根路由、全局守卫和启动入口；不承载具体业务或被业务模块反向依赖。
+- `src/core/`：认证会话、访问控制、导航配置、未保存工作保护和路由安全工具等全应用基础能力；可以被 `app` 和业务模块使用，但不得依赖业务模块。
+- `src/modules/`：按客户、仓库、头程订单、主数据、下载中心、IAM 等稳定业务领域组织页面、API、类型、组件和路由。新增业务页面必须进入对应模块，不再建立根级 `views/`。
+- `src/shared/`：与具体业务无关的后台公共 HTTP、组件和工具。模块专属能力先留在模块内部，只有被无关模块真实复用时才上移。
+- `src/prototype/`：未纳入当前迭代的原型页面和原型路由；正式模块不得依赖原型代码。
+- `src/modules/*/pages/`：路由级页面和业务编排；复杂展示、表单、抽屉和交互下沉到同模块组件或 composable。
+- `src/modules/*/routes.ts`：模块路由片段；由 `src/app/router/index.ts` 统一装配。新增模块时同步维护 `src/core/navigation/adminNavigation.ts`。
+- `src/core/*/` 与 `src/modules/*/stores/`：前者只放全应用基础状态，后者放领域状态；仅页面局部使用的状态留在页面或 composable。
+- `src/modules/*/api/`：领域接口适配；公共 Axios 客户端位于 `src/shared/api/http.ts`，页面与组件不得散落创建 Axios 实例。
 - `VITE_API_BASE_URL` 控制浏览器请求前缀，`API_PROXY_TARGET` 控制 Vite 开发代理上游；后者只由开发服务器读取，不进入客户端构建。新增或变更环境变量时同步更新 `.env.example`，不得提交真实密钥或环境专属凭据。
-- `src/types/`：后台专属类型；跨应用共享的稳定契约放到 `packages/shared`。
+- 模块专属类型放在对应模块；跨应用共享的稳定契约放到 `packages/shared`。
 - `src/styles/`：设计令牌和全局样式；优先复用现有 `--cc-*` 变量和组件样式。
 
+依赖方向保持为 `app -> modules/core/shared`、`modules -> core/shared`、`core -> shared`、`shared -> 无上层依赖`。模块间确需调用时只能引用对方根入口公开的 API 或契约，不得引用其他模块的页面、内部组件或内部目录。
+
 ## 业务与安全约束
 
 - 菜单隐藏和前端路由守卫只改善体验，不能替代服务端鉴权。新增操作必须使用稳定的权限编码，并与 API 权限保持一致。
-- 认证统一经过 `src/stores/auth.ts` 和 `src/api/http.ts`；不要在页面中复制令牌读写或手工拼装 `Authorization`。
+- 认证统一经过 `src/core/auth/auth.ts` 和 `src/shared/api/http.ts`；不要在页面中复制令牌读写或手工拼装 `Authorization`。
 - 当前登录和部分数据仍可能是模拟实现。接入 `services/api` 时删除对应模拟路径，不允许让生产逻辑静默回退到假数据。
 - 删除、停用、改权限等高风险操作必须有明确确认、处理中、成功和失败反馈；失败时保留用户上下文，避免误以为已生效。
 - 日志、提示和示例数据不得包含真实账号、令牌、客户隐私或生产数据。