Semantica合规实战：FDA 21 CFR Part 11与ICH E6 GCP落地的7步指南

Semantica合规实战：FDA 21 CFR Part 11与ICH E6 GCP落地的7步指南

【免费下载链接】semanticaGraph-Native Infrastructure for Context and Accountable AI Systems项目地址: https://gitcode.com/GitHub_Trending/sema/semantica

Semantica是一个面向受监管行业的图原生 AI 基础设施，核心能力是数据溯源（Provenance）、决策审计、合规导出：为每一条知识记录生成 W3C PROV-O 溯源链和 SHA-256 防篡改校验，帮助医药、金融团队把 FDA 21 CFR Part 11 电子记录要求和 ICH E6(R2) GCP 审计跟踪（Audit Trail）要求真正落地，而不只是一句承诺。

合规审查时，监管方最常问的三个问题是："这个数据从哪来？""谁在什么时候改过它？""有没有被篡改？"Semantica 的每个模块都恰好为这三个问题提供了可验证的答案。下面按 7 个步骤拆解落地路径。

一、数据溯源：给每条记录签发"电子身份证"

21 CFR Part 11 要求电子记录包含可识别的操作者、时间戳和完整性保障。Semantica 的ProvenanceManager为每个实体、关系和属性值记录 W3C PROV-O 合规条目：来源文档、时间戳、执行者（agent_id）、活动（activity_id），并自动计算 SHA-256 校验和用于防篡改验证。

关键机制：

• 版本链（Version Chaining）：同一实体被再次更新时，旧记录自动归档，新记录通过parent_entity_id链接旧版本，形成完整的"数据链式保管记录"
• 多源归因：track_property_source()可分别记录同一属性在不同来源下的取值与置信度，当审计方追问"这个值从哪来"时，可精确到来源文档、章节和置信分数
• 完整性验证：verify_checksum()重算哈希比对，任何写入后的修改都会被标记为TAMPERED，满足 11.10(e) 对防篡改审计的要求

生产环境务必传入storage_path（如provenance.db），以 SQLite 持久化溯源记录，支持审计人员直接查询。

📎 源码与文档：semantica/provenance/manager.py、semantica/provenance/integrity.py、docs/guides/provenance.md

二、变更管理：图级快照即"合规电子记录"

ICH E6 GCP 要求临床试验中的任何记录变更可追溯、可回溯。Semantica 的TemporalVersionManager提供整图快照能力，每个快照都包含author、timestamp、checksum三个字段——这正是合规电子记录所需的三要素。

典型合规工作流：

1. Snapshot：批量入库或提交监管前，对知识图谱打一个命名快照
2. Diff：任意两个版本间生成结构化差异报告（新增/删除/修改的节点与边）
3. Verify：SHA-256 校验确认数据未被篡改
4. Tag：打上人类可读标签（如approved、submitted_2024Q4）
5. Rollback：发现错误数据时一键回滚

get_node_history()还能查询单个实体（如某患者、某受试者）的全部变更历史，每条变更记录都带时间戳、操作类型和版本标签。

📎 源码与文档：semantica/change_management/managers.py、docs/reference/change_management.md

三、决策审计：让"AI 为什么这么做"可解释

在临床场景下，这是 GCP 审计的核心。Semantica 的ContextGraph把每个 AI 决策变成一等公民：记录类别、场景、推理依据、结果和置信度，并支持因果链追踪。

以药物相互作用检查为例（官方文档中的标准配方）：

d1 = graph.record_decision( category="drug_interaction_check", scenario="患者 P-4821: 华法林 + 胺碘酮联用", reasoning="胺碘酮增强华法林抗凝作用", outcome="flag_for_review", confidence=0.91, ) graph.add_causal_relationship(d1, d2, relationship_type="CAUSED") chain = graph.trace_decision_chain(d1) # 完整因果溯源

