ODIN · data dictionary

数据字典 — caseFormV0

注册库病例的全部字段：类型、必填性、取值。来源为 @dentum/registry 模式，表格在构建时自动生成。

字段	类型	必填	取值/范围	说明
`study_uuid`	`uuid`	服务端		由服务端签发
`consent_scopes`	`enum[]`	是	model_training \| external_research \| commercial_use
`consent_confirmed`	`bool`	是		“无同意即无记录”
`age`	`int`	是	18–100
`sex`	`enum`	是	m \| f
`smoking`	`enum`	是	no \| former \| current
`diabetes`	`enum`	是	no \| type1 \| type2
`hygiene`	`enum`	否	good \| fair \| poor
`tooth_fdi`	`int`	是	11–48	见下方 FDI 说明
`bone_type`	`enum`	否	1 \| 2 \| 3 \| 4
`implant_system`	`string`	是	–60	品牌——最强单一预测因子
`implant_length_mm`	`num`	否	4–20
`implant_diameter_mm`	`num`	否	2–8
`immediate_placement`	`bool`	否
`augmentation`	`bool`	否
`surgeon_experience_years`	`int`	否	0–40
`prosthetics`	`enum`	否	single_crown \| bridge \| overdenture \| full_arch
`outcome`	`enum`	否	success \| periimplantitis \| failure
`marginal_bone_loss_mm`	`num`	否	0–15
`outcome_date`	`date`	否
`failure_reason`	`string`	否	–200

字段名即 API 名（不翻译）。结局字段基线为空，于 6/12 个月随访填写。

FDI

牙位编号 — FDI/ISO-3950：两位数字，第一位为象限（1–4），第二位为牙位（1–8）。如 36 = 左下第一磨牙。

success — 种植体行使功能，无临床主诉

periimplantitis — 炎症伴骨吸收征象

failure — 种植体已取出或未骨结合

model_training — 模型训练

external_research — 外部研究（T1/T2）

commercial_use — 商业用途