BossAgentsGovernance-native three-tier collaborative design solution
Core Principles
Users/Agents only perform business operations; governance automatically occurs on the SCSAI server side. The application layer only displays results and does not trigger governance.
用户输入 "帮我把这个BOM改一下参数"
↓
对话框 → 解析意图 → 调用SCSAI API（业务操作）
↓
SCSAI服务端 → 执行业务操作 → OnAfterUpdate Method自动触发
↓
治理逻辑 → 校验完整性 → 计算质量分 → 写入GovernanceLog → 建立Relationship
↓
返回结果 → 包含治理信息（质量分变化、修复了什么）
↓
对话框展示 → "已完成修改，质量分从72提升到95，修复了3个缺失字段"
一、业务界面层改造
1.1 角色定位变化
| 原来（错误） | 现在（正确） |
|-------------|-------------|
| User clicks "Fix" button → Calls governance API | User clicks "Modify Parameters" button → Calls SCSAI business API → Governance automatically occurs |
| Interface needs to trigger governance actions | Interface only displays governance results, does not trigger governance |
| Governance is a separate Tab/function module | Governance information is integrated into each business Tab |
1.2 BOM Details Page Modification
Do not change: Do not create separate "Asset Information" Tab or "Governance History" Tab.
Correct approach: Integrate asset information into the Basic Information Tab, and integrate governance history into the Change Record Tab.
┌─ 基础信息 Tab ──────────────────────────────────────┐
│ │
│ ┌─ 业务属性 ─────────┐ ┌─ 资产属性 ───────────┐ │
│ │ 编号: BOM-001 │ │ ? 估值: ¥47.2万 │ │
│ │ 名称: XX产品BOM │ │ ? 质量: 95分(A级) │ │
│ │ 版本: 2.3 │ │ ✅ 治理: 已治理 │ │
│ │ 状态: 已发布 │ │ 责任人: 张三 │ │
│ └────────────────────┘ └────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────┘
┌─ 变更记录 Tab ──────────────────────────────────────┐
│ │
│ ┌─ 业务变更 ─────────┐ ┌─ 治理动作 ───────────┐ │
│ │ 2024-06-15 ECO-123 │ │ 巡检 发现缺失规格 │ │
│ │ 2024-05-20 ECO-098 │ │ 修复 补全规格 │ │
│ │ 2024-04-10 ECO-076 │ │ 优化 参数调优 │ │
│ └────────────────────┘ └────────────────────────┘ │
│ │
│ 说明：业务变更和治理动作在同一个时间线展示 │
│ │
└──────────────────────────────────────────────────────┘
1.3 数据来源
不再调用单独的治理API，直接调用SCSAI API：
// 查询Part完整数据（业务属性 + 资产属性）
const aml = `<AML>
<Item type="Part" action="get"
select="id,name,item_number,state,classification,asset_class,valuation,quality_score,governance_status,last_inspection"
id="${partId}">
</Item>
</AML>`;
// 查询治理历史（通过Relationship）
const logAml = `<AML>
<Item type="Part" action="get" id="${partId}">
<Relationships>
<Item type="Part Governance Log" action="get"
select="action_type,operator_name,timestamp,diff_summary,impact_quality,impact_value"/>
</Relationships>
</Item>
</AML>`;
1.4 操作触发
点击"修复"按钮 → 不调用治理API，调用SCSAI业务API：
// 点击"修复" → 实际是"编辑并补全字段"
const aml = `<AML>
<Item type="Part" action="edit" id="${partId}">
<description>${补全后的描述}</description>
<weight>${补全后的重量}</weight>
<!-- 补全其他缺失字段 -->
</Item>
</AML>`;
// SCSAI执行edit → OnAfterUpdate Method自动触发 → 治理自动发生
二、对话框改造
2.1 角色定位
对话框是用户的主要操作入口，用户说一句话 → 系统执行业务操作 → 治理自动发生 → 返回结果包含治理信息。
2.2 Dialogue Flow Design
用户: "帮我把这个BOM的参数改一下"
系统解析:
意图: 编辑BOM参数
对象: BOM-001
参数: ???（需要澄清）
系统: "请问要修改哪些参数？当前参数如下："
- 参数A: 100
- 参数B: 50
- 参数C: 缺失
用户: "把参数A改成150，补全参数C"
系统执行:
1. 调用SCSAI API编辑BOM
AML: <Item type="BOM" action="edit">
<parameter_a>150</parameter_a>
<parameter_c>补全的值</parameter_c>
</Item>
2. SCSAI执行edit
3. OnAfterUpdate Method自动触发
- 校验完整性: 发现参数D也缺失 → 自动补全
- 计算质量分: 从72 → 95
- 写入GovernanceLog: action_type=repair
- 建立Relationship
4. SCSAI返回结果（含治理信息）
系统回复: "已完成修改。"
✓ 参数A已更新为150
✓ 参数C已补全
✓ 自动补全了参数D（发现缺失）
✓ 质量评分从72提升到95
✓ 估值增加¥5,200
✓ 治理日志已记录
2.3 对话界面展示
┌─ 对话记录 ─────────────────────────────────────────┐
│ │
│ 用户: 帮我把这个BOM的参数改一下 │
│ │
│ 系统: 请问要修改哪些参数？当前参数如下： │
│ - 参数A: 100 │
│ - 参数B: 50 │
│ - 参数C: 缺失 ⚠️ │
│ │
│ 用户: 把参数A改成150，补全参数C │
│ │
│ 系统: ✓ 已完成修改 │
│ ┌─ 执行结果 ─────────────────────────────┐ │
│ │ · 参数A已更新为150 │ │
│ │ · 参数C已补全 │ │
│ │ · 自动补全了参数D（发现缺失） │ │
│ └─────────────────────────────────────────┘ │
│ ┌─ 治理结果 ─────────────────────────────┐ │
│ │ ? 质量评分: 72 → 95 (+23) │ │
│ │ ? 估值: ¥42万 → ¥47.2万 (+¥5.2万) │ │
│ │ ✅ 治理状态: pending → governed │ │
│ │ ? 治理日志: repair动作已记录 │ │
│ └─────────────────────────────────────────┘ │
│ │
└────────────────────────────────────────────────────┘
2.4 对话后端逻辑
async function handleConversation(userInput, context) {
// 1. 解析意图
const intent = await parseIntent(userInput);
// 2. 获取当前对象数据
const currentData = await querySCSAI(context.objectId);
// 3. 构建AML（业务操作）
const aml = buildAML(intent, currentData);
// 4. 调用SCSAI API执行操作
const result = await sendAML(aml);
// 5. 解析返回结果（含治理信息）
const newData = result.items[0];
const qualityChange = newData.quality_score - currentData.quality_score;
const valueChange = newData.valuation - currentData.valuation;
// 6. 构建回复消息
const reply = `已完成修改。
✓ 参数已更新
? 质量评分: ${currentData.quality_score} → ${newData.quality_score} (+${qualityChange})
? 估值: ¥${currentData.valuation} → ¥${newData.valuation} (+¥${valueChange})
✅ 治理状态: ${newData.governance_status}`;
return reply;
}
三、智能体（数字员工）层改造
3.1 角色定位
数字员工执行业务操作，不需要单独调用治理API。治理在SCSAI服务端自动发生。
3.2 Digital Employee Execution Process
数字员工任务: "优化BOM-001的参数"
执行步骤:
1. 查询BOM-001当前数据 → 从SCSAI获取
2. 分析哪些参数需要优化 → 本地AI分析
3. 构建AML（编辑操作） → 本地构建
4. 调用SCSAI API → sendAML(aml)
5. SCSAI执行edit → OnAfterUpdate Method自动触发
- 治理逻辑自动执行
- 质量分自动更新
- GovernanceLog自动写入
6. 解析返回结果 → 包含治理信息
7. 更新任务板 → 显示资产贡献
任务板展示:
✓ 优化了3个参数
? 质量评分: 72 → 95 (+23)
? 估值: +¥5.2万
? 治理日志: optimize动作已记录
3.3 数字员工任务板改造
┌─ 工艺数字员工 · 任务执行 ──────────────────────────┐
│ │
│ 任务: 优化BOM-001的参数 │
│ │
│ 步骤1: 查询BOM当前数据 │
│ ✓ 获取到BOM-001完整数据 │
│ │
│ 步骤2: 分析优化点 │
│ ✓ 发现参数A偏高，建议降低 │
│ ✓ 发现参数B偏低，建议提高 │
│ │
│ 步骤3: 执行优化（调用SCSAI API） │
│ ✓ 参数A已优化: 100 → 80 │
│ ✓ 参数B已优化: 50 → 60 │
│ ┌─ 资产贡献 ───────────────────────────────┐ │
│ │ ? 质量评分: 72 → 95 (+23) │ │
│ │ ? 估值: ¥42万 → ¥47.2万 (+¥5.2万) │ │
│ │ ? 治理动作: optimize已记录 │ │
│ └───────────────────────────────────────────┘ │
│ │
│ 步骤4: 生成优化报告 │
│ ✓ 报告已生成，可查看 │
│ │
│ ──────────────────────────────────────────────── │
│ 本次任务资产贡献: │
│ ? 价值提升: +¥5.2万 │
│ ? 质量提升: +23分 │
│ ? 治理记录: 2条 │
│ │
└────────────────────────────────────────────────────┘
3.4 多数字员工协同
共享治理结果，GovernanceLog累积记录：
┌─ 多数字员工协同 ──────────────────────────────────┐
│ │
│ 用户: "帮我检查这个BOM并优化" │
│ │
│ 巡检数字员工: │
│ → 扫描BOM-001 │
│ → 发现缺失字段 │
│ → SCSAI Method自动写入GovernanceLog │
│ → 返回: 发现3个缺失字段 │
│ │
│ 修复数字员工: │
│ → 调用SCSAI API补全字段 │
│ → SCSAI Method自动触发治理 │
│ → 返回: 已修复，质量+15分 │
│ │
│ 优化数字员工: │
│ → 调用SCSAI API优化参数 │
│ → SCSAI Method自动触发治理 │
│ → 返回: 已优化，质量+8分 │
│ │
│ ──────────────────────────────────────────────── │
│ 协同结果: │
│ ? 质量评分: 72 → 95 (+23) │
│ ? 估值: +¥5.2万 │
│ ? 治理记录: 3条（巡检+修复+优化） │
│ │
└────────────────────────────────────────────────────┘
3.5 绩效统计维度扩展
| 维度 | 原来 | 现在 |
|------|------|------|
| Capability Definition | Identify/Create/Repair/Optimize/Compare/Generate | Unchanged, governance automatically occurs during execution |
| Task Record | Record execution steps | Record execution steps + Asset contribution |
| Performance Statistics | Number of tasks completed | Number of tasks completed + Total asset contribution |
IV. Complete Three-Tier Collaborative Process
┌──────────────────────────────────────────────────────────────┐
│ 用户视角 │
├──────────────────────────────────────────────────────────────┤
│ │
│ 用户打开BOM详情页 │
│ → 看到: 业务信息 + 资产信息（融合展示） │
│ → 看到: 变更记录 + 治理历史（融合展示） │
│ │
│ 用户输入对话 "帮我把这个BOM改一下参数" │
│ → 对话框解析意图 │
│ → 调用SCSAI API │
│ → SCSAI Method自动触发治理 │
│ → 返回: 执行结果 + 治理结果 │
│ │
│ 用户点击"优化"按钮 │
│ → 调用SCSAI API │
│ → SCSAI Method自动触发治理 │
│ → 页面刷新，展示新的质量分和估值 │
│ │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ 智能体（数字员工） │
├──────────────────────────────────────────────────────────────┤
│ │
│ 数字员工执行任务 │
│ → 调用SCSAI业务API │
│ → SCSAI Method自动触发治理 │
│ → 任务板展示: 执行步骤 + 资产贡献 │
│ │
│ 数字员工协同 │
│ → 多个员工依次调用SCSAI API │
│ → SCSAI Method每次都自动触发治理 │
│ → GovernanceLog累积记录 │
│ │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ SCSAI服务端 │
├──────────────────────────────────────────────────────────────┤
│ │
│ 接收AML请求 │
│ → 执行业务操作（edit/add/delete） │
│ → 触发OnAfterUpdate Method │
│ → 校验完整性 │
│ → 计算质量评分 │
│ → 更新资产属性 │
│ → 写入GovernanceLog │
│ → 建立Relationship │
│ → 返回结果（含治理信息） │
│ │
└──────────────────────────────────────────────────────────────┘
五、关键改造清单
| 层级 | 改造点 | 原来做法 | 正确做法 |
|------|--------|---------|---------|
| Business Interface | BOM Details Page | Asset Information in Separate Tab | Integrated into Basic Information Tab |
| Business Interface | Change Record Tab | ECO Only Displayed | ECO + GovernanceLog Displayed |
| Business Interface | Capability Button | Calls Governance API | Calls SCSAI Business API, Governance Occurs Automatically |
| Dialog Box | Intent Parsing | Calls Governance API After Parsing | Calls SCSAI Business API After Parsing |
| Dialog Box | Result Display | Execution Result Only Displayed | Execution Result + Governance Result Displayed |
| Digital Employee | Task Execution | Calls Governance API After Execution | Executes SCSAI Business API, Governance Occurs Automatically |
| Digital Employee | Task Board | Execution Steps Displayed | Execution Steps + Asset Contribution Displayed |
| Digital Employee | Performance Statistics | Task Completion Count | Task Completion Count + Total Asset Contribution |
Six. Current Status and Next Steps
6.1 Current Implementation Status (Phase 3 Completed)
| Level | Status | Description |
|---|---|---|
| SCSAI Governance Engine | ✅ Completed | OnGovernanceTrigger + BatchGovernance, Asset Attributes, GovernanceLog |
| Server-side Dashboard API | ✅ Completed | /api/dashboard/asset-overview + today-governance |
| BOM Detail Page Refactoring | ✅ Completed | Asset attributes integrated into Basic Info Tab, governance logs integrated into Change History Tab, redundant code cleanup |
| Dashboard Homepage | ✅ Completed | 4 asset overview cards + today's governance activity |
| Dialog Governance Result | ✅ Completed | Part/BOM repair operations return governance impact |
| Digital Employee Asset Contribution | ✅ Completed | Task logs display quality/value changes |
6.2 Future Enhancement Directions
- Multi-Digital Employee Collaborative Aggregation — Summarize total asset contribution from multi-employee collaboration task results
- Dialog Intent Directly Connects to SCSAI — After AI parses user intent, directly build the SCSAI business AML, instead of going through the /api/ai-agent/execute intermediate layer
- Performance Statistics Extension — Add "Total Asset Contribution" dimension to the digital employee performance panel
6.3 Verification Loop Closure
SCSAI中修改Part字段 → OnAfterUpdate → 质量分自动更新 → GovernanceLog自动生成
↓
前端BOM详情页实时看到质量分变化 Dashboard今日动态同步出现该条记录
↓ ↓
对话框执行修改操作时返回治理变化对比 数字员工日志展示资产贡献
附录：相关文件
| 文件 | 说明 |
|------|------|
| server/scripts/phase3-governance-setup.js | SCSAI data model auto-configuration script |
| server/scripts/phase3-verify.js | Verification Script |
| server/scripts/methods/OnGovernanceTrigger.cs | OnAfterUpdate Trigger Method |
| server/scripts/methods/BatchGovernance.cs | Batch Governance Method |
| server.js | Governance Dashboard API Endpoints |
| src/components/BomDetailModal.vue | Asset/Governance Integrated Display |
| src/views/Dashboard.vue | Asset Overview/Governance Activity |
| src/views/AiWorkbench.vue | Dialog Governance Result Reply |
| src/views/DigitalStaff.vue | Digital Staff Asset Contribution |
| docs/Governance Native Architecture Refactoring - Implementation Summary-v1.md | Phase 3 Implementation Summary |
