# server —— 后端（未开始）

本目录预留给后端服务，**当前为空占位**。

## 已定的技术栈

| 项 | 选型 |
|---|---|
| 框架 | Spring Boot 4.1.0 |
| 语言 | Java 21 |
| Web | spring-boot-starter-webmvc |
| 持久层 | spring-boot-starter-jdbc（**无 ORM**） |
| 连接池 | Druid 1.2.18 |
| 数据库 | **SQL Server**（mssql-jdbc） |
| 鉴权 | JJWT 0.12.6 |
| Excel | Apache Fesod 2.0.2-incubating |
| 其他 | ip2region、ua-parser |
| 构建 | Maven |

## 规划的分包方式

按业务域分包（已确认）：

```
cn.g3soft.erp
├── common/          # 通用返回、异常、工具
├── engine/          # 元数据驱动引擎（查询 / 保存 / 权限）—— 未设计
└── module/
    ├── ocean/       # 海运
    ├── air/         # 空运
    ├── container/   # 箱管
    ├── finance/     # 财务
    ├── crm/         # CRM
    └── system/      # 系统管理
```

## 与前端的关系

**唯一契约是 HTTP 接口。** 前端不读后端源码，后端不管前端怎么调。

同仓的三条纪律（见根 `README.md`）：

1. **独立构建** —— `mvn package` 不触发前端构建，反之亦然
2. **独立版本** —— tag 分开打（`api-v1.2.0` / `web-v1.2.0`）
3. **接口契约写进 `docs/`** 并版本化