全局审计相关issues

.scratch/tech-global-audit/issues/01-audit-event-write-loop.md

@@ -0,0 +1,18 @@
+# 01 — 交付不可变 Audit Event 写入闭环
+
+**What to build:** 业务用例可以通过统一 Audit Writer 写入不可变、多资源、可串联且默认脱敏的审计事件。成功事件能够与业务事实共用事务，失败或拒绝事件使用独立短事务保留；未注册动作、缺少主要资源或审计写入失败时按明确策略阻止错误事实落地。
+
+**Blocked by:** `.scratch/tech-public-foundation/issues/01-public-migration-ownership-and-gates.md` — 01 — 建立公共迁移所有权与检查门禁
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为 Application + Port/Adapter，辅助通道为 Infrastructure。
+
+**完整业务边界:** 本票收口 Audit Event、事件资源、动作注册表、统一 Sanitizer、内容哈希、大小控制和 Writer 可靠性，并用一个代表性敏感写操作验证公开接缝。明确不迁移其他旧 Service，不提供完整审计查询中心，不用 Audit Event 替代领域流水。
+
+- [ ] Audit Event 支持稳定事件 ID、操作者与入口快照、结果、风险、前后数据、请求/关联/父事件 ID、HTTP 摘要、内容哈希和创建时间；事件资源支持 `primary/affected/reference`，且每个事件至少包含一个 `primary`。
+- [ ] 动作注册表集中定义稳定动作编码、中文名称、类别、默认风险、允许资源类型和敏感字段规则；未经注册的动作不能写入生产审计。
+- [ ] 统一 Sanitizer 删除禁止字段；`before_data`、`after_data`、`metadata` 分别执行 16KB 上限，超限后保存截断标志、原字节数、摘要和受控制品引用。
+- [ ] `content_hash` 基于脱敏、标准化后的不可变内容生成，不包含数据库自增 ID；相同内容哈希稳定，Repository 不提供 Update/Delete 能力。
+- [ ] `AppendWithTx` 与业务事实使用同一 GORM 事务，任一步失败整体回滚；已经回滚的 `failed/denied` 使用独立短事务，二次失败保留原业务错误并产生 critical 日志和指标。
+- [ ] 真实 PostgreSQL 集成测试覆盖不可变约束、多资源、动作注册、风险默认值、哈希、截断、禁止字段、重复事件幂等和事务回滚。

.scratch/tech-global-audit/issues/02-integration-log-attempt-loop.md

@@ -0,0 +1,18 @@
+# 02 — 交付可恢复的 Integration Log 尝试闭环
+
+**What to build:** 外部调用和未实际发出的同步尝试都能以稳定 Integration ID 建立可恢复事实，并通过受控条件更新进入明确终态。入站回调在业务处理前保存脱敏摘要和幂等标识，出站响应未知时保留未知结论而不伪装成普通失败。
+
+**Blocked by:** `.scratch/tech-public-foundation/issues/01-public-migration-ownership-and-gates.md` — 01 — 建立公共迁移所有权与检查门禁
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为 Infrastructure，辅助通道为 Application + Port/Adapter。
+
+**完整业务边界:** 本票收口 Integration Log 模型、Writer、执行态到终态的条件更新、入站摘要和未发送结果语义。明确不接管 Gateway、支付、企微或运营商的业务状态机，不把外部交互记录作为业务权威状态。
+
+- [ ] Integration Log 支持 provider、方向、operation、外部单号、资源、触发来源/场景/序列/尝试、计划与开始时间、结果、渠道摘要、脱敏请求响应摘要、耗时、状态变化标志和关联 ID。
+- [ ] 方向固定为 `inbound/outbound`；公开终态至少覆盖成功、失败、未找到、无效载荷、忽略、合并、限频、提前完成和取消，并返回对应中文名称。
+- [ ] 实际外部调用前持久化稳定尝试身份，完成后使用预期状态条件更新；并发完成、重复回调或重复消费不能改写既有终态。
+- [ ] 请求已发出但响应未知时记录明确的未知结论和恢复策略，不自动把具有副作用的请求当成普通失败盲目重发。
+- [ ] 入站回调先保存脱敏摘要、内容哈希和幂等标识；原始密文、完整正文、签名、附件和密钥不进入普通记录。
+- [ ] PostgreSQL 集成测试覆盖出站成功、明确失败、响应未知、未发送终态、入站回调、重复回调、条件更新冲突和 Audit Event 关联。

.scratch/tech-global-audit/issues/03-access-log-route-hardening.md

