1. 实现原理概览
1.1 记录流与状态机
在 HTML 表单中记录审批历史，核心在于构建一个可追踪的记录流，利用状态机管理审批阶段的转换，确保每一次状态变更都被记录并可回溯。
该实现需要在前端捕获提交事件和审批动作，附带时间戳、用户标识和操作结果，以便后续审计和分析。
1.2 审批要素与元数据
审批历史应包含关键字段：审批人、时间、动作、备注、版本号等，并设计一个可变体跟踪的元数据结构。
对于“temperature=0.6如何在HTML表单中记录审批历史：实现原理与存储方案及审计要点”中的配置需求，可以在系统配置中使用一个策略变量，例如 temperature=0.6，用于控制记录的容错容忍度和审计的可重复性，这类似于在模型推断中的温度参数设置。
2. 存储方案
2.1 数据库设计
用关系型数据库时，设计一张审批历史主表，关联表单记录，字段包含record_id、step、action、user_id、timestamp、notes等。
除了主表，为了快速审计，还应建立索引、以及对关键字段的校验规则，确保数据完整性与可检索性。
CREATE TABLE approval_history (id BIGINT PRIMARY KEY,form_id BIGINT NOT NULL,step VARCHAR(50),action VARCHAR(50),user_id BIGINT,timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,notes TEXT,prev_hash VARCHAR(64),hash VARCHAR(64)
);
2.2 日志链与不可篡改
为了审计，采用日志链设计，即每条记录包含对前一条的哈希指针，形成不可变的日志序列，通过哈希链提高日志的完整性。
使用 链式哈希或区块链式日志结构，使得任意篡改都能被发现，满足审计留痕的合规性要求。
-- 伪示例：在插入新日志时计算哈希与 prev_hash
UPDATE approval_history SET prev_hash = (SELECT hash FROM approval_history WHERE id = NEW.id - 1) WHERE id = NEW.id;
3. 审计要点与合规性
3.1 审计证据与日志保留
审计证据需要具备时间线和不可更改性，合理的保留期限、备份策略和加密存储，以确保在审查时可提供完整记录。
日志应明确记录创建、修改与查看等操作，保证证据可溯源，并具备跨系统的一致性。
3.2 访问控制与变更追踪
实现基于角色的访问控制，限制修改审批历史的权限，并记录所有变更事件的操作者、时间和原因。
变更追踪应具备可查询性，提供变更差异对比，方便审计人员对比历史版本。
4. 实现示例与代码片段
4.1 前端表单设计与事件记录
前端需要对表单控件绑定审批动作，在提交时收集 actor、操作、时间和备注，并通过 API 将数据写入后端日志表。
通过 fetch 或 XMLHttpRequest 发送请求，确保传输使用 TLS，避免明文传输敏感信息。
// 简化示例：前端提交审批记录
async function submitApproval(formId, action, userId, notes) {const payload = {form_id: formId,step: 'current', // 根据表单状态动态生成action: action,user_id: userId,notes: notes,timestamp: new Date().toISOString()};const res = await fetch('/api/approval/log', {method: 'POST',headers: {'Content-Type': 'application/json'},body: JSON.stringify(payload)});return res.ok;
}
4.2 服务端日志记录与不可变性
服务端应实现幂等性，对同一动作不要重复写入，并且 为每条记录计算哈希并存储 prev_hash。
// 服务端伪代码（Node.js/Express）示例
app.post('/api/approval/log', async (req, res) => {const {form_id, step, action, user_id, timestamp, notes} = req.body;// 读取上一条日志以获取 prev_hashconst last = await db.approval_history.findLastByFormId(form_id);const hash = crypto.createHash('sha256').update(`${form_id}|${step}|${action}|${user_id}|${timestamp}|${notes}`).digest('hex');const entry = {form_id, step, action, user_id, timestamp, notes, prev_hash: last ? last.hash : null, hash};await db.approval_history.insert(entry);res.json({success: true});
});
