You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
43 lines
1.5 KiB
43 lines
1.5 KiB
1 week ago
|
# lab-lims-api — LIMS API 接口
|
||
|
|
|
||
|
|
**路径:** `project_husbandry_back/lab-service-api/lab-lims-api/`
|
||
|
|
**包名:** `org.springblade.lims.*`
|
||
|
|
**作用:** Feign 客户端接口 + 服务间调用共享 DTO
|
||
|
|
|
||
|
|
## 包结构
|
||
|
|
|
||
|
|
```
|
||
|
|
org.springblade.lims/
|
||
|
|
├── ao/ # 应用对象（2 个文件）
|
||
|
|
├── Cache/ # 缓存常量（1 个文件）
|
||
|
|
├── capital/ # 资金/财务 DTO（49 个文件）
|
||
|
|
├── entry/ # 实体定义（51 个文件）
|
||
|
|
└── feign/ # Feign 客户端接口（1 个文件）
|
||
|
|
```
|
||
|
|
|
||
|
|
## 关键包说明
|
||
|
|
|
||
|
|
| 包 | 文件数 | 用途 |
|
||
|
|
|----|--------|------|
|
||
|
|
| `entry/` | 51 | 共享实体类（JPA/MyBatis-Plus 映射） |
|
||
|
|
| `capital/` | 49 | 资金领域 DTO（VO、DTO、AO） |
|
||
|
|
| `feign/` | 1 | ILimsClient — 服务间调用的 Feign 接口 |
|
||
|
|
| `ao/` | 2 | 应用层 DTO |
|
||
|
|
| `Cache/` | 1 | 缓存键常量 |
|
||
|
|
|
||
|
|
## 约定规范
|
||
|
|
|
||
|
|
- **单一 Feign 接口**: 所有 LIMS Feign 端点定义在 1 个客户端接口中
|
||
|
|
- **实体共享**: `entry/` 包含跨服务共享的实体（不在实现模块中重复定义）
|
||
|
|
- **资金子域**: 拥有独立子包，49 个文件 — 重要的子领域
|
||
|
|
- **无业务逻辑**: 纯 API 契约模块，不含 service/impl
|
||
|
|
|
||
|
|
## 快速定位
|
||
|
|
|
||
|
|
| 任务 | 路径 |
|
||
|
|
|------|------|
|
||
|
|
| 查找实体定义 | `entry/*.java` |
|
||
|
|
| 查找资金模块 VO/DTO | `capital/vo/*.java` |
|
||
|
|
| 查找 Feign API 契约 | `feign/ILimsClient.java` |
|
||
|
|
| 添加跨服务 DTO | 在对应包中创建，然后同步 lab-lims 实现模块 |
|