@@ -0,0 +1,21 @@
+# 03 — 完成 Access Log 全路由敏感信息防泄漏
+
+**What to build:** 当前项目所有敏感 HTTP 路由均使用统一的请求、响应、Query 和 Header 脱敏及路由级安全摘要策略。即使正文不是 JSON、解析失败或属于文件载荷，也不会把可复用凭证、完整回调或文件内容写入 Access Log。
+
+**Blocked by:**
+
+- `.scratch/tech-public-foundation/issues/09-access-log-recursive-redaction.md` — 09 — 统一 Access Log 请求与响应递归脱敏
+- `.scratch/tech-public-foundation/issues/10-sensitive-route-safe-summaries.md` — 10 — 为敏感接口提供安全摘要策略
+
+**Status:** ready-for-agent
+
+**架构通道:** Infrastructure。
+
+**完整业务边界:** 本票将公共 Access Log 安全能力应用到当前仓库真实路由并建立固定回归矩阵。明确不修改业务响应，不创建审计事实，不把 Access Log 升级为业务权威存储。
+
+- [ ] 登录、Token、支付与企微配置路由只记录字段存在性、长度和安全结果，不记录密码、验证码、Token、Secret、密钥或完整配置值。
+- [ ] 支付、企微和运营商回调只记录事件类型、安全资源标识、大小、内容类型、摘要哈希与处理结果，不记录密文、完整正文、签名或附件。
+- [ ] 上传、下载和导出路由不记录文件字节、Base64、multipart 正文、临时凭证或签名 URL，只保留脱敏文件元数据和任务标识。
+- [ ] Query 和 Header 覆盖 token、secret、sign、nonce、authorization、cookie 等大小写变体；请求和响应均先脱敏再执行 50KB 截断。
+- [ ] 非 JSON、XML、表单、二进制及解析失败场景均按路由策略安全降级，不能回退记录原文。
+- [ ] 真实 Fiber 测试捕获最终 Access Log，覆盖敏感路由矩阵，并断言测试凭证、操作密码、回调原文、签名 URL、Authorization 和 Cookie 均未落盘。

.scratch/tech-global-audit/issues/04-account-role-permission-audit-migration.md

@@ -0,0 +1,18 @@
+# 04 — 迁移账号、角色与权限敏感操作到统一审计
+
+**What to build:** 账号、角色和权限敏感操作通过统一 Audit Writer 记录操作者、动作、目标资源、结果、风险和前后变化。关键成功审计与业务修改同事务，拒绝和失败审计可可靠保留，这些入口不再调用旧账号审计 Writer。
+
+**Blocked by:** 01 — 交付不可变 Audit Event 写入闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为简单写 Application，辅助通道为旧 MVC Adapter。
+
+**完整业务边界:** 本票收口现有账号、角色和权限敏感写入口的统一审计接入。明确不重构整个账号模块，不迁移无关读取，不删除或回填旧账号历史表。
+
+- [ ] 账号创建、修改、启停、删除、角色分配及权限变更使用注册动作和统一资源类型，成功、拒绝和失败语义明确。
+- [ ] 账号角色或权限关键成功事件与业务事实使用同一 GORM 事务；审计失败时业务修改回滚。
+- [ ] 权限拒绝与业务失败通过独立短事务记录，不向客户端泄露底层错误或资源是否存在。
+- [ ] 事件包含操作者与入口快照、请求/关联标识、变更前后事实和直接受影响资源，敏感字段按统一规则删除或脱敏。
+- [ ] 生产装配中的上述入口不再调用旧账号审计 Service，也不直接创建旧账号日志模型；静态检查和真实用例测试可证明该边界。
+- [ ] 测试覆盖事务成功、审计失败回滚、拒绝、业务失败、重复请求和数据权限边界，不改变旧历史查询结果。

.scratch/tech-global-audit/issues/05-card-asset-lifecycle-audit-migration.md

@@ -0,0 +1,18 @@
+# 05 — 迁移卡资产生命周期操作到统一审计
+
+**What to build:** 卡分配、回收、删除、停复机、实名策略和状态变化等资产生命周期操作统一产生可关联的 Audit Event，并以多资源关系表达卡、设备、店铺、订单等直接影响对象。复杂卡状态规则仍由完整业务用例收口，不在审计 Adapter 中复制。
+
+**Blocked by:** 01 — 交付不可变 Audit Event 写入闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** 复杂卡状态用例采用 Application/Domain；其他入口采用旧 MVC Adapter。
+
+**完整业务边界:** 本票迁移现有卡资产生命周期写入口的审计能力。明确不重新设计周期轮询、队列、卡资格或重排策略，不迁移本需求未触碰的资产规则，不删除旧资产历史表。
+
+- [ ] 卡分配、回收、删除、手工停复机、实名策略和业务状态变化均映射到已注册动作，成功、拒绝和失败结果保持一致。
+- [ ] 事件至少关联一个主要卡资源，并按实际影响关联设备、来源/目标店铺、订单或其他直接资源；不递归制造资源关系。
+- [ ] 关键状态变更成功审计与业务事实同事务；失败或拒绝使用独立短事务，重复状态请求不制造重复业务副作用或虚假变化。
+- [ ] `request_id/correlation_id/parent_event_id` 在 HTTP、业务用例和后续异步链路中按各自职责传播。
+- [ ] 当前卡资产入口不再调用旧资产审计 Writer 或直接创建旧资产日志模型，但兼容历史读取仍可工作。
+- [ ] 测试覆盖权限拒绝、状态条件更新、事务回滚、多资源时间线、敏感 ICCID 默认脱敏和重复请求。

