/legal-visualization

法律视觉常量

本文件沉淀 Legal Visualization 的页面、字体、布局和通用线条常量。角色、主题、事实状态、强调、密度与形状 token 的机器可读真相源是 config/visual-role-registry.json，不得在本文件或其他脚本重复维护另一套枚举与主题色。

设计原则

• 一图一观点：每张图服务一个核心观点。节点颜色、线型、强调色必须服务该观点。
• 颜色含义优先：所有颜色都是语义符号，不是装饰。同主体同色，同状态同型，争议/风险用强调色，缺失用灰色。
• 强调色不超 3 个：主色 + 决策橙 + 争议/缺失红灰。本文件只定义 4 个色板值。

页面与画布

page:
  paper: A4
  orientation: portrait
  margin_cm: { top: 2.54, bottom: 2.54, left: 3.18, right: 3.18 }
  usable_width_cm: 14.64
  dpi: 260
  grid_unit_px: 10
  origin: { x: 60, y: 80 }
  grid_step: 60

• 节点坐标从 x=60, y=80 开始画，避免 SVG viewBox 偏移（与 xml-reference.md 行 155 一致）。
• 自由布局的同坐标空间 sibling 节点建议保留至少 60px 水平/垂直间距；表格单元格、泳道分栏和模板声明的紧凑 slot 可以边界相接，但不得正面积相交。
• 容器必须使用真实 parent 关系，或在扁平背景框上声明 container=1；不能仅凭颜色或大矩形外观推断容器语义。

字体

font:
  family: "Microsoft YaHei, SimHei, PingFang SC, sans-serif"
  size_title_pt: 24       # 图表主标题
  size_subtitle_pt: 14    # 副标题、结论栏
  size_node_pt: 14        # 节点正文
  size_caption_pt: 12     # 注释、证据编号
  size_legend_pt: 10      # 图例、技术标注
  weight_bold: 1          # drawio fontStyle: 1=粗体, 2=斜体, 4=下划线

调色板

palette:
  primary:        "#1f77b4"  # 主色：同主体、合同主线、确认事实
  primary_light:  "#E3F2FD"  # 主色浅底：节点填充
  accent_decision: "#FF8C00"  # 强调-决策：菱形/判断节点
  accent_decision_light: "#FFF3E0"
  accent_dispute: "#C0392B"  # 强调-争议：争议事实、违约、风险
  accent_dispute_light: "#FDECEA"
  grey_missing:   "#9E9E9E"  # 缺失/待补充/未提及
  grey_missing_light: "#F5F5F5"
  line_solid:     "#333333"  # 已证关系实线
  line_dashed:    "#666666"  # 主张/推定虚线
  line_dotted:    "#9E9E9E"  # 推定/待证点线
  text_primary:   "#1a1a2e"  # 主文字色
  text_caption:   "#757575"  # 注释/小字色
  frame:          "#BDBDBD"  # 容器/泳道边框
  frame_bg:       "#F5F5F5"  # 容器/泳道底色

线型与状态绑定

relations.status 与线型/颜色必须严格对应（具体可执行值以视觉注册表为准）：

节点样式映射

节点视觉的权威映射见 config/visual-role-registry.json，组合方法见 references/shape-registry.md。形状收敛为统一圆角矩形（菱形仅决策点，容器保留既有形状）。下表只说明语义类别，不作为主题色或默认状态的第二真相源。

当事人角色不提供默认线型或默认强调：被告不自动虚线，原告不自动粗边。事实状态用 epistemic_status，阅读重点用 emphasis 显式声明。

节点尺寸参考

以下尺寸用于自由布局的初始估算；表格、泳道和锁定模板按各自 slot 容量执行：

文本容量由 scripts/validate_drawio.py 统一预检：全角/CJK 字符按 1.0 显示单位、半角字母数字按 0.56、标点按 0.5、空格按 0.35；显示单位乘 fontSize 后再计入 padding。whiteSpace=wrap 时按可用宽度估算换行行数和 1.2 × fontSize 行高；确定溢出阻断，临界容量告警。该估算不替代最终 PNG/SVG 目视检查。

edge 标签超过 8 显示单位进入人工复核，超过 14 显示单位阻断；长说明移到独立文本节点、侧栏或图例。

复用入口

• references/output-workflow.md：draw.io 生成规则引用本文件代替硬编码。
• references/quality-checklist.md：颜色含义检查引用本文件。
• references/vizspec-schema.md：关系状态样式引用本文件。
• references/xml-reference.md：节点样式属性引用本文件。
• scripts/validate_drawio.py：不校验颜色语义；校验 XML 结构、parent/容器关系、节点几何重叠、文本容量和 edge 标签风险。
• scripts/normalize_naming.py：引用本文件 + naming-conventions.md。

修改记录