project_husbandry_back/lab-service/lab-lims/AGENTS.md

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 包只有单个类 — 功能可能不完整