feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义
This commit is contained in:
2026-03-17 22:07:19 +08:00
parent c0870dce50
commit 136c2fa579
728 changed files with 107690 additions and 5614 deletions

View File

@@ -0,0 +1,51 @@
# 前端集成蓝图:跨节点资源共享配额管理 (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%)。
- [ ] 临时配额申请的自动化审批工作流。
- [ ] 导出包含跨节点资源贡献的年度技术审计报告。