u

code/g3soft-erp/server/README.md

@@ -0,0 +1,45 @@
+# 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/`** 并版本化