.scratch/tech-global-audit/issues/06-device-import-audit-migration.md

@@ -0,0 +1,18 @@
+# 06 — 迁移设备与资产导入操作到统一审计
+
+**What to build:** 设备分配、回收、绑定、控制操作以及卡和设备导入任务通过统一 Audit Writer 留下稳定、脱敏、可检索的事件。批量操作只在事件中保存命令摘要和计数，逐项明细继续由业务任务或受控制品承担。
+
+**Blocked by:** 01 — 交付不可变 Audit Event 写入闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为简单写 Application/旧 MVC Adapter，辅助通道为 Infrastructure。
+
+**完整业务边界:** 本票收口设备生命周期与现有资产导入入口的审计接入。明确不重构整个设备 Service，不建立通用批量任务表，不把大批量明细塞入 Audit Event JSON。
+
+- [ ] 设备分配、回收、系列绑定、绑卡/解绑、停复机、限速、WiFi 设置、切卡、重启和恢复出厂映射为注册动作。
+- [ ] 卡和设备导入任务创建、完成与失败事件关联任务、操作者、来源文件安全摘要和结果计数，不保存文件内容、签名 URL 或完整逐项数据。
+- [ ] 批量事件超过大小限制时记录截断元数据、原始计数、摘要及受控任务/制品引用，查询仍能定位权威明细。
+- [ ] 关键业务修改与成功审计同事务；拒绝和失败可靠保留，重复任务或重复控制请求不制造重复成功事件。
+- [ ] 相关生产入口不再调用旧资产审计 Writer；自动检查覆盖直接旧模型 Create 和隐藏装配注入。
+- [ ] 真实用例测试覆盖单项与批量、事务回滚、部分结果摘要、多资源关系、权限范围和敏感字段删除。

.scratch/tech-global-audit/issues/07-shop-package-config-audit-migration.md

@@ -0,0 +1,18 @@
+# 07 — 迁移店铺、套餐和关键配置操作到统一审计
+
+**What to build:** 店铺敏感归属、套餐管理以及支付、企微和关键系统配置的现有写操作统一记录注册动作、操作者、目标资源和前后变化。关键配置与权限相关成功审计和业务事实同事务，敏感配置原值永不进入审计正文。
+
+**Blocked by:** 01 — 交付不可变 Audit Event 写入闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为简单写 Application，辅助通道为旧 MVC Adapter。
+
+**完整业务边界:** 本票迁移当前已有店铺、套餐和关键配置敏感入口。明确不接管各业务 PRD 尚未实现的状态机，不主动迁移无关 CRUD，不创建配置专用审计表。
+
+- [ ] 店铺敏感业务员归属、关键账号关联和其他已识别敏感变更使用稳定动作及店铺/人员资源关系。
+- [ ] 套餐创建、修改、上下架、授权或其他已存在敏感管理入口记录业务命令摘要和直接受影响资源。
+- [ ] 支付、企微及关键系统配置变更只记录 Key、安全类型与脱敏前后摘要，不保存 Secret、Token、EncodingAESKey、私钥、公钥原文或签名材料。
+- [ ] 关键配置和权限相关成功审计与业务事实同事务；拒绝、校验失败和持久化失败按公共失败策略记录。
+- [ ] 相关旧账号/资产审计调用与零散配置日志不再承担这些操作的权威审计，生产装配可被自动检查验证。
+- [ ] 测试覆盖配置审计失败回滚、店铺越权、套餐批量摘要、敏感字段删除、重复更新和统一中文错误。

.scratch/tech-global-audit/issues/08-finance-order-audit-migration.md

