优化结构

internal/README.md

@@ -3,8 +3,8 @@
 系统模块承载当前管理后台的完整业务边界。`internal` 顶层只保留有明确
 生命周期或分层职责的包：
 
-- `app`：组合根、模块 catalog 和任务/路由运行时组合
-- `modules`：按 system/integration/task/payment 维护 Definition 等模块贡献
+- `app`：运行时组合根，负责依赖注入后的任务/路由组合
+- `modules`：静态模块 catalog，按 system/integration/task/payment 维护 Definition
 - `biz/system`：用户、权限、菜单、审计、媒体和系统配置领域
 - `biz/payment`：支付订单、支付流程、支付接口和支付日志
 - `biz/integration`：集成配置定义、校验和连接测试边界
@@ -27,14 +27,17 @@
 定义位于 `modules/system`，JWT 实现集中在 `security`，protobuf JSON 统一使用
 `pkg/protoutil`。
 
-`internal/app` 只保留 `catalog.go` 作为组合根：它负责组装模块 catalog、任务
-注册和运行时。system 的迁移、管理面和定时任务由 `internal/modules/system`
-自己的 `Definition()` 声明，便于后续业务模块独立接入。
+`internal/modules/catalog.go` 是静态模块 catalog 的唯一注册点，负责按依赖顺序
+汇总各模块 Definition。`internal/app/runtime.go` 只负责依赖注入后的任务注册
+和路由运行时组合。这样新增模块只需在 modules catalog 注册一次，app 不再重复
+维护模块声明。
 
 系统表统一使用 `sys_` 前缀；业务表应由新业务模块自行命名和迁移，不要混入
 本目录。
 
-system 通过 `modules/system.Definition()` 提供系统迁移、通信集成菜单/API 和默认任务；
+system 通过 `modules/system.Definition()` 提供系统迁移；integration 通过
+`modules/integration.Definition()` 提供通信集成菜单/API；task 通过
+`modules/task.Definition()` 提供定时任务迁移和默认任务；
 payment 通过 `modules/payment.Definition()` 提供支付迁移及支付菜单/API。两者通过
 `worker.TaskMethods` 提供依赖系统用例的任务实现，通过 `server/router.Routes` 提供
 路由。静态模块贡献可由 catalog 汇总；带运行时依赖的路由和任务仍需在 cmd/Wire