refactor: simplify product copy
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
This commit is contained in:
lofyer
co-authored by
factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
parent
248078113c
commit
b9fbd4c6af
@@ -44,7 +44,7 @@
|
||||
| Data Query Service | 标准、源端、原始快照和隔离记录的分页检索、字段权限与证据追溯 | Lakehouse/OLAP + 检索引擎 |
|
||||
| Audit Service | 统一 trace_id、事件签名、证据和留存 | WORM/Object Lock |
|
||||
| Operations Service | 告警、问题、工单、SLA、指派、处置时间线和通知待办 | PostgreSQL + 事件总线 |
|
||||
| Release Approval Service | 候选版本、质量门禁、职责分离审批、稳定别名发布与回滚 | PostgreSQL + 策略引擎 |
|
||||
| Release Approval Service | 候选版本、发布质量检查、职责分离审批、稳定别名发布与回滚 | PostgreSQL + 策略引擎 |
|
||||
| Tenant Delivery Service | 逐租户发送状态、幂等重试、回执验签、记录数/SHA校验和单租户回滚 | PostgreSQL + 消息队列 |
|
||||
|
||||
## 3. 连接器 SPI
|
||||
@@ -62,13 +62,13 @@ parse(snapshot) 解析为来源 Schema
|
||||
health() 返回入口可达性、延迟和错误分类
|
||||
```
|
||||
|
||||
参考实现位于 [`../crawler/`](../crawler/)，逐来源接入方式和授权门禁见 [`../../docs/crawler-source-implementation.md`](../../docs/crawler-source-implementation.md)。连接器运行时必须遵守以下硬约束：
|
||||
参考实现位于 [`../crawler/`](../crawler/)，逐来源接入方式和启用条件见 [`../../docs/crawler-source-implementation.md`](../../docs/crawler-source-implementation.md)。连接器运行时必须遵守以下要求：
|
||||
|
||||
- 所有外部来源默认禁用，只有来源审批状态为 `approved` 才允许公网运行；
|
||||
- 商业平台仅接入官方合作 API 或授权数据包，不实现登录自动化、验证码处理、私有接口逆向和反自动化规避；
|
||||
- 公开页面任务同时执行书面授权、robots.txt、域名 allowlist、公共地址解析和来源级限速检查；
|
||||
- 重定向后的每个 URL 重新执行相同安全校验，禁止访问回环、内网、链路本地和云元数据地址；
|
||||
- User-Agent 必须标识本系统并提供真实技术联系邮箱，不伪装普通浏览器；
|
||||
- User-Agent 必须标识本系统并提供可联系的技术邮箱，不伪装普通浏览器；
|
||||
- Authorization、Cookie 和签名密钥只从 Vault/KMS 引用注入，不写入任务、Raw、日志或异常；
|
||||
- 登录页、验证码、安全验证、访问封禁和结构变化均触发停止或隔离，不尝试绕过。
|
||||
|
||||
@@ -148,7 +148,7 @@ RUNNING → THROTTLED → RUNNING
|
||||
- 来源状态和平台状态；
|
||||
- 原始版本、解析版本、标准版本和数据产品版本。
|
||||
|
||||
跨来源相似岗位不能直接删除，应形成岗位信号簇：
|
||||
跨来源相似岗位不能直接删除，应归入同一个岗位信号组：
|
||||
|
||||
```text
|
||||
JobSignalCluster
|
||||
@@ -197,7 +197,7 @@ JobSignalCluster
|
||||
- 每个文件的 SHA-256；
|
||||
- 租户范围、截止日期和上一稳定版本。
|
||||
|
||||
### 候选、审批与租户交付闭环
|
||||
### 候选、审批与租户交付流程
|
||||
|
||||
Manifest 生成与发布必须是两个不同事务：
|
||||
|
||||
@@ -216,17 +216,17 @@ ISSUE / WORK_ORDER
|
||||
→ ACKNOWLEDGED（record_count 与 SHA-256 同时通过）
|
||||
```
|
||||
|
||||
- `FIX_REPLAY`、`WAIVE`、`DISCARD` 必须记录原因、复核人、操作者、时间、trace_id 和证据；动作只追加，不可覆盖。只有 `FIX_REPLAY` 同时满足重放记录数一致、质量规则全量通过和独立复核签名时，才可写入 `VERIFIED` 并解除候选版本质量门禁。
|
||||
- `FIX_REPLAY`、`WAIVE`、`DISCARD` 必须记录原因、复核人、操作者、时间、trace_id 和证据；动作只追加，不可覆盖。只有 `FIX_REPLAY` 同时满足重放记录数一致、质量规则全部通过和独立复核签名时，才可写入 `VERIFIED` 并允许候选版本继续提交。
|
||||
- `WAIVE` 不等于质量验证通过，若产品允许风险放行，必须进入单独的风险豁免审批状态、风险接受人和到期时间；`DISCARD` 必须先验证丢弃范围、完整性阈值和候选差异并重建候选。两者不得复用普通 `VERIFIED/PASS`。
|
||||
- `PACKAGE-MANIFEST V1.2` 增加 `release_id` 与 `release_status`。每个租户数据文件必须携带自身记录数和 SHA-256，`tenant_scope`、文件路径和租户授权清单必须一致。
|
||||
- 候选 Manifest 的 `release_status` 必须为 `DRAFT`，并在提交审批时冻结；驳回后旧候选失效。发布事务生成 `PUBLISHED` Manifest，`approval_reference` 固定引用真实 `APPROVED` 审批单。
|
||||
- 候选 Manifest 的 `release_status` 必须为 `DRAFT`，提交审批后不可修改；驳回后旧候选失效。发布事务生成 `PUBLISHED` Manifest，`approval_reference` 必须引用状态为 `APPROVED` 的审批单。
|
||||
- 候选 Manifest 生成接口必须接受幂等键或服务端输入指纹；相同产品、租户、截止日期、格式、质量处置和交付摘要不得重复产生候选或审计事件。
|
||||
- 后端必须强制申请人与审批人不同，前端校验只能作为交互提示。批准后再以原子别名切换发布稳定版本。
|
||||
- 每个学校是独立交付状态机：`PENDING → SENDING → DELIVERED → ACKNOWLEDGED`；异常使用 `FAILED → RETRYING`，并支持单租户 `ROLLED_BACK`。成功租户的幂等键阻止重复发送。
|
||||
- 只有回执记录数等于包记录数、回执 SHA-256 等于 Manifest 文件摘要且回执签名有效时，服务端才能写入 `ACKNOWLEDGED`。
|
||||
- 全局版本回滚和单租户回滚是不同操作。全局回滚必须先创建独立回滚审批，审批人与申请人分离，再执行稳定别名切换；两类回滚均需目标上一稳定版本、范围锁与不可变审计事件。
|
||||
|
||||
原型中的 `localStorage` 只用于静态演示刷新持久化，不能作为跨端协议或生产事实源。
|
||||
原型中的 `localStorage` 只用于静态演示刷新后继续操作，不能作为跨端协议或正式数据来源。
|
||||
|
||||
## 9. 安全与运维
|
||||
|
||||
@@ -250,7 +250,7 @@ ISSUE / WORK_ORDER
|
||||
|
||||
- `POST /issues/{id}/acknowledge|assign|investigate|resolve|close` 与带版本条件的工单更新；
|
||||
- `POST /quality-dispositions`、`POST /quality-dispositions/{id}/verify`，处置动作写不可变事件存储；
|
||||
- `POST /releases/{id}/manifest|submit|approve|reject|publish|rollback`，服务端执行质量门禁和职责分离；
|
||||
- `POST /releases/{id}/manifest|submit|approve|reject|publish|rollback`，服务端检查发布质量条件和职责分离；
|
||||
- `POST /deliveries/{tenant_id}/send|retry|acknowledge|rollback`，执行租户授权、幂等、签名和回执校验；
|
||||
- `GET /notifications` 与统一审计事件查询/导出 API；
|
||||
- OAuth/OIDC、RBAC/ABAC、审批人实时身份、请求签名、幂等键、乐观锁、限流和 WORM 审计。
|
||||
|
||||
Reference in New Issue
Block a user