@@ -0,0 +1,21 @@
+# 08 — 迁移现有资金与订单敏感操作到统一审计
+
+**What to build:** 当前钱包变更、充值、退款和订单资金敏感操作通过统一 Audit Event 关联业务单、钱包、钱包流水、操作者和完整业务链路。金额结论继续以 Domain Ledger 为准，关键成功审计与资金事实同事务且只产生一次。
+
+**Blocked by:**
+
+- 01 — 交付不可变 Audit Event 写入闭环
+- `.scratch/tech-public-foundation/issues/02-transactional-public-outbox-write.md` — 02 — 在业务事务中可靠写入公共 Outbox
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为复杂写 Application/Domain，辅助通道为 Port/Adapter。
+
+**完整业务边界:** 本票迁移仓库当前存在的钱包、充值、退款和订单资金敏感入口，完整收口所触碰用例的金额、并发、幂等和可靠事件边界。明确不用 Audit Event 替代钱包流水、订单或退款事实，不重写未触碰资金用例。
+
+- [ ] 钱包余额变更、代理钱包回退、线下充值入账、人工退款结果及现有订单资金操作使用注册动作和稳定 correlation。
+- [ ] Audit Event 关联审批或业务单、钱包、钱包流水及直接受影响资产；每条投影明确领域流水才是金额权威。
+- [ ] 余额、流水、成功审计和必要 Outbox 在同一 GORM 事务内提交；审计或 Outbox 写入失败时资金事实整体回滚。
+- [ ] 状态条件更新、钱包版本或稳定业务键保证重复请求、Worker 重投和并发处理不重复改变余额、流水或成功审计。
+- [ ] 明确失败、拒绝和结果异常使用独立短事务记录安全摘要，不把第三方支付密钥、完整凭证或底层错误返回客户端。
+- [ ] PostgreSQL 集成测试覆盖正常资金变化、审计失败、Outbox 失败、乐观锁冲突、重复业务键、并发处理和金额事实对账。

.scratch/tech-global-audit/issues/09-manual-polling-task-integration-cutover.md

@@ -0,0 +1,24 @@
+# 09 — 承接手动轮询状态并记录同步外部尝试
+
+**What to build:** 现有手动触发、进度和监控接口保持用户契约，但运行状态由公共异步任务契约承接；Gateway 实际请求及合并、互斥、限频、提前完成等未发送尝试进入 Integration Log，只有状态变化、人工强制、连续失败或高风险异常进入 Audit Event。
+
+**Blocked by:**
+
+- 01 — 交付不可变 Audit Event 写入闭环
+- 02 — 交付可恢复的 Integration Log 尝试闭环
+- `.scratch/tech-public-foundation/issues/02-transactional-public-outbox-write.md` — 02 — 在业务事务中可靠写入公共 Outbox
+- `.scratch/tech-public-foundation/issues/03-outbox-at-least-once-delivery.md` — 03 — 完成 Outbox 到 Asynq 的至少一次投递闭环
+- `.scratch/tech-public-foundation/issues/06-unified-async-task-contract.md` — 06 — 冻结统一异步任务五态和查询契约
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为 Application + Infrastructure，辅助通道为 Query。
+
+**完整业务边界:** 本票收口旧手动轮询日志承担的运行状态替代、外部尝试记录和兼容接口。明确不改变轮询配置、间隔、Redis 分片队列、任务类型、卡级开关、并发控制或失败重排，不新建同步专用运行表。
+
+- [ ] 手动触发、进度与监控公开契约继续可用，状态、计数、失败摘要和恢复行为映射到公共异步任务五态。
+- [ ] 实际 Gateway 请求在调用前建立 Integration Log，完成后记录结果、耗时、状态变化和脱敏上游摘要。
+- [ ] 合并、互斥、限频、已达预期和取消即使未产生 HTTP 请求也有可解释终态，不伪造 HTTP 状态。
+- [ ] 同步序列传播 `request_id/correlation_id/series_id/attempt`；同序列查询可连续看到立即、3 分钟、5 分钟的全部尝试。
+- [ ] 普通无变化成功只写 Integration Log；状态变化、人工强制、连续失败或高风险异常按注册规则关联 Audit Event。
+- [ ] 回归测试固定现有轮询配置、队列、开关和监控基线，验证切换前后调度事实不变且旧手动轮询表不再承担新增运行状态。

.scratch/tech-global-audit/issues/10-legacy-audit-read-projection.md

@@ -0,0 +1,18 @@
+# 10 — 提供旧审计历史统一只读投影
+
+**What to build:** 审计查询可以把旧账号、旧资产和旧手动轮询记录规范化为统一只读历史事件，并与新 Audit Event 稳定分页排序。现有资产操作日志兼容接口继续可用，但不再直接绑定旧资产日志表。
+
+**Blocked by:** 01 — 交付不可变 Audit Event 写入闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** Query。
+
+**完整业务边界:** 本票收口三个旧历史来源的 `UNION ALL` 投影、确定性历史键和资产兼容读取。明确不在线回填新表，不修改或删除旧记录，不伪造历史中不存在的 correlation、风险或多资源关系。
+
+- [ ] 旧账号、资产和手动轮询记录分别返回 `legacy_account/legacy_asset/legacy_polling` 来源及确定性历史事件键。
+- [ ] 字段映射保留可证明的操作者、操作、资源、结果、时间和摘要；不存在的关联、风险或资源关系显式为空而非推测填充。
+- [ ] 新旧记录使用稳定时间加 ID/历史键排序，分页跨越切换时间时无重复、漏项或顺序漂移。
+- [ ] 资产操作日志兼容接口同时读取新 Audit Event 与旧资产投影，并保持原业务调用方所需响应兼容性。
+- [ ] Query 不返回可用于业务写入的聚合对象，不对旧 JSON 做无索引模糊扫描，不产生 N+1 查询。
+- [ ] PostgreSQL 投影测试覆盖三类历史样本、字段映射、确定性键、分页排序、新旧交界和兼容接口。

