联系热线






系统概述与运行环境
备忘录核验结论(10 项差异与处理)
七个增强域(功能、实测与截图)
一、多框架披露映射引擎
二、双重重要性评估
三、不可变审计轨迹
四、可重放计算与规则版本化
五、AI 证据核验与漂绿偏差
六、供应商 Scope3 与 PACT 对齐
七、数据质量评分
报表体系与发布版报告(10 张)
界面总览
验收与测试
部署、运维与备份
附录:数据表与 API 清单
本平台是《ESG 系统先进功能增量增强规格文档》的落地实现,定位为披露与鉴证就绪层: 不替换既有碳核算与能碳管理底座,而是通过"扩展实体 + 新增关联实体 + 新增服务"的方式, 把核算结果转化为可对外披露、可被审计师复核的 ESG 数据产品。
Python 3.12 标准库 HTTP 服务 + SQLite(WAL)+ 原生 JS 单页界面;报表用 openpyxl / python-docx。零外部服务依赖。
Windows 10/11,双击 启动ESG平台.bat;便携 Python 已内置,无需安装数据库与依赖包。
35 个数据点、55 条披露项、68 条映射、12 份证据、4 份产品足迹、6 家供应商;覆盖 2024(锁定)与 2025 两个周期。
平台管理员 / 编制人 / 复核人 / 审计只读四角色;编制与复核分离,审计角色只读。
| 账号 | 初始口令 | 角色 | 权限范围 |
|---|---|---|---|
| admin | Admin@2026 | 平台管理员 | 读、写、审批、用户与规则管理 |
| editor | Esg@2026 | ESG 编制人 | 读、写(数据点、映射、证据、计算) |
| reviewer | Review@2026 | 复核人 | 读、审批(人工确认、偏差复核、周期锁定) |
| auditor | Audit@2026 | 审计只读 | 只读;可校验审计链、导出报表 |
逐条比对文档的实体、字段、API 与验收标准后,发现 10 处与现有底座不一致或未定义的地方。 下表给出核验结果与本平台的处理方式;完整分析见《01_备忘录核验与设计说明.md》。
| # | 文档表述 | 核验结果 | 本平台处理 |
|---|---|---|---|
| 1 | 现有指标/数据点表 | 现有底座只有核算结果与活动数据,无独立数据点主数据 | 新增 esg_datapoint + esg_datapoint_value,用 source_ref 绑定碳台账 |
| 2 | 现有报告周期表 | 不存在该表,period 以字符串散落在各表 | 新增 esg_period(年度、边界、锁定状态),作为 7 个域的主键维度 |
| 3 | GRANT 写保护审计链 | SQLite 无列级授权 | 改用 BEFORE UPDATE/DELETE 触发器 RAISE(ABORT),任何连接均无法改删 |
| 4 | PostgreSQL 语法 | 交付机需离线免安装 | 主实现 SQLite(生成列/约束/触发器等价),另附 MySQL 8 与 PostgreSQL 16 脚本 |
| 5 | 披露项主数据 | 文档未给出来源与版本 | 内置 55 条(ESRS 23 / GRI 17 / ISSB 9 / SASB 6),带版本与生效日期 |
| 6 | 报表章节 | 文档只定义表与 API,无报表 | 补齐 9 张报表:覆盖、缺口、重要性、审计、重放、漂绿、Scope3、质量、尽调报告 |
| 7 | AI 定位 | 未定义置信度与可解释性 | 透明规则评分 + 置信度 + 逐条理由 + 入链;结果停留 ai_verified |
| 8 | 多映射冲突 | 未定义同一披露项多映射如何取值 | 取最高覆盖级别,映射有效期与报告期取交集,披露包固定快照 |
| 9 | 规则与因子关系 | 未说明如何支撑重放 | 重放仅用 input_snapshot + rule_version_id,因子来源写入快照 |
| 10 | PACT 启用条件 | 写死仅 api_pact 可用,与 P2 建议矛盾 | manual/portal/api_pact 三档,portal 亦可提交 PCF |
每个域给出设计要点、验收实测与界面截图;所有数字均可在系统内实时复算。
采集一次,映射到所有需要的框架
数据点级多对多映射,一个数据点可同时支撑 ESRS / GRI / ISSB / SASB 的对应披露项。
覆盖级别三档:full 完全满足、partial 部分满足、reference 仅作引用;同一披露项取最高级别。
缺口清单自动列出未达 full 的披露项,按强制披露优先排序。
披露包快照固定当次映射版本(P-2025-01 起),发布后改映射不影响已发布版本。
取 E1-SCOPE1(范围一排放),同时映射 ESRS E1-6、IFRS S2.29(a)、GRI 305-1,三者均为 full。
修改任一映射后,数据点取值保持 11,855.13 不变,接口返回 value_unchanged=true。
两项影响分别评分,不以合并总分替代结论
财务重要性(对企业价值的影响)与影响重要性(对社会与环境的影响)独立评分,各自设阈值。
material性结论由数据库生成列自动判定,应用层与前端均不可直接写入。
已外部审计确认的议题修改阈值,必须填写解锁理由并写入 UNLOCK 审计事件,同时重置外部确认。
矩阵图按 10×10 网格呈现,虚线为阈值,金色为双重重要议题。
评分 3/3 时两项结论均为否;改为 8/3 后财务重要即在同一次事务内变为是。
已确认议题改阈值被拒绝;填写理由后通过,且 verified_external 自动归零。
可编辑的审计日志不构成审计证据
每条记录包含 prev_hash、entry_hash、实体、动作、操作者、时间与变更前后完整快照。
entry_hash = SHA256(prev_hash | occurred_at | actor | action | entity_type | entity_id | before | after)。
数据库触发器拒绝对审计链执行 UPDATE / DELETE;校验动作本身也写入链中,形成自证。
校验按 seq 顺序重算全链,返回第一个断链位置与原因。
数据点更新产生带前后快照的记录;SQL 直接 UPDATE、DELETE 均被数据库拒绝。
全链 360 条逐条重算一致;人为改一条结果值后,重放立即识别不一致。
每个数字都能追溯回输入、规则与审批
规则公式以结构化 JSON 存储,求值器基于 AST 白名单,只允许四则运算与 min/max/abs/round。
结果绑定 rule_version_id、input_snapshot 与 run_id;重放不重新执行业务规则,而是从快照重建。
启用新规则版本不会改变已锁定周期内旧结果的 rule_version_id。
排放因子按来源、版本、适用年份管理,不在代码中硬编码。
4/4 结果重放一致;启用测试版本 v99 后,4 条旧结果绑定保持不变。
把一条结果值加 1.0 后重放,返回 mismatch,差值 1.0。
AI 输出是带置信度的标记信号,不是判决
证据按类型、指纹、议题相关性、有效期与数据点取值一致性评分,输出置信度与逐条理由。
AI 结果停留在 ai_verified / flagged,只有人工确认(human_confirmed)后方可支撑披露。
偏差率与等级由数据库生成列计算:>20% 自动 high,>10% 为 medium。
偏差记录不提供静默关闭;复核只能「接受并说明」或「升级处理」,均须填写说明。
AI 核验后状态为 ai_verified/flagged,未自动通过;偏差 42.86% 自动 high + open。
closed 决策被拒绝;无说明被拒绝;填写说明后标记 reviewed_accepted。
先门户、后 API,状态机不可跳跃
供应商数据交换能力三档:手工采集、门户填报、PACT API;门户与 PACT 均可提交足迹。
数据请求状态机:not_started → pending → requires_approval → complete;逾期由截止日期推导。
驳回必须填写原因,状态退回 pending;审批动作记录复核人与时间。
PACT 报文兼容 3.0.3 字段;五维 DQR 任一缺失即不得进入 verified。
not_started → complete 被拒绝;驳回无原因被拒绝,有原因后退回 pending。
缺 reliability 的足迹状态为 unverified,验证接口拒绝并说明原因。
由采集入口的校验结果驱动,不阻断录入
四维:完整性、一致性、时效性、核验通过率;三套权重方案(默认 / 投资决策 / 合规报送)。
10 个质量标记码,覆盖缺失、波动、滞后、证据未确认与过期等情形。
同一数据点同一周期可多次评分,只追加不覆盖,历史完整保留。
低于 60 分红色显示,并进入驾驶舱「质量待改进」统计。
补录客户满意度后完整性 0 → 100;重复评分评分行 2 → 3。
平均质量分 73.1 分,4 个数据点低于 60 分并给出具体标记。
文档只定义了表与 API,没有报表章节。本平台补齐 10 张报表,其中 8 张 Excel 均含封面、口径页与明细页, 汇总页保留与明细页联动的复核公式;2 张 Word 分别为九章尽调报告与 14 章对外发布版报告。
| 编码 | 名称 | 格式 | 主要内容 |
|---|---|---|---|
| R01 | 多框架披露覆盖矩阵 | XLSX | 覆盖汇总、披露明细、缺口清单、计算口径 |
| R02 | 双重重要性评估矩阵 | XLSX | 评估明细、象限统计、阈值与口径 |
| R03 | 不可变审计轨迹验证报告 | XLSX | 验证结论、记录明细、哈希规则 |
| R04 | 可重放计算一致性报告 | XLSX | 结果明细、输入快照、容差口径 |
| R05 | 漂绿偏差标记台账 | XLSX | 偏差明细、分级规则、复核结论 |
| R06 | Scope3 与 PACT 数据台账 | XLSX | 数据请求、产品足迹、DQR 完整性 |
| R07 | 数据质量评分表 | XLSX | 评分明细、权重方案、标记字典 |
| R08 | ESG 披露综合尽调包 | XLSX | 跨域关键指标汇总 |
| R09 | ESG 披露尽调报告 | DOCX | 九章结构化报告:结论、缺口、建议 |
| R10 | ESG 报告(对外发布版) | DOCX | 14 章发布版:封面/目录/致辞/治理/TCFD/三年数据/索引/鉴证 |
参照头部企业年度 ESG 报告的通用结构,新增 R10 发布版报告(29 页、8 张图表):封面(关键数据卡片)、Word 目录域、 页眉页脚与页码、14 章正文、14 张表、三年数据表、多框架指标索引、鉴证声明页与读者反馈。 章节叙述与目标进展可在「报告编制」页在线维护,数据表与索引由业务库自动装配。
与《2024 阿里巴巴环境、社会和治理(ESG)报告》(186 页)对照,本平台在“数字可审计、可重放”上更强, 在版式设计、案例叙事、第三方鉴证意见与双语发布上仍有差距,详见《01_备忘录核验与设计说明.md》第六章。
| 维度 | 头部企业报告 | 本平台现状 | 判断 |
|---|---|---|---|
| 报告成品 | 186 页,专业设计、信息图 | 14 章 / 25 页 Word,表格为主 | 结构达标,设计仍弱 |
| 双重重要性 | 议题矩阵 + 利益相关方调研 | 双维度评分 + 阈值生成列 + 分布表 | 方法论更强 |
| 气候披露 | TCFD 四要素 + 范围三 12 类 + 情景财务量化 | TCFD 四要素 + 风险表 + 范围三 4 类 | 中等差距 |
| 数据表 | 3–5 年、多主体拆分 | 2023–2025 三年、35 个数据点 | 可用,缺主体拆分 |
| 指标索引 | GRI/SASB/ISSB/HKEX 完整索引 | 28 条强制披露项索引 | 可用 |
| 第三方鉴证 | 独立鉴证报告 | 鉴证声明页 + 可审计过程证据 | 需外部机构 |
| 数据治理 | 内部系统 + 人工复核 | 哈希链 + 快照 + 可重放 + 质量分 | 本平台更强 |
| 案例与可视化 | 大量案例、图片、图表 | 叙述可编辑,缺案例素材 | 明显差距 |
验收脚本 python -m esg.tests.acceptance 逐条复现文档的 9 条验收标准, 并补充权限分离、报表生成、篡改识别等用例,共 40 项,全部通过;报告自动写入 docs/验收测试报告.md。
| 验收要点 | 实现位置 | 结果 |
|---|---|---|
| 同一指标映射三个框架且均 full | /api/mappings | 通过 |
| 改映射不改指标值 | /api/mappings/save | 通过 |
| 材料性结论随评分同事务变化 | esg_materiality 生成列 | 通过 |
| 改阈值需解锁事件 | UNLOCK + unlock_reason | 通过 |
| 数据点更新带前后快照 | esg_audit_chain | 通过 |
| 数据库拒绝改删审计链 | 触发器 trg_audit_no_* | 通过 |
| 重放与存储值一致 / 篡改可识别 | /api/results/replay | 通过 |
| 新规则版本不改旧结果绑定 | /api/rules/activate | 通过 |
| AI 停留 ai_verified | /api/evidence/ai-verify | 通过 |
| 偏差 >20% 自动 high 且不可静默关闭 | 生成列 + 复核接口 | 通过 |
| 状态机不跳跃 / 驳回须原因 | 转移白名单 | 通过 |
| DQR 缺失不得 verified | /api/pact/product-footprints | 通过 |
| 重评分只追加 | /api/quality/rescore | 通过 |
启动:双击 启动ESG平台.bat,浏览器自动打开 http://127.0.0.1:18888。
停止:双击 停止ESG平台.bat(结束 18888 端口进程)。
自检:双击 一键自检.bat,自动启动服务并执行 40 项验收,输出报告。
备份:停止服务后复制 esg/data/esg.db 与 esg/data/reports/;恢复时覆盖回原路径。 审计链随库迁移,校验结论不变。
并入现有库:esg/sql/V25__esg_schema_core.mysql.sql 与 ...postgres.sql 提供 MySQL 8 / PostgreSQL 16 建表与写保护脚本,字段命名与平台一致。
换端口:python -m esg.server --port 18889。
重建数据:python -m esg.server --reseed(清空业务库并重新初始化)。
| 表名 | 用途 |
|---|---|
| esg_period | 报告周期(年度、边界、锁定状态) |
| esg_datapoint | 数据点主数据(编码、议题、来源系统与引用) |
| esg_datapoint_value | 数据点按周期取值(数值/定性、来源快照、质量标记) |
| esg_standard_disclosure | 标准披露项(框架、编码、版本、生效日期) |
| esg_mapping | 数据点—披露项映射(覆盖级别、理由、有效期) |
| esg_disclosure_package | 披露包版本快照 |
| esg_materiality | 双重重要性评估(生成列判定材料性) |
| esg_audit_chain | 不可变审计轨迹(append-only) |
| esg_rule_version | 计算规则版本(结构化公式) |
| esg_factor_catalog | 排放因子目录(来源与版本化) |
| esg_calc_result | 可重放计算结果(run_id、输入快照) |
| esg_evidence | 证据记录(置信度、AI 理由、人工覆盖) |
| esg_greenwashing | 漂绿偏差(生成列偏差率与等级) |
| esg_supplier | 供应商扩展(数据交换能力、PACT 端点) |
| esg_supplier_request | 供应商数据请求(状态机) |
| esg_product_footprint | PACT 产品足迹(五维 DQR) |
| esg_quality_score | 数据质量评分(四维 + 综合分,只追加) |
| esg_report | 报表生成记录 |
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/login | 算术验证码 + PBKDF2 校验,返回会话令牌 |
| GET | /api/dashboard | 驾驶舱六项 KPI 与分布 |
| GET | /api/periods | 报告周期列表 |
| POST | /api/periods/lock | 锁定/解锁周期(写审计事件) |
| GET | /api/datapoints | 数据点台账(含取值、质量分、证据数) |
| POST | /api/datapoints/value | 录入取值并自动评分、留痕 |
| GET | /api/mappings | 按数据点/披露项查询映射 |
| POST | /api/mappings/save | 新增或更新映射(不改指标值) |
| GET | /api/coverage | 披露覆盖矩阵与覆盖率 |
| GET | /api/coverage/gaps | 缺口清单 |
| POST | /api/coverage/package | 生成披露包版本快照 |
| GET | /api/materiality | 双重重要性议题与象限统计 |
| POST | /api/materiality/save | 评分与阈值(阈值变更需解锁理由) |
| POST | /api/materiality/verify | 标记外部审计确认 |
| GET | /api/audit/logs | 审计链分页查询 |
| POST | /api/audit/verify | 全链校验,返回首个断点 |
| GET | /api/rules | 规则版本列表 |
| POST | /api/rules/activate | 启用规则版本(不动旧结果绑定) |
| GET | /api/factors | 排放因子目录 |
| GET | /api/results | 计算结果与重放状态 |
| POST | /api/results/replay | 单条重放比对 |
| POST | /api/results/replay-all | 全量重放 |
| GET | /api/evidence | 证据列表与状态统计 |
| POST | /api/evidence/ai-verify | AI 证据核验(只标记) |
| POST | /api/evidence/confirm | 人工确认/驳回(入链) |
| GET | /api/greenwashing | 漂绿偏差列表 |
| POST | /api/greenwashing/review | 复核(禁止静默关闭) |
| GET | /api/suppliers | 供应商台账 |
| GET | /api/supplier-requests | 数据请求与逾期 |
| POST | /api/supplier-requests/transition | 状态机转移 |
| POST | /api/supplier-requests/review | 审批/驳回(驳回须原因) |
| POST | /api/pact/product-footprints | PACT 报文接入 |
| POST | /api/footprints/verify | DQR 完整性校验后验证 |
| GET | /api/quality | 质量评分列表 |
| POST | /api/quality/rescore | 重新评分(只追加) |
| GET | /api/reports/catalog | 报表目录 |
| POST | /api/reports/generate | 生成报表并归档 |
| GET | /api/audit/verify | GET 方式校验(便于脚本调用) |
| 标记码 | 含义 |
|---|---|
| MISSING_VALUE | 必填数值或定性内容缺失 |
| MISSING_UNIT | 计量单位缺失 |
| MISSING_SOURCE | 来源快照缺失,不可溯源 |
| NO_EVIDENCE | 该数据点无任何证据 |
| EVIDENCE_UNCONFIRMED | 证据仅经 AI 标记,未人工确认 |
| EVIDENCE_EXPIRED | 证据有效期已过 |
| VOLATILITY_HIGH / MID | 同比波动超过 50% / 30%~50% |
| LATE_SUBMISSION | 提交滞后超过 90 天 |
| QUALITATIVE_ONLY | 仅定性披露,无量化口径 |
按 ESG 数据科学与鉴证视角,对 7 个维度打分(1–5)。V1.0 加权 3.10,V2.0 加权 3.98;重构重点是把"结果表"升级为"温室气体清单"、 把"拍分"升级为"因子化评分"、把"纯表格报告"升级为"图文并茂报告"。完整评估见 docs/03_科学评估与架构重构说明.md。
| 维度 | 权重 | V1.0 | V2.0 | 关键变化 |
|---|---|---|---|---|
| 概念一致性 | 15% | 3.5 | 4.0 | 补齐清单、因子、主体相关字段 |
| 核算科学性 | 20% | 2.0 | 4.0 | 清单法、双报告、分气体/类别、不确定度、重述登记 |
| 重要性判定 | 15% | 2.5 | 3.5 | 因子化、IRO、时间维度、证据引用 |
| 数据治理与可追溯 | 20% | 4.5 | 4.5 | 保持哈希链、快照、重放优势 |
| 鉴证就绪 | 10% | 3.0 | 3.5 | 鉴证范围与结论表述、重述登记 |
| 报告呈现 | 10% | 2.0 | 4.0 | 8 张图表、题注、29 页、目录页码 |
| 工程质量 | 10% | 4.0 | 4.0 | 验收扩至 48 项 |
| 加权总分 | 100% | 3.10 | 3.98 | 合格线上,未达"完美" |
科学上不存在"完美报告",只存在"可被独立复核的合规"。本系统把完美定义为:每条披露有数据点支撑、每个数字可重放、每处修改有痕迹、 每张图表与数据一致、每项缺口如实披露。据此 V2.0 已达成;与头部企业报告相比,仍差设计资源、案例素材与第三方鉴证意见。