4. 模型文档体系
一、核心原理：模型文档不是“说明书”，而是风险治理的证据链
在PD、LGD、EAD模型中，文档体系承担的不是简单记录功能，而是把“模型为什么可信”转化为可验证、可追溯、可问责的证据链。监管检查时，检查人员通常不会直接重跑模型，而是先看文档：模型目标是否清晰、数据来源是否合规、假设是否合理、验证是否独立、上线后监控是否闭环。文档质量直接决定模型能否通过内部审计与外部监管。
从风险治理视角看，模型文档至少服务四类对象：开发者用于交接与复现；独立验证者用于判断模型是否达到使用标准；审批者用于决策是否批准上线；监管与审计用于确认银行是否具备模型风险管理的制度能力。因此，文档不是一次性交付物，而是贯穿模型全生命周期的“活文件”。
核心原则：任何模型结论都必须能追溯到数据、代码、参数、假设、验证结论和审批记录。文档缺失，等同于模型不可验证；模型不可验证，等同于不可用。
二、监管期望：从“有文档”到“文档可审计”
监管对模型文档的期望通常集中在五个方面：完整性、准确性、可追溯性、独立性和时效性。完整性要求覆盖模型开发、验证、审批、上线、监控、变更和退役；准确性要求文档与实际运行版本一致；可追溯性要求每个关键参数和结论都有来源；独立性要求验证文档由独立于开发团队的岗位出具；时效性要求模型变更后文档同步更新。
以《商业银行模型风险管理指引》及巴塞尔协议相关要求为参照，监管通常关注以下问题：模型文档是否明确模型边界与局限性？是否记录数据清洗规则与样本选择偏差？是否披露专家判断与定性调整？是否保留验证发现及整改闭环？是否记录审批意见与条件？这些问题若无法回答，模型即使技术指标优秀，也可能被认定为“高风险”。
| 监管关注维度 | 典型检查点 | 常见缺陷 |
|---|---|---|
| 完整性 | 开发、验证、审批、监控文档齐全 | 缺少监控方案或退役记录 |
| 准确性 | 文档版本与生产版本一致 | 参数已调整但文档未更新 |
| 可追溯性 | 数据源、代码、假设可回溯 | 手工调整无记录 |
| 独立性 | 验证报告由独立团队签署 | 开发人员自验自签 |
| 时效性 | 变更后文档同步更新 | 版本混乱、审批滞后 |
三、方法流程：文档结构、版本管理、审批与审计追踪
一套可落地的模型文档体系，通常采用“主文档+附件+记录”的三层结构。主文档描述模型方法论与核心假设；附件包括数据字典、代码清单、验证报告、监控报表；记录包括审批单、变更日志、会议纪要和审计发现。三层结构既保证可读性，又保证可审计性。
1. 文档结构建议
- 模型概述：模型名称、编号、版本、业务用途、适用范围、模型类型（PD/LGD/EAD）。
- 方法论：建模方法、变量选择、样本定义、时间窗口、违约定义、回收率定义。
- 数据与假设：数据来源、清洗规则、缺失值处理、异常值处理、专家判断记录。
- 开发与校准：训练集与测试集划分、参数估计、校准方法、性能指标。
- 验证结论：独立验证范围、测试结果、局限性、整改建议。
- 上线与监控：上线条件、监控指标、阈值、触发机制、回退方案。
- 变更与退役：变更原因、影响评估、审批记录、退役条件。
2. 版本管理与审批流程
版本管理应遵循“一模型一版本树”原则，禁止用文件名区分版本。推荐使用语义化版本：主版本号表示方法论重大变更，次版本号表示参数或数据更新，修订号表示文字修正。每次变更必须关联变更单，记录变更人、审批人、生效日期和影响范围。
模型编号：PD-RETAIL-001
版本：v2.3.1
变更类型：参数校准更新
变更原因：2024年Q4违约率上升，重新校准中心趋势
影响范围：PD评分卡、风险等级映射、拨备计算
审批记录：模型风险管理委员会 2025-01-15 批准
生效日期：2025-02-01
回退方案：若监控指标连续两月超阈值，回退至v2.2.0
审批流程通常分为四道关口：开发团队自检、独立验证、模型风险管理委员会审批、上线前IT与业务确认。每道关口都应在系统中留痕，形成不可篡改的审计追踪。审计追踪至少包含：谁、在何时、对哪个版本、做了什么操作、依据什么、结果如何。
实战建议：把审批流嵌入模型管理平台，而不是依赖邮件和共享文件夹。平台应自动记录版本、审批意见、附件哈希值和操作日志，减少人工整理成本。
四、案例/场景与误区复盘
场景：某银行零售PD模型在2024年上线后，因宏观经济变化导致违约率上升，业务部门要求紧急调整评分卡截断点。开发团队直接修改了参数并重新上线，但未更新文档，也未提交独立验证。三个月后监管检查发现：生产版本与文档版本不一致，变更无审批记录，监控指标未触发预警。最终该模型被要求暂停使用并重新验证。
复盘：问题不在技术，而在文档与治理流程脱节。若当时执行“变更即文档、文档即审批、审批即留痕”，风险可控。具体改进包括：建立变更影响评估模板；强制独立验证对参数调整出具意见；监控阈值与回退方案写入主文档；审计追踪自动记录所有操作。
常见误区：①把文档当成一次性交付，上线后不再维护；②用开发文档替代验证文档，失去独立性；③版本靠文件名区分，导致生产与文档不一致；④审批只留邮件，无法形成审计追踪；⑤监控方案缺失，模型失效后无回退依据。
综上，模型文档体系的本质是模型风险治理的基础设施。它把技术工作转化为可审计的组织能力，使PD、LGD、EAD模型在监管、审计和业务使用中具备可持续的可信度。文档不是负担，而是模型价值的放大器。