.scratch/tech-global-audit/issues/11-global-event-resource-query.md

@@ -0,0 +1,23 @@
+# 11 — 交付全局事件和资源轨迹查询闭环
+
+**What to build:** 获得授权的平台用户可以分页查看全局审计事件与详情，先搜索业务资源候选，再打开包含新事件和历史投影的资源时间线。资源权限与字段脱敏由后端重新校验，代理或企业用户只能在原业务范围查看允许的资源轨迹。
+
+**Blocked by:**
+
+- 01 — 交付不可变 Audit Event 写入闭环
+- 05 — 迁移卡资产生命周期操作到统一审计
+- 06 — 迁移设备与资产导入操作到统一审计
+- 10 — 提供旧审计历史统一只读投影
+
+**Status:** ready-for-agent
+
+**架构通道:** Query。
+
+**完整业务边界:** 本票收口事件列表/详情、资源候选搜索和资源时间线 API 及权限、分页、索引和 DTO 投影。明确不递归遍历资源图，不扫描 JSONB，不通过聚合根读取，不实现其他审计视角。
+
+- [ ] 事件列表和详情支持注册动作、操作者、来源、结果、风险、时间、资源和请求标识等有索引过滤，默认 20、最大 100，并稳定按时间与 ID 排序。
+- [ ] 资源搜索先查询业务读模型返回类型、ID、Key 和显示名；静态搜索路由先于动态资源路由注册。
+- [ ] 资源时间线组合新 Audit Event 和旧投影，`include_related=true` 只展开事件直接关联资源，不递归遍历关系图。
+- [ ] 超级管理员、平台角色、代理和企业按权限码与原数据范围取交集；越权查询不泄露资源是否存在。
+- [ ] DTO 默认脱敏并返回结果、风险等中文名称；公共关键词不对 JSONB 执行无索引模糊扫描。
+- [ ] 真实 Fiber、认证、GORM 和 PostgreSQL 测试覆盖路由顺序、分页、筛选、权限、历史交界、无 N+1 和常用查询索引；新增 Handler 同步两个文档生成器。

.scratch/tech-global-audit/issues/12-actor-risk-query.md

@@ -0,0 +1,21 @@
+# 12 — 交付人员行为和风险事件查询闭环
+
+**What to build:** 获得相应权限的平台用户可以查看操作者列表、行为摘要、个人事件时间线以及风险概览和风险事件列表。所有聚合均由服务端完成，并严格隔离代理、企业和无对应权限的平台角色。
+
+**Blocked by:**
+
+- 04 — 迁移账号、角色与权限敏感操作到统一审计
+- 11 — 交付全局事件和资源轨迹查询闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** Query。
+
+**完整业务边界:** 本票收口人员与风险两个读取视角、服务端汇总和权限边界。明确不建设自动封禁、风险处置工单、实时行为分析或前端全量下载聚合。
+
+- [ ] 操作者查询支持 actor kind、稳定 ID、名称快照、入口、动作、结果、风险和时间过滤，并提供摘要及稳定分页事件时间线。
+- [ ] 风险概览按风险等级、结果、类别、动作和时间窗口进行有索引汇总，风险事件列表可进一步检索详情。
+- [ ] `audit:actor:view` 与 `audit:risk:view` 独立授权；代理和企业账号不能进入人员或风险全局视角。
+- [ ] 平台角色的权限与数据范围取交集，失败、拒绝、高风险和严重事件不会因缺失可选关联而被错误过滤。
+- [ ] 汇总使用服务端 SQL 和批量投影，不下载全量事件、不对 JSONB 模糊扫描、不产生操作者或资源 N+1。
+- [ ] HTTP 与性能测试覆盖超级管理员、不同平台角色、代理、企业、空态、筛选空态及代表性数据量；OpenAPI 文档同步更新。

.scratch/tech-global-audit/issues/13-request-correlation-integration-timeline.md

