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

59 lines
7.7 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.

# PHP 旧业务清理报告
日期:2026-09-27。所有改动仅在 `/Users/admin/Documents/www/virt-cloud/web`。
原 `/Users/admin/Documents/www/html` 和 `/Users/admin/Documents/www/virsh-panel` 未修改。清理阶段没有操作 Git;新项目后续统一使用目标仓库的 `venix` 分支管理。
> 历史说明:本文记录 2026-09-27 的旧业务裁剪阶段。之后 Virt Cloud 已完成宿主机配置集成;当前行为以 [INTEGRATION_PLAN.md](INTEGRATION_PLAN.md)、[DEPLOYMENT.md](DEPLOYMENT.md) 和现行路由为准。文中关于管理员宿主机页面“不接受凭据、不连接宿主机”的描述只代表当时的过渡状态,不是当前版本契约。
## 本轮完成
- 仅保留 venix 的模板和静态资源,删除 Material、Codex 两套主题。
- 用户页面节点列表、菜单、旧节点 API 全部移除;在本报告对应的过渡阶段,管理员 `/admin/hosts` 曾是宿主机配置准备页,字段和按钮禁用,不接受凭据、不保存配置、不连接宿主机;该状态已由后续 Virt Cloud 宿主机配置集成取代。
- 用户确认的 AI、社区聊天、边缘配置、DNS 策略、节点网络监控/访问 API、代理流量/TCP/连接告警、闲置/异常用户、Apple 账号功能、订阅记录、Redis 在线设备、在线 IP、审计规则/记录、付费注册、签到、用户文档和旧客户端分发功能已移除。包括路由、后台代码、模型、专属 SQL、页面和相关资源,不只是隐藏菜单。
- `Bob.php`、`apple-account-detector-go` 和检测器配套资源已移除。
- 取消代理流量/账户/等级重置、试用和自动清理任务;不再按账户/等级到期自动禁用或清除用户。验证码、会话、支付订单和优惠券的安全/支付有效期仍保留。
- 邮箱账户注册/登录、验证码、TOTP、可信设备、会话撤销、密码找回/修改、人工账户管理、公告、工单、问卷、邀请和充值/财务基础功能保留。手动邀请码轮换不是退役的代理重置任务。
- 账户表删去代理字段及账户/等级到期列,不提供旧测试数据迁移或代理占位字段。新密码使用 `password_hash`/`password_verify`,bcrypt cost 12、随机盐;新密码需 12–72 字节并包含大小写、数字、符号。旧 MD5/SHA 账户哈希不兼容。
- 本轮当时保留的用户旧商城及公开优惠码试算接口已在后续清理中移除;管理员基础套餐、销售方案与优惠券管理继续保留。旧代理套餐开通、流量/等级变更、重置/续费逻辑已经删除;保留优惠券管理不代表优惠券已接入新的云账单或订单流程。
- Telegram 只提供管理员私聊绑定和管理员工单通知。没有普通用户绑定、群组功能、TG 登录、签到、AI、订阅或机器人回复用户工单的能力;用户工单在网页处理。
## 配置、SQL 与备份
- 原实际 `.config.php` 未复制,因此修改的是 `web/config/.config.php.example`。
- 邮件、数据库和超级管理员配置区块保留;邮件模板已在后续云账单与实例通知工作中改造,不属于本次旧业务裁剪的原始结果。数据库区块内原有 Redis 在线库键也按“数据库配置不动”的要求保留,但没有在线设备实现再使用它们。
- 删除注册旧配置区块、旧业务重置/自动清理、多用户混淆、签到、文档、订阅/TG URL 等配置;保留登录 IP 绑定和剩余流量提醒配置。
- 剩余流量提醒阈值规则保留为 `TrafficNotificationThreshold`;尚未接入 VM 流量配额,因此不会读取已删除的代理用量字段或假装已经发出 VM 提醒。
- `ss.sql` 为全新 PHP 账户/销售基础结构,`user_log.sql` 仅保留邮件、设置和站点统计/安全五张表。它们不包含 Python 虚拟化引擎表;不要对生产数据库直接执行。
- 自动备份仅导出已配置的数据库 SQL,使用 AES-256 ZIP,私有目录 0700、文件 0600。无口令或 AES 支持时拒绝执行,不把网站、配置文件或应用密钥装入归档。数据库账号口令经私有临时客户端配置传递,不放入进程参数。
- 加密备份保存在 `storage/backups`,不自动删除历史。恢复加密支付设置还需另行保管原应用密钥/环境密钥;仅 SQL 不能替代密钥保管。
- cron 为注释示例,不会在副本中启动自动任务。
管理员 Telegram:配置入口已合并到 `/admin/ticket#telegram-notifications` 的“工单系统”,独立管理页面已删除。在这里配置开关、bot token 和独立 HTTPS 通信域名;token 与服务端生成的 webhook secret 使用 purpose-separated 密钥加密存储。升级时会尝试一次性导入旧 `config.php` 值,写入迁移标记后运行期只读数据库;示例配置已删除这些旧项。后台状态展示使用 60 秒 Redis 快照,其中 token 和 secret 始终保持密文,Redis 故障自动回退数据库,配置写入后立即失效快照;Webhook 校验、通知、注册和绑定等运行期凭据始终绕过缓存读取权威数据库。保存后注册 webhook、生成五分钟一次性绑定码,再向机器人私聊发送 `/start 绑定码`。绑定码只存哈希、事务锁消费;Webhook 使用官方 [secret token 请求头](https://core.telegram.org/bots/api#setwebhook) 校验,不在 URL 中传 secret。当前通知仅绑定一个管理员接收方,后台可重新绑定或解绑。
## 验证及限制
- 使用隔离 PHP 8.5.10 检查全部 177 个 PHP 源文件语法,32 个测试中 30 个通过、2 个因运行时缺少 sodium 扩展未能完成。涵盖路由目标、账户强密码、配置/SQL 边界、手动删除隔离、验证码、会话、邮件假客户端、配额阈值、CLI 安全等。
- Smarty 编译全部 66 个 venix 模板,无应用引导、无真实数据库访问;独立 Telegram 管理页路由移除后,共 142 条路由注册目标可解析。
- 44 个内联脚本以两种模板分支共检查 88 次,10 个顶层 venix JS 文件语法通过;51 个完整页面展开后的 HTML 标签检查通过。
- USDT 模拟扫描与 SQLite 内存库重复入账测试通过。易支付/Paytaro 完整测试受隔离运行时缺少 sodium 扩展限制,不能记为完整通过;保留真实加密实现,未做降级。生产运行仍需对应 PHP sodium 扩展。
- 依赖按现有 Composer lock 安装到临时测试目录,未升级项目锁定版本、未给网站安装运行依赖。
- 原第三方 Datatables 库仍有 PHP 8.5 弃用提示;原 venix 第三方 CSS 有少量已有的装饰图片缺失,不属于此次删除导致。尚未进行浏览器完整业务联调。
- 没有连接真实 MariaDB/Redis、SMTP、Telegram、支付渠道或虚拟化宿主机,没有初始化或清理任何真实数据库。
这仍是待集成的开发版本。网页首次初始化、统一普通用户 CSRF、SMTP TLS 校验、Python 私有引擎认证、VM 所有权、开通/计费状态机、VNC 和大文件上传等仍需后续实施;不要把此轮清理当成销售面板已经上线。
## 可恢复副本
清理前完整快照:
`/private/tmp/virt-cloud-prune.QCPXnM/web-before-prune.tar.gz`
精确移出的目录/文件:
- `/private/tmp/virt-cloud-prune.QCPXnM/removed-ui/views/material`、`views/codex`
- `/private/tmp/virt-cloud-prune.QCPXnM/removed-ui/theme/material`、`theme/codex`
- `/private/tmp/virt-cloud-prune.QCPXnM/removed-ui/downloads/SSEncrypt.module`
- `/private/tmp/virt-cloud-prune.QCPXnM/removed-backend` 中的 Bob、Go 检测器及删除文件清单
以上临时路径可能被系统清理。需要长期保留时,请把完整快照另存到自己的备份位置;不要直接覆盖已清理的工作目录,恢复应先解压到新的目录核对。