9.9 KiB
LMS 管芯托盘绑定与日计划定时调度实现计划
面向 AI 代理的工作者： 必需子技能：使用 superpowers:executing-plans 逐任务实现此计划。步骤使用复选框（
- [ ]）跟踪进度。本仓库规则未获得新增测试授权，因此不创建或运行测试，以编译、Lint、SQL 幂等执行和数据库事务场景核验代替。
目标： 建立逐根管芯台账和 PDA 托盘绑定接口，并实现按最新日计划策略逐根创建桁架抓取、托盘 AGV 搬运和管芯出库任务的两个 XXL-JOB。
架构： lms_core_tube 是每根管芯的唯一状态真值，lms_base_papervehicle 只保存托盘格位关联。LMS 使用现有日计划 Claim、管芯/点位条件更新和 Task RPC 生成单根现场任务，MQ 回调幂等更新位置与日计划进度。Task 模块补充业务标识查询和并发防重能力。
技术栈： Java 17、Spring Boot、MyBatis XML、MySQL、OpenFeign、RocketMQ、XXL-JOB、UniApp PDA 接口契约。
任务 1：创建管芯表、字典和编码规则
文件：
-
创建：
sql/mysql/lms_core_tube.sql -
修改：
sql/mysql/lms_daily_plan.sql -
创建
lms_core_tube，字段按规格定义；重量为decimal(12,3)；租户内管芯编号唯一；有效托盘格位通过tenant_id, vehicle_code, row_num, col_num, active_slot唯一约束。 -
幂等增加
lms_base_papervehicle.core_tube_id/core_tube_code及查询索引。 -
为
lms_daily_plan_strategy增加cursor_executed_qty int NOT NULL DEFAULT 0，用于逐根权重计数。 -
初始化
lms_core_tube_stage、lms_core_tube_status字典和CORE_TUBE_CODE编码规则，格式为GX + yyyyMMdd + 6位序列。 -
在
huachuang_lms_dev连续执行两遍脚本，确认表、字段、字典和编码规则不重复。
任务 2：实现管芯主表和 PDA 5×5 批量绑定
文件：
-
创建：
nl-module-lms/nl-module-lms-server/src/main/java/cn/code/nl/module/lms/dal/dataobject/coretube/CoreTubeDO.java -
创建：
.../dal/mysql/coretube/CoreTubeMapper.java -
创建：
.../resources/mapper/coretube/CoreTubeMapper.xml -
创建：
.../controller/pda/coretube/CoreTubePdaController.java -
创建：
.../controller/pda/coretube/vo/CoreTubePalletRespVO.java -
创建：
.../controller/pda/coretube/vo/CoreTubeBindReqVO.java -
创建：
.../controller/pda/coretube/vo/CoreTubeBindItemReqVO.java -
创建：
.../controller/pda/coretube/vo/CoreTubeBindRespVO.java -
创建：
.../service/coretube/CoreTubeBindingService.java -
创建：
.../service/coretube/CoreTubeBindingServiceImpl.java -
修改：
.../stockingivt/PaperVehicleDO.java -
修改：
.../stockingivt/StockingIvtMapper.java/xml -
修改：
nl-module-lms/nl-module-lms-api/src/main/java/cn/code/nl/module/lms/enums/ErrorCodeConstants.java -
定义绑定请求：
requestNo、vehicleCode、materialId和格位列表；每格包含 1–5 的行列和大于零的重量。响应返回每格生成的管芯 ID、编号和重量。 -
实现
GET /api/pda/coreTube/pallet，关联管芯主表返回托盘点位和完整 5×5 格位。 -
实现
POST /api/pda/coreTube/bind：锁定托盘点位，批量校验格位，逐根调用CodeGenApi.generate(CORE_TUBE_CODE)，同事务插入管芯和格位关系。 -
使用请求号和格位唯一约束防止重复绑定；并发冲突整个批次回滚并抛中文业务异常。
-
运行 LMS Maven compile，预期
BUILD SUCCESS。
任务 3：补齐 Task RPC 的业务防重
文件：
-
修改：
nl-module-task/nl-module-task-api/src/main/java/cn/code/nl/module/task/api/TransportTaskApi.java -
修改：
.../dto/TaskInfoDTO.java -
修改：
nl-module-task/nl-module-task-server/src/main/java/cn/code/nl/module/task/api/TransportTaskApiImpl.java -
修改：
.../service/transporttask/TransportTaskService.java -
修改：
.../service/transporttask/TransportTaskServiceImpl.java -
修改：
.../dal/mysql/transporttask/TransportTaskMapper.java -
增加
getUnfinishedTaskByBiz(ownerService, bizType, bizId)RPC，返回未终态任务。 -
RPC 创建入口以
ownerService:bizType:bizId获取 Redisson 锁，锁内重查；存在时抛“相同业务任务正在执行”，不存在才插入。 -
LMS 调用超时后先按业务标识查询，已存在则绑定既有任务 ID，明确不存在才释放预占。
-
编译 Task 和 LMS 依赖，预期
BUILD SUCCESS。
任务 4：将日计划调度改为逐根策略游标
文件：
-
修改：
.../dailyplan/DailyPlanScheduleService.java -
修改：
.../dailyplan/DailyPlanScheduleServiceImpl.java -
修改：
.../dailyplan/DailyPlanScheduleCandidate.java -
修改：
.../dailyplan/DailyPlanStrategyDO.java -
修改：
.../dailyplan/DailyPlanStrategyMapper.java -
修改：
.../resources/mapper/dailyplan/DailyPlanStrategyMapper.xml -
修改：
.../dailyplan/DailyPlanMapper.java -
修改：
.../resources/mapper/dailyplan/DailyPlanMapper.xml -
增加不立即创建 Claim 的备货/套管候选预览，权重模式从当前游标开始排列，供 Job 跨规格扫描。
-
增加领取指定计划的方法，
claimedQty固定为 1；锁内重新校验状态、剩余量和未完成单根业务任务。 -
增加“现场任务创建成功”确认：权重计数加 1，达到最新权重才推进游标；只创建 AGV、缺货或跳过时不消耗权重。
-
模式、顺序或权重变化时下一轮重读策略；模式切换清零本轮计数。
-
已创建任务持有 Claim；回收 Claim 前必须核对任务，不得因过期重复创建现场任务。
任务 5：实现备货与套管任务选择、预占和创建
文件：
-
创建：
.../service/coretube/CoreTubeTaskDispatchService.java -
创建：
.../service/coretube/CoreTubeTaskDispatchServiceImpl.java -
创建：
.../service/coretube/CoreTubeTaskContext.java -
创建：
.../enums/CoreTubeStageEnum.java -
创建：
.../enums/CoreTubeStatusEnum.java -
创建：
.../enums/CoreTubeLocationTypeEnum.java -
创建：
.../enums/CoreTubeTaskBizTypeEnum.java -
创建：
.../enums/CoreTubeHandleCodeConstants.java -
修改：
.../dal/mysql/coretube/CoreTubeMapper.java/xml -
修改：
.../stockingivt/StockingIvtMapper.java/xml -
备货先按策略顺序和物料去重扫描对接位；命中目标规格后锁定一根、创建单根 Claim、预占管芯并创建桁架抓取任务，本轮结束。
-
所有规格均不能直接抓取时：对接位有其他托盘则创建一条移出任务；为空则按“足够且最接近缺口，否则数量最多”选择缓存托盘创建一条移入任务。
-
同规格、同托盘、同对接位和同管芯均使用稳定业务幂等键及条件更新，任何时刻只允许一条未完成任务。
-
套管每轮领取一个计划，从管芯库按点位顺序预占一根目标规格管芯并创建出库任务。
-
套管无管芯时查询该规格的 AGV/抓取任务，分别记录“正在备货”或“备货区库存不足”，释放无任务 Claim。
任务 6：实现任务完成、取消和恢复回调
文件：
-
创建：
.../task/CoreTubeStockingTask.java -
创建：
.../task/CoreTubeSleevingTask.java -
修改：
.../service/coretube/CoreTubeTaskDispatchService.java/Impl.java -
修改：
.../dal/mysql/coretube/CoreTubeMapper.java/xml -
修改：
.../stockingivt/StockingIvtMapper.java/xml -
AGV 完成时更新来源/目标点位和托盘位置，不更新日计划备货进度；取消时只释放预占。
-
桁架抓取完成时解绑托盘格位，将管芯更新为“管芯库/可用”并将备货进度增加 1；取消时恢复“备货区/可用”。
-
管芯出库完成时更新为“套管中/作业中”并将套管进度增加 1；取消时恢复“管芯库/可用”。
-
回调按任务 ID 和管芯阶段幂等；备货、套管使用不同处理器，互不修改对方状态。
-
增加内部恢复方法：任务不存在/失败释放资源，执行中续期，成功但未回写时补做幂等回调。
任务 7：增加两个 XXL-JOB
文件：
-
创建：
nl-module-lms/nl-module-lms-server/src/main/java/cn/code/nl/module/lms/job/DailyPlanCoreTubeJob.java -
修改：LMS 配置示例文件
-
@XxlJob("dailyPlanStockingJob")调用一次备货分配；无任务、正在备货和库存不足均记录中文业务日志并正常结束。 -
@XxlJob("dailyPlanSleevingJob")调用一次套管分配，每次最多创建一条单根出库任务。 -
用
lms.core-tube.*配置 AGV 系统类型、ACS 类型、抓取目标点、套管目标点和任务参数，不硬编码现场设备点位。
任务 8：完整验证
文件：
-
必要时同步：
docs/superpowers/specs/2026-08-17-lms-core-binding-scheduling-design.md -
执行
mvn -pl nl-module-lms/nl-module-lms-server,nl-module-task/nl-module-task-server -am -DskipTests compile，确认BUILD SUCCESS。 -
SQL 连续执行两遍，核对表、约束、字典、编码规则和升级列。
-
在回滚事务中核对：PDA 重复绑定、A/B/C 对接位为 B 时只选 B、所有规格不匹配时只选一条 AGV、权重 2/3 得到 A/A/B/B/B、套管提示分支、AGV 不累计进度、抓取只累计 1。
-
执行
git diff --check和git status --short；保留用户原有未跟踪nl-module-wms/img.png。
任务 9：PDA UniApp 页面接入（外部仓库前置）
前置条件： README 引用的 nl-ui-admin-uniapp 源码加入工作区。当前仓库只有截图，没有可修改的 UniApp 文件，因此不能伪造文件路径或在 Vben 管理端创建替代页面。
- 在 UniApp 仓库定位此前确认的 5×5 管芯绑定页面、扫码组件和请求封装。
- 扫描托盘后调用
GET /api/pda/coreTube/pallet；提交调用POST /api/pda/coreTube/bind；显示每格管芯编号和重量。 - 运行该仓库
package.json已定义的 Lint/类型检查命令。