@@ -0,0 +1,24 @@
+# 13 — 交付请求、业务链路和外部集成时间线
+
+**What to build:** 运维人员可以按 request ID 或 correlation ID 查看同一请求或完整业务链路中的 Audit Event、Integration Log、Outbox 和异步任务摘要，并可按外部提供方、操作、方向、结果、资源、场景和序列检索外部尝试。
+
+**Blocked by:**
+
+- 02 — 交付可恢复的 Integration Log 尝试闭环
+- 09 — 承接手动轮询状态并记录同步外部尝试
+- 11 — 交付全局事件和资源轨迹查询闭环
+- `.scratch/tech-public-foundation/issues/02-transactional-public-outbox-write.md` — 02 — 在业务事务中可靠写入公共 Outbox
+- `.scratch/tech-public-foundation/issues/06-unified-async-task-contract.md` — 06 — 冻结统一异步任务五态和查询契约
+
+**Status:** ready-for-agent
+
+**架构通道:** Query。
+
+**完整业务边界:** 本票收口请求时间线、关联时间线和 Integration Log 列表/详情查询。明确不在 API 请求中扫描本地 Access Log，不复制 Outbox/任务完整载荷，不把外部交互结果解释成业务权威状态。
+
+- [ ] Request Timeline 组合可关联的审计事件、外部尝试、Outbox 和任务安全摘要，并返回 Access Log 检索标识而不读取日志文件。
+- [ ] Correlation Timeline 以稳定 correlation 串联跨请求、回调和异步处理，`parent_event_id` 只表达直接因果，不替代 correlation。
+- [ ] Integration 查询支持 provider、operation、方向、结果、资源、触发来源、场景、序列、尝试和时间过滤，列表默认 20、最大 100。
+- [ ] 同一同步序列能够按尝试顺序连续展示立即、3 分钟、5 分钟结果，包括合并、限频和提前完成等未发送终态。
+- [ ] 原始外部正文、密文、签名、附件、Outbox 载荷和任务敏感失败明细不进入普通查询 DTO。
+- [ ] 真实链路测试覆盖单请求、多请求 correlation、异步传播、重复尝试、0/3/5 序列、权限隔离和常用查询索引；OpenAPI 文档同步更新。

.scratch/tech-global-audit/issues/14-finance-audit-timeline.md

@@ -0,0 +1,21 @@
+# 14 — 交付资金审计时间线
+
+**What to build:** 财务人员可以按业务单、钱包、审批、资产和时间查看组合时间线，统一展示 Audit Event、钱包流水、订单、退款、充值和审批实例，并清楚区分每条记录来源及金额权威。
+
+**Blocked by:**
+
+- 08 — 迁移现有资金与订单敏感操作到统一审计
+- 13 — 交付请求、业务链路和外部集成时间线
+
+**Status:** ready-for-agent
+
+**架构通道:** Query。
+
+**完整业务边界:** 本票收口资金审计的只读组合投影、权限、分页和对账语义。明确不通过查询修改资金状态，不把 Audit Event 当作金额账本，不迁移未触碰的资金写用例。
+
+- [ ] 时间线组合 Audit Event、钱包流水、订单、退款、充值和审批实例，每条返回明确 `record_source`、时间、业务标识和安全摘要。
+- [ ] 金额、余额和资金结论始终取自 Domain Ledger；审计事件只解释操作者、动作、风险、前后变化和关联关系。
+- [ ] 支持钱包、店铺、业务单、审批、资产、动作、结果、风险和时间等有索引过滤，并使用稳定时间加来源 ID 排序。
+- [ ] `audit:finance:view` 独立授权，代理和企业不能进入全局资金视角；平台角色权限与原资金数据范围取交集。
+- [ ] 金额、手机号、第三方交易号等字段默认按权限脱敏，不因某条关联缺失泄露其他资源存在性。
+- [ ] 对账和性能测试覆盖多来源同链路、退款与充值、审批关联、无重复漏项、无 N+1 和代表性数据量；OpenAPI 文档同步更新。

.scratch/tech-global-audit/issues/15-sensitive-read-self-audit.md

@@ -0,0 +1,22 @@
+# 15 — 交付敏感值二次查看与自审计闭环
+
+**What to build:** 审计详情默认返回掩码或安全状态；具有独立敏感查看权限的用户可以针对明确事件或资源二次请求允许展示的完整值，而该查看行为本身会产生高风险 Audit Event，并保留被查看对象、操作者和请求链路。
+
+**Blocked by:**
+
+- 01 — 交付不可变 Audit Event 写入闭环
+- 11 — 交付全局事件和资源轨迹查询闭环
+- 12 — 交付人员行为和风险事件查询闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为 Query，辅助通道为简单写 Application。
+
+**完整业务边界:** 本票收口敏感字段受控读取、字段级授权和读取自审计。明确不恢复已被策略删除的原值，不允许超级管理员绕过二次审计，不授予导出权限。
+
+- [ ] 普通详情对手机号、IP、ICCID、钱包金额和第三方交易号等受控字段默认脱敏；禁止字段始终不可恢复。
+- [ ] 二次查看要求 `audit:sensitive:view`、明确目标和字段范围，并重新校验平台角色、数据范围与资源权限。
+- [ ] 成功或被拒绝的敏感查看产生注册的高风险 Audit Event，关联被查看事件/资源、操作者、入口和 request ID。
+- [ ] 审计写入失败时敏感值不返回；重复查看每次都保留独立读取事实，不因已有全局权限跳过。
+- [ ] 无权限、历史字段不存在、原值已删除和资源越权返回明确但不泄密的统一错误或状态。
+- [ ] 真实 Fiber 和 PostgreSQL 测试覆盖授权查看、越权、审计失败、禁止字段、历史缺失、并发请求及自审计事件查询；OpenAPI 文档同步更新。

