Files
FT546-WCS/CONTEXT.md

3.9 KiB

标准四向车 WCS

本上下文描述标准四向车 WCS 接收仓储业务意图、协调物流设备并形成可恢复执行事实时使用的统一语言。它不定义 WMS 库存决策,也不定义 PLC 的运动与安全控制。

任务与流程

运输订单: WCS 接受的一次仓储运输业务意图,包含业务类型、载荷、起点、终点和优先级。 Avoid: PLC任务、车辆任务、作业行

流程实例: 为完成一张运输订单而创建的有序执行过程,由一个或多个具有依赖关系的执行步骤组成。 Avoid: 线程流程、项目脚本

执行步骤: 流程实例中可独立等待、分配、运行和完成的最小业务执行单元。 Avoid: PLC命令、路径段

项目流程定义: 某个交付项目对标准业务步骤的组合规则,不拥有核心状态迁移和资源安全规则。 Avoid: 核心流程、硬编码分支

设备与执行

设备命令: WCS 已持久化并准备交给一个物理设备执行的标准动作意图。 Avoid: 寄存器写入、设备完成

设备事件: 设备适配器向 WCS 报告的一次标准化事实变化,带有可去重和排序的身份信息。 Avoid: 原始报文、业务回调

设备快照: 某一时刻设备位置、载货、模式、健康、电量和当前动作的组合物理事实。 Avoid: 数据库任务状态、内存设备对象

设备能力: 设备能够可靠支持并由适配器明确声明的动作和反馈语义集合。 Avoid: 猜测能力、默认功能

协议 Profile: 一类设备协议的能力、地址、编码、握手和超时语义的版本化定义。 Avoid: 设备实例、核心策略

设备适配器: 标准设备命令、事件与某个项目设备协议之间的双向翻译边界。 Avoid: 调度器、状态机、PLC线程

拓扑与交通

有效拓扑: 经过校验和发布、供运行任务绑定使用的不可变仓库节点、边、区域、端口和资源快照。 Avoid: 临时拓扑、运行时占用图

交通区域: 使用同一拓扑版本和调度规则进行统一协调的空间范围,本身不默认是互斥资源。 Avoid: 互斥区、整区锁

冲突资源: 同一时刻只能按定义容量被兼容车辆或任务共同占用的节点、边、巷道、端口或设备。 Avoid: 路径建议、地图颜色

资源预约: 某个执行步骤或设备命令对冲突资源取得、占用和释放权利的生命周期记录。 Avoid: 临时占用、预计经过

软路径: 尚未交给设备执行、可以因资源和现场状态变化重新规划的完整业务路径意向。 Avoid: 已执行路径、硬路权

已承诺路径: 已经交给设备执行或结果尚不确定、因此不可被新规划覆盖的路径或动作范围。 Avoid: 候选路径、预计路径

产品边界

WCS 内核: 所有项目共享的任务、调度、交通、设备协同、执行和恢复规则集合。 Avoid: 项目 Admin、公共工具包

项目 Admin: 一个具体交付项目的 RuoYi 应用入口,保存该项目的接口转换、协议实现、流程定义、策略和页面。 Avoid: WCS 内核、共享多租户平台

WMS 适配器: 项目 WMS 契约与标准运输订单命令、业务事件之间的双向翻译边界。 Avoid: 库存服务、任务状态机

项目策略: 项目根据标准上下文返回评分、端口或充电选择的无副作用规则。 Avoid: 项目状态机、项目调度器

恢复

结果未知: 命令可能已经产生物理动作但当前证据不能证明其成功或失败的执行状态。 Avoid: 发送失败、自动重试

恢复工单: 记录异常发现、隔离、现场对账、恢复决定和审计证据的受控处理过程。 Avoid: 普通告警、数据库修复记录

局部隔离: 在事实不确定时冻结最小相关设备、资源或交通区域,同时允许无关部分继续运行的保护措施。 Avoid: 全局停机、忽略故障