bkn-map

name	bkn-map
description	属性到字段映射 + 覆盖率计算 + 完备性放行。

属性映射

公约：../_shared/contract.md | 映射规则：references/mapping-rules.md

做什么

给定已绑定对象和视图字段 schema，为每个属性确定映射状态，计算覆盖率，判定是否放行。

输入

• binding_decision_list：bkn-bind 的输出（仅处理 bound 对象）
• relation_binding_result：bkn-relation-bind 的输出（仅处理 confirmed 关系）
• object_draft_list：对象清单（含属性）
• view_schema_map：已绑定视图的字段 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

关系类 View Property 映射（新增）

仅处理 relation_binding_result.data_view_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 的 data_view 类型关系

输出

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, view_id, field_path, confidence, reason}]
mapping_gate_summary: {coverage, blocked_count, mapping_quality, recommended_strategy}

# 新增：关系类映射结果
relation_mapping_draft:
  - 关系ID: ""
    关系名称: ""
    关系类型: direct | data_view
    intermediate_view_id: ""      # 仅 data_view 类型
    source_mapping:
      - source_property: ""
        view_property: ""
        status: mapped | blocked
        reason: ""
    target_mapping:
      - view_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 不直接写入该文件