.scratch/tech-global-audit/issues/16-audit-export-permission-snapshot.md

@@ -0,0 +1,24 @@
+# 16 — 交付审计导出与字段授权快照
+
+**What to build:** 获得审计导出权限的用户可以从支持的审计视角创建异步导出任务。任务创建时固化过滤条件、数据范围、字段授权和脱敏等级，后续角色变更或任务重试不会扩大导出内容。
+
+**Blocked by:**
+
+- 11 — 交付全局事件和资源轨迹查询闭环
+- 12 — 交付人员行为和风险事件查询闭环
+- 13 — 交付请求、业务链路和外部集成时间线
+- 14 — 交付资金审计时间线
+- 15 — 交付敏感值二次查看与自审计闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为 Query + Export DataSource，辅助通道为 Application。
+
+**完整业务边界:** 本票收口审计导出 Scene、字段能力、权限快照、异步任务和导出审计。明确不创建第二套导出框架，不把敏感查看权限等同敏感导出权限，不在权限解析失败时回退全字段。
+
+- [ ] 审计导出复用统一 Export DataSource 和任务契约，支持经批准的事件、资源、链路、集成、风险和资金过滤条件。
+- [ ] 创建任务时快照操作者、权限、数据范围、字段集合、脱敏等级和过滤条件；Worker 只使用快照执行。
+- [ ] `audit:export` 与 `audit:sensitive:view` 独立；导出完整敏感字段需要额外字段授权，解析失败一律拒绝。
+- [ ] 文件不包含禁止字段、完整外部报文、密钥、签名 URL 或未授权业务数据；下载继续遵守安全摘要和临时访问策略。
+- [ ] 创建、完成、失败和下载等敏感导出行为产生统一 Audit Event，并能关联导出任务与请求链路。
+- [ ] 测试覆盖权限快照、角色变更、字段空集、敏感权限分离、任务重试、导出审计、越权和文件内容检查。

.scratch/tech-global-audit/issues/17-retention-cleanup-observability.md

@@ -0,0 +1,21 @@
+# 17 — 交付审计保留、清理和运行监控
+
+**What to build:** 运维人员可以观察 Audit/Integration 写入、旧表意外新增、Integration Log 增长与清理、敏感读取和导出，并由受控维护身份按保留策略分批清理可清理记录。在线应用始终不能更新或删除 Audit Event。
+
+**Blocked by:**
+
+- 01 — 交付不可变 Audit Event 写入闭环
+- 02 — 交付可恢复的 Integration Log 尝试闭环
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为 Infrastructure，辅助通道为 Query。
+
+**完整业务边界:** 本票收口保留分类、Integration Log 分批清理、权限边界、指标与告警。明确不由在线应用删除 Audit Event，不预建尚无必要的复杂分区系统，不清理已有生产审计事实作为回滚手段。
+
+- [ ] 审计事件按资金/权限/审批/关键配置与普通资产/业务分类表达 5 年或 2 年保留策略，在线应用账号无 Update/Delete 能力。
+- [ ] Integration Log 默认保留 180 天，Gateway 无变化成功记录保留 30 天；清理按稳定时间与主键小批量执行并记录结果。
+- [ ] 清理只允许受控维护身份执行，使用条件范围和可恢复进度，不影响异常、状态变化或仍被业务链路引用的记录。
+- [ ] 指标和告警覆盖 Audit/Integration 写入失败、失败短事务失败、旧三表意外新增、Outbox 积压、Integration 增长/清理、敏感读取和导出次数。
+- [ ] 日志与指标标签只使用安全 ID、结果和计数，不包含正文、敏感值或高基数未受控载荷。
+- [ ] 测试覆盖保留边界、分批重跑、并发清理、在线账号拒绝、旧表新增告警和不删除未到期/受保护记录。

.scratch/tech-global-audit/issues/18-frontend-contract-acceptance-pack.md

