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.
51 lines
2.4 KiB
51 lines
2.4 KiB
# 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` 包只有单个类 — 功能可能不完整
|
|
|