Files
makemd/archive/handover/reputation-perks-ui.md
wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
2026-03-17 22:07:19 +08:00

2.9 KiB
Raw Blame History

前端集成蓝图:声誉驱动的阶梯费率与流量倾斜 (Reputation Perks)

[AI-3 @ 2026-03-14]:由后端 Agent 在完成 BIZ_SOV_13 逻辑后产出。

1. 业务意图 (Business Intent)

  • 核心价值:通过自动化声誉分级体系,为高信用节点提供更低的结算费率与更高的流量分配优先级,构建正向激励的主权网络。
  • 关联后端 ServiceReputationPerksService.ts

2. UI/UX 布局方案 (Layout Design)

  • 页面入口Console -> 节点治理 -> 声誉权益中心
  • 展示组件
    • 声誉等级金字塔:展示当前节点的声誉分数及其所在的权益阶梯。
    • 权益应用记录流:展示最近由于声誉变动导致的费率折扣与流量权重调整。
    • 激励策略预览表:展示不同声誉区间对应的具体权益(费率、流量、配额)。
  • 交互草图
    +-----------------------------------------------------------+
    | [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)

  • 支持权益变动的实时消息推送通知。
  • 权益详情与计费模块、流量分配模块的最终一致性校验。
  • 导出包含声誉权益贡献的节点经营分析报告。