# 客户企业本体：第一版业务类与字段

日期：2026-09-07。范围：能续达建筑节能膜演示，Zoe 获客、Lily 邮件触达、Wendy 社媒运营、Lucas 专业建站。以下是业务模型建议，不是已上线接口或真实执行记录。

[查看业务关系概览图](./business-ontology-v1.svg)

## 一、先理解这张图

公司是客户自己的公司，不是百型智能。产品是公司卖的东西；资料是原始依据；画像、任务、策略和内容是业务对象；数字员工是可以处理这些对象的岗位角色。

一条箭头必须能读成一句业务话。不要把“可协助”画成“已经执行”，也不要把“公司上传了文件”理解成“文件中的全部内容已被核验”。

```mermaid
flowchart LR
  C[客户公司] -->|销售| P[产品]
  C -->|管理| D[资料文件]
  D -->|提供资料依据| P
  P -->|归入分类| CAT[产品分类]
  P -->|用于获客产品线| PL[获客产品线]
  PL -->|面向买家画像| BP[买家画像]
  Z[Zoe 获客] -.->|可协助处理| T[获客任务]
  T -->|选择产品线| PL
  T -->|按画像筛选| BP
  T -->|发现潜客| PC[潜客公司]
  PC -->|发来询盘| I[询盘]
  I -->|咨询产品| P
  L[Lily 触达] -.->|可协助处理| ES[邮件策略]
  L -.->|可协助处理| I
  ES -->|介绍推广| P
  E[案例与资质] -->|适用于产品| P
  W[Wendy 社媒] -.->|可协助处理| SP[社媒内容]
  SP -->|介绍推广| P
  SP -->|发布到：需要授权及确认| SA[社媒账号]
  C -->|授权连接| SA
  U[Lucas 建站] -.->|可协助处理| WP[网站页面]
  C -->|拥有网站| WEB[企业网站]
  WEB -->|包含页面| WP
  WP -->|展示产品| P
  SP -->|链接至页面：不等于归因| WP
```

网页内“类与字段”视图是同一业务模型的可点击箭头图。以下每一类可以有多个实例；例如一个 Product 类下面可以有多个膜型号。

## 二、通用字段与资料状态

所有对象：id（稳定字符串，不用显示名当主键）、type（业务类）、label（展示名）、description（说明）、status（资料状态）、attributes（业务字段）。

- provided：用户输入提供，但未独立核验。
- suggested：业务建议、规划或待创建对象，未执行。
- unknown：资料缺失，值留空，不编造。

正式入库建议补充 tenantId、sourceRef、sourcePage、updatedAt、version、reviewedBy；tenantId 必须由服务端身份决定，不能由模型或前端任填。本演示只有一个服务端配置的客户上下文，不是多租户持久化产品。

通用字段类型建议：名称、说明、域名、引用为文本；多值市场/语言/关键词/卖点/规则为文本数组；计数与排序为非负整数；enabled 为布尔；时间为带时区 ISO 8601；业务状态为受控枚举。当前 JSON 演示校验类、字段键、关系端点和安全的基本值类型，尚未实施所有业务枚举、日期和基数约束。

## 三、16 个业务类的文字字段字典

### 1. Company 客户公司

name 公司名称；brand 品牌；industry 行业；website 官网；targetMarkets 目标市场数组；businessLanguages 业务语言数组；profileStatus 资料完整度。

最少需要能识别公司的名称或品牌。法人全称未知时明确待补充，不能用品牌假定法定主体。1 家公司可以销售 N 个产品、管理 N 份资料。

### 2. ProductCategory 产品分类

name 分类名称；description 分类说明；sortOrder 排序整数；enabled 是否启用。

用来组织产品目录。分类层级用 containsCategory 关系表达，一个子分类最多一个父分类，正式入库禁止循环。不是 Zoe 的产品线。

### 3. ProductLine 获客产品线

name 产品线名称；description 获客方向；salesKeywords 搜索关键词数组；targetMarkets 目标市场数组；priority 优先级；enabled 是否启用。

用来决定“卖什么方向、找什么买家”。一个具体产品可以对应多条获客产品线；同一产品线可以包含多型号产品。不能直接复用产品分类 ID。

### 4. Product 产品

name 产品名称；model 型号；productType 产品类型；summary 产品摘要；sellingPoints 卖点数组；specifications 参数与适用条件；salesStatus 销售状态。

参数先放详情，不必每个数字都变成一个节点。正式规格建议拆成“参数名 / 数值 / 单位 / 测试条件 / 来源页码”。宣传材料标称节能率不等于任何建筑的实际节能收益。

### 5. SourceAsset 资料文件

fileName 文件名；assetType 文件/图片/视频/文本类型；language 语言；version 版本；storageRef 对象存储引用；parseStatus 解析状态；uploadedAt 上传时间。

资料库保存原件；知识库保存有来源的内容或片段；图保存对象及它们的关系，三者不混为一张表。本轮输入只有文件名时，必须写“未解析正文”，不能声称上传或 RAG 更新成功。

### 6. BusinessEvidence 案例与资质

evidenceType 案例/证书/报告；title 标题；scope 适用范围；issuerOrIndustry 签发机构或客户行业；authorizationStatus 公开使用授权；validUntil 有效期；confirmationStatus 核验状态。

与原始附件建立 supports 关系，与适用产品建立 appliesTo 关系。材料里提到认证，不等于已取得可对外展示的证书。

### 7. BuyerPersona 买家画像

name 画像名称；buyerType 买家类型；industry 行业；targetCountries 国家数组；painPoints 痛点数组；purchaseKeywords 采购关键词数组；qualificationRules 筛选条件数组。

