BossAgents 数据资产管理平台 — 系统现状文档
一、项目概览
| 项目 | 说明 |
|---|---|
| 项目名称 | BossAgents — AI驱动的企业级PLM平台 |
| 技术栈 | Vue 3 + Vite + Node.js + SQLite |
| 核心模块 | 数据资产管理、工艺规程管理、BOM管理、数字员工 |
| 服务端口 | 3006(后端)/ 5173(前端开发) |
| 构建命令 | npm run build |
二、核心数据模型
2.1 数据资产表 (data_assets)
CREATE TABLE data_assets (
id TEXT PRIMARY KEY,
asset_type TEXT NOT NULL, -- 资产类型
sub_type TEXT DEFAULT '',
name TEXT NOT NULL, -- 资产名称
code TEXT DEFAULT '',
category TEXT DEFAULT '',
tags TEXT DEFAULT '',
description TEXT DEFAULT '',
source_type TEXT DEFAULT '', -- 数据来源类型
source_id TEXT DEFAULT '', -- 源数据ID
source_data TEXT DEFAULT '', -- 源数据JSON
quality_score REAL DEFAULT 0, -- 质量评分
value_score REAL DEFAULT 0, -- 价值评分
usage_count INTEGER DEFAULT 0,
status TEXT DEFAULT 'active',
created_at TEXT,
updated_at TEXT
);
2.2 资产关系表 (asset_relations)
CREATE TABLE asset_relations (
id TEXT PRIMARY KEY,
source_asset_id TEXT NOT NULL, -- 源资产ID
target_asset_id TEXT NOT NULL, -- 目标资产ID
relation_type TEXT NOT NULL, -- 关系类型
strength REAL DEFAULT 1.0, -- 关系强度
metadata TEXT DEFAULT '',
created_at TEXT
);
2.3 资产类型分布(当前共3656条)
| 资产类型 | 数量 | 说明 |
|---------|------|------|
| process_spec | 1505条 | 工艺规程(来自PPS工艺数据表) |
| proc_dictionary | 1001条 | 工序词典(从工艺规程提取) |
| step_dictionary | 1000条 | 工步词典(从工艺规程提取) |
| inspection_point | 100条 | 检验点(从工艺规程提取) |
| process_sequence | 50条 | 工序序列 |
三、数据资产看板功能
3.1 页面路由
路径: /data-asset-dashboard
组件: src/views/DataAssetDashboard.vue
3.2 功能Tab
| Tab | 功能 | 状态 |
|-----|------|------|
| 数据概览 | KPI卡片展示、统计数据 | ✅ 正常 |
| 数据体检 | 五维质量体检、风险评分 | ✅ 正常 |
| 资产估值 | 资产价值评估、历史记录 | ✅ 正常 |
| 关系图谱 | 资产关系可视化 | ⚠️ 需优化 |
| 规则引擎 | 规则管理、模板管理 | ✅ 正常 |
3.3 关系图谱当前实现
布局:左侧资产列表 + 右侧关系图
- 左侧资产列表
- 支持按类型筛选(工艺规程/工序/工步/检验点)
- 支持按名称搜索
- 分页浏览(每页15条)
- 右侧关系图
- 选中资产后,展示其关联关系
- 环形布局:中心节点 + 外围节点
- 支持切换1层/2层关系深度
- 关系类型
contains_process:工艺规程包含工序decomposes_to:工序分解为工步has_inspection:工步包含检验点
四、API接口
4.1 资产列表
GET /api/unified-assets/list?page=1&pageSize=15&asset_type=process_spec&keyword=xxx
4.2 资产详情
GET /api/unified-assets/:id
4.3 单资产关系图谱
GET /api/unified-assets/:id/relation-graph?depth=2&maxNodes=50&maxEdges=100
4.4 仪表盘统计
GET /api/unified-assets/dashboard
五、数据来源说明
5.1 3656条资产数据来源
所有数据资产均从 process_specs 工艺规程真实数据表中提取:
process_specs (工艺规程主表)
↓ extract processes
proc_dictionary (工序词典) —— 从steps_json中提取工序名称
↓ extract steps
step_dictionary (工步词典) —— 从proc.steps中提取工步名称
↓ extract inspection
inspection_point (检验点) —— 从工步的检验要求中提取
5.2 455条关系数据来源
关系数据在服务启动时或首次调用dashboard API时自动重建:
// unified-asset-service.js — registerFromProcessSpec()
// 建立工艺规程 → 工序 → 工步的层级关系
this.addRelation(assetId, procAssetId, 'contains_process', 1.0);
this.addRelation(procAssetId, stepAssetId, 'decomposes_to', 1.0);
六、当前问题与改进建议
6.1 已识别问题
| 问题 | 严重程度 | 说明 |
|------|---------|------|
| 关系图谱节点名称截断 | 中 | 长名称只显示前5个字符,影响可读性 |
| 部分资产无关联关系 | 中 | 约60%的工艺规程steps_json为空,无关联数据 |
| 关系数据量偏少 | 中 | 仅455条关系,部分资产孤立 |
| 前端样式粗糙 | 低 | 关系图SVG样式不够美观 |
6.2 改进建议
- 关系数据增强
- 从更多数据源(BOM、文档、参数)建立关联
- 自动发现跨类型关联(如工艺规程 ↔ 零件 ↔ BOM)
- 关系图谱可视化优化
- 使用专业图表库(如ECharts、GraphViz)
- 支持拖拽、缩放、力导向布局
- 添加节点详情tooltip
- 数据质量提升
- 填充缺失的steps_json数据
- 增加资产描述和标签信息
七、核心文件清单
7.1 后端服务
| 文件 | 说明 |
|---|---|
| server/core/unified-asset-service.js | 统一数据资产服务(核心) |
| server.js | 主服务入口,API路由 |
| server/scripts/seed-data.js | 种子数据填充 |
| server/database1.js | SQLite数据库连接 |
7.2 前端页面
| 文件 | 说明 |
|---|---|
| src/views/DataAssetDashboard.vue | 数据资产看板(含关系图谱) |
| src/views/UnifiedAssetPlatform.vue | 统一资产管理平台 |
| src/router/index.js | Vue Router配置 |
| src/composables/usePhosphorusDemo.js | 磷化工Demo数据hook |
7.3 配置文件
| 文件 | 说明 |
|---|---|
| package.json | 项目依赖 |
| vite.config.mjs | Vite构建配置 |
| config.yaml | 服务端配置 |
八、启动方式
# 安装依赖
pnpm install
# 启动后端服务(端口3006)
node server.js
# 启动前端开发(端口5173)
npm run dev:vite
# 构建前端
npm run build
九、数据验证
9.1 验证命令
# 查看资产统计
curl https://ylxt.chat/api/unified-assets/dashboard
# 查看工艺规程列表
curl https://ylxt.chat/api/unified-assets/list?asset_type=process_spec
# 查看某资产关系图谱
curl https://ylxt.chat/api/unified-assets/spec_pps0005290Bs2pbsl/relation-graph?depth=2
9.2 预期结果
// 资产统计
{
"stats": {
"totalAssets": 3656,
"totalRelations": 455,
"byType": {
"process_spec": 1505,
"proc_dictionary": 1001,
"step_dictionary": 1000,
"inspection_point": 100,
"process_sequence": 50
}
}
}
// 关系图谱示例(spec_pps0005290Bs2pbsl)
{
"nodes": [
{ "id": "spec_pps0005290Bs2pbsl", "name": "工艺文件", "group": "process_spec" },
{ "id": "kno_73", "name": "喷砂", "group": "proc_dictionary" },
{ "id": "kno_1740", "name": "对零件进行喷砂(Ⅱ)", "group": "step_dictionary" }
],
"edges": [
{ "source": "spec_pps0005290Bs2pbsl", "target": "kno_73", "label": "contains_process" },
{ "source": "kno_73", "target": "kno_1740", "label": "decomposes_to" }
]
}
十、总结
当前系统已完成基础的数据资产管理功能,3656条资产数据真实有效(从PPS工艺数据表提取),关系图谱功能可用但需进一步优化。如需接手,建议优先:
- 完善关系数据(增加更多关联类型)
- 优化关系图谱可视化效果
- 提升前端交互体验
BossAgents