审计时一条trace_decision_chain()就能给出"这个剂量调整决策由哪个上游检查触发、依据什么规则"的完整答案——这正是 GCP 偏差调查（Deviation Investigation）需要的证据链。

📎 源码与文档：semantica/context/context_graph.py、semantica/context/decision_recorder.py

四、策略引擎：把 GCP 规则写成可执行的治理门禁

ICH E6 强调基于风险的管控。Semantica 的PolicyEngine把治理规则版本化存储为图节点，在运行时对每个决策做合规检查，返回True/False供工作流路由：

• 置信度规则：低于阈值（如 0.85）的决策自动升级人工复核
• 结果白名单：仅允许特定结果类别放行
• 多级审批：违规决策进入带完整审批链的例外流程，批准人与理由永久记录

规则版本历史 + 例外记录 + 检查轨迹，共同构成监管可查的治理证据。

📎 源码与文档：semantica/context/policy_engine.py、docs/guides/policy-engine.md

五、SHACL 数据质量门禁：协议数据入库前的最后一道闸

试验数据（方案、实验室结果、受试者信息）入库前，结构错误就是合规风险。Semantica 的 SHACL 验证流程：

1. 从领域本体（OWL）自动生成 SHACL 约束形状
2. 对知识图谱执行验证
3. 输出结构化违规报告：缺失必填属性、数据类型错误、基数超限

例如"每个受试者必须有唯一 ID、访视日期不得晚于入组日期"这类规则，都可以声明为Violation级形状，在分析或导出前拦截脏数据。

📎 源码与文档：semantica/ontology/ontology_validator.py、docs/guides/shacl-validation.md

六、冲突检测：多源数据的"差异裁决记录"

GCP 数据管理常面临多来源冲突（不同系统对同一访视记录给出不同值）。Semantica 的冲突模块不做静默覆盖：检测到矛盾后标记、比较来源可信度/新鲜度/置信度，再按策略裁决，且裁决过程本身可溯源——与 Provenance 模块联动，能完整回答"为什么采信了 A 源而不是 B 源"。

📎 源码与文档：semantica/conflicts/conflict_resolver.py、docs/guides/conflict-resolution.md

七、合规导出：一键生成监管可用的交付物

审计与申报的最终形态是文件。Semantica 的导出模块支持把含溯源的知识图谱导出为：

典型做法：把决策链 + 实体溯源 + 版本快照打包为audit_trail.ttl提交，监管方拿到的是一份可机器验证、可重放校验链的完整审计包。

📎 源码与文档：semantica/export/rdf_exporter.py、docs/guides/export.md

落地建议：最小合规配置清单

给刚起步团队的 4 条实用建议：

1. 溯源库用 SQLite 持久化（ProvenanceManager(storage_path="provenance.db")），审计人员可用标准数据库工具直接查询
2. 每次批量入库前后各打一次快照，形成"入库前基线 + 入库后验证"的链式保管证据
3. 把关键治理规则写进 PolicyEngine并版本化管理，避免"规则改了没人知道"
4. 导出固定为 RDF + CSV 双格式，一份给监管系统、一份给审计方人工复核

整体架构和各模块的选型对照可参考 docs/choose-your-module.md，合规基础设施的完整能力介绍见 docs/getting-started.md。

小结

Semantica 的合规价值不在某个"合规功能"，而在于它的结构性设计：溯源不是附加项，而是数据有结构之后自然产生的能力。7 个步骤串起来就是一条完整证据链——来源可查（Provenance）、变更可溯（Change Management）、决策可解释（Context Graph）、规则可执行（Policy Engine）、数据可信（SHACL）、冲突可裁决（Conflicts）、交付可验证（Export）。对需要同时满足 FDA 21 CFR Part 11 与 ICH E6 GCP 的团队来说，这条链就是你面对审计时的全部答案。

【免费下载链接】semanticaGraph-Native Infrastructure for Context and Accountable AI Systems项目地址: https://gitcode.com/GitHub_Trending/sema/semantica