是“想找哪类买家”的定义，不是具体客户。窗膜经销商、安装服务商可以作为建议画像，但不能凭空生成真实联系人。

### 8. ProspectCompany 潜客公司

name 企业名称；domain 域名；country 国家；industry 行业；matchStatus 匹配状态；sourceType 线索来源；followupStage 跟进阶段。

必须有真实来源后再建实例。联系人、邮箱和电话留在受权限控制的业务系统，不进入默认可视图。

### 9. AcquisitionTask 获客任务

name 任务名称；targetCountries 国家范围数组；dailyLimit 每日数量上限；status 状态；startedAt 开始时间；endedAt 结束时间；exclusions 排除规则数组。

任务选择一个产品线，可以使用多个画像，也可发现多个潜客。Zoe 的 canHandle 表示“可处理这个任务”，真实运行以后才增加执行记录。

### 10. EmailStrategy 邮件触达策略

name 策略名称；goal 触达目标；language 邮件语言；roundCount 轮次数；intervalRules 间隔规则；contentVersion 内容版本；enabled 是否启用。

策略、邮件模板、实际发送是不同对象。本轮先定义策略，未创建邮件发送记录，也不会给“enabled=true”赋予发送授权。

### 11. Inquiry 询盘

channel 来源渠道；receivedAt 收到时间；subject 主题摘要；intent 采购意向；status 处理状态；owner 负责人引用；detailRef 受限详情引用。

真实询盘才建实例。邮件正文及附件不直接进图。潜客可发来多个询盘，一个询盘也可咨询多个产品。

### 12. SocialAccount 社媒账号

platform 平台；displayName 展示名；connectionStatus 授权状态；authorizedUses 授权用途数组；accountRef 受限账号引用。

禁止把平台令牌、密码、Cookie 放到节点属性。只有已授权账号才可以承接真实发布，建议账号不代表已连接。

### 13. SocialPost 社媒内容

title 标题；summary 内容摘要；language 语言；publishStatus 发布状态；scheduledAt 计划时间；publishedAt 实际发布时间；platformUrl 平台链接。

建议一条记录对应一个平台版本。草稿、待审核、已排期、已发布分别表示不同业务状态。图谱生成不会自动调用 Wendy 发布。

### 14. Website 企业网站

domain 域名；purpose 网站用途；targetMarkets 目标市场数组；languages 网站语言数组；deliveryStatus 交付状态；owner 负责人引用。

一家公司可以有多个站点，一个站点可以有多页。建议建站时域名可以为空，不能假定已经上线。

### 15. WebPage 网站页面

name 页面名称；path 页面路径；pageType 页面类型；language 语言；contentVersion 内容版本；publishStatus 发布状态；conversionGoal 转化目标。

页面可以展示多个产品、引用多个案例和资料。社媒 linksTo 页面只表示链接关系，不证明流量归因或成交。完整自动建站/部署接入仍待单独核实。

### 16. DigitalEmployee 数字员工

name 名称；role 岗位职责；allowedActions 可申请的动作数组；requiredData 依赖数据数组；integrationStatus 本体接入状态；executionMode 执行模式；owner 负责人引用。

Zoe / Lily / Wendy / Lucas 是同一类的四个角色实例。图中的角色不是新建四个生产 Agent，也不意味着现有岗位已读取此图。本轮只真实创建一个“本体制图师”辅助 Agent 来生成图谱文本。

## 四、四个数字员工最先需要什么

| 数字员工 | 核心输入 | 可准备的业务对象 | 真正执行时才需要 |
| --- | --- | --- | --- |
| Zoe | 产品线、关键词、画像、国家与排除规则 | 获客任务、候选买家范围 | 获客账号权限与任务确认 |
| Lily | 产品卖点、可用论据、买家上下文、邮件目标/语言/节奏 | 邮件策略、回复草稿 | 真实联系人、发信邮箱、发送授权 |
| Wendy | 品牌语气、受众、产品资料、可使用素材 | 社媒内容计划与草稿 | 已连接账号、素材授权、发布确认 |
| Lucas | 公司介绍、产品目录、案例资质、语言/栏目/转化目标 | 站点结构、产品页草稿 | 域名、托管权限、上线确认 |

## 五、本轮闭环和刻意不做的事

公司资料文本 → 灵枢测试环境专用 Agent → 完整 JSON 结果 → 类/字段/关系校验 → 本机渲染器。

不是“模型随意发明类”；是我们先规定业务词表，再让模型根据资料生成实例。普通 Agent 单轮结构化输出足够完成本轮演示，无须多智能体协作或 OWL 推理器。

本轮不做：真实 RAG 入库、上传后自动解析、图数据库持久化、自动发信/发帖/上线、生产部署、300 客户隔离、完整关系基数校验。图谱刷新/页面关闭后不保证保存；可下载 JSON 保留。

如果继续做上传自动更新，推荐流程：文件入库并留来源 → 提取候选事实 → 校验与冲突标记 → 用户确认 → 带版本更新知识与图投影。不要直接让 Agent 覆盖全部历史关系。

## 六、依据和确认等级

- 已核对本地代码：Zoe 以产品线/画像/国家组织获客；Lily 使用企业及产品上下文；Wendy 草稿与发布接口分开，真实发布有外部副作用。
- 本版提出的设计：16 类、关系命名、JSON 契约以及 Lucas 的 Website/WebPage 拆分。
- 待确认：正式必填字段、业务状态枚举、现有系统到对象 ID 的映射、各岗位的生产接入。
- 资料范围：本次默认生成只使用用户提供的品牌、业务描述及四个 PDF 文件名，未在本轮重新解析 PDF 正文，也未读取客户数据库。