develop: 临时保存修改
This commit is contained in:
@@ -115,4 +115,15 @@ public class BehaviortreeController extends BaseController
|
|||||||
return toAjax(behaviortreeService.deleteBehaviortreeByIds(ids));
|
return toAjax(behaviortreeService.deleteBehaviortreeByIds(ids));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取行为树对应的平台
|
||||||
|
* @param id
|
||||||
|
* @return
|
||||||
|
*/
|
||||||
|
@PreAuthorize("@ss.hasPermi('system:behaviortree:query')")
|
||||||
|
@GetMapping("/getPlat/{id}")
|
||||||
|
@ApiOperation("获取行为树对应的平台")
|
||||||
|
public AjaxResult getPlat(@PathVariable("id") Integer id) {
|
||||||
|
return success(behaviortreeService.getPlat(id));
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -7,10 +7,10 @@ spring:
|
|||||||
# 主库数据源
|
# 主库数据源
|
||||||
master:
|
master:
|
||||||
# url: jdbc:mysql://192.168.166.71:3306/behaviortreedb?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
|
# url: jdbc:mysql://192.168.166.71:3306/behaviortreedb?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
|
||||||
url: jdbc:mysql://localhost:3306/autosolution_db?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
|
url: jdbc:mysql://192.168.166.71:3306/autosolution_db?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
|
||||||
username: root
|
username: root
|
||||||
# password: 123456
|
# password: 123456
|
||||||
password: 1234
|
password: 123456
|
||||||
# 从库数据源
|
# 从库数据源
|
||||||
slave:
|
slave:
|
||||||
# 从数据源开关/默认关闭
|
# 从数据源开关/默认关闭
|
||||||
|
|||||||
@@ -59,4 +59,11 @@ public interface BehaviortreeMapper
|
|||||||
* @return 结果
|
* @return 结果
|
||||||
*/
|
*/
|
||||||
public int deleteBehaviortreeByIds(Long[] ids);
|
public int deleteBehaviortreeByIds(Long[] ids);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取行为树对应的平台
|
||||||
|
* @param id
|
||||||
|
* @return
|
||||||
|
*/
|
||||||
|
Integer getPlatId(Integer id);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -59,4 +59,11 @@ public interface IBehaviortreeService
|
|||||||
* @return 结果
|
* @return 结果
|
||||||
*/
|
*/
|
||||||
public int deleteBehaviortreeById(Long id);
|
public int deleteBehaviortreeById(Long id);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取行为树对应的平台
|
||||||
|
* @param id
|
||||||
|
* @return
|
||||||
|
*/
|
||||||
|
Integer getPlat(Integer id);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -93,4 +93,17 @@ public class BehaviortreeServiceImpl implements IBehaviortreeService
|
|||||||
{
|
{
|
||||||
return behaviortreeMapper.deleteBehaviortreeById(id);
|
return behaviortreeMapper.deleteBehaviortreeById(id);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取行为树对应的平台
|
||||||
|
* @param id
|
||||||
|
* @return
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
public Integer getPlat(Integer id) {
|
||||||
|
if(null == id){
|
||||||
|
throw new RuntimeException(ExceptionConstants.PARAMETER_EXCEPTION);
|
||||||
|
}
|
||||||
|
return behaviortreeMapper.getPlatId(id);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -35,6 +35,12 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
|
|||||||
where id = #{id}
|
where id = #{id}
|
||||||
</select>
|
</select>
|
||||||
|
|
||||||
|
<select id="getPlatId" resultType="java.lang.Integer">
|
||||||
|
SELECT platform_id
|
||||||
|
FROM behaviortree
|
||||||
|
WHERE id = #{id}
|
||||||
|
</select>
|
||||||
|
|
||||||
<insert id="insertBehaviortree" parameterType="Behaviortree" useGeneratedKeys="true" keyProperty="id">
|
<insert id="insertBehaviortree" parameterType="Behaviortree" useGeneratedKeys="true" keyProperty="id">
|
||||||
insert into behaviortree
|
insert into behaviortree
|
||||||
<trim prefix="(" suffix=")" suffixOverrides=",">
|
<trim prefix="(" suffix=")" suffixOverrides=",">
|
||||||
|
|||||||
66
requirements.md
Normal file
66
requirements.md
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
**1.项目概述**：
|
||||||
|
|
||||||
|
	军事沙盘游戏，是一个Spring Boot框架，若依开发平台前后端分离版， 主要为了服务别的服务调用我的接口，我自动生成火力配置，主要是做火力规则。
|
||||||
|
|
||||||
|
**2.大致需求**：
|
||||||
|
|
||||||
|
	我现在需要根据入参的json（超级大，将近1.3M，2w多行）使用Drools（项目中rule模块已经引入依赖）系统完成规则的建立，并且每个drl文件中的注释要清楚，因为后续要加入WorBench让不懂开发的人员修改我的规则（暂时先不用）
|
||||||
|
|
||||||
|
并且要注意出传入的json如果过大需要注意OOM，并且注入Drools中的实体过多也有可能OOM，理解整个需求文档之后，设计怎么接收参数，插入Drools，保证不会出现OOM！因为传入的JSON总体来说有不少需要用到，但是有一些细致的参数可能又不需要匹配上！
|
||||||
|
|
||||||
|
2.1需求详细：
|
||||||
|
|
||||||
|
我需要根据传入的json匹配我的规则，然后再json中填写红方任务下的武器、武器参数、部署位置、航迹等位置的数据
|
||||||
|
|
||||||
|
2.1.1 允许出现蓝方武器，红方没有应对的武器的情况，证明红方武器不够
|
||||||
|
|
||||||
|
2.1.2 允许出现返回的红方任务中的部分json字段为空，原样返回，因为我的规则不需要把所有数据填上去（具体需要填那些我会在第三部分具体规则设计中写出来）
|
||||||
|
|
||||||
|
2.2 注意事项：
|
||||||
|
|
||||||
|
2.2.1 Json很大，需要使用流式解析，接收时拿到需要的数据，具体需要那些参数我会把Json参考文件（区域防御场景设计_2026-01-14 11_49_10_带注释）放到和本文件同级的位置，你自己取阅读，决定，只要匹配我下方的规则就行；
|
||||||
|
|
||||||
|
2.2.3 整个火力规则接口的里面需要用到的数据都是传入的json中的，没有数据库操作，包括输出的json也是传入的json，只是需要把json中红方的任务内容填上去（允许有规则匹配不上导致参数为空）
|
||||||
|
|
||||||
|
	注释要求：
|
||||||
|
|
||||||
|
	 1.任何注释都不要在行尾进行注释，放在上方
|
||||||
|
|
||||||
|
	 2.实体类的属性注释和方法（函数）内部的注释要使用//，类注释和方法上的注释使用/\* \*/
|
||||||
|
|
||||||
|
**3.具体规则设计**：
|
||||||
|
|
||||||
|
**只需要在json中填写红方任务下的内容，具体的规则需要体现在Drools的drl文件中，必须添加注释，供业务人员修改规则**
|
||||||
|
|
||||||
|
3.1 需要设计装备匹配的规则，主要有装备类型的匹配，比如蓝方有空中武器，需要根据航迹，经纬高，来决定我方使用何种武器（从json的红方装备拿，拿id填写到weaponId上就行，在weaponId附近有一个targetId要填写这个武器对应的是蓝方的什么武器，其他的参数需要你理解填写上去，不理解的不要乱填，所有数据都在传入的json中），还需要根据蓝方的数量做匹配，理论上应该>= 蓝方数量（允许出现小于，因为红方获取数量武器不够），还需要根据威胁等级字段名：threatLevel 取值范围（1-3来决定使用那些红方武器进行打击）
|
||||||
|
|
||||||
|
允许你根据传入json（蓝方已有条件和红方已有条件）设计其他匹配的规则，但是要标明注释，根据那些参数，怎么使用，修改
|
||||||
|
|
||||||
|
3.2 需要设计阵位的规则，根据蓝方的阵位部署，红方的武器需要部署在红方的防区和作战区，作战区域字段名：warTerritory ，防区类型字段名：airspaceType 3是防区的意思（注意必须是红方的防区或者作战区，作战区不分红蓝方）
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3.3 需要设计航迹的规则，根据蓝方任务编队的航迹来决定我方任务的航迹，可以根据高度、速度、航向角、经纬高等参数设计规则，不管使用最短距离算法，还是绕后打击算法都可以（最好在Drools中提供规则，标明怎么使用，修改）
|
||||||
|
|
||||||
|
3.4 需要做任务类型的匹配，如果蓝方是干扰任务，红方需要根据红方的反干扰武器进行匹配，具体匹配可以同3.1的规则，但是任务类型不同
|
||||||
|
|
||||||
|
3.5 上述所有规则都需要贴合实际，并且规则中不需要考虑任务的开始结束时间
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
**4.JSON辅助理解**
|
||||||
|
|
||||||
|
本点是辅助你理解传入的JSON
|
||||||
|
|
||||||
|
4.1 Tasks下是蓝红方的所有任务，我需要根据蓝方的任务做红方的任务匹配，并且匹配红方任务下的武器装备
|
||||||
|
|
||||||
|
4.2 RefAttributeObject下是所有武器的参数，注意要区分这个武器是蓝方还是红方，attDefaultValue字段是这个武器的值，attExplain是值的单位
|
||||||
|
|
||||||
|
4.3 ScenarioBase和Options这两个我的整个规则系统中不需要关心，Environment这个字段里面是环境的配置，你自由决定内部参数参不参与规则
|
||||||
|
|
||||||
|
4.4 ForceSides用来区分红蓝方，Equipments是所有装备（注意区分红蓝方）
|
||||||
|
|
||||||
|
4.5 所有的武器装备，参数，任务，都没有形成直接的上下级结构，都是通过id来关联
|
||||||
|
|
||||||
|
4.6 taskName不用关心，Groups暂时不用关心（后续可能会需要）
|
||||||
|
|
||||||
323
scheme.md
Normal file
323
scheme.md
Normal file
@@ -0,0 +1,323 @@
|
|||||||
|
# 火力规则实现方案（scheme）— 详细版
|
||||||
|
|
||||||
|
本文档供**后续智能体或开发人员**按步骤实现代码使用。依据 [requirements.md](requirements.md) 与样例 JSON（`区域防御场景设计_2026-01-14 11_49_10_带注释.json`）。需求中提及但样例中**未出现**的字段（如 `threatLevel`、`warTerritory`、`airspaceType`）在代码中预留 **Optional / 占位事实类字段**，规则写骨架注释即可，**不要阻塞主流程编译**。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 目标与边界（实现时必须遵守）
|
||||||
|
|
||||||
|
| 项 | 说明 |
|
||||||
|
|----|------|
|
||||||
|
| 输入 | 单份超大军事场景 JSON（约 1.3MB 级），**无数据库** |
|
||||||
|
| 输出 | **同一 JSON 结构**；仅对**红方任务**下业务约定字段做补全；其它键值保持输入原样 |
|
||||||
|
| 引擎 | Drools 7.x（见 `auto-solution-rule/pom.xml` 的 `drools.version`） |
|
||||||
|
| 注释规范（Java/DRL） | 与 requirements 一致：**禁止行尾注释**；类/公开 API 用 `/** */`；字段与函数体内用 `//` |
|
||||||
|
| 不参与匹配 | `ScenarioBase`、`Options`；`taskName`、`Groups`；任务开始/结束时间 |
|
||||||
|
| 允许 | 红方武器不足以覆盖蓝方；红方任务部分字段匹配不上则**保持空或原值** |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. JSON 结构参考（实现时的路径依据）
|
||||||
|
|
||||||
|
根路径：`MilitaryScenario`（注意：样例文件在部分 key 后带有 `// 注释`，**标准 Jackson 默认不能解析**。实现时三选一：① 调用方传标准 JSON；② 服务端先 **strip 行尾 `//...`** 再解析；③ 使用 `jackson-core` 自定义或第三方「带注释 JSON」解析。下文路径均指**去掉注释后的逻辑结构**。）
|
||||||
|
|
||||||
|
### 2.1 顶层键（与 `MilitaryScenario` 同级）
|
||||||
|
|
||||||
|
实现时至少关心：
|
||||||
|
|
||||||
|
```
|
||||||
|
MilitaryScenario
|
||||||
|
├── RefAttributeObject # Map：key=设备 refId（字符串），value=属性对象数组
|
||||||
|
├── ForceSides # 数组：阵营
|
||||||
|
├── Equipments # 数组：装备
|
||||||
|
├── Tasks # 数组：任务（红+蓝+…）
|
||||||
|
├── Environment # 可选，默认可不进规则
|
||||||
|
├── ScenarioBase # 忽略
|
||||||
|
└── Options # 忽略
|
||||||
|
```
|
||||||
|
|
||||||
|
（若实际文件还有其它顶层字段，**原样透传**，不要删除。）
|
||||||
|
|
||||||
|
### 2.2 `ForceSides[]`（阵营表）
|
||||||
|
|
||||||
|
每条典型字段：
|
||||||
|
|
||||||
|
- `ObjectHandle`：阵营 UUID（字符串）
|
||||||
|
- `ForceSideName`：如「红方」「蓝方」「白方」
|
||||||
|
|
||||||
|
**实现要点**：建立 `Map<String, String>`：`sideUuid -> sideName`，以及反向查询。红方 UUID 用于与 `Equipments.OwnerForceSide`、`task.task.sideId` 等比对。
|
||||||
|
|
||||||
|
### 2.3 `RefAttributeObject`（属性字典）
|
||||||
|
|
||||||
|
- 类型：对象，**子 key 为 refId**（与装备里 `device.refId`、`device.id` 等引用对齐）。
|
||||||
|
- 值：数组，元素字段包括但不限于：`attDef`、`attDefaultValue`、`attExplain`、`attName`。
|
||||||
|
|
||||||
|
**实现要点**：不必把所有属性塞进 Drools。解析阶段可构建：
|
||||||
|
|
||||||
|
- `Map<String, Map<String, String>> refIdToAttDefValue`：仅保留规则会用到的 `attDef`（若未知则先存全量 **按 refId 分桶的 List**，但单桶过大时要按 attDef 过滤，避免 OOM）。
|
||||||
|
|
||||||
|
### 2.4 `Equipments[]`（装备）
|
||||||
|
|
||||||
|
典型字段：
|
||||||
|
|
||||||
|
- `OwnerForceSide`：所属阵营 UUID
|
||||||
|
- `EquipmentID`：装备实例 id
|
||||||
|
- `SupportType`、`Platform_type`、`Name` 等：用于类型与展示
|
||||||
|
- `SubComponents`：对象，键如 `weapon`、`sensor`、`platform`、`jammer`、`communication` 等，值为**组件数组**
|
||||||
|
|
||||||
|
组件项常见字段：
|
||||||
|
|
||||||
|
- `ObjectHandle`、`deviceId`、`soleId`
|
||||||
|
- `device`：`{ id, name, refId }`
|
||||||
|
- `ParentPlat`：父平台 id
|
||||||
|
- `platform` 类下可能有 `positions`：`[经度, 纬度, 高度]`
|
||||||
|
|
||||||
|
**实现要点**：为规则准备**红方装备摘要列表**（扁平结构，见第 5 节），不要 deep clone 整个 `SubComponents`。
|
||||||
|
|
||||||
|
### 2.5 `Tasks[]`（任务）
|
||||||
|
|
||||||
|
外层常见：
|
||||||
|
|
||||||
|
- `id`：任务 id
|
||||||
|
- `side`：字符串，如「蓝方」（**以样例为准**）
|
||||||
|
- `dataType`：如 `taskPlane`
|
||||||
|
- `task`：内层大对象
|
||||||
|
|
||||||
|
内层 `task` 常见：
|
||||||
|
|
||||||
|
- `side`、`sideId`（阵营 UUID）
|
||||||
|
- `type`：任务类型，如 `interference`、`assault`、`policePatrol`
|
||||||
|
- `speed`：数值
|
||||||
|
- `execute`：**数组**，每项含 `type` 及多种列表字段
|
||||||
|
|
||||||
|
`execute[]` 内常见列表（名称以样例为准）：
|
||||||
|
|
||||||
|
- `targetList[]`：常含 `weaponId`、`targetId`、`ID`、以及若干战术字段
|
||||||
|
- `disturbList[]`：干扰相关，可含 `weaponId`、`targetId`
|
||||||
|
- 其它 `*List`：按任务类型存在与否不同
|
||||||
|
|
||||||
|
**红方识别**（实现逻辑，按优先级）：
|
||||||
|
|
||||||
|
1. `task.task.sideId` 或外层推导的阵营 UUID **等于** 红方 `ForceSides.ObjectHandle`；或
|
||||||
|
2. `task.side` / 外层 `side` 字符串等于「红方」（需与 `ForceSideName` 一致）。
|
||||||
|
|
||||||
|
**仅对识别为红方的任务**执行写回；蓝方任务只读，用于生成「对手事实」。
|
||||||
|
|
||||||
|
### 2.6 需求字段与样例缺失
|
||||||
|
|
||||||
|
| 需求字段 | 样例中状态 | 代码策略 |
|
||||||
|
|----------|------------|----------|
|
||||||
|
| `threatLevel` (1–3) | 未检索到 | Java 事实类保留 `Integer threatLevel`，默认 null；DRL 用 `threatLevel != null` Guard |
|
||||||
|
| `warTerritory`、`airspaceType` | 未检索到 | 事实类预留 `String`/`Integer`；阵位规则文件先写注释骨架 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 总体数据流（智能体实现顺序）
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
flowchart TB
|
||||||
|
P1[预处理可选: 去注释]
|
||||||
|
P2[第一遍流式: 建索引]
|
||||||
|
P3[第二遍或同遍: 收集蓝方摘要 + 红方可写槽位]
|
||||||
|
P4[组装 Drools 事实]
|
||||||
|
P5[KieSession fireAllRules]
|
||||||
|
P6[应用 Rule 输出到内存补丁结构]
|
||||||
|
P7[写回 JSON: Tree 或 流式]
|
||||||
|
P1 --> P2 --> P3 --> P4 --> P5 --> P6 --> P7
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. OOM 与解析策略（必须写进实现）
|
||||||
|
|
||||||
|
### 4.1 禁止
|
||||||
|
|
||||||
|
- 使用 `ObjectMapper.readTree(整个 InputStream)` 默认把 1.3MB+ 全树常驻且复制多份。
|
||||||
|
- `insertAll(全部 Equipment)`、`insertAll(全部 Task)` 进入 KieSession。
|
||||||
|
- 无界 `String` 拼接整文件多次。
|
||||||
|
|
||||||
|
### 4.2 推荐
|
||||||
|
|
||||||
|
1. **Jackson `JsonParser` + `JsonToken`** 顺序扫描；仅当 `currentName` 属于目标段时深入读取。
|
||||||
|
2. **分块构建索引**：`RefAttributeObject`、`ForceSides`、`Equipments` 各用 `Map` / 紧凑 DTO 列表；数字与字符串优先，避免嵌套 `Map` 过深。
|
||||||
|
3. **Tasks**：流式读数组，每元素解析为「任务摘要对象」或**仅红方**保留完整 `task` 子树的 **JsonNode 引用**（若采用 DOM 则只保留红方子树，蓝方只保留摘要）。
|
||||||
|
4. **写回**：
|
||||||
|
- **方案 A（推荐起步）**：第一遍用流式解析 + 若内存允许用 `JsonNode` 仅替换 `Tasks` 下红方节点（需评估内存）；
|
||||||
|
- **方案 B**：两遍文件：第一遍偏移量/路径索引，第二遍 `JsonGenerator` 复制并覆盖红方字段。
|
||||||
|
|
||||||
|
智能体实现时可先 **方案 A + 设置 Jackson 流式配置**，在压测后再切方案 B。
|
||||||
|
|
||||||
|
### 4.3 Drools 工作内存
|
||||||
|
|
||||||
|
- 单次 `fireAllRules` 前插入事实数建议：**O(蓝方任务数 + 红方候选装备数 + 红方待填槽位数)**，每项为**小对象**（< 1KB 量级为宜）。
|
||||||
|
- 规则执行完后 **`dispose()`** KieSession，避免泄漏。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Java 侧建议类型（包名可按项目调整）
|
||||||
|
|
||||||
|
建议包：`com.solution.rule.firepower`（或沿用 `com.solution.rule` 下子包），避免与旧 `WarplaneHandler` 混在同一责任链。
|
||||||
|
|
||||||
|
### 5.1 索引与上下文（非 Drools Fact，解析阶段使用）
|
||||||
|
|
||||||
|
| 类名（建议） | 职责 |
|
||||||
|
|--------------|------|
|
||||||
|
| `ScenarioIndexes` | 持有 `sideIdToName`、`redSideId`、`blueSideId`（可多蓝多红时扩展为 Set）、`refAttributes` 精简索引 |
|
||||||
|
| `EquipmentSummary` | 单条红方可用装备：`equipmentId`、`ownerSideId`、`platformType`、`weaponComponentIds`（List<String>）、可选 `positionLonLatAlt` |
|
||||||
|
| `BlueTaskFact` | 单条蓝方任务摘要：`taskId`、`taskType`、`speed`、`sideId`、从 `execute` 抽出的 **打击/干扰目标 id 列表**、**航迹摘要**（见下） |
|
||||||
|
| `TrackSummary` | 可选：`routeId` 或关键点 `List<double[]>`（经纬高），从蓝方编队/平台关联推导（若样例中路径复杂，第一版可只填 `speed` + 单点位置） |
|
||||||
|
| `RedTaskFillSlot` | 描述一处待填写位置：`taskId`、`executeIndex`、`listName`（如 `targetList`）、`itemIndex`、指向 Map 或 JsonNode 的**可变引用**（或用 `Consumer` 写回） |
|
||||||
|
|
||||||
|
### 5.2 Drools 事实（插入 KieSession）
|
||||||
|
|
||||||
|
| 类名（建议） | 说明 |
|
||||||
|
|--------------|------|
|
||||||
|
| `OpponentContext` | 当前正在处理的蓝方任务/目标封装（可多条规则共享） |
|
||||||
|
| `RedInventory` | 红方可用武器/装备 id 及剩余数量（数量规则 3.1 用） |
|
||||||
|
| `MatchResult` | 规则填写结果：`selectedWeaponId`、`targetId`、`reasonCode`（便于日志） |
|
||||||
|
| `ThreatContext` | 预留 `Integer threatLevel` |
|
||||||
|
| `PositionContext` | 预留防区/作战区相关字段 |
|
||||||
|
|
||||||
|
事实类使用 **可修改 JavaBean**（Drools 7 常用），在规则中 `modify()` 或 **通过全局服务**写回 `RedTaskFillSlot`（若用全局服务，需 `KieSession.setGlobal(...)`）。
|
||||||
|
|
||||||
|
### 5.3 规则与 Java 交互方式（二选一，文档推荐前者）
|
||||||
|
|
||||||
|
1. **纯规则修改 Fact**：`MatchResult` 填好后，Java 在 `fireAllRules` 后遍历 Fact 应用到 JSON。
|
||||||
|
2. **全局写回器**：`globals.put("fillService", bean)`，drl 中调用 `fillService.apply(...)`（需在 drl 声明 `import` 与 `global`）。
|
||||||
|
|
||||||
|
智能体选一种即可，**全项目统一**。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Drools 规则文件组织
|
||||||
|
|
||||||
|
目录：[`auto-solution-rule/src/main/resources/rules/`](auto-solution-rule/src/main/resources/rules/)（以实际 `DroolsConfig` 的 `classpath*:rules/*.*` 为准）。
|
||||||
|
|
||||||
|
| 文件 | package 建议 | 内容 |
|
||||||
|
|------|----------------|------|
|
||||||
|
| `fire-package.drl` | `rules.fire` | 仅 `package`、`import`、**中文块注释说明修改须知** |
|
||||||
|
| `fire-task-type.drl` | 同上 | `task.type`：干扰 vs 打击 vs 巡逻等分支；salience 最高或单独 agenda-group `task-type` |
|
||||||
|
| `fire-equipment-match.drl` | 同上 | 装备类型、数量 ≥ 蓝方、`weaponId`/`targetId` 绑定；引用 `RedInventory` |
|
||||||
|
| `fire-position.drl` | 同上 | 阵位：预留条件，注释写「待 warTerritory/airspaceType 路径确认」 |
|
||||||
|
| `fire-track.drl` | 同上 | 航迹：高度、速度、航向、经纬高；注释说明可调参数 |
|
||||||
|
| `fire-fallback.drl` | 同上 | 无匹配时的默认策略或显式「不填写」 |
|
||||||
|
|
||||||
|
**删除或覆盖**无效的 [`fire-rule.drl`](auto-solution-rule/src/main/resources/rules/fire-rule.drl) 占位内容，保证 `KieBuilder` 能 `buildAll()` 成功。
|
||||||
|
|
||||||
|
**Salience 建议**（数值越大越先执行，按项目再调）：
|
||||||
|
|
||||||
|
- 任务类型分支：100
|
||||||
|
- 装备匹配：80
|
||||||
|
- 阵位：60
|
||||||
|
- 航迹：40
|
||||||
|
- 兜底：-10
|
||||||
|
|
||||||
|
**agenda-group**（可选）：`task-type` → `equipment` → `position` → `track`，Java 中按序 `getAgenda().getAgendaGroup("xxx").setFocus()`。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 规则与需求章节映射（DRL 注释必须写清）
|
||||||
|
|
||||||
|
| requirements 章节 | DRL 落点 | 注释必须说明 |
|
||||||
|
|-------------------|----------|--------------|
|
||||||
|
| 3.1 装备匹配 | `fire-equipment-match.drl` | 依据哪些 Fact 字段；如何改「优先级」 |
|
||||||
|
| 3.2 阵位 | `fire-position.drl` | 红方防区/作战区判定条件（占位） |
|
||||||
|
| 3.3 航迹 | `fire-track.drl` | 最短距离/绕后等可选策略的切换方式 |
|
||||||
|
| 3.4 任务类型（干扰↔反干扰） | `fire-task-type.drl` | 与 3.1 的差异 |
|
||||||
|
| 3.5 贴合实际、不考虑时间 | 各文件 | 不写时间条件 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 解析算法伪代码（供智能体翻译为 Java）
|
||||||
|
|
||||||
|
```
|
||||||
|
function process(inputStream) -> OutputStream:
|
||||||
|
bytesOrReader = optionalStripJsonComments(inputStream) // 若需要
|
||||||
|
|
||||||
|
indexes = new ScenarioIndexes()
|
||||||
|
blueFacts = new ArrayList<BlueTaskFact>()
|
||||||
|
redSlots = new ArrayList<RedTaskFillSlot>()
|
||||||
|
redEquipSummaries = new ArrayList<EquipmentSummary>()
|
||||||
|
|
||||||
|
parser = JsonFactory.createParser(bytesOrReader)
|
||||||
|
while parser.nextToken() != END_OBJECT:
|
||||||
|
if field == "RefAttributeObject":
|
||||||
|
indexes.refAttributes = parseRefAttributeObjectStream(parser)
|
||||||
|
else if field == "ForceSides":
|
||||||
|
indexes.parseForceSides(parser) // 设置 redSideId / blueSideId
|
||||||
|
else if field == "Equipments":
|
||||||
|
for each equipment object in stream:
|
||||||
|
if owner == indexes.redSideId:
|
||||||
|
redEquipSummaries.add(summarize(equipment))
|
||||||
|
else if field == "Tasks":
|
||||||
|
for each task object in stream:
|
||||||
|
if isRedTask(task, indexes):
|
||||||
|
redSlots.addAll(collectFillSlots(task)) // 只记录需规则填的槽位
|
||||||
|
else if isBlueTask(task, indexes):
|
||||||
|
blueFacts.add(summarizeBlue(task))
|
||||||
|
|
||||||
|
session = kieBase.newKieSession()
|
||||||
|
try:
|
||||||
|
session.insert(new RedInventory(redEquipSummaries))
|
||||||
|
for b : blueFacts: session.insert(b)
|
||||||
|
for slot : redSlots: session.insert(slot)
|
||||||
|
// globals if needed
|
||||||
|
session.fireAllRules()
|
||||||
|
applyFactsToJson(modelOrPatches)
|
||||||
|
finally:
|
||||||
|
session.dispose()
|
||||||
|
|
||||||
|
return serialize(modelOrPatches)
|
||||||
|
```
|
||||||
|
|
||||||
|
`collectFillSlots`：遍历 `task.execute[*]` 下各 `*List`，对 `weaponId`/`targetId` 为空且业务约定需要填的项注册 `RedTaskFillSlot`（第一版可只处理 `targetList`）。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Spring 接口层建议
|
||||||
|
|
||||||
|
- **Controller**（可放在 `auto-solution-admin` 或独立 API 模块）：
|
||||||
|
- `POST /api/firepower/plan`（路径自定）
|
||||||
|
- `Content-Type: application/json`
|
||||||
|
- 方法参数：`HttpServletRequest.getInputStream()` 或 `InputStreamResource`，**不要** `@RequestBody String` 若可避免。
|
||||||
|
- **Service**：`FirepowerRuleService#apply(InputStream in, OutputStream out)`，异常包装为业务码，**不要吞掉栈**。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. 与现有模块的衔接（避免冲突）
|
||||||
|
|
||||||
|
| 文件/类 | 动作 |
|
||||||
|
|---------|------|
|
||||||
|
| [`DroolsConfig`](auto-solution-rule/src/main/java/com/solution/rule/config/DroolsConfig.java) | 保持；新增 drl 放入 `rules/` |
|
||||||
|
| [`JsonStreamParser`](auto-solution-rule/src/main/java/com/solution/rule/parser/JsonStreamParser.java) | 重写或新建 `MilitaryScenarioStreamParser`，与注释中假数据结构脱钩 |
|
||||||
|
| `TaskJsonDTO` 等 | 与样例不一致时：**以样例为准** 新建 `firepower` 包 DTO，或 `JsonNode` |
|
||||||
|
| [`WarplaneHandler`](auto-solution-rule/src/main/java/com/solution/rule/handler/WarplaneHandler.java) | **不要**强行合并；新链路独立 Bean |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. 测试与验收（智能体应补充用例）
|
||||||
|
|
||||||
|
1. **单元测试**：`MilitaryScenarioStreamParser` 对**小样本 JSON**（截取 `Tasks` 一条 + `ForceSides` + 一条 `Equipments`）解析结果符合预期索引。
|
||||||
|
2. **规则测试**：使用 Drools `KieSessionTest` 或 JUnit 手动 `insert` 事实，断言 `MatchResult`。
|
||||||
|
3. **集成测试**：完整样例文件跑通不 OOM（JVM `-Xmx` 限制下观察）；输出 JSON **除红方任务外字节级或键序**尽量一致（键序若难一致，至少结构等价）。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 12. 实现检查清单（按顺序勾选）
|
||||||
|
|
||||||
|
1. [ ] 确定 JSON 注释处理策略并实现 `strip` 或约束调用方。
|
||||||
|
2. [ ] 实现 `ScenarioIndexes` + 流式解析 `RefAttributeObject`、`ForceSides`、`Equipments`。
|
||||||
|
3. [ ] 实现 `Tasks` 遍历 + 红/蓝识别 + `RedTaskFillSlot` 收集。
|
||||||
|
4. [ ] 定义 Drools 事实类 + `kie-module` 可编译的 `fire-*.drl`。
|
||||||
|
5. [ ] 实现 `FirepowerRuleService`：`newKieSession` → `insert` → `fireAllRules` → 应用结果。
|
||||||
|
6. [ ] 实现写回：JsonNode 或流式生成。
|
||||||
|
7. [ ] Controller + 集成测试 + 日志（规则命中原因）。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 13. 修订记录
|
||||||
|
|
||||||
|
| 日期 | 说明 |
|
||||||
|
|------|------|
|
||||||
|
| 2026-03-26 | 初稿 |
|
||||||
|
| 2026-03-26 | 详细版：路径说明、类设计、伪代码、DRL 分层、检查清单、测试要求 |
|
||||||
202
t.txt
Normal file
202
t.txt
Normal file
@@ -0,0 +1,202 @@
|
|||||||
|
"Tasks": [
|
||||||
|
{
|
||||||
|
"color": "rgb(220,39,39)",
|
||||||
|
"dataType": "taskPlane",
|
||||||
|
"drawName": "xxx随队干扰任务",
|
||||||
|
"editPermission": [
|
||||||
|
"edits",
|
||||||
|
"noHidden",
|
||||||
|
"noGroups",
|
||||||
|
"del",
|
||||||
|
"downLoad"
|
||||||
|
],
|
||||||
|
"groupType": "tasks",
|
||||||
|
"id": "0614808c-6621-40a0-b254-d13d2959fc19",
|
||||||
|
"idKey": "id",
|
||||||
|
"isSelected": false,
|
||||||
|
"name": "xxx随队干扰任务",
|
||||||
|
"parentId": "56a96b1b-14a8-4daf-a2d0-47c7faa4b831_taskPlane",
|
||||||
|
"permission": [
|
||||||
|
"14bc8ff9-3c93-4218-b01a-e144add196f9",
|
||||||
|
"56a96b1b-14a8-4daf-a2d0-47c7faa4b831"
|
||||||
|
],
|
||||||
|
"show": true,
|
||||||
|
"side": "红方",
|
||||||
|
"sort": 1774271360496,
|
||||||
|
"task": {
|
||||||
|
"at_time": 0,
|
||||||
|
"attackId": "b4256ee6-50a6-4bd0-a358-eb1e772a8e3f",
|
||||||
|
"color": "rgb(220,39,39)",
|
||||||
|
"departureAirport": "",
|
||||||
|
"execute": [
|
||||||
|
{
|
||||||
|
"disturbList": [
|
||||||
|
{
|
||||||
|
"arrayPositionId": "",
|
||||||
|
"at_time": "1200",
|
||||||
|
"deceiveType": "",
|
||||||
|
"decoyLen": "",
|
||||||
|
"decoyNum": "",
|
||||||
|
"disturbPos": [],
|
||||||
|
"disturbStrength": "100",
|
||||||
|
"disturbStyle": [
|
||||||
|
"0"
|
||||||
|
],
|
||||||
|
"disturbTime": "1",
|
||||||
|
"disturbTimes": [],
|
||||||
|
"dragAcceleSpeed": "",
|
||||||
|
"dragSpeed": "",
|
||||||
|
"dragTime": "",
|
||||||
|
"endTime": "2000",
|
||||||
|
"followFormation": "",
|
||||||
|
"groupId": "d5aa0dc8-8baa-4d3b-9eb6-a268c5da7633",
|
||||||
|
"interferTargetList": [
|
||||||
|
"xxx车__933e3796-792f-41f7-ac96-70174c9c24af__b52c23cb-80a5-408d-9868-2ae2a3db5187"
|
||||||
|
],
|
||||||
|
"keepTime": "",
|
||||||
|
"podPosition": "",
|
||||||
|
"routeId": "",
|
||||||
|
"stopTime": "",
|
||||||
|
"targetId": "",
|
||||||
|
"weaponId": "",
|
||||||
|
"weaponType": ""
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"droneSwarmList": [
|
||||||
|
{
|
||||||
|
"ID": "32a86eed-5f14-43ed-95e0-0bb111ef2602",
|
||||||
|
"at_time": "",
|
||||||
|
"decoyNum": "",
|
||||||
|
"disturbNum": "",
|
||||||
|
"droneNum": "",
|
||||||
|
"dropPosition": "",
|
||||||
|
"hitNum": "",
|
||||||
|
"load": "",
|
||||||
|
"targetId": "",
|
||||||
|
"weaponId": "",
|
||||||
|
"weaponType": ""
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"earlyWaringList": [
|
||||||
|
{
|
||||||
|
"PositionRouteId": "",
|
||||||
|
"arrayPositionId": "",
|
||||||
|
"at_time": "",
|
||||||
|
"earlyWarTactics": "",
|
||||||
|
"endTime": ""
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"floatAirList": [
|
||||||
|
{
|
||||||
|
"Direction": "",
|
||||||
|
"FlySpeed": "",
|
||||||
|
"at_time": "",
|
||||||
|
"load": ""
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"moveRouteId": "",
|
||||||
|
"netAttackList": [
|
||||||
|
{
|
||||||
|
"arrayPositionId": "",
|
||||||
|
"at_time": "",
|
||||||
|
"endTime": "",
|
||||||
|
"node": ""
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"patrolList": [
|
||||||
|
{
|
||||||
|
"PositionRouteId": "",
|
||||||
|
"arrayPositionId": "",
|
||||||
|
"endTime": "",
|
||||||
|
"patrolRules": "",
|
||||||
|
"patrolTeams": "",
|
||||||
|
"startTime": ""
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"refulList": [
|
||||||
|
{
|
||||||
|
"arrayPositionId": "",
|
||||||
|
"at_time": "",
|
||||||
|
"fulHeight": "",
|
||||||
|
"hangTime": "",
|
||||||
|
"hangTimeH": "",
|
||||||
|
"refulRule": "",
|
||||||
|
"targetId": ""
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"spyonList": [
|
||||||
|
{
|
||||||
|
"PositionRouteId": "",
|
||||||
|
"arrayPositionId": "",
|
||||||
|
"at_time": "",
|
||||||
|
"endTime": "",
|
||||||
|
"spyonArea": "",
|
||||||
|
"spyonTactics": "",
|
||||||
|
"spyonTeams": ""
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"targetList": [
|
||||||
|
{
|
||||||
|
"ID": "b3515b7e-bc28-47f5-8be5-1cab0e25097e",
|
||||||
|
"arrayPositionId": "",
|
||||||
|
"arrayPositionIdBak": "",
|
||||||
|
"at_time": {
|
||||||
|
"timeUp": true,
|
||||||
|
"value": 0
|
||||||
|
},
|
||||||
|
"attackType": "",
|
||||||
|
"boost": "",
|
||||||
|
"bootTime": "",
|
||||||
|
"companion": "",
|
||||||
|
"cruiseRouteId": "",
|
||||||
|
"cruiseRouteOffset": [
|
||||||
|
{
|
||||||
|
"UpOrDown": true,
|
||||||
|
"value": 0
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"BeforeOrAfter": true,
|
||||||
|
"value": 0
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"LeftOrRight": true,
|
||||||
|
"value": 0
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"decoyNum": "0",
|
||||||
|
"decoyTime": "0",
|
||||||
|
"disturbNum": "0",
|
||||||
|
"disturbStartTime": "0",
|
||||||
|
"droneNum": "",
|
||||||
|
"fireType": "absolute",
|
||||||
|
"hitNum": "",
|
||||||
|
"launchAngle": "",
|
||||||
|
"launchAzimuth": "",
|
||||||
|
"noFlyZone": "",
|
||||||
|
"orbitInclination": "",
|
||||||
|
"refulId": "",
|
||||||
|
"salvo": {
|
||||||
|
"salvoUp": true,
|
||||||
|
"value": 0
|
||||||
|
},
|
||||||
|
"strategy": [],
|
||||||
|
"targetId": "",
|
||||||
|
"times_interval": 1,
|
||||||
|
"weaponId": "",
|
||||||
|
"weaponRelease": "",
|
||||||
|
"weaponType": "",
|
||||||
|
"weaponUseCount": 1
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"type": "interference"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"landAirport": "",
|
||||||
|
"missionList": [],
|
||||||
|
"name": "xxx随队干扰任务",
|
||||||
|
"side": "红方",
|
||||||
|
"sideId": "56a96b1b-14a8-4daf-a2d0-47c7faa4b831",
|
||||||
|
"speed": 600,
|
||||||
|
"type": "interference",
|
||||||
|
"weaponId": ""
|
||||||
|
},
|
||||||
20229
区域防御场景设计_2026-01-14 11_49_10_带注释.json
Normal file
20229
区域防御场景设计_2026-01-14 11_49_10_带注释.json
Normal file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user