# 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 实现模块 |