@@ -0,0 +1,25 @@
+# 18 — 冻结审计中心跨仓前端契约与验收包
+
+**What to build:** 前端仓库获得稳定、框架无关的审计工作台契约和可执行验收数据，能够实现全局事件、人员行为、资源轨迹、请求/业务链路、资金审计、风险事件和外部集成七个视角，并正确处理权限、敏感查看、导出、空态与错误状态。
+
+**Blocked by:**
+
+- 11 — 交付全局事件和资源轨迹查询闭环
+- 12 — 交付人员行为和风险事件查询闭环
+- 13 — 交付请求、业务链路和外部集成时间线
+- 14 — 交付资金审计时间线
+- 15 — 交付敏感值二次查看与自审计闭环
+- 16 — 交付审计导出与字段授权快照
+
+**Status:** ready-for-agent
+
+**架构通道:** Query/API 契约。
+
+**完整业务边界:** 本票收口跨仓页面、状态、权限和验收契约以及 OpenAPI/样本数据。当前仓库不含前端源码，明确不虚构组件目录、状态库或技术栈，不在本票实现前端页面。
+
+- [ ] 契约覆盖 `/operations/audit` 七个视角、权限控制 Tab、服务端筛选分页、稳定 URL 参数和详情抽屉字段分组。
+- [ ] 资源轨迹定义先搜索候选再查看时间线；请求与 correlation 可相互跳转；Integration 序列连续展示立即、3 分钟、5 分钟尝试。
+- [ ] 敏感字段默认掩码，二次查看重新请求受控接口；导出、敏感查看和各视角权限分别处理。
+- [ ] 明确定义加载、真实空态、筛选空态、403、404/不可见、失败重试、历史字段不存在和数据已删除等状态。
+- [ ] 提供不含真实敏感数据的七视角验收样本、权限矩阵和人工验收清单，后端 OpenAPI 与真实路由保持一致。
+- [ ] 文档明确前端隐藏不是授权边界，第一版不实现自动封禁、风险工单或自由拖拽关系图。

.scratch/tech-global-audit/issues/19-one-time-audit-cutover-gate.md

@@ -0,0 +1,37 @@
+# 19 — 执行一次性审计切换与停机发布门禁
+
+**What to build:** 发布负责人可以在一次停机窗口内完成新结构、Writer、现有敏感入口、历史查询、权限、监控和跨仓契约切换，并通过自动化门禁决定是否开放流量。任一关键检查失败时整体停止发布；一旦新系统产生生产事实，只能前向修复，不能恢复旧 Writer 制造分裂历史。
+
+**Blocked by:**
+
+- 03 — 完成 Access Log 全路由敏感信息防泄漏
+- 04 — 迁移账号、角色与权限敏感操作到统一审计
+- 05 — 迁移卡资产生命周期操作到统一审计
+- 06 — 迁移设备与资产导入操作到统一审计
+- 07 — 迁移店铺、套餐和关键配置操作到统一审计
+- 08 — 迁移现有资金与订单敏感操作到统一审计
+- 09 — 承接手动轮询状态并记录同步外部尝试
+- 10 — 提供旧审计历史统一只读投影
+- 11 — 交付全局事件和资源轨迹查询闭环
+- 12 — 交付人员行为和风险事件查询闭环
+- 13 — 交付请求、业务链路和外部集成时间线
+- 14 — 交付资金审计时间线
+- 15 — 交付敏感值二次查看与自审计闭环
+- 16 — 交付审计导出与字段授权快照
+- 17 — 交付审计保留、清理和运行监控
+- 18 — 冻结审计中心跨仓前端契约与验收包
+- `.scratch/tech-public-foundation/issues/12-foundation-release-gate-and-integration-contract.md` — 12 — 建立公共基础发布门禁和下游接入契约
+
+**Status:** ready-for-agent
+
+**架构通道:** 主通道为 Infrastructure，辅助通道为 Application/Query 验收。
+
+**完整业务边界:** 本票收口全局审计一次性停机切换、迁移验证、旧写收缩、对账、性能、安全、监控和发布回滚边界。明确不允许长期双写或局部放量，不删除旧历史，不在新事实产生后通过删表回滚。
+
+- [ ] 停机顺序明确覆盖暂停流量与 Worker、前置检查、增量迁移、权限初始化、新 Writer 装配、旧写护栏、历史对账、Worker 恢复和开放流量。
+- [ ] 自动切换清单证明生产产物不再调用旧账号/资产审计 Writer、不再直接 Create 旧三表、启动装配不再注入旧 Writer；旧表意外新增会立即告警或失败。
+- [ ] 门禁覆盖关键业务与审计同事务、审计失败回滚、失败短事务、Integration 结果未知、历史新旧交界、Access Log 敏感矩阵和权限隔离。
+- [ ] Query 性能验证常用过滤使用索引、无 JSONB 全表模糊扫描、无资源/操作者 N+1，并满足项目 P95/P99 目标。
+- [ ] 任一迁移、旧写清单、样本对账、事务、安全、权限、性能、监控或跨仓验收失败均在开放流量前整体终止发布，不能让局部模块继续写旧表。
+- [ ] 发布与回滚说明明确：未产生新事实时可回退兼容应用；已产生 Audit/Integration/Outbox 事实后保留全部记录、停止异常生产者并前向修复，禁止恢复旧 Writer 或删除事实。
+- [ ] 中文功能总结覆盖关键流程、前后端契约、异常闭环、发布回滚、监控恢复和待决策项，README 增加索引；完整停机演练通过后方可放量。