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

2.5 KiB
Raw Blame History

前端集成蓝图:基于 DID 的自治清算协议 (DID Settlement)

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

1. 业务意图 (Business Intent)

  • 核心价值:自动化处理品牌方、代运营与达人的三方自动分润,降低结算争议 95%,实现“无感清算”。
  • 关联后端 ServiceDIDSettlementService.ts

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

  • 页面入口Console -> 财务中心 -> 自治清算管理
  • 展示组件
    • DID 合约看板:展示各主体的 DID 身份与分成比例。
    • 清算记录表:展示每笔订单的清算状态与隐私存证证明。
    • 分润热力图:展示各主体的历史收益占比。
  • 交互草图
    +-----------------------------------------------------------+
    | [Icon] 自治清算管理 (DID-based Settlement)               |
    +-----------------------------------------------------------+
    | [ 当前合约状态:已激活 (ACTIVE) ]                         |
    | - 品牌方 (Brand): 70% [DID: brand-001] [✅ Verified]      |
    | - 代运营 (Ops):   20% [DID: ops-002]   [✅ Verified]      |
    | - 达人 (KOL):     10% [DID: kol-003]   [✅ Verified]      |
    +-----------------------------------------------------------+
    | [ 最近清算记录 (Last 10 Settlements) ]                    |
    | --------------------------------------------------------- |
    | Order ID | Party | Amount | Status | ZKP Proof          |
    | ORD-1234 | Brand | $140.0 | ✅ Done | [ View Proof ]     |
    | ORD-1234 | Ops   | $40.0  | ✅ Done | [ View Proof ]     |
    | ORD-1234 | KOL   | $20.0  | ✅ Done | [ View Proof ]     |
    +-----------------------------------------------------------+
    | [?] 审计备注:所有清算均通过 ZKP 存证,隐私且不可篡改。   |
    +-----------------------------------------------------------+
    

3. API 交互契约 (API Integration)

  • 数据获取GET /api/v1/finance/settlement/did
  • 关键字段映射
    • party_did -> DID 标识
    • party_role -> 角色
    • amount -> 清算金额
    • proof_hash -> ZKP 证明哈希
  • 状态流转
    • 点击 [View Proof] -> 调用 PrivateAuditService.verifyProof -> 展示验证通过标识。

4. 生产校验项 (FE Readiness)

  • DID 身份的实名/实体认证校验。
  • 大额清算的二次确认机制。
  • 导出加密格式的清算审计流水。