优化结构

This commit is contained in:
Yvan
2026-08-27 19:08:51 +08:00
parent 653414a1da
commit 5052835fcb
11 changed files with 197 additions and 19 deletions
+4 -7
View File
@@ -3,14 +3,12 @@
系统模块承载当前管理后台的完整业务边界。`internal` 顶层只保留有明确
生命周期或分层职责的包:
- `app`:应用组合根,负责依赖注入后的任务/路由组合
- `modules`:静态模块 catalog,按 system/integration/task/payment 维护 Definition
- `biz/system`:用户、权限、菜单、审计、媒体和系统配置领域
- `biz/payment`:支付订单、支付流程、支付接口和支付日志
- `biz/integration`:集成配置定义、校验和连接测试边界
- `biz/task`:定时任务模型、用例和任务注册协议
- `config`:Viper 配置模型、加载、快照和热更新
- `global`:进程级 DB、Redis、Mongo、Storage、MQ、WebSocket 和 Scheduler 入口
- `data`:共享数据库生命周期;仓储按 `data/system`、`data/integration`、`data/task`、`data/payment` 隔离
- `initialize`:数据库首次初始化和系统种子数据编排
- `integration`:Redis、邮件、对象存储、支付、WebSocket、EMQX 和 RabbitMQ 适配器
@@ -25,13 +23,12 @@
目录代表边界,模块文件按资源命名。DTO、handler、中间件、路由和 HTTP
响应工具分别放在独立子包中,避免 `service`/`server` 根目录堆积几十个
文件,同时不把只有一两个文件的业务逻辑再拆成新包。system 的 module
定义位于 `modules/system`,后台 JWT 签发/解析位于 `data/system/token.go`,protobuf JSON 统一使用
`pkg/protoutil`。
定义位于 `modules/system`,后台 JWT 签发/解析位于 `data/system/token.go`。
`internal/modules/catalog.go` 是静态模块 catalog 的唯一注册点,负责按依赖顺序
汇总各模块 Definition。`internal/app/runtime.go` 只负责依赖注入后的任务注册
和路由组合。这样新增模块只需在 modules catalog 注册一次,app 不再重复
维护模块声明。
汇总各模块 Definition。`cmd` 是应用组合根,负责依赖注入后的任务注册和路由
组合;这样新增模块只需在 modules catalog 注册一次,组合根不再重复维护模块
声明。
系统表统一使用 `sys_` 前缀;业务表应由新业务模块自行命名和迁移,不要混入
本目录。