优化构架

README.md

@@ -23,9 +23,19 @@ pnpm build
 pnpm test
 ```
 
+## 源码结构
+
+- `src/app/`：应用壳层、根路由和启动装配。
+- `src/core/`：认证、权限、导航、未保存工作保护等全应用基础能力。
+- `src/modules/`：按业务领域组织页面、接口、组件、类型和模块路由。
+- `src/shared/`：不依赖具体业务的 HTTP、基础组件和工具。
+- `src/prototype/`：尚未进入当前迭代的原型页面与路由，和正式业务代码隔离。
+
+新增业务页面时，在对应 `src/modules/<domain>/` 中就近放置页面、测试和领域能力，并从模块 `routes.ts` 导出路由片段；根路由只负责装配，菜单仍由 `src/core/navigation/adminNavigation.ts` 集中维护。跨模块调用必须经过模块根入口公开的 API，不能引用对方内部目录。
+
 依赖和 `pnpm-lock.yaml` 均保存在当前前端项目中，不需要在仓库根目录安装 Node 依赖。
 
-工作台已从一期路由与菜单移除；登录后按当前角色进入第一个有权限的业务页面。一期 Admin 路由聚焦登录、客户及注册审核、平台收货仓、快递公司、往来单位、头程订单、内部用户、角色管理和菜单权限。
+工作台已从一期菜单和默认入口移除；登录后按当前角色进入第一个有权限的业务页面。历史工作台仍保留为不展示菜单的原型路由。一期 Admin 正式路由聚焦登录、客户及注册审核、平台收货仓、快递公司、往来单位、头程订单、内部用户、角色管理和菜单权限。
 
 后台菜单仅展示已接入的一期模块；其余平台原型菜单保留为导航配置中的注释，待对应业务契约接入后再恢复展示。企业审核、仓库、头程订单、平台角色、菜单及按钮权限资源均接入真实接口；用户管理通过 IAM 统一维护平台账号和企业租户账号。运行时不再提供本地演示业务数据或静态角色预览。