浅念
8cea7dee20
- SiteForge Enterprise V8.10.0-dev.1 upstream source (210 tests) - Fix: v8_workflows._mapped_input now reads both 类型/分类 columns so WXR imports keep post/product types instead of collapsing to page - Docs: trade-pro theme port spec (R3) and implementation plan Co-Authored-By: Claude Code <noreply@anthropic.com>
59 lines
6.6 KiB
Markdown
59 lines
6.6 KiB
Markdown
> 本文件含 V8.8 原始评估内容；V8.9 最新实测数据与剩余门禁以 [V8.9 验收报告](P0_P4_V8_9_VERIFICATION.md) 为准。
|
||
|
||
# SiteForge Enterprise V8.9 — P0–P4 实现与验收矩阵
|
||
|
||
> 状态：**集成开发版，不是生产验收完成版**。本文件依据《COMPLETION_PLAN(1).md》v2.0 的 P0–P4 验收要求，结合 V8.8 源码与 V8.9 新增的导入、性能、恢复及媒体回归编写。文档历史记录（原源码 v5、运行 v4）不等于本工程当前运行事实。
|
||
|
||
## 本轮实质交付
|
||
|
||
1. **按设备调整真正的多列布局**：`layout` 区块现在分别支持平板 1–3 列、手机 1–2 列；每列单独设置顺序、跨列、显隐；子组件支持已有响应式样式。规则校验后构建成静态 CSS。为防整站模板复制后 ID 冲突，按网站页面路径哈希作用域隔离 CSS。
|
||
2. **整站套版增加审核态**：后台原“确认应用”改成“暂存 → Owner 发布”；发布时必须验证草稿版本与整站布局指纹；若网站被其他人修改，返回 409，不静默覆盖。
|
||
3. **多页套版原子化**：使用同一个数据库事务修改全部页面和网站主题/导航；执行中失败后整体回滚；拒绝覆盖仍存在的页面/全站草稿。新页面默认草稿状态、`noindex,follow`，不伪造 SEO 与客户数据。
|
||
4. **路径与媒体修复**：区块 CTA、图片等使用根路径；编辑器预览使用 `/local-media/{site}/{file}`；新增站点媒体库选择与画廊/轮播添加入口。
|
||
5. **样式白名单收口**：背景色严格为六位十六进制；间距为 0–120 的整数，显隐为布尔值；防止无效 CSS 或任意表达式进入构建器。
|
||
6. **版本、Compose、CI 断言统一**：`8.9.0-dev.1`；修复旧 `siteforge-v8-6` Compose 项目名遗留问题；保留独立 Worker 健康检查与测试脚本。
|
||
|
||
## 对《COMPLETION_PLAN(1).md》逐项判断
|
||
|
||
符号：✅ 已有代码及本地测试；◐ 部分实现/缺实机验收；❌ 未完成。
|
||
|
||
| 阶段 | 需求 | 现状 | 阻断生产交付的剩余工作 |
|
||
|---|---|---|---|
|
||
| P0 | 版本标识、预览根路径、favicon、Worker 健康 | ✅/◐ | 目标机上镜像摘要、实际浏览器、回滚演练尚未验证 |
|
||
| P0 | 一键 Compose 构建/启动、备份恢复、跨平台 CI | ◐ | Docker Engine 实机及 GitHub Actions 真正运行、旧数据库升级演练 |
|
||
| P0 | 真实凭据轮换 | ❌ | 运维方需要在自己环境轮换管理员口令、Session、第三方 Secret，不能通过打包源码代替 |
|
||
| P1 | 数据库迁移登记、Worker 幂等/超时/取消/重试/容量 | ◐ | SQLite 迁移登记已有；旧表的完整版本迁移、多个 Worker 并发/死信恢复仍不完整 |
|
||
| P1 | 安全出网、密钥引用、日志、资源上限 | ◐ | 核心 HTTP SSRF 规则和密钥引用已有；生产密钥轮换、告警、各协议审计仍待实机 |
|
||
| P2 | WordPress REST/WXR、Sitemap、检查点、媒体 | ◐ | 公开文章、页、分类、标签、有限媒体已支持；私有内容与任意 Elementor/ACF/WooCommerce 结构不能保证无损 |
|
||
| P2 | 全 URL/SEO/媒体基线及统一迁移向导 | ◐ | 有 URL/SEO 比较和复核；需要本地综合夹具、真实授权 WP 站点全流程验收，复杂媒体 CSS/srcset 适配继续开发 |
|
||
| P3 | Excel/CSV/JSON/XML/API/只读 MySQL | ◐ | 有暂存、映射、工作任务、关系预览与回滚；真实 MySQL TLS、5000 条数据容量、API 密钥轮换仍待验收 |
|
||
| P3 | 安全 XML/ZIP 与批次完整回滚 | ◐ | XXE/压缩限制与受保护回滚已有；更复杂文件与异常恢复需故障注入测试 |
|
||
| P4 | 受控声明式区块/主题预设 | ✅ | 有组件白名单、四套主题、模板预检及安全渲染；实际视觉质量需正式素材验收 |
|
||
| P4 | 页面/全站草稿与正式构建隔离 | ✅/◐ | 页面草稿/全站草稿已隔离，整站模板现在具备暂存及 Owner 发布；旧批量生成入口仍需全面权限梳理 |
|
||
| P4 | PC/平板/手机不同布局 | ◐ | 现在支持区块间距/显隐与布局列数/跨列/排序；不等于三套完全独立可拖拽画布 |
|
||
| P4 | 整站模板可复制、回退、兼容检查 | ◐ | 已预检、模板暂存与原子应用；模板版本升级兼容和视觉回归、全站变更历史回退仍不完整 |
|
||
| P4 | Chrome 桌面/平板/390px/360px 回归与无障碍 | ❌ | 需真实浏览器交互、键盘流程及系统性视觉回归；当前环境未完成 |
|
||
|
||
## 不应误报为完成的需求
|
||
|
||
- 正式 **Art Design Pro 官方工程**整合与编译：未完成。当前仍以现有 Web 后台为主。
|
||
- PostgreSQL/Redis 的高可用和多实例：非 P0–P4 生产验收范围，也尚未完成；企业 Compose/兼容层不能代替实测。
|
||
- SFTP/S3 正式发布、生产回滚、多语言：P5–P7 尚待后续独立交付。
|
||
- 任意 WordPress 插件的像素级还原：不承诺。必须按特定站点/组件制定转换规则和复核结果。
|
||
|
||
## 已执行的验证
|
||
|
||
- Python 自动化回归，包含 V8.8 新增的响应式布局、复制模板、草稿不泄漏、两步应用、旧站改动拒绝、事务失败回滚、内页链接及媒体路径等专项测试。
|
||
- `scripts/verify_release.py`、JavaScript `node --check`、Python 编译、源码 ZIP 完整性；以上以实际最后一次运行结果为准。
|
||
- **未执行**：真实 Docker Engine 启动、GitHub Actions 云端运行、正式浏览器和移动设备视觉测试、授权 WordPress 实站迁移、远程发布故障恢复、真实 MySQL TLS。
|
||
|
||
## 达到 P0–P4 完全验收的明确条件
|
||
|
||
需在安装好的测试服务器上完成：`docker compose up -d --build` 一条命令通过；`/api/health` 和镜像版本相符；360/390/1024/1440 像素交互验收；5000 行内容导入与批次中断恢复；WordPress REST/WXR/Sitemap/媒体综合本地夹具及一个授权实站；四主题整站草稿、模板套用、构建前后隔离；密钥轮换、安全审计、数据库备份与恢复。每项有可重复报告，未过项不能标记为生产完成。
|
||
|
||
## V8.9 补充（以新报告为准）
|
||
|
||
- 已加入 P0 备份先验证后恢复、P2 WordPress 响应式媒体路径、P3 站点级品牌/分类缓存和 100 条分页、P3 性能夹具、P4 静态质量与模板回归测试。
|
||
- 5,000 条同分类测试，技术构建生成 50 个分类分页和 50 个产品中心分页；独立静态 QA 扫描 5,191 HTML，`errors=0`。详细警告与环境限制参见 `P0_P4_V8_9_VERIFICATION.md`。
|
||
- **仍不满足 P0–P4 全面上线门禁**：真实 Docker、GitHub CI、各设备浏览器、授权 WordPress 站点、真实 MySQL TLS、密钥轮换/高可用尚未实机验收。
|