docs: 新增V30.0版本相关设计文档与指南

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
This commit is contained in:
Ansonai
2026-03-16 01:31:26 +08:00
commit 6759d47de4
74 changed files with 9310 additions and 0 deletions

View File

@@ -0,0 +1,50 @@
# 前端集成蓝图:声誉驱动的阶梯费率与流量倾斜 (Reputation Perks)
> **[AI-3 @ 2026-03-14]**:由后端 Agent 在完成 BIZ_SOV_13 逻辑后产出。
## 1. 业务意图 (Business Intent)
- **核心价值**:通过自动化声誉分级体系,为高信用节点提供更低的结算费率与更高的流量分配优先级,构建正向激励的主权网络。
- **关联后端 Service**`ReputationPerksService.ts`
## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**Console -> 节点治理 -> 声誉权益中心
- **展示组件**
- [ ] **声誉等级金字塔**:展示当前节点的声誉分数及其所在的权益阶梯。
- [ ] **权益应用记录流**:展示最近由于声誉变动导致的费率折扣与流量权重调整。
- [ ] **激励策略预览表**:展示不同声誉区间对应的具体权益(费率、流量、配额)。
- **交互草图**
```text
+-----------------------------------------------------------+
| [Icon] 声誉权益中心 (Reputation Perks) |
+-----------------------------------------------------------+
| [ 当前节点: Node-Alpha ] [ 声誉分: 92.5 ] [ 等级: 卓越 ] |
+-----------------------------------------------------------+
| 尊享权益: |
| - 结算费率折扣: -20.00% (已生效) |
| - 流量倾斜系数: 1.5x (已生效) |
+-----------------------------------------------------------+
| [ 权益变更历史 ] |
| --------------------------------------------------------- |
| 日期 | 变动原因 | 权益调整 |
| 2026-03-14 | 声誉升至 90+ | 费率折扣提升至 20% |
| 2026-03-10 | 完成大额清算 | 声誉分 +2.5 |
+-----------------------------------------------------------+
| [?] AGI 激励建议: |
| "保持当前的履约成功率,预计下月声誉分可达 95届时将解锁 |
| '跨节点零费率结算' 试用权。" |
+-----------------------------------------------------------+
```
## 3. API 交互契约 (API Integration)
- **数据获取**`GET /api/v1/governance/reputation/perks?node_id=Node-Alpha`
- **关键字段映射**
- `reputation_score` -> 声誉分
- `applied_discount` -> 已应用折扣
- `applied_traffic_weight` -> 已应用流量权重
- **状态流转**
- 声誉系统更新分数 -> 触发 `ReputationPerksService.applyPerks` -> UI 自动显示新权益。
## 4. 生产校验项 (FE Readiness)
- [ ] 支持权益变动的实时消息推送通知。
- [ ] 权益详情与计费模块、流量分配模块的最终一致性校验。
- [ ] 导出包含声誉权益贡献的节点经营分析报告。