# 前端集成蓝图：跨节点资源共享配额管理 (Resource Quota)

> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_SOV_14 逻辑后产出。

## 1. 业务意图 (Business Intent)
- **核心价值**：实现全球 Hub 节点间的资源弹性共享，基于声誉分数动态分配算力与存储配额，确保高信用节点在资源紧张时拥有优先权。
- **关联后端 Service**：`NodeResourceQuotaService.ts`

## 2. UI/UX 布局方案 (Layout Design)
- **页面入口**：Console -> 节点治理 -> 资源共享配额
- **展示组件**：
    - [ ] **配额使用进度条**：展示当前算力、存储的已用配额与总配额。
    - [ ] **配额分配记录表**：展示最近由于声誉变化导致的配额调整历史。
    - [ ] **跨节点任务监控**：展示当前正在借用其它节点算力执行的任务。
- **交互草图**：
    ```text
    +-----------------------------------------------------------+
    | [Icon] 跨节点资源配额 (Resource Quota)                   |
    +-----------------------------------------------------------+
    | [ 当前声誉: 92.5 ] [ 配额状态: 充足 ]                     |
    +-----------------------------------------------------------+
    | 算力配额 (Compute): [==========----------] 450/925 Units  |
    | 存储配额 (Storage): [=====---------------] 2.1/9.2 GB     |
    +-----------------------------------------------------------+
    | [ 配额调整日志 ]                                          |
    | --------------------------------------------------------- |
    | 时间       | 事件           | 算力变更 | 存储变更         |
    | 2026-03-14 | 声誉更新(+5)   | +50      | +500 MB          |
    | 2026-03-01 | 系统例行分配   | 875      | 8.7 GB           |
    +-----------------------------------------------------------+
    | [ AGI 资源建议 ]                                          |
    | "您的存储配额利用率较低，建议质押部分存储资源给 Hub-DE-01 |
    | 以赚取额外的声誉分。"                                    |
    +-----------------------------------------------------------+
    | [ 申请临时扩容 ]                  [ 资源外借设置 ]         |
    +-----------------------------------------------------------+
    ```

## 3. API 交互契约 (API Integration)
- **数据获取**：`GET /api/v1/governance/resource/quota?node_id=Node-Alpha`
- **关键字段映射**：
    - `compute_quota` -> 总算力配额
    - `storage_quota` -> 总存储配额
    - `reputation_score` -> 关联声誉分
- **状态流转**：
    - 声誉变动 -> 调用 `NodeResourceQuotaService.allocateQuota` -> 数据库更新 -> UI 重新渲染。

## 4. 生产校验项 (FE Readiness)
- [ ] 算力与存储配额消耗的准实时性核对（误差 < 1%）。
- [ ] 临时配额申请的自动化审批工作流。
- [ ] 导出包含跨节点资源贡献的年度技术审计报告。