Files
cms-SiteForge/docs/V8_12_WORKFLOW_USABILITY.md
T
浅念 5c7643fcf2 upgrade: adopt V8.12.0-dev.1 (V8.11 unified professional UI + V8.12 workflow usability)
- Overlay 26 changed files from SiteForge_Enterprise_V8_12 (UI layer only:
  professional-ui.js/css, workspace/factory-v2/operations/editor templates,
  +2 test files, compose/ci/scripts/docs)
- Re-apply v8_workflows type-mapping fix (类型/分类) lost in upgrade
- Pin compose project name to siteforge-v8-10 so existing data volumes
  (hesupipe site 483295c29ea0, 193 entries) keep attached
- Drop stray .s10_* state files; ignore .s10_*/.sf_*/.s87_* patterns
- Plan/spec revisions per plan-review round 1 (icons are new design,
  real test assertions, recorded deviations)

Tests: 226 passed / 1 env-only failure (test needs node binary in PATH,
absent in python:3.12-slim container; host node v24 --check all 9 JS OK)

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-22 17:02:45 +08:00

3.4 KiB

SiteForge Enterprise V8.12 — 工作台流程与任务可恢复性

本轮目标

在 V8.11 专业页面统一导航之后,继续修复普通用户实际操作中的断点。本版不声称完成 Art Design Pro 官方前端或 P5 企业级远程发布,数据库 schema、主题和已有构建引擎未作破坏性变更。

真实代码改动

旧问题 新功能 实现位置
刷新后回到首页,丢失当前站点 优先解析 URL 中 site/view,之后参考上次网站偏好;都要先校验 /api/sites 可访问列表 app/static/workspace.js
无法前进/后退或分享指定页面 用 history.pushState 和 popstate 管理站点+菜单状态,避免浏览器刷新;异步选站采用序号避免慢响应覆盖当前站 workspace.js
工作台“完善设计”永远显示未完成 设计标为持续优化项,按已有内容与构建确定建议的下一步,不杜撰人工验收结果 workspace.js
关闭/刷新构建页后看不到运行中的任务 查询 /api/enterprise/sites/{id}/jobs 和已有构建版本;进入构建页自动刷新;有活跃任务时定期刷新并禁止重复点击 workspace.js
任务取消入口不直观 在构建页直观显示 Worker 状态与取消按钮,仍调用受权限保护的原 API workspace.js
构建未完成也显示预览/下载入口 仅完成状态提供预览、质量报告和 ZIP 下载 workspace.js
“快速导入”默认直接写入且不可批次回滚 默认进入既有可暂存、预演、确认、回滚的专业导入工作台;快速直写保留在显式展开的高级区并要求确认 workspace.js
难以分清构建与正式发布 增加“交付前检查”按钮,调用既有 /api/factory/sites/{id}/migration/readiness,展示阻断及待审事项,不将构建完成误称为上线 workspace.js

验证与已知限制

  • 后端使用现有 CSRF 与 RBAC,不引入第二套任务队列。
  • 离线预览文件使用模拟 API 和示例数据,不连接真实后台,不能用于证明真实浏览器 E2E。
  • 正式站点需要实测多网站切换、长耗时 Worker、真实数据导入和 SEO 审核;生产发布仍需 P5 完整实施。
  • V8.12 没有声称已经完成 Elementor/WooCommerce 任意站点无损迁移、PostgreSQL/Redis 多实例生产验收或官方 Art Design Pro 编译。

推荐人工验收步骤

  1. 登录,选择网站 A,进入内容管理;复制浏览器 URL 并刷新,仍在 A 内容页面。
  2. 切换 B,使用浏览器返回/前进,正确恢复 A/B 且没有旧站 API 响应覆盖当前站。
  3. 提交构建,跳到其他菜单再回来;Worker 运行时界面可恢复;取消按钮有确认。
  4. 构建未完成时不提供下载;成功后出现预览、检查及 ZIP。
  5. 导入页面的主要操作进入“安全导入”,直写只在高级折叠区。
  6. 运行交付前检查,能识别阻断和待审核事项;检查通过也不会显示已上线。
  7. 360px 与 390px 下侧边栏、任务列表、操作按钮可触达。

运行

docker run --rm -v "${PWD}:/project" -w /project python:3.12-slim python scripts/init_config.py
docker compose up -d --build

部署建议: 在新测试卷启动,不直接覆盖原 V8.11 数据卷。检查 /api/health 版本为 8.12.0-dev.1 后再进行测试。