YG_FT/平台治理.md

平台治理功能说明

平台治理涵盖用户管理、租户管理、项目管理、审批管理、审计日志、资源授权(ACL)、留存策略等企业管理能力。功能入口位于侧边栏「平台治理」和「系统设置」两个分组下。

本平台核心业务是模型微调：用户上传数据 → 数据处理 → 模型训练 → 模型评测 → 模型推理。平台治理负责管理谁能访问哪个租户/项目的哪些资源。

---

侧边栏菜单结构

平台治理
├── 租户管理        /tenants
├── 项目空间        /projects
├── 审计日志        /audit-logs
├── 审批模板        /approval-templates
└── 审批中心        /approval-instances

系统设置
├── 用户设置        /user-settings
├── 平台性能        /hardware
└── 查看日志        /logs

---

1. 租户管理

对应页面：列表页 TenantListView.vue + 详情页 TenantDetailView.vue
后端接口：GET/POST /tenants、GET/PUT/DELETE /tenants/:id、PUT /tenants/:id/quota、PUT /tenants/:id/retention-policy

列表页

展示列：租户名称、用户ID、状态、创建时间

行操作：

按钮	功能
详情	跳转详情页 /tenants/:id
删除	确认弹窗后调用 DELETE /tenants/:id

新建租户弹窗：

字段	控件	说明
名称	文本输入	必填
用户ID	文本输入	可选
GPU 数量	数字输入	配额，0=不限制
存储配额(GB)	数字输入	配额，0=不限制
最大项目数	数字输入	配额，0=不限制

详情页

基本信息：名称、用户ID、状态、创建时间、配额（友好格式显示，如 GPU 8 | 存储 100GB | 项目 5）

配额编辑：GPU 数量 / 存储配额(GB) / 最大项目数，三个数字输入 + 保存按钮

已移除：详情页中不再内嵌项目空间列表（项目有独立页面）

当前缺失

• 编辑租户名称和用户ID（updateTenant API 已有，UI 缺失）
• 留存策略关联设置（setTenantRetention API 已有，UI 缺失）
• 列表页无搜索/筛选
• 状态列无 Tag 着色

---

2. 项目空间

对应页面：列表页 ProjectListView.vue + 详情页 ProjectDetailView.vue
后端接口：GET/POST /projects、GET/PUT/DELETE /projects/:id、GET/POST/DELETE /projects/:id/members、PUT /projects/:id/archive

列表页

展示列：项目名、编码ID、状态、描述、创建时间

工具栏：

• 租户选择器（下拉过滤，按租户编码选择）
• 搜索框（按项目名/编码搜索）
• 新建项目按钮

新建项目弹窗：

字段	控件	说明
名称	文本输入	必填
编码ID	下拉选择	选择已有租户的编码（如 default），关联到该租户
描述	文本域	可选，3行

行操作：详情 + 删除

详情页

基本信息：名称、编码、状态、租户、描述、创建时间

项目成员管理：

• 成员列表（用户名、角色、添加时间）
• 添加成员：选择用户 + 角色（member/admin/viewer）
• 移除成员

资源授权(ACL)：

• 弹窗编辑器，逐条配置授权规则
• 主体类型：用户（下拉选已有用户）或项目角色（member/admin/viewer）
• 权限：read / write / execute / download / delete / share（多选 checkbox）
• 增删行后统一保存

当前缺失

• 编辑项目基本信息（名称、描述）
• 项目启停/归档操作（archiveProject API 已有，UI 缺失）
• 项目下的资源使用统计（模型数、数据集数、任务数）

---

3. 审批管理

对应页面：ApprovalTemplateView.vue（模板）+ ApprovalInstanceView.vue（实例）
后端接口：模板 CRUD、实例列表+决策

审批模板

展示列：模板名、步骤数、创建时间

新建模板：

字段	控件	说明
模板名称	文本输入	必填
审批步骤	文本域	需手写 JSON 字符串，体验差

当前缺失：

• 可视化步骤编辑（拖拽添加步骤、选审批人）
• 模板编辑/删除（API 已有，UI 缺失）
• 模板详情页

审批中心

展示列：资源类型、资源ID、状态（Tag着色）、发起人、创建时间

工具栏：状态筛选（待审批/已通过/已拒绝）、资源类型/ID 搜索

行操作：通过/拒绝（弹窗填写审批意见）

当前缺失：

• "我发起的"审批视角
• 审批流转详情（谁审批了、什么时间）
• 撤回功能

---

4. 审计日志

对应页面：AuditLogView.vue
后端接口：GET /system/audit-logs（多条件筛选+分页）、GET /system/audit-logs/export（CSV导出）

列表页

展示列：时间、租户ID、项目ID、操作人ID、动作、目标类型、目标ID、详情、IP

筛选条件：租户ID、项目ID、操作人ID、动作、目标类型、开始时间、结束时间

工具栏：CSV 导出按钮（最多 10000 条）

当前缺失

• 分页控件（数据量大时需要翻页）
• 筛选字段改为下拉选择（当前全是文本输入，不知道有哪些可选值）
• 详情弹窗（点击某条记录查看完整信息）

---

5. 用户设置

对应页面：UserSettingsView.vue（列表）+ UserCreateView.vue（创建）+ UserPermissionView.vue（权限弹窗）
后端接口：GET/POST/PUT/DELETE /users、POST /users/:id/reset-password

列表页

展示列：账号、显示名、角色、状态、页面权限、创建时间

行操作：

操作	说明
启停开关	protected 用户和自己不可操作
重置密码	弹窗确认，默认密码 Platform@123
页面权限	弹窗 checkbox 组，12 个模块可选：看板/模型训练/模型评测/模型推理/模型管理/数据集/数据处理/数据转换/算力/平台性能/查看日志/用户设置
删除	确认弹窗，protected 用户和自己不可操作

创建页

表单字段：账号、显示名、初始密码、角色（超级管理员/操作员/观察员）、状态、页面权限

当前缺失

• 用户编辑页面（修改显示名、角色等，updateUser API 已有，UI 缺失）
• 权限码显示为英文（如 fine-tune），无中文翻译

---

6. 平台性能

对应页面：HardwareView.vue
后端接口：GET /system-info、GET /health（顶部栏实时指标）

页面内容

概览卡片：CPU（型号/核心数/使用率）、内存（已用/总量/使用率）、磁盘（已用/总量/使用率）、网络吞吐

趋势图：CPU/内存/磁盘/GPU 利用率折线图（最近 60 次采样，1/3/5/10秒自动刷新）

GPU 资源池：每张卡展示名称、状态、利用率、显存、温度、功耗、风扇转速；点击卡片查看详情抽屉（设备属性、趋势图、进程列表）

主机信息：OS、运行时长、进程数、GPU 驱动版本

当前缺失

• 历史数据持久化（刷新后采样清空）
• 告警阈值设置
• 网络吞吐数据显示为空

---

7. 查看日志

对应页面：LogsView.vue（系统日志 + 训练日志双 Tab）

系统日志

• 按日期选择日志文件
• 关键词搜索
• 日志级别筛选（INFO/WARN/ERROR/DEBUG）
• 自动刷新（5/10/30/60 秒可调）

训练日志

• 按 PID 选择训练日志文件
• 同样支持搜索和级别筛选

当前缺失

• 日志下载/导出
• 分页或虚拟滚动（大文件加载慢）
• 行号显示

---

8. 留存策略 ⚠️ 前端完全缺失

后端 API 已完整实现（CRUD 5 个端点），前端 retention.ts 模块已封装，但：

• 侧边栏无菜单入口
• 路由未配置
• 无任何 Vue 页面

---

数据流转关系

用户登录 → 分配角色(admin/operator/viewer) + 页面权限
    │
    ├─ 创建租户（配额：GPU/存储/项目数）
    │     └─ 关联用户
    │
    ├─ 创建项目（关联租户，选择编码ID）
    │     ├─ 项目成员（角色：member/admin/viewer）
    │     └─ 资源授权(ACL)：谁对什么资源有什么权限
    │
    ├─ 创建审批模板（定义审批流程）
    │     └─ 审批实例：敏感操作需要审批（通过/拒绝）
    │
    ├─ 审计日志：所有操作自动记录（谁在什么时间做了什么）
    │
    └─ 留存策略：定义数据保留周期，自动清理过期数据

---

完成度总表

模块	列表	新建	编辑	删除	搜索	筛选	导出	完成度
租户管理	✅	✅	仅配额	✅	❌	❌	❌	75%
项目空间	✅	✅	❌	✅	✅	按租户	❌	80%
审批模板	✅	✅(JSON)	❌	❌	❌	❌	❌	45%
审批中心	✅	N/A	N/A	❌	✅	按状态	❌	65%
审计日志	✅	N/A	N/A	N/A	❌	多字段	CSV	70%
用户设置	✅	✅	仅权限	✅	❌	❌	❌	75%
平台性能	✅	N/A	N/A	N/A	N/A	N/A	❌	80%
查看日志	✅	N/A	N/A	N/A	关键词	按级别	❌	70%
留存策略	❌	❌	❌	❌	❌	❌	❌	0%