You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
virt/docs/PRUNING_REPORT.md

54 lines
6.4 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 当前保留与删除边界
本仓库是独立 Virt Cloud 项目,开发分支为 `go`。旧项目目录不属于本仓库,也不作为运行时依赖。
## 保留
- venix 管理主题,以及原虚拟机面板风格的登录页和普通用户页。
- 邮箱注册/登录、验证码、TOTP、可信设备、会话撤销、密码找回、管理员账户管理、公告、工单、邀请、充值与财务能力。
- 云套餐、库存、订单、发票、支付、独立预付费账期、冻结到用户与商业线路组的共享流量池、严格 FEFO 流量分配和三天未支付续费宽限。有限额度到期只作废自身未用部分;无限流量账期不加入有限流量池,旧的未入池账期继续使用实例独立额度。
- 多宿主机、资源池、容量策略、reservation、具体公网 IP 账本、多 CIDR、云镜像、救援 ISO、快照、防火墙、指标与控制台入口。
- 同地区 direct L3 VPC:后台地区 CIDR 池、用户 VPC/IPAM、实例冷启动连接与断开、宿主机路由投影和维护迁移保留私网 IP/MAC。VPC 不提供跨地区互联、NAT 或二层广播;独立备份恢复和云快照新建实例不继承源实例 VPC。
- 同宿主机、同商业线路内的公网地址池受控批量替换:面板一次性冻结每台实例的目标 IP,再以独立 `network_change` 子任务并发执行。全部成功且源池无占用后才停用源池;部分成功继续排空,任一效果未知都保留原 operation 围栏并禁止自动重放。
- 管理员工单 Telegram 通知,以及当前绑定的超级管理员对已映射通知的纯文本回复;普通用户仍只在网页处理工单。
- 公开产品落地页,以及后台统一维护、带草稿和发布历史的全局服务条款与隐私政策页面;法律内容不按域名拆分。
- 后台双 S3 兼容对象存储后端、密钥密封和只读连接验证。普通云备份以一个就绪主副本完成发布并异步补齐第二副本;云镜像与救援 ISO 必须在两个不同故障域形成就绪副本后才能发布。管理员可把受支持实例的完整系统盘备份上传到对象存储,并在原宿主机或其他合格宿主机的指定资源池上,使用同一已验证网络接入下全新的 IPv4+IPv6 双栈地址创建独立免计费实例。普通用户可按服务周期购买自动备份,在实例设置中选择每天或每周执行并保留最多两份;全局备份库独立于源实例生命周期,源实例删除后仍可恢复或清理对象。增量链和管理员手工备份的自动保留策略暂未接入。
## 删除
- 旧 Python/libvirt 引擎的全部代码、服务、配置、密文、内部 API 和数据库兼容路径。
- SSH 驱动的宿主机凭据模型。PHP 不保存 root 密码或私钥;每台宿主机改为本地 Go Agent。
- 旧节点列表、节点管理、代理订阅/流量/等级业务、旧客户端分发、签到、AI、社区聊天、DNS 策略、边缘配置和已退役监控入口。
- Material、Codex 等主题;只保留 venix 管理主题和既有用户面板样式。
- 旧账户哈希、旧代理字段、账户/等级到期、旧引擎表、旧宿主机表和旧任务载荷的导入。
- 云镜像原始来源路径、`source_type`/`sealed_source_url` 目录字段,以及面板暂存文件直接签发给 Agent 的 `cloud-template` 下载能力;新镜像必须先形成对象存储不可变主副本。
普通用户不得获得 `/admin/agents`、宿主机、资源池、网络池、镜像后台或系统日志管理能力。删除菜单不是授权边界;PHP 路由和服务层必须继续校验用户、资源所有权、管理员及超级管理员权限。
## 新职责边界
- PHP 是账户、财务、资源账本、Agent 注册、公共 HTTP 授权和操作协调的唯一权威。
- 每台宿主机的 `virt-agent` 只负责本机 `qemu:///system`、受管磁盘、网络、防火墙、快照、救援、指标和控制台后端。
- 面板到 Agent 的每个请求使用该宿主机独立 HMAC 密钥,并在 Agent 主动建立的 WSS 会话上转发。Agent 不连接面板数据库,浏览器不能直接调用 Agent。
- Agent Gateway 负责 Agent 主动 WSS 会话、PHP 请求转发和反向控制台,不承担账户或 VM 调度逻辑。
## 数据库边界
`web/sql/ss.sql`、`web/sql/user_log.sql` 和 `php xcat cloudInit` 只用于全新空数据库。安装过程不读取、转换或删除旧生产库;旧库应作为离线只读备份单独保存。
Agent 数字身份、启用状态、版本和测试结果保存在 PHP 业务库,不保存宿主机 endpoint;每宿主机 HMAC 密钥使用面板 `cloud_data_key` 的用途隔离密钥密封。云镜像及首次启动脚本同样由 PHP 保存,任务派发时快照 revision 与 generation。Agent 的操作日志只保存本机操作边界和结果,不取代业务库。旧格式密文不受理;只能创建全新数据。
配置文件必须可读且内容有效,但应用不得用 owner/group/mode 审核阻止启动。推荐最小权限只是部署加固,不是兼容条件;绝不能因此增加弱密钥、明文传输或公开端口的回退。
## 业务不变量
- 每次购买只创建一台 VM;同一幂等键和 `operation_id` 不得重复扣款或重复创建。
- 每次续费创建独立账期和流量权益;提前续费顺延,不提前刷新当前权益。有限权益只在购买时冻结的同一用户与商业线路组内共享,并按到期时间优先、权益 ID 次序的严格 FEFO 消耗;权益到期只作废自身未用额度,历史消耗不回退。
- RX 与 TX 都计费。无限流量账期不贡献也不消费有限流量池;强制模式下共享池耗尽会断开该用户与线路组内全部活动有限流量实例,恢复可用余额后只解除流量池自身的限制。旧的未入池账期仍按实例独立额度处理。最终到期只断网,不关机;三天宽限结束才删除定义和面板受管磁盘。
- 派发后的超时、断线和进程中断是未知结果。破坏性操作不能自动重放、自动退款或仅靠删除任务记录释放资源。
- VM 使用 Q35 UEFI 并关闭 Secure Boot。镜像首次启动脚本只执行一次,失败或中断也不自动重放。
## 发布条件
删除旧代码或通过单元测试都不等于可上线。必须按 [部署说明](DEPLOYMENT.md) 和 [验证说明](VALIDATION.md) 在非生产环境完成 PHP、MariaDB、Agent、libvirt、网络、UEFI、cloud-init、付款、控制台和失败核对验收。