bkn-map

# 属性映射 公约：`../_shared/contract.md` | 映射规则：`references/mapping-rules.md` ## 做什么 给定已绑定对象和视图字段 schema，为每个属性确定映射状态，计算覆盖率，判定是否放行。 ## 输入 - `binding_decision_list`：`bkn-bind` 的输出（仅处理 bound 对象） - `relation_binding_result`：`bkn-relation-bind` 的输出（仅处理 confirmed 关系） - `object_draft_list`：对象清单（含属性） - `resource_schema_map`：已绑定资源的 property schema + 外键信息 ## 流程 ### 对象属性映射 1. **属性回灌**：以原始文本 + 绑定视图字段为输入，重建属性候选 - 分层标注：`core_business`（原始文本存在）/ `view_derived`（仅视图中有）/ `technical_excluded`（纯技术字段） - 输出差异动作：keep / add / rename / merge / drop_candidate - **属性名对齐**：若 draft 阶段使用的属性名与视图字段名不一致，执行 rename 操作，将 draft 属性名改为视图实际字段名 - 无已绑定视图时输出空差异，标注原因 2. **映射判定**：每个属性三态之一 - `mapped`：有明确字段来源、语义一致、类型兼容 - `waived`：有依据的豁免（非必填/业务确认暂不绑定） - `blocked`：无可接受字段/类型冲突/多候选无法裁决 3. **覆盖率**：`coverage = (mapped + waived) / total` 4. **质量评定**： - `blocked_count = 0 AND coverage = 100%` → `mapping_quality: full` - `blocked_count = 0 AND coverage >= 80%` → `mapping_quality: partial`（有豁免项） - `blocked_count > 0 OR coverage < 80%` → `mapping_quality: needs_work` `mapping_quality` 作为评分输入传给 `bkn-review`，不单独阻断 pipeline。Pipeline 放行权由 `bkn-review` 的综合评分决定。 `mapping_quality` 非 `full` 时提供互斥策略： - **A（BKN 优先）**：补映射后重跑 - **B（视图优先）**：按视图重构属性后重跑 - **C（混合治理）**：高价值差异增补，其余豁免 详细规则见 `references/mapping-rules.md` ### 间接关系 Resource Property 映射（新增） 仅处理 `relation_binding_result.indirect_relations` 中 `status: confirmed` 的关系： 1. **Source Mapping 映射**： - 输入：`source_mapping_rules`（起点属性 → 中间视图字段） - 验证：起点属性存在于起点对象的 Data Properties - 验证：中间视图字段存在于中间视图 schema - 映射状态：mapped / blocked 2. **Target Mapping 映射**： - 输入：`target_mapping_rules`（中间视图字段 → 终点属性） - 验证：中间视图字段存在于中间视图 schema - 验证：终点属性存在于终点对象的 Data Properties - 映射状态：mapped / blocked 3. **关系映射质量评定**： - 所有 Source/Target Mapping 都 mapped → `relation_mapping_quality: full` - 有 blocked → `relation_mapping_quality: partial` **跳过条件**： - `relation_binding_result` 为空或不存在 - 无 `confirmed` 的 indirect 类型关系 ## 输出 ```yaml property_regen_summary: {keep, add, rename, merge, drop_candidate} property_mapping_draft: - object_name: "" mapped_count: 0 waived_count: 0 blocked_count: 0 coverage: 0.0 rows: [{property_name, status, resource_id, property_path, confidence, reason}] mapping_gate_summary: {coverage, blocked_count, mapping_quality, recommended_strategy} # 新增：关系类映射结果 relation_mapping_draft: - 关系ID: "" 关系名称: "" 关系类型: direct | indirect backing_resource_id: "" # 仅 indirect 类型 source_mapping: - source_property: "" resource_property: "" status: mapped | blocked reason: "" target_mapping: - resource_property: "" target_property: "" status: mapped | blocked reason: "" relation_mapping_quality: full | partial | skipped relation_mapping_summary: total_relations: 0 mapped_relations: 0 blocked_relations: 0 skipped_relations: 0 # pending 关系，跳过映射 ``` ## 约束 - 属性回灌不可跳过，即使绑定率已达标 - 不将"猜测"标为 mapped - 不将"暂无字段"标为 waived（waived 是有依据的豁免） - coverage 必须可追溯到逐属性证据 - 本 skill 执行完成后，pipeline 负责将 `map_completed: true` 写入 `pipeline_state.yaml`，本 skill 不直接写入该文件