# lab-lims — LIMS 核心模块

**路径:** `project_husbandry_back/lab-service/lab-lims/`
**包名:** `org.springblade.lims.*`
**规模:** 后端最大模块（约 250+ Java 源文件）

## 包结构

```
org.springblade.lims/
├── api/              # 内部 API DTO（3 个文件）
├── config/           # 模块级配置（2 个文件）
├── controller/       # REST 接口（47 个控制器）
├── demo/             # 演示/测试桩（2 个文件）
├── excel/            # Excel 导出处理器（13 个文件）
├── feign/            # Feign 客户端实现（1 个文件）
├── mapper/           # MyBatis-Plus Mapper（46 个文件）
├── Scheduled/        # 定时任务（1 个文件）
├── service/          # 业务逻辑（92 个文件）
├── tools/            # 工具类（1 个文件）
└── utils/            # 工具类（15 个文件）
```

## 领域控制器分类

| 领域 | 关键控制器 |
|------|-----------|
| 样品/委托 | Entrust、HandleSample、RetentionSample、Simple、SimpleRel、SimpleSet、LsReservedSample |
| 检测/检验 | Examine、ExamineItem、ExamineResult、ExamineTask、ExamineBasis、SimpleDoExamineLog |
| 安全/危化品 | DangerApply、DangerApplyLog、DangerMoveLog、DangerRecoveryLog、DangerStorage |
| 仪器设备 | Instrument、InstrumentMaintLog、InstrumentUseLog、TemperatureControl |
| 试剂/实验动物 | Reagent、ReagentUseLog、ExperimentalAnimal |
| 质量/标准 | QualityStandard、DetermineFormula |
| 合同/维修 | Contract、ContractSample、RepairApplication、ScrapApplication |
| 环境 | EnvDict、EnvLog、DisinfectLog、SewageDischargeLog |
| 模板/蓝图 | Template、TaskBlueprint、LsTemplateLog |
| 日志/审计 | LsAuditTrailLog、LsEventLog、LsTemperatureHumidityLog |
| 统计/大屏 | LsDataStatistic、LargeScreen |

## 约定规范

- **CRUD**: 标准 SpringBlade 模式 controller → service（接口）→ service/impl → mapper
- **Excel**: 导出处理器放在 `excel/` 包下，每个实体对应一个
- **Mapper**: MyBatis-Plus BaseMapper 扩展，XML 映射文件在 resources 中
- **内部 API**: DTO 放在 `api/` 包中，仅供模块内部使用
- **定时任务**: `Scheduled` 包存放 @Scheduled 任务（不在 service/ 中）

## 反模式

- 无单元测试（仅有 `demo/` 空壳）
- `Scheduled` 包只有单个类 — 功能可能不完整