第二十九章 智能个体可视化编辑与交互
- 智能对象可视化编辑器
- 对象属性的动态编辑
- 对象方法的管理与配置
- 对象状态的可视化管理
- 对象关系的图形化组织
- 前台交互与后台实例数据关联
- 编辑结果的保存与运行验证
第二十九章 智能个体可视化编辑与交互
本章研究智能个体的可视化编辑与交互工程。前两章分别建立了智能对象运行数据与 Smarty 模板的数据映射机制,以及基于 Smarty 的智能个体动态页面生成机制。本章进一步研究如何在这些页面基础上建立可视化编辑界面,使用户能够通过前台操作完成智能对象属性、方法、状态和关系的查看、编辑、配置与组织,并将编辑结果提交到后端智能构建系统进行验证和保存。
在 WSaiOS 工程体系中,可视化编辑不是简单的网页表单编辑,而是对智能对象结构数据和实例运行数据进行可视化操作。用户通过编辑界面修改对象属性定义、属性值、方法配置、状态定义和对象关系,后端程序负责识别编辑对象、验证修改内容、确定数据所属层次,并按照对应的数据管理机制保存。
这里必须区分结构定义编辑与实例数据编辑。修改对象属性定义,可能影响结构定义及其版本;修改某个实例的属性值,只影响该实例的数据。修改方法配置可能涉及方法定义和处理器绑定;修改实例当前状态则必须符合状态转换规则。不能将这些不同性质的编辑操作统一处理为普通表单字段更新。
本章的工程目标是建立前台可视化编辑、后端数据处理、结构验证、实例数据保存和运行验证之间的完整联系。
29.1 智能对象可视化编辑器
智能对象可视化编辑器是智能个体构建与管理过程中用于呈现和编辑对象结构的前台工具。它通过图形化界面展示智能对象的基本信息、属性、方法、状态和关系,使用户不必直接操作底层数据库或结构数据文件,就能够完成相应的编辑工作。
可视化编辑器的数据来源是 WSaiOS 后端已经建立的结构定义和实例数据。编辑器本身不直接定义智能对象的底层运行逻辑,而是将后端结构数据转换为可视化编辑内容,再将用户的修改请求提交给相应的后端服务。
智能对象的可编辑数据可以表示为:
其中,\(D_i\) 表示对象结构定义,\(P_i\) 表示属性定义,\(V_i\) 表示实例属性值,\(M_i\) 表示方法配置,\(S_i\) 表示状态定义及实例状态,\(R_i\) 表示对象关系,\(C_i\) 表示结构和运行约束。
可视化编辑器根据当前编辑目标选择相应数据。编辑结构定义时,主要读取 \(D_i、P_i、M_i、S_i、R_i\);编辑实例运行数据时,主要读取 \(V_i\) 及实例当前状态。
因此,编辑器需要建立明确的编辑对象类型:
其中,\(ID_e\) 是编辑任务标识,\(ID_o\) 是被编辑对象标识,\(T_e\) 是编辑类型,\(V_e\) 是编辑数据版本,\(C_e\) 是编辑约束。
编辑类型可以区分结构定义编辑、实例属性编辑、方法配置编辑、状态定义编辑、对象关系编辑和运行状态查看。不同编辑类型对应不同后端处理入口。
整体架构如下:
建议将可视化编辑程序组织为:
WSaiOS/
└── Presentation/
└── VisualEditor/
├── ObjectEditorController.php
│ // 可视化编辑器入口,组织对象读取、编辑和提交过程
├── EditorDataBuilder.php
│ // 将结构定义和实例数据组织为前台编辑数据
├── EditorModeResolver.php
│ // 判断当前编辑属于结构定义编辑还是实例数据编辑
├── EditorPermissionChecker.php
│ // 检查用户对目标对象及编辑操作的权限
├── EditorRequestValidator.php
│ // 验证前台提交的编辑请求及数据格式
└── EditorResultBuilder.php
// 将后台处理结果组织为前台可读取的响应数据
其中,ObjectEditorController.php 负责编辑器入口,EditorDataBuilder.php 负责读取并组织编辑数据,EditorModeResolver.php 用于确定当前操作的数据层次,EditorPermissionChecker.php 负责权限判断,EditorRequestValidator.php 负责检查编辑请求,EditorResultBuilder.php 负责形成操作结果。
前台编辑界面可以使用 Smarty 生成基础页面,再结合 JavaScript 实现属性面板、方法配置区域和对象关系图形等交互功能。Smarty 负责初始页面生成,前端交互程序负责收集用户操作,后端 PHP 程序负责验证和保存数据。
编辑器的基本页面可以组织为:
templates/
└── editor/
├── object_editor.tpl
│ // 智能对象可视化编辑器主页面
├── object_basic.tpl
│ // 智能对象基本信息编辑区域
├── property_editor.tpl
│ // 动态属性定义与属性值编辑区域
├── method_editor.tpl
│ // 对象方法定义和配置编辑区域
├── state_editor.tpl
│ // 对象状态定义与状态规则编辑区域
└── relation_editor.tpl
// 对象关系图形化编辑区域
编辑器的主要职责是建立用户操作与后端结构数据之间的映射,而不是在前台重新实现一套智能对象管理系统。
29.2 对象属性的动态编辑
智能对象属性具有动态定义特征,不同对象可以拥有不同的属性集合。可视化编辑器需要根据对象当前的属性定义动态生成编辑字段,而不是为所有对象预先设置相同的属性表单。
属性编辑首先要区分两种情况:一是修改属性定义,例如属性名称、类型、单位、约束和默认值;二是修改实例属性值,例如某台设备当前的温度、转速或工作参数。
属性定义可以表示为:
其中,\(ID_j\) 为属性标识,\(N_j\) 为名称,\(T_j\) 为类型,\(U_j\) 为单位,\(C_j\) 为约束,\(D_j\) 为默认值,\(V_j\) 为定义版本。
实例属性值可以表示为:
其中,\(ID_i\) 是实例标识,\(ID_j\) 是属性标识,\(X_{ij}\) 是属性值,\(Q_{ij}\) 是数据来源或质量信息,\(T_{ij}\) 是数据更新时间。
编辑器必须根据属性定义决定使用什么类型的输入控件。例如,数值属性可以使用数字输入框,文本属性可以使用文本输入框,布尔属性可以使用开关,具有有限选项的属性可以使用下拉选择。属性类型和约束应由后端定义提供,前端不能擅自改变。
属性编辑数据示例:
{
"instance_id": "motor_001",
"property_id": "rated_power",
"edit_type": "instance_value",
"property_definition": {
"name": "额定功率",
"type": "number",
"unit": "kW",
"constraints": {
"min": 0,
"max": 500
}
},
"current_value": 15
}
如果用户修改的是实例属性值,编辑器提交的内容可以组织为:
{
"request_id": "edit_202611160001",
"instance_id": "motor_001",
"property_id": "rated_power",
"edit_type": "instance_value",
"old_version": 8,
"new_value": 18.5
}
如果用户修改的是属性定义,则需要明确标记为结构定义编辑,并由结构管理程序进行版本处理,不能直接更新实例属性值表。
PHP 属性编辑服务示例:
class VisualPropertyEditor
{
private $propertyRepository;
private $propertyValidator;
private $instanceValueRepository;
public function __construct(
$propertyRepository,
$propertyValidator,
$instanceValueRepository
) {
$this->propertyRepository = $propertyRepository;
$this->propertyValidator = $propertyValidator;
$this->instanceValueRepository =
$instanceValueRepository;
}
public function updateInstanceValue(
$instanceId,
$propertyId,
$newValue,
$version
) {
$definition = $this->propertyRepository
->getDefinition($instanceId, $propertyId);
if (!$definition) {
throw new InvalidArgumentException(
'属性定义不存在'
);
}
$this->propertyValidator->validate(
$newValue,
$definition
);
return $this->instanceValueRepository->update(
$instanceId,
$propertyId,
$newValue,
$version
);
}
}
上述程序仅展示实例属性值编辑的基本调用关系。实际工程中,属性定义读取应依据结构标识和结构版本完成,实例属性值更新则需要使用事务和版本检查,防止并发编辑覆盖其他用户已经保存的数据。
Smarty 可以根据后端传入的属性定义生成编辑字段:
<div class="property-editor">
{foreach $editable_properties as $property}
<div class="property-field">
<label>
{$property.name|escape}
</label>
{if $property.type == 'number'}
<input
type="number"
name="properties[{$property.id|escape}]"
value="{$property.value|escape}"
/>
{elseif $property.type == 'boolean'}
<input
type="checkbox"
name="properties[{$property.id|escape}]"
value="1"
{if $property.value}checked{/if}
/>
{else}
<input
type="text"
name="properties[{$property.id|escape}]"
value="{$property.value|escape}"
/>
{/if}
<span>{$property.unit|escape}</span>
</div>
{/foreach}
</div>
在此基础上,可以扩展日期、枚举、对象引用等属性类型对应的编辑组件。具体支持哪些类型,应以 WSaiOS 属性类型定义机制为依据。
属性编辑保存时,需要重新检查属性标识、类型、单位、约束、用户权限和实例版本。对于结构定义修改,还需要进入结构版本管理过程;对于实例属性值修改,则进入实例数据更新过程。
29.3 对象方法的管理与配置
对象方法决定智能对象能够通过哪些程序处理过程完成相应操作。可视化编辑器需要提供方法定义、参数配置、执行条件、处理器映射和权限配置等编辑功能。
方法定义与实际程序实现之间必须保持分离。用户通过编辑器修改的是方法定义及其配置,不能通过前台输入任意 PHP 代码来改变后端程序执行逻辑。
方法结构可以表示为:
其中,\(ID_j\) 为方法标识,\(N_j\) 为方法名称,\(P_j\) 为参数定义,\(R_j\) 为返回值定义,\(C_j\) 为执行约束,\(H_j\) 为处理器映射,\(V_j\) 为方法版本。
方法编辑界面主要需要组织方法基本信息、参数定义、返回结果定义、执行条件、权限配置和处理器选择。
例如,设备启动方法可以具有如下配置:
{
"method_id": "start_device",
"method_name": "启动设备",
"parameters": [],
"return": {
"type": "execution_result"
},
"handler": {
"handler_id": "device.start"
},
"constraints": {
"allowed_states": [
"standby"
],
"permission": "device_control"
}
}
其中,handler_id 是已经注册的程序处理器标识,不是用户可以任意输入并执行的程序代码。编辑器只能从经过授权的处理器注册信息中选择对应处理器。
对于需要参数的方法,编辑器可以根据参数定义动态生成参数配置区域。例如,设置设备转速的方法可以定义目标转速、单位和允许范围。参数配置提交后,后端需要验证其类型、范围和单位是否与方法定义一致。
方法管理程序可以组织为:
WSaiOS/
└── Presentation/
└── VisualEditor/
└── Method/
├── MethodEditorService.php
│ // 组织对象方法定义及配置的编辑操作
├── MethodParameterEditor.php
│ // 管理方法参数的增加、修改和删除
├── MethodHandlerSelector.php
│ // 从已注册处理器中选择合法的方法实现
├── MethodConstraintEditor.php
│ // 编辑方法执行条件和权限配置
└── MethodEditValidator.php
// 验证方法定义、参数和处理器映射的完整性
MethodEditorService.php 是方法编辑入口,其他程序分别负责参数、处理器、约束和验证,最终将经过验证的方法定义提交给方法管理模块。
方法编辑结果不能立即被当作可运行方法。还需要检查处理器是否存在、参数定义是否完整、执行条件是否有效、用户是否具有相应配置权限,以及方法版本是否与当前结构版本兼容。
方法编辑流程如下:
如果修改的是已经被运行实例使用的方法定义,还需要进行版本兼容性检查。不能因为编辑器保存了新的方法配置,就直接覆盖所有实例正在使用的旧版本。
29.4 对象状态的可视化管理
对象状态管理涉及状态定义、状态转换条件、实例当前状态和状态历史。可视化编辑器需要将这些数据组织成可理解的图形化界面,使用户能够查看和管理状态结构。
状态定义描述对象可以具有哪些状态,以及不同状态之间满足什么条件时允许转换。实例当前状态描述某个具体对象在运行过程中实际处于什么状态。
状态定义可以表示为:
状态转换规则可以表示为:
其中,\(s_a\) 是原状态,\(s_b\) 是目标状态,\(E\) 是触发事件,\(C\) 是转换条件。
例如,设备状态可以定义为待机、运行、暂停和故障。可视化管理界面可以将这些状态显示为节点,将状态转换关系显示为有向连接线。
这张图表达的是状态定义和允许的转换关系,不表示设备当前一定处于其中某个状态。
状态编辑界面可以包含状态节点、状态名称、状态标识、进入条件、退出条件、转换事件和约束配置。用户修改状态关系后,后端需要检查状态标识是否存在、转换端点是否有效、转换条件是否完整,以及是否存在不允许的状态转换。
状态编辑数据示例:
{
"object_id": "motor_structure",
"state_definitions": [
{
"state_id": "standby",
"state_name": "待机"
},
{
"state_id": "running",
"state_name": "运行"
},
{
"state_id": "fault",
"state_name": "故障"
}
],
"transitions": [
{
"from": "standby",
"to": "running",
"event": "start",
"condition_id": "start_condition"
},
{
"from": "running",
"to": "fault",
"event": "fault_detected",
"condition_id": "fault_condition"
}
]
}
状态可视化编辑程序可以组织为:
WSaiOS/
└── Presentation/
└── VisualEditor/
└── State/
├── StateEditorService.php
│ // 组织对象状态定义和转换规则的编辑
├── StateNodeBuilder.php
│ // 将状态定义转换为图形化节点数据
├── StateTransitionBuilder.php
│ // 将状态转换规则转换为图形化连接数据
├── StateRuleValidator.php
│ // 验证状态节点、转换条件和状态关系
└── StateEditRepository.php
// 保存经过验证的状态定义编辑结果
其中,节点构建程序只负责生成图形化节点数据,转换构建程序负责组织状态之间的连接,规则验证程序负责检查状态定义是否完整。
还需要特别区分状态定义编辑与实例当前状态管理。用户修改状态定义时,应当进入结构定义版本管理流程;用户查看或修改实例当前状态时,则必须遵守运行引擎的状态转换机制。不能通过可视化编辑器直接将运行中的设备状态改成任意值,以此代替真实状态反馈。
对于机器人和工业设备,状态定义的修改可能影响正在执行的任务。此类修改需要检查当前运行实例是否兼容,并根据运行安全要求决定是否允许立即生效。
29.5 对象关系的图形化组织
智能对象之间存在多种结构关系。可视化编辑器需要将对象关系转换为图形节点和连接线,使用户能够通过图形操作建立、修改和查看对象之间的关系。
对象关系可以表示为:
其中,\(ID_j\) 为关系标识,\(O_a\) 和 \(O_b\) 为关系两端对象,\(T_j\) 为关系类型,\(C_j\) 为关系约束。
可视化关系编辑器将对象表示为节点,将关系表示为节点之间的连接。节点可以显示对象名称、类型和标识,连接线则表示包含、关联、依赖、控制或其他已经定义的关系类型。
例如,一个工业控制系统可以包含控制器、电机和温度传感器三个对象。控制器与电机之间具有控制关系,温度传感器与电机之间具有监测关系。
关系图数据可以组织为:
{
"nodes": [
{
"id": "controller_001",
"name": "控制器",
"object_type": "controller"
},
{
"id": "motor_001",
"name": "一号电机",
"object_type": "motor"
},
{
"id": "sensor_001",
"name": "温度传感器",
"object_type": "sensor"
}
],
"edges": [
{
"relation_id": "rel_001",
"source": "controller_001",
"target": "motor_001",
"type": "controls"
},
{
"relation_id": "rel_002",
"source": "sensor_001",
"target": "motor_001",
"type": "monitors"
}
]
}
图形编辑时,用户可以选择对象节点、创建关系连接、选择关系类型并配置关系约束。前端只负责收集节点和连接操作,后端负责检查对象标识、关系类型和约束是否合法。
关系编辑程序可以组织为:
WSaiOS/
└── Presentation/
└── VisualEditor/
└── Relation/
├── RelationGraphBuilder.php
│ // 将智能对象和对象关系组织为图形节点及连接数据
├── RelationEditService.php
│ // 接收并组织对象关系的新增、修改和删除请求
├── RelationTypeResolver.php
│ // 检查关系类型是否属于系统允许的定义
├── RelationConstraintValidator.php
│ // 检查关系两端对象和关系约束
└── RelationEditRepository.php
// 保存经过验证的对象关系编辑结果
图形化关系编辑的主要数据过程为:
关系图的显示结果不能代替后端关系数据。用户在图形界面中拖动节点,可能只是改变页面布局,并不意味着对象关系发生变化。只有新增、修改或删除有效关系连接时,才形成结构关系编辑请求。
同时,图形关系编辑还应检查重复关系、循环依赖、关系方向和结构组合约束。对于具有特殊运行意义的控制关系,还应检查相关对象是否具有对应的方法、权限和运行条件。
29.6 前台交互与后台实例数据关联
可视化编辑器产生的所有有效修改,最终都需要与后台的结构定义或实例数据建立准确关联。前台操作不能只根据页面显示名称确定修改对象,而应使用稳定的实例标识、结构标识、属性标识、方法标识和关系标识。
例如,用户在页面中修改一个名为“额定功率”的属性,后台不能只根据这个名称查找并更新数据,因为不同对象可能存在同名属性。必须使用实例标识和属性标识确定具体编辑对象。
前台编辑请求可以统一组织为:
其中,\(ID_e\) 是编辑请求标识,\(T_e\) 是编辑类型,\(ID_o\) 是对象或实例标识,\(ID_s\) 是结构标识,\(D_e\) 是修改数据,\(V_e\) 是原始数据版本,\(C_e\) 是操作上下文。
例如,实例属性编辑请求:
{
"edit_id": "edit_202611160001",
"edit_type": "instance_property",
"instance_id": "motor_001",
"property_id": "rated_power",
"base_version": 8,
"data": {
"value": 18.5
}
}
对象结构定义编辑请求:
{
"edit_id": "edit_202611160002",
"edit_type": "structure_property_definition",
"structure_id": "motor_structure",
"property_id": "rated_power",
"base_version": 12,
"data": {
"name": "额定功率",
"type": "number",
"unit": "kW"
}
}
这两个请求虽然都涉及属性,但前者修改某个实例的属性值,后者修改结构中的属性定义。后台必须根据 edit_type 进入不同服务。
前后台数据关联的程序组织如下:
WSaiOS/
└── Presentation/
└── VisualEditor/
└── BackendBridge/
├── EditorRequestRouter.php
│ // 根据编辑类型将前台请求分发到对应后台服务
├── EditorObjectResolver.php
│ // 根据稳定标识解析被编辑的结构、对象和实例
├── EditorContextBuilder.php
│ // 建立用户、权限、对象版本和编辑任务上下文
├── EditorVersionChecker.php
│ // 检查前台编辑所依据的数据版本是否仍然有效
└── EditorResponseBuilder.php
// 将后台处理结果转换为前台编辑响应
前台与后台的调用关系如下:
后台接口应当使用明确的编辑类型和操作标识,不能允许前台直接指定任意数据库表名、字段名或 PHP 方法名称进行写入。
对于结构定义、模板配置和实例数据,还应分别使用对应的管理服务。前台编辑器只负责提交修改意图,后台决定实际修改范围、数据存储位置和版本处理方式。
此外,编辑接口需要执行身份验证、权限检查、请求来源保护、参数验证和操作日志记录。对于可能影响运行中实例的结构修改,还需要进入专门的兼容性检查和变更审批流程。
29.7 编辑结果的保存与运行验证
可视化编辑器中的修改内容,在提交后不能直接视为已经生效。必须经过数据验证、保存处理和必要的运行验证,才能确定编辑结果是否可以投入使用。
不同编辑类型的保存机制有所区别。
实例属性值编辑,需要检查属性定义、类型、约束、当前实例版本和用户权限,验证通过后保存新的属性值。
结构属性定义编辑,需要检查结构完整性、属性引用、数据类型、约束和结构版本,并生成新的结构定义版本。
方法编辑,需要检查方法参数、返回定义、处理器注册情况、执行条件和权限配置。
状态编辑,需要检查状态节点、状态转换关系、事件和转换条件。
关系编辑,需要检查关系两端对象、关系类型、关系方向和结构约束。
因此,统一编辑保存过程可以表示为:
其中,\(Validate(E)\) 表示编辑数据验证,\(Save(E)\) 表示数据保存,\(Version(E)\) 表示版本管理,\(Verify(E)\) 表示编辑结果验证。
对于结构定义修改,可以采用草稿、验证、发布的管理过程。草稿阶段保存用户修改内容,验证阶段检查结构完整性和兼容性,发布阶段形成新的结构版本。已经运行的实例是否使用新版本,需要单独进行迁移和授权,不能由结构版本发布自动决定。
对于实例属性值修改,可以采用事务保存和版本控制。对于运行状态修改,则必须通过状态管理服务处理,不能直接绕过状态转换规则写入当前状态表。
编辑保存程序可以组织为:
WSaiOS/
└── Presentation/
└── VisualEditor/
└── Save/
├── EditorSaveService.php
│ // 组织编辑结果验证、保存和结果返回
├── EditorChangeValidator.php
│ // 验证编辑内容与原始结构定义的一致性
├── EditorTransactionManager.php
│ // 管理编辑数据保存过程中的数据库事务
├── EditorVersionManager.php
│ // 记录编辑结果对应的结构或实例数据版本
├── EditorRuntimeVerifier.php
│ // 对允许进行运行验证的编辑结果执行验证
└── EditorAuditRepository.php
// 保存编辑人员、修改内容、时间和处理结果等审计记录
其中,EditorSaveService.php 统一组织保存过程,EditorChangeValidator.php 检查修改内容,EditorTransactionManager.php 保证数据库写入的一致性,EditorVersionManager.php 管理版本,EditorRuntimeVerifier.php 执行必要的运行验证,EditorAuditRepository.php 保存操作记录。
保存结果可以分为以下状态:
{
"edit_id": "edit_202611160001",
"status": "saved",
"validation": {
"passed": true,
"message": "属性数据验证通过"
},
"version": {
"old_version": 8,
"new_version": 9
},
"runtime_verification": {
"required": false,
"status": "not_required"
}
}
如果修改的是方法配置或状态转换规则,可能需要进一步进行运行验证。例如,方法处理器是否已经注册、参数能否正确传递、状态转换条件能否通过验证,都需要按照相应的测试机制进行检查。
运行验证不能简单地通过调用真实设备操作来完成。对于物理设备,验证方式需要根据设备环境选择,可以先完成结构和参数验证,再通过模拟环境、测试设备或受控运行环境检查方法调用及状态变化。没有真实运行反馈时,不能将模拟结果标记为实际设备已经执行成功。
编辑结果验证流程如下:
对于结构定义修改,建议保存结构主体和结构版本的对应关系;对于实例属性修改,保存实例属性值及其数据版本;对于方法和状态配置修改,保存相应定义版本和处理器关联信息;对于对象关系修改,保存关系标识、两端对象和关系版本。
所有编辑操作还应记录修改前内容、修改后内容、操作人员、编辑时间、验证结果和版本信息,以便在发生配置错误时进行追溯。
编辑器最终形成的不是一组脱离运行系统的页面数据,而是经过验证并能够进入 WSaiOS 结构管理、实例管理和运行管理体系的编辑结果。
本章建立的整体工程关系可以归纳为:
通过这一机制,用户能够以图形化方式管理智能对象的属性、方法、状态和关系,同时保持可视化编辑与智能对象实际结构及运行数据之间的一致性。
本章与第二十八章的关系是:第二十八章主要研究智能个体页面如何根据结构和运行数据动态生成;第二十九章则进一步研究如何通过这些页面对智能个体进行可视化编辑,并将修改结果安全、准确地关联到后台结构定义和实例运行数据。
下一章将研究智能个体前台与后台的数据交互,进一步建立页面展示、用户操作、后端处理、运行结果返回和数据同步之间的完整交互机制。





