# erp-server

## 设计思想

`erp-server` 是 L3 层——**唯一的组装点**。它不包含业务逻辑，只负责把所有业务模块组装成可运行的服务。

核心决策：
- **配置优先** — 使用 `config` crate 从 TOML 文件 + 环境变量加载，`ERP__` 前缀覆盖（如 `ERP__DATABASE__URL`）
- **启动序列严格有序** — 配置 → 日志 → 数据库 → 迁移 → Redis → 路由 → 监听，每步失败即终止
- **单一入口** — 所有模块通过 `ModuleRegistry` 注册，server 本身不直接 import 业务模块的类型

## 代码逻辑

### 启动流程 (`main.rs`)
```
1. AppConfig::load()           ← config/default.toml + 环境变量
2. init_tracing(level)         ← JSON 格式日志
3. db::connect(&db_config)     ← SeaORM 连接池 (max=20, min=5)
4. Migrator::up(&db_conn)      ← 运行所有待执行迁移
5. redis::Client::open(url)    ← Redis 客户端（当前未使用）
6. Router::new()               ← 当前仅有 404 fallback
7. bind(host, port).serve()    ← 启动 HTTP 服务
```

### 配置结构
```
AppConfig
├── server: ServerConfig     { host: "0.0.0.0", port: 3000 }
├── database: DatabaseConfig { url, max_connections: 20, min_connections: 5 }
├── redis: RedisConfig       { url: "redis://localhost:6379" }
├── jwt: JwtConfig           { secret, access_token_ttl, refresh_token_ttl }
└── log: LogConfig           { level: "info" }
```

### 当前状态
- 数据库连接池正常工作
- 迁移自动执行
- **没有注册任何路由** — 仅返回 404
- **没有使用 ModuleRegistry** — 未集成业务模块
- Redis 客户端已创建但未执行任何命令
- 缺少 CORS、压缩、请求追踪中间件

## 关联模块

- **[[erp-core]]** — 提供 AppError、ErpModule trait、ModuleRegistry
- **[[database]]** — 迁移文件通过 `erp-server-migration` crate 引用
- **[[infrastructure]]** — Docker 提供 PostgreSQL 和 Redis 服务
- **[[frontend]]** — Vite 代理 `/api` 请求到 server 的 3000 端口

## 关键文件

| 文件 | 职责 |
|------|------|
| `crates/erp-server/src/main.rs` | 服务启动入口 |
| `crates/erp-server/src/config.rs` | 5 个配置 struct + 加载逻辑 |
| `crates/erp-server/src/db.rs` | SeaORM 连接池配置 |
| `crates/erp-server/config/default.toml` | 默认配置值 |
| `crates/erp-server/Cargo.toml` | 依赖声明 |

## 待完成 (Phase 1 剩余)

1. 实例化 `ModuleRegistry` 并注册模块
2. 添加 CORS 中间件（tower-http）
3. 添加请求追踪中间件
4. 将 Redis 连接注入 AppState
5. 健康检查端点 (`/api/v1/health`)