FDE 本体建模操作手册 v1.2-draft2
写给 FDE 同事:从接客户到把本体建进平台、交出去、能回滚,全流程一件事一张表。
数据口径与 建模方案 V5.0 一致:14 对象 / 105 属性 / 21 关系 / 45 动作 / 22 字典 / 14 权限。门禁评审已取消,阶段出关改用 exit_met / exit_gap。
0 三分钟速览
六段全景
每段做完有出关检查:对照 entry_gate 逐条核对,达成写 exit_met(是/否),差距写 exit_gap(AI 对照 entry_gate 逐条推导、标来源,机密级)。门禁评审会已取消——出关靠证据不靠开会。
谁干什么
| 角色 | 干什么 |
|---|---|
| FDE(你) | 收资料→整理需求→出方案→跑机检→落平台→写变更记录 |
| 数字员工(智兑现) | 登记/查询/推进等日常动作的执行者;exit_gap 由它推导初稿 |
| 部门领导 | 审推进阶段(advance_phase)、方案确认、高危动作 |
| 老板/真人复核 | 只看四块:新增对象、权限表、机检 ERROR/WARN、变更清单 |
最容易踩的坑
-draft;③ 验证 A 文件发 B 文件 → 只对「即将发布的那一个文件」做比对。④ 速查表编码凭语义手写 → 必须脚本从清单读(draft2 初版曾错 13 个动作码+8 个字典码)。1 怎么开始
五类输入准入(缺一不开工)
| 输入 | 从哪来 | 缺了会怎样 |
|---|---|---|
| 业务全貌(靠什么赚钱、价值链) | 访谈 + 业务分析 | 对象边界全错 |
| 组织与岗位责权 | 组织诊断 | 答不出「谁问/谁写」 |
| 业务流程(端到端) | 组织诊断 + 访谈 | 动作只能编 |
| 业务对象与术语 | 台账/表单/系统截图 | 属性全靠猜 |
| 数据可得性 | 依赖分析 | 建出来是空表 |
资料可信度排序
台账/表单/截图 > 访谈记录 > 制度文件 > 行业通识。只有前两类能支撑属性和动作。
数据可得性 L1–L4
| 级别 | 含义 | 结论 |
|---|---|---|
| L1 | 接口直读 | 能做 |
| L2 | 导出文件 | 能做(半自动) |
| L3 | 人工补录 | 慎做 |
| L4 | 数据不存在 | 不能做 |
2 六段流程(每段:它做 / 你做 / 产出 / 出关)
2.1 组织诊断
| 它做 | 你做 | 产出 | 出关(entry_gate→exit) |
|---|---|---|---|
| 查部门/人员/角色 | 组织诊断、定准入 | 组织与岗位清单 | 五类输入齐→exit_met 写是 |
2.2 业务规划
| 它做 | 你做 | 产出 | 出关 |
|---|---|---|---|
| 查口径库/依赖 | 整理需求、出建模方案(draft_plan) | 需求条目+方案版本 | 方案 confirm→exit_gap 记差距 |
2.3 本体建模(数字员工构建)
| 它做 | 你做 | 产出 | 出关 |
|---|---|---|---|
| 登记岗位/提议工作项 | 建对象/属性/关系/动作、跑机检 | 建模清单+机检报告 | ERROR=0 且四项比对过 |
2.4 平台落地(上岗)
| 它做 | 你做 | 产出 | 出关 |
|---|---|---|---|
| launch_employee 上架 | 平台落地、冒烟、register_deliverable | 可用数字员工+交付物 | 冒烟通过→mark_plan_applied |
2.5 运行(全面运行)
| 它做 | 你做 | 产出 | 出关 |
|---|---|---|---|
| 跑工作项、record_roi_metric | 盯成效、处理 issue/dependency | 成效数据 | 指标达标→出关 |
2.6 沉淀
| 它做 | 你做 | 产出 | 出关 |
|---|---|---|---|
| 查历史口径 | 口径入库、close_project 或 terminate_project | 资产复用包 | 资产入库→关项目/终止 |
pause_project 后用 resume_project 恢复;确认不做用 terminate_project(aborted=不做了)。3 常用话术(照着说)
| 场景 | 照着说 |
|---|---|
| 客户答复口径 | 「陈工,客户王经理说报表口径按自然月」→ register_caliber_result |
| 材料可信 | 「这份台账出处核过了,可以引」→ mark_evidence_verified |
| 材料不可信 | 「这份口头数字跟台账对不上,不采信」→ reject_evidence |
| 提出需求 | 「客户要周报自动发」→ raise_requirement |
| 需求重复 | 「REQ-003 和 REQ-007 都是说导出报表」→ merge_requirement |
| 登记卡点 | 「要客户开 CRM 接口,登记卡点」→ raise_dependency |
| 卡点解除 | 「客户把接口开通了」→ resolve_dependency |
| 登记问题 | 「数据接口要 3 周才能给,风险」→ raise_issue |
| 项目暂停 | 「客户预算调整,项目暂停」→ pause_project |
| 项目复工 | 「预算批了,项目复工」→ resume_project |
| 项目终止 | 「客户砍了预算,项目终止」→ terminate_project(aborted) |
| 阶段出关 | 「阶段2 退出门槛达成,推进到阶段3」→ advance_phase(一并落 exit_met/exit_gap) |
| 数字员工退役 | 「客户项目结束,舆情秘书退役」→ retire_employee |
4 四张表怎么看
对象表(14 个)
每个对象答得出「谁问/谁写/参与什么判断」,编码=英文小写下划线,别名 ≥3 个真俗称(对象名本身不算别名)。清单见第 10 节速查。
属性表(105 条)
- 类型只用 9 种原值逐字照抄;长度/精度必填
- 密级按字段内容定,不按对象:同一对象可混级(exit_met 公开、exit_gap 机密)
- 字典值段一律英文小写 snake;状态类枚举每个值写清到达路径
关系表(21 条)
- 挂钩列只能单列;一列只能挂一条关系(挂两个目标建两列,如口径的 mount_requirement_code / mount_project_code)
- 方向+基数必填;双向必须有反向关系名;N:N 给中间表名与两列名
动作表(45 个)与动作完备性
每个对象过四格:①创建 ②改关键字段 ③状态流转(进+出双向可达)④作废/关闭。终态清单:ended/closed/aborted/retired/dropped/resolved/rejected/deployed/applied/superseded/merged。
查询权限表(14 行)
做隔离三件事一起改:角色移出①、模式改「或」、②配归属字段(必须是对象真实人员列)。
5 机检与验收
三层分工
| 层 | 谁 | 干什么 |
|---|---|---|
| 机检 | 脚本(T1–T14) | 格式与完备性,ERROR=0 才许交付 |
| 自检 | FDE 本人 | 42 条业务自检(fde-ontology-checklist),任一条未过不得交付 |
| 真人复核 | 家辉/老板 | 只看四块,不逐行 |
ERROR 三分类
A 可自修类型/格式类,改完重跑 | B 待决策权限/口径类,报人挂起,⛔ 不许编值凑合 | C 缺信息客户资料缺,停,报「缺什么去哪拿」。
真人只看四块
① 新增对象 ② 权限设计表 ③ 机检 ERROR/WARN ④ 变更清单。变更差值必须代码 diff,⛔ 手算。
T1–T14 规则
| 规则 | 查什么 | 级别 |
|---|---|---|
| T1 | 属性类型在 9 原值内 | ERROR |
| T2/T3 | 挂钩列单列且真实;关系编码唯一 | ERROR |
| T4 | 参数类型合法;归属人参数指向真实列;owner 档必须有归属人参数(双向判定) | ERROR |
| T5/T6 | 枚举绑字典;密级三档内 | ERROR |
| T7/T8 | 别名≥3 真俗称;长度/精度 | WARN |
| T9/T10 | 双向有反向名;fixed 写明审批人 | ERROR |
| T11/T12 | 文档属性开挂载;字典值段 snake | ERROR |
| T13 | 每对象有查询权限 | ERROR |
| T14 | 四格完备 + 状态双向可达(能进也要能出,终态豁免) | ERROR |
交付件与审阅件分开
审阅件(md/HTML):含沿革、典型问句、变更清单。交付件(xlsx):只含平台真字段,⛔ 混进「沿革」列会被当成要建的字段。
交付前四项比对
6 平台落地
七步
执行顺序固定:字典→对象→属性→关系→动作→权限;关系必须等源/目标对象都建完(平台约束);每段完成即回读。
三方比对
方案 vs 平台现状:平台有方案无 → 标「来源不明」⛔ 不进变更集,先报人。⛔ 不许从平台反导当方案。
回滚能力
每次写操作登记 fde_platform_change:payload 可重放、rollback_way(改回旧值/可删/停用/加新列迁移/不可逆须书面确认)。每条写操作落 JSONL 日志(只增不删)。
7 红线(碰到就是事故)
2 未确认方案 ⛔ 进客户平台
3 平台变更不登记就执行
4 机检 ERROR≠0 就说「可交付」
5 未验收的文件占正式版本号
6 覆盖同名交付文件
7 推断值录进 ROI(只录实测)
8 从平台反导当方案
9 交付件混进「沿革/典型问句」验收列
10 用「我验证过」代替「我比对过这个文件」
11 速查表编码凭语义手写,不从清单读
8 真实案例(都真发生过)
| # | 事故 | 怎么发现 | 改成什么规矩 |
|---|---|---|---|
| 1 | 别名凑数:把对象名本身当别名 | 家辉复跑机检抓出 | T7 判定排除对象名本身 |
| 2 | 属性新增数手算 18,实际 36 | 家辉代码 diff 对出 | 变更差值必须代码 diff,⛔ 手算 |
| 3 | 会话自报 WARN 4,文档写 WARN 0 | 家辉比对文档与自报 | 机检结论一致性:文档数字必须与代码输出逐字一致 |
| 4 | 5 个对象一个动作都没有 | 家辉复查设计 | 动作完备性四格;T14 落地 |
| 5 | 属性描述写了动作名,动作表里没这个动作 | 机检扫描发现 0 次命中 | 描述提到的动作必须在动作表存在 |
| 6 | xlsx 交付件混进「沿革」列 | 回读生成日志发现 | 删列按列名不按索引;交付件只含平台真字段 |
| 7 | 验证的是 14 对象的数据,发布的是 16 对象的旧文件 | 家辉复跑对不上 | 四项数字比对:只对「即将发布的那一个文件」做比对 |
| 8 | 速查表 45 个动作码里 13 个、22 个字典码里 8 个是按语义自己起的 | 家辉逐条比清单暴露——条数全对,不逐条比发现不了 | 速查类内容必须脚本从清单生成+反向提取逐条比对(B4 新纪律) |
9 技能清单(17 个,按六段归类)
| 阶段 | 技能 | 一句话作用 |
|---|---|---|
| 第1段 组织诊断 | fde-org-diagnosis | 组织诊断准入:判这个客户能不能建模、理组织与岗位 |
fde-source-evidence | 资料取证:客户给的材料怎么分级、什么能当事实写进交付物 | |
fde-dependency-analysis | 外部依赖:判断数据拿不拿得到、要客户给什么授权 | |
| 第2段 业务规划 | fde-requirement-structuring | 需求结构化:把现场资料/访谈口述整理成需求条目 |
fde-caliber-confirmation | 口径确认:模糊口径向客户确认的话术与登记 | |
| 第3段 本体建模 | fde-capability-attribution | 能力归属判断:一个功能该放本体/流程/技能/职责/界面哪层 |
fde-ontology-modeling | 本体建模主标准:对象/属性/关系/动作怎么设计 | |
fde-ontology-lint | 机检 T1–T14:交付前自动校验,ERROR=0 才许出 | |
fde-ontology-checklist | 42 条自检清单:业务正确性逐条过,任一未过不得交付 | |
| 第4段 平台落地 | fde-platform-connect | 接入验权:登客户本体平台拿 token、验权限 |
fde-platform-snapshot | 现状快照:拉平台已有对象全量存档,只增不删 | |
fde-platform-diff | 三方比对:方案 vs 平台现状出变更集 | |
fde-platform-apply | 变更执行:dry-run 先行、分段落库、JSONL 留痕可回滚 | |
| 通用 | fde-phase-gate | 六段门禁判断:项目在哪个阶段、该产出什么、能否进下一段 |
fde-deliverable-report | 交付物与汇报:结构、话术、四项比对、版本命名 | |
| 通道 | remote-shell-tasks | 远程执行通道:需要远程跑命令时用 |
workbench-delivery | 交付与消息通道:发文件、发通知 |
10 对象速查(14 个)
数据源:落库清单 V5.0
| 对象名 | 编码 | 一句话说明 | 关键字段(取自属性表前 4 列) |
|---|---|---|---|
| 客户 | fde_customer | 我们长期服务的甲方单位,跨项目资产的锚点,边界是只收已签合作意向的单位 | customer_code、customer_name、industry、cooperation_status |
| 交付项目 | fde_project | 一个客户的一次数字员工落地/运维交付,对齐商务合同口径,边界是不含未立项的售前机会 | project_code、project_name、customer_code、current_phase |
| 阶段 | fde_phase | 项目所处的六段法阶段(1-6),门禁评审与交付物的挂靠点 | phase_code、project_code、phase_no、phase_status |
| 数字员工岗位 | fde_digital_employee | 长期服务客户的一个数字员工实例,资产挂客户不随项目消亡 | employee_code、employee_name、customer_code、role_scope |
| 需求条目 | fde_requirement | 从现场资料理出的一条需求,边界是单条可独立评审确认 | requirement_code、requirement_desc、project_code、source_material_code |
| 源材料 | fde_source_material | 客户给的一份原始资料及其取证记录,挂客户跨项目复用 | material_code、material_name、customer_code、owner |
| 口径确认 | fde_caliber_confirmation | 一条模糊口径向客户的确认结论,挂客户沉淀跨项目继承 | project_code、confirm_code、caliber_desc、conclusion |
| 外部依赖 | fde_dependency | 一项**外部方(客户/第三方)应给而未给**的授权/接口/数据,堵住就影响推进;边界:已发生的状况不进这里,进 fde_issue——同一件事只登记一处 | dep_code、dep_desc、project_code、blocker_requirement_code |
| 交付物 | fde_deliverable | 一份交付出去的文档/报告/配置,挂阶段不直接挂项目 | deliverable_code、deliverable_name、phase_code、deliverable_type |
| ROI 记录 | fde_roi_record | 数字员工上岗后的一条成效核算,只录实测值 | record_code、employee_code、metric_name、metric_value |
| 问题与风险 | fde_issue | **已发生的状况**(问题/风险)及其处置,按 RK/OP/CH 前缀分类;边界:外部方应给而未给的等待项不进这里,进 fde_dependency——同一件事只登记一处 | issue_code、issue_desc、project_code、owner |
| 方案版本 | fde_ontology_plan | 一版本体建模方案(如 V4)的整份存档与状态:哪个项目、基于哪版、确认没有、落地没有——「这个项目现在执行的是哪版方案」只有它能答 | plan_code、plan_version、project_code、based_on_version |
| 平台变更记录 | fde_platform_change | 一次对客户平台的写操作留痕:改了什么(payload)、谁批的、怎么回滚、回滚没有——「上次动了客户平台什么、出事怎么退」只有它能答 | change_code、project_code、plan_version、op_type |
| 工作项 | fde_work_item | 数字员工长期要干的一类活的登记,挂数字员工岗位——「这个数字员工这周该干什么、哪些活还没人管」只有它能答 | workitem_code、workitem_name、employee_code、workitem_desc |
11 关系图(21 条)
数据源:落库清单 V5.0
21 条关系明细(逐行来自清单「关系表」,SVG 正下方)
| 源对象 | 关系名 | 目标对象 | 基数 | 必须 |
|---|---|---|---|---|
fde_project | 属于 | fde_customer | N:1 | 是 |
fde_phase | 隶属 | fde_project | N:1 | 是 |
fde_digital_employee | 属于 | fde_customer | N:1 | 是 |
fde_digital_employee | 首次上岗于 | fde_project | N:1 | 否 |
fde_roi_record | 核算 | fde_digital_employee | N:1 | 是 |
fde_requirement | 属于 | fde_project | N:1 | 是 |
fde_requirement | 提炼自 | fde_source_material | N:1 | 否 |
fde_requirement | 指向工作项 | fde_work_item | N:1 | 否 |
fde_source_material | 属于 | fde_customer | N:1 | 是 |
fde_caliber_confirmation | 挂靠需求 | fde_requirement | N:1 | 否 |
fde_caliber_confirmation | 挂靠项目 | fde_project | N:1 | 否 |
fde_caliber_confirmation | 属于 | fde_project | N:1 | 是 |
fde_caliber_confirmation | 继承自 | fde_caliber_confirmation | N:1 | 否 |
fde_dependency | 阻碍 | fde_requirement | N:1 | 否 |
fde_dependency | 属于 | fde_project | N:1 | 是 |
fde_deliverable | 归属阶段 | fde_phase | N:1 | 是 |
fde_issue | 属于 | fde_project | N:1 | 是 |
fde_ontology_plan | 属于 | fde_project | N:1 | 是 |
fde_platform_change | 属于 | fde_project | N:1 | 是 |
fde_platform_change | 依据方案 | fde_ontology_plan | N:1 | 是 |
fde_work_item | 服务岗位 | fde_digital_employee | N:1 | 是 |
12 动作速查(45 个)
数据源:落库清单 V5.0
| 动作名 | 编码 | 作用于 | 谁能发起(角色|人员) | 审批档 | 一句话 |
|---|---|---|---|---|---|
| 登记确认结论 | register_caliber_result | fde_caliber_confirmation | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 客户口头或书面答复了一条口径后用。例:「陈工,客户王经理说报表口径按自然月」。边界:只登记结论不改需求本身;口径作废(录错对象)由真人删,无作废动作 |
| 标记取证完成 | mark_evidence_verified | fde_source_material | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 一份材料核完来源、能当事实引用时用。例:「这份台账出处核过了,可以引」。边界:rejected 的材料不走此动作;材料作废(登记错误)由真人删,无作废动作 |
| 标记取证不采信 | reject_evidence | fde_source_material | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 材料来源存疑/口径矛盾判定不可采信时用。例:「这份口头数字跟台账对不上,不采信」。边界:终态;采信走 mark_evidence_verified |
| 登记材料 | register_material | fde_source_material | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 收到客户新材料入台账时用。例:「客户给了 6 月台账,登记」。边界:编号按格式生成 |
| 提出需求 | raise_requirement | fde_requirement | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 从现场资料/访谈理出一条需求时用。例:「客户要周报自动发」。边界:编号按格式生成;挂项目 |
| 确认需求 | confirm_requirement | fde_requirement | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 评审通过、客户认可这条需求时用。例:「REQ-003 客户确认要做」。边界:须 open;确认后进工作项排期 |
| 放弃需求 | drop_requirement | fde_requirement | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 需求取消/客户不再要时用。例:「预算砍了,REQ-005 放弃」。边界:终态;须 open 或 confirmed |
| 解决问题 | resolve_issue | fde_issue | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 问题处理完毕、验证通过时用。例:「DEP-003 接口通了,关掉」。边界:终态;须 open 或 escalated;解决方式写在 issue_desc 追加 |
| 登记问题 | raise_issue | fde_issue | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 交付中发现问题/风险时登记。例:「数据接口要 3 周才能给,风险」。边界:编号按格式生成;挂项目 |
| 出方案版本 | draft_plan | fde_ontology_plan | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 深化/新建建模方案时用。例:「基于 V4.1 出 V4.2」。边界:编号按格式生成;content_md 必须整份存档 |
| 作废方案版本 | discard_plan | fde_ontology_plan | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 方案草稿作废(不再走这版)时用。例:「V4.2 方向改了,草稿作废」。边界:仅 draft 可作废;confirmed/applied 的历史版本只能被新版 superseded,不删 |
| 升级问题 | escalate_issue | fde_issue | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 超过处置时限或影响门禁时用。例:「DEP-003 堵两周了,升级到部门」。边界:升级后状态置 escalated |
| 解除依赖 | resolve_dependency | fde_dependency | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 客户给了授权/接口/数据后用。例:「客户把接口开通了」。边界:必须实际拿到才点,预期拿到不算 |
| 登记依赖 | raise_dependency | fde_dependency | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 发现需要客户给授权/接口/数据时登记。例:「要客户开 CRM 接口,登记卡点」。边界:编号按格式生成;挂项目 |
| 标记重复或合并需求 | merge_requirement | fde_requirement | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 评审发现两条需求是同一件事时用。例:「REQ-003 和 REQ-007 都是说导出报表」。边界:保留一条,另一条置 merged |
| 录入成效数据 | record_roi_metric | fde_roi_record | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 每次复盘拿到真实数字时用(成效流水只增不改不删,生命周期跟随核算岗位,不设作废动作)。例:「本月问答 1200 次,准确率 92%」。边界:只录实测值,推断数据不得录入 |
| 推进到下一阶段 | advance_phase | fde_phase | FDE 项目执行角色 | 项目FDE本人 | 部门领导审批(FDE中心负责人) | 出关检查通过后把阶段推入下一段时用。例:「阶段2 退出门槛达成,推进到阶段3」。边界:不再依赖门禁评审记录;出关时一并落 exit_met / exit_gap(exit_gap 逐条对应 entry_gate 且标来源) |
| 标记阶段被卡 | block_phase | fde_phase | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 阶段因外部依赖/资源/决策卡住时用。例:「阶段3 卡在客户接口授权」。边界:须 in_progress 或 passed 前的进行中状态 |
| 解除阶段卡点 | unblock_phase | fde_phase | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 卡点解除、阶段恢复推进时用。例:「客户接口开了,阶段3 复工」。边界:须 blocked |
| 作废阶段 | discard_phase | fde_phase | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 阶段建错(挂错项目/序号重复)时用。例:「阶段4 建错了,作废」。边界:仅限建错;已有门禁评审记录的不作废,走纠错流程 |
| 终止项目 | terminate_project | fde_project | FDE 项目执行角色 | 项目FDE本人 | 项目负责人审批 | 项目确认不做了(非验收完结)时用。例:「客户砍了预算,项目终止」。边界:终态不可逆;由负责FDE的直属上级审批 |
| 恢复项目 | resume_project | fde_project | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 暂停的项目恢复推进时用。例:「预算批了,项目复工」。边界:仅 paused 可恢复 |
| 暂停项目 | pause_project | fde_project | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 项目暂缓推进时用。例:「客户预算调整,项目暂停」。边界:须 active;恢复走 resume |
| 登记项目 | create_project | fde_project | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 立项时用。例:「XX 集团的落地项目立项了」。边界:customer_code 须已存在;编号按格式生成 |
| 关闭项目 | close_project | fde_project | FDE 项目执行角色 | 项目FDE本人 | 项目负责人审批 | 项目验收完结、不再推进时用。例:「一期验收完了,关项目」。边界:验收完成才可关闭;由负责FDE的直属上级审批 |
| 删除项目 | delete_project | fde_project | FDE 项目执行角色 | 项目FDE本人 | 项目负责人审批 | 建错需要清除时用(高危不可逆,慎重)。例:「FP-2026-001 建错了,删掉」。边界:仅限建错且无有效关联记录;由负责FDE的直属上级审批 |
| 确认方案 | confirm_plan | fde_ontology_plan | FDE 项目执行角色 | 项目FDE本人 | 部门领导审批(FDE中心负责人) | FDE 确认一版方案时用。例:「V4 我确认了,可以拿去建」。边界:草稿状态才能确认;确认后方案状态置 confirmed |
| 标记方案已落地 | mark_plan_applied | fde_ontology_plan | FDE 项目执行角色 | 项目FDE本人 | 部门领导审批(FDE中心负责人) | 按方案在平台建完并冒烟通过后用。例:「V4 的对象全建完了,标记落地」。边界:必须已 confirmed;确认后置 applied,同时旧版置 superseded |
| 登记平台变更 | register_platform_change | fde_platform_change | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 每次对客户平台写操作前后登记留痕用。例:「按 V4 变更集建 3 个对象,逐条登记」。边界:不可逆操作必须已有 FDE 书面确认才可登记为 planned |
| 标记变更已执行 | mark_change_done | fde_platform_change | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 写操作成功返回后用。例:「对象建好了,code=0,id=88」。边界:必须带真实返回码与主键,事后能对账 |
| 标记变更已回滚 | mark_change_rolled_back | fde_platform_change | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 执行回滚操作成功后用。例:「误建的对象已删,回滚完成」。边界:必须按 rollback_way 执行;irreversible 无回滚,不走此动作。本对象生命周期跟随方案与审计要求,不设作废动作 |
| 登记客户 | register_customer | fde_customer | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 出现新的意向合作甲方时用。例:「XX 集团签了合作意向,建档」。边界:只收已签合作意向的单位;customer_code 按格式生成 |
| 暂停合作 | pause_cooperation | fde_customer | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 客户暂缓合作(预算/组织调整)时用。例:「XX 集团今年预算冻结,暂停」。边界:须 active;暂停不删历史项目数据 |
| 结束合作 | close_cooperation | fde_customer | FDE 项目执行角色 | 项目FDE本人 | 部门领导审批(FDE中心负责人) | 合作终止时用。例:「XX 集团合同期满不再续」。边界:终态不可逆;须无未闭环项目;由部门领导审批 |
| 上架数字员工 | launch_employee | fde_digital_employee | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 数字员工构建完成、正式上岗时用。例:「舆情秘书建好了,上岗」。边界:须 role_scope 已填、至少 1 个 confirmed 工作项 |
| 登记数字员工岗位 | register_employee | fde_digital_employee | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 立项交付方案确定要建一个数字员工时登记岗位。例:「这个项目要上一个舆情秘书,登记」。边界:编号按格式生成;挂客户 |
| 扩展职责 | expand_employee | fde_digital_employee | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 给在岗数字员工加新工作项时用。例:「舆情秘书加一条周报工作项」。边界:须 running |
| 退役数字员工 | retire_employee | fde_digital_employee | FDE 项目执行角色 | 项目FDE本人 | 部门领导审批(FDE中心负责人) | 数字员工停用退出时用。例:「客户项目结束,舆情秘书退役」。边界:终态不可逆;须无 running 工作项;由部门领导审批 |
| 登记交付物 | register_deliverable | fde_deliverable | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 阶段产出一份交付物时登记。例:「阶段2 的《业务规划书》出了」。边界:挂阶段,编号按格式生成 |
| 标记交付完成 | mark_deliverable_sent | fde_deliverable | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 交付物实际交给客户/归档时用。例:《业务规划书》客户已签收。边界:须有真实交付动作 |
| 作废交付物 | cancel_deliverable | fde_deliverable | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 交付物版本作废/发错版本时用。例:「发错的 r2 版作废」。边界:已交付(delivered_date 已填)的不作废,另发修正版 |
| 提议工作项 | propose_workitem | fde_work_item | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 发现一类数字员工该干的活时登记提议。例:「客户周报该让舆情秘书干,提议一条」。边界:只登记不启动 |
| 启动工作项 | activate_workitem | fde_work_item | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 数字员工正式开始干这条活时用(提议即确认,合并 confirmed 环节)。例:「周报工作项客户认了,开跑」。边界:须 proposed;岗位须 running |
| 修改工作项 | update_workitem | fde_work_item | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 改频次/触发方式/难度等业务关键值时用。例:「周报改月报」。边界:retired 的不可改 |
| 停用工作项 | retire_workitem | fde_work_item | FDE 项目执行角色 | 项目FDE本人 | 无需审批 | 这条活不再需要时用。例:「客户不再要周报,停用」。边界:终态不可逆;停用后岗位可退役 |
13 字典速查(22 个)
数据源:落库清单 V5.0
| 字典 code | 取值=标签(清单原样) |
|---|---|
dic_customer_coop | active=合作中; paused=暂停; ended=已结束 |
dic_six_phase | phase1=组织诊断; phase2=业务规划; phase3=数字员工构建; phase4=数字员工上岗; phase5=全面运行; phase6=沉淀 |
dic_project_status | active=进行中; paused=暂停; closed=已关闭; aborted=不做了 |
dic_phase_status | in_progress=进行中; passed=门禁通过; blocked=被卡 |
dic_employee_status | building=构建中; running=运行中; expanding=扩展职责中; retired=已退役 |
dic_dept_type | fde=FDE中心; sales=销售; delivery=交付; support=职能 |
dic_req_status | open=待评审; confirmed=已确认; merged=已合并; dropped=已放弃 |
dic_priority | high=高; mid=中; low=低 |
dic_evidence_status | pending=待取证; verified=取证完成; rejected=不可采信 |
dic_mount_type | requirement=挂需求; project=挂项目; both=两者都挂 |
dic_dep_status | blocking=阻塞中; resolved=已解除 |
dic_deliverable_type | report=报告; doc=文档; config=配置; training=培训; briefing=汇报 |
dic_issue_status | open=未处理; resolved=已解决; escalated=已升级 |
dic_plan_status | draft=草稿; confirmed=已确认; applied=已落地; superseded=已被取代 |
dic_op_type | create_object=建对象; add_property=加属性; update_property=改属性; create_link=建关系; create_action=建动作; set_perm=设权限; delete_object=删对象 |
dic_rollback_way | revert=改回旧值; delete=可删; disable=停用; migrate=加新列迁移; irreversible=不可逆须书面确认 |
dic_change_status | planned=待执行; done=已执行; rolled_back=已回滚; failed=失败 |
dic_trigger_type | schedule=定时触发; event=事件触发; manual=人工发起 |
dic_frequency | daily=每日; weekly=每周; monthly=每月; ondemand=按需 |
dic_difficulty | low=规则明确; mid=需判断; high=需人工复核 |
dic_data_level | level1=接口直读(L1); level2=导出文件(L2); level3=人工补录(L3); level4=数据不存在(L4) |
dic_workitem_status | proposed=提议; confirmed=已确认; running=运行中; retired=已停用 |
14 术语表
| 术语 | 意思 |
|---|---|
| 本体/对象 | 组织里一类被记录被询问的事物(≈表) |
| 属性 | 对象的信息字段(≈列) |
| 关系 | 对象间连接(≈外键),必须单列挂钩 |
| 动作 | 对对象可执行的操作(≈函数),须过四格 |
| entry_gate / exit_met / exit_gap | 退出门槛 / 是否达成 / 差距明细(机密) |
| 机检 T1–T14 | 交付前自动校验规则,ERROR=0 才许交付 |
| 归属套 | 管理本体(我们平台)vs 客户业务本体(客户平台) |
| source_tag | 对象溯源标记:哪个方案版本哪天谁建的 |
| dry-run | 平台写操作先演练不落库 |
| 四项比对 | 标题数=表实数=机检 COUNT=正文数字,全等才发布 |
| 版本三段式 | 结构性变更升主版本;内容修正升次版本;排版升修订号 |
| -draft | 未通过验收的草案后缀,验收通过才占正式版本号 |
15 常见问题
| 问题 | 答 |
|---|---|
| 门禁评审去哪了? | 取消了。出关看证据:advance_phase 时一并落 exit_met/exit_gap。 |
| 为什么只有 14 个对象? | V5.0 删了门禁评审(仪式不产生决策)和建模对象登记(残缺,查已建对象走平台快照)。 |
| 口径到底挂客户还是挂项目? | 主挂项目,customer_code 只是快照列。跨项目继承用 inherit_from_code。 |
| 口径挂需求还是挂项目? | 两列各自可选(mount_requirement_code/mount_project_code),至少填一个。 |
| 项目做不下去了怎么登记? | terminate_project→status=aborted(不做了),区别于验收完结的 closed。 |
| 机检 ERROR=0 是不是就万事大吉? | 不是。格式与完备性过了;业务正确靠 42 条自检+真人复核。 |
| 什么时候升主版本? | 增删对象/关系/动作、改挂靠列、改枚举语义、改必填——结构性变更必须升主版本。 |
| 草案能发给别人看吗? | 能,但文件名带 -draft,⛔ 不许占正式版本号。 |
| 发现技能规则缺一条怎么办? | 只提「建议补哪条」,报家辉批准后才落。 |
| 客户平台已有的对象要重建吗? | 不。先拉快照比对,平台有的不重建。 |
16 验收单(交付前逐项打勾)
| ✓ | 项 |
|---|---|
| ☐ | 五类输入齐,缺项已报「缺什么去哪拿」 |
| ☐ | 机检 T1–T14 跑完,ERROR=0,覆盖数已报 |
| ☐ | ERROR 三分类列清:A 已修 / B 待确认 / C 缺信息 |
| ☐ | 42 条自检逐条过(fde-ontology-checklist) |
| ☐ | 四格完备:每对象创建/改关键字段/状态进+出/作废 |
| ☐ | 真人确认页四块齐(新增对象/权限/机检/变更清单) |
| ☐ | 变更差值代码 diff 得出,非手算 |
| ☐ | xlsx 交付件只含平台真字段 |
| ☐ | 四项数字比对 PASS(标题=实数=COUNT=正文数字) |
| ☐ | 标题=版本行=基线指向上一版,上一版文件还在 |
| ☐ | 被删对象/动作全文出现 0 次 |
| ☐ | 速查块从清单脚本生成+反向提取逐条比对 PASS |
| ☐ | 文件名规范:未验收带 -draft;每版新文件名不覆盖 |
| ☐ | 平台变更已登记(含 rollback_way),dry-run 先行 |
| ☐ | 明文链接已贴给验收人 |
FDE 本体建模操作手册 v1.2-draft2 | 数据口径:建模方案 V5.0(14/105/21/45/22/14,数据源:落库清单 V5.0)| 技能清单见第 9 节(17 个)| 生成日期 2026-11-03