"""T06-a 方案维度解析测试：AC-29 / AC-44。 维度是 Skills/Rules 的元数据，不新增"维度卡"（14 §5）。本文件锁定三件事： - 同 ID 不同定义必须拒绝合并（不让模型或程序临时挑一个） - 相同定义只出现一次，引用被合并而不是重复计数 - 呈现判定覆盖 0 / 2 / 6 / 9 维与异刻度，且**不丢失任何维度** """ import unittest from services import review_plan as plan SCALE = "evidence-stage" LEVELS = [ {"value": 0, "label": "未提供", "criterion": "材料未提供"}, {"value": 1, "label": "仅有说明", "criterion": "仅客户经理口头或文字说明"}, {"value": 2, "label": "材料待核", "criterion": "提供了材料但未交叉核对"}, {"value": 3, "label": "交叉核验", "criterion": "两个独立来源一致"}, {"value": 4, "label": "人工复核", "criterion": "评审员已人工核实"}, ] def spec(dimension_id="d1", label="回款依据", order=0, scale_id=SCALE, scale_version="v1", levels=None, required=False, refs=None): return {"id": dimension_id, "label": label, "order": order, "scale_id": scale_id, "scale_version": scale_version, "levels": levels or LEVELS, "component_refs": refs or [], "required": required} def many(count, **over): return [spec(f"d{index}", f"维度{index}", index, **over) for index in range(count)] class DeduplicationTests(unittest.TestCase): def test_identical_definitions_merge_into_one(self): # AC-29：相同定义只出现一次 merged = plan.resolve_dimensions([ spec("d1", refs=[{"id": "skill.a", "version": "1"}]), spec("d1", refs=[{"id": "skill.b", "version": "1"}]), ]) self.assertEqual(len(merged), 1) self.assertEqual(sorted(ref["id"] for ref in merged[0]["component_refs"]), ["skill.a", "skill.b"]) def test_same_id_different_label_is_a_conflict(self): with self.assertRaises(ValueError) as ctx: plan.resolve_dimensions([spec("d1"), spec("d1", label="另一个名字")]) self.assertIn("不一致定义", str(ctx.exception)) self.assertIn("不得由程序或模型临时选择其一", str(ctx.exception)) def test_same_id_different_scale_id_is_a_conflict(self): with self.assertRaises(ValueError): plan.resolve_dimensions([spec("d1"), spec("d1", scale_id="other-scale")]) def test_same_scale_id_different_version_is_a_conflict(self): # 刻度改版后语义可能变化，必须视为不同定义 with self.assertRaises(ValueError): plan.resolve_dimensions([spec("d1"), spec("d1", scale_version="v2")]) def test_same_id_different_levels_is_a_conflict(self): changed = [dict(level) for level in LEVELS] changed[3] = {"value": 3, "label": "两来源一致", "criterion": "改了判据"} with self.assertRaises(ValueError): plan.resolve_dimensions([spec("d1"), spec("d1", levels=changed)]) def test_required_flag_is_unioned_on_merge(self): merged = plan.resolve_dimensions([spec("d1"), spec("d1", required=True)]) self.assertTrue(merged[0]["required"]) def test_order_is_stable_and_sorted(self): merged = plan.resolve_dimensions([spec("db", order=5), spec("da", order=1)]) self.assertEqual([item["id"] for item in merged], ["da", "db"]) def test_invalid_dimension_is_rejected(self): broken = spec() broken["levels"] = [{"value": 0, "label": "只有一个层级", "criterion": "c"}] with self.assertRaises(ValueError) as ctx: plan.resolve_dimensions([broken]) self.assertIn("维度不合法", str(ctx.exception)) class PresentationTests(unittest.TestCase): def check(self, dimensions, hard=()): result = plan.presentation(dimensions, hard) plan.assert_nothing_dropped(result, dimensions) # 不丢项是每次都要过的硬断言 return result def test_empty_plan_says_so_without_placeholder_axes(self): # UI Spec：空维度显示"尚未配置"，不补六轴占位 result = self.check([]) self.assertEqual(result["layout"], "empty") self.assertIn("尚未配置核查维度", result["reason"]) def test_two_dimensions_use_list_not_radar(self): result = self.check(many(2)) self.assertEqual(result["layout"], "list") self.assertEqual(result["radar_ids"], []) def test_six_dimensions_use_radar_plus_equivalent_list(self): result = self.check(many(6)) self.assertEqual(result["layout"], "radar") self.assertEqual(len(result["radar_ids"]), 6) self.assertIn("等价文字列表", result["reason"]) def test_nine_dimensions_are_grouped_not_radar(self): result = self.check(many(9)) self.assertEqual(result["layout"], "grouped") self.assertEqual(result["radar_ids"], []) self.assertEqual(len(result["listed_ids"]), 9, "全部维度仍可查看") def test_three_and_eight_are_the_radar_boundaries(self): self.assertEqual(self.check(many(3))["layout"], "radar") self.assertEqual(self.check(many(8))["layout"], "radar") def test_mixed_scales_force_faceted_display(self): # 异刻度不强行归一化 dimensions = [spec("d1"), spec("d2", "负债率", 1, scale_id="ratio-scale")] result = self.check(dimensions) self.assertEqual(result["layout"], "faceted") self.assertEqual(result["radar_ids"], []) def test_hard_blocks_are_listed_separately_and_never_in_the_radar(self): # 14 §5：硬阻断单列，不被平均数或面积覆盖 dimensions = many(6) result = self.check(dimensions, hard={"d0"}) self.assertEqual(result["hard_block_ids"], ["d0"]) self.assertNotIn("d0", result["radar_ids"]) self.assertEqual(len(result["radar_ids"]), 5) self.assertEqual(result["layout"], "radar") def test_hard_blocks_are_separated_even_when_faceted(self): dimensions = [spec("d1"), spec("d2", "负债率", 1, scale_id="ratio-scale")] result = self.check(dimensions, hard={"d1"}) self.assertEqual(result["hard_block_ids"], ["d1"]) self.assertIn("d2", result["listed_ids"]) def test_dropping_a_dimension_would_be_caught(self): # 守卫本身必须真的会报错，否则"不丢项"只是口号 with self.assertRaises(ValueError): plan.assert_nothing_dropped( {"radar_ids": ["d0"], "listed_ids": [], "hard_block_ids": []}, many(2)) def test_unknown_scale_versions_never_share_a_radar(self): dimensions = [spec("d1"), spec("d2", "同刻度不同版本", 1, scale_version="v2")] self.assertEqual(self.check(dimensions)["layout"], "faceted") if __name__ == "__main__": unittest.main()