Files
cms-SiteForge/docs/V8_28_GUIDED_LAUNCH_CENTER.md
T
浅念 8884e100f9 upgrade: adopt V8.31.1 (theme 1.3/1.4 redesigns, editor deep-canvas, guided launch, component library)
Overlay 190 upstream items (V8.22→8.31) preserving trade-pro theme,
registry tests, and design docs. Re-applied full patch set on identical
anchors (discovery/env_for/blocks.css/type-mapping/locale-override/
theme_color/frontend entries/test_theme_pro_v3 mods) plus compose pins.

Verified: theme suites 35/35; dual-baseline full run 415 passed vs
pristine 386+29 ours, FAILED-set diff EMPTY (same 10 Windows env fails).
Live: container 8.31.1-dev.1 healthy, hesupipe 192 entries intact,
trade-pro build 203 pages 0 errors.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-26 09:43:17 +08:00

5.3 KiB
Raw Blame History

SiteForge Enterprise V8.28 — 新手友好上线操作中心

版本:8.28.0-dev.1
交付类型:V8.27 完整源码的增量集成版(开发验收,不是生产验收)
设计原则:用户只看到当前应执行的操作;用日常中文解释状态;不能把构建、审批或任务排队错误地称为“已上线”。

1. 打开方式

登录工作台 → 选择当前网站 → 左侧 检查并上线。也可从网站概览的快捷卡片、建站操作指引(审核并上线)进入。

2. 六个步骤

步骤 使用者要做的事 系统做的检查 常见问题
1. 选择网站版本 选择已完成的静态构建;如果没有则点击“开始构建” 只列出 status=complete 的构建 网站保存成功不代表已构建
2. 预览并检查质量 打开预览、核对图片和 SEO;勾选本地检查框 人工确认只存在于当前页面会话,不是服务器审批 检查不同设备和关键链接
3. 提交审批 向另一位审核人提交申请 读取服务器审批状态;重复 pending/approved 不重新申请 自己不能审批自己提交的申请
4. 发布前检查 审批通过后点击“执行发布前检查” 调用既有 /api/production/sites/{site}/preflight/{build} 会重新校验构建、质量、迁移和审批
5. 提交部署 选择测试或正式环境,再提交 只有前述条件全部满足且目标已配置时才启用;服务器仍重新校验 未配置目标时联系运维配置 Agent/SFTP/S3
6. 真实网址核查 等待 Worker 完成,再到网站地址检查 读取发布记录,但不把发布记录视为外网验收成功 检查 DNS、TLS、CDN 缓存、主页、联系表单

请注意正确顺序:先提交审批、由其他有权限的人员通过,再执行发布前检查。之前页面中“检查发布条件”放在“提交审批”之前,实际服务器会因为缺乏审批而拒绝,是本版修正的重要体验问题。

3. 安全边界及兼容性

  • 没有新开任何发布后门。申请、检查、部署都调用原有服务端端点,继续受登录、CSRF、站点角色、质量检查、独立审核、Worker 任务与安全出网限制。
  • 所有临时确认与发布前检查结果仅用于当前会话的按钮状态,不写入业务数据库;浏览器刷新后需重新操作。换站、换构建或换环境会清除相关确认,防止复用错误状态。
  • 发布前检查与部署存在时间差,服务端部署操作必须再次校验。客户端按钮仅用于简化引导,不能替代后端检查。
  • 读取审批状态失败时不宣称“未申请”或者“已批准”;读取目标配置失败时不宣称目标已经配置。
  • 只显示当前网站对应版本的审批/发布记录,跳过不属于所选站点的结果。
  • 已有“构建与交付”的专业管理功能继续保留在高级折叠区域,原有 API、数据库 Schema、URL、构建产物和发布审批策略均未改变。
  • 正式域名按钮只接受符合 HTTPS 格式的地址;在离线演示中使用 example.com 占位地址,不会访问生产环境。

4. 非技术使用者视角的改善

原流程需要在“建站指引、构建、审批中心、质量报告、部署记录”之间来回跳转,也容易把构建成功当作上线。现在正常日常操作可以在一个页面内完成,进阶操作仍可进入专业工具。

导航明确命名为 “生成与预览” 和 “检查并上线”,避免技术用户和普通用户混淆。移动端在 390px 宽度验证按钮、表单自适应,无横向溢出。

5. 模块与回归入口

  • app/static/workspace-launch.js:可单独测试的发布流程状态模型。
  • app/static/workspace.js:上线操作中心 UI、API 操作、审批状态读取及站点切换保护。
  • app/templates/workspace.html、app/static/workspace.css:统一入口与响应式布局。
  • tests_js/workspace_launch_v828.test.cjs:上线流程前置条件、防跨站/跨版本、目标环境、是否真正上线等场景。
  • tests/test_v828_launch_center.py:页面/脚本/API 连接检查。
  • scripts/browser_launch_v828.py:使用真实工作台 JS 的隔离 Chromium 测试(模拟 API,不触碰生产)。
  • scripts/regression_v828.py:独立 pytest 批次回归执行器,保留原始结果。
  • examples/V8_28_简洁上线操作中心_交互演示.html:双击即可打开的模拟数据界面,可点击“模拟另一位审核人批准”。

本地检查命令

python -m pytest -q tests/test_v828_launch_center.py tests/test_v827_guided_workspace.py
node --test tests_js/*.test.cjs
python scripts/browser_launch_v828.py
python scripts/http_end_to_end.py
python scripts/verify_release.py
python scripts/regression_v828.py --group-size 2 --timeout 25

6. 未关闭的正式交付门槛

  • Chromium 本次模拟原始后台 Web/API,不能代替真实账号登录、真正不同账号审批、实际公网部署与回滚的端到端演练。
  • Art Design Pro 官方完整工程未随项目提供,官方 pnpm build 尚无实测证据。
  • PostgreSQL/Redis 多 Worker、多实例、真实 Agent/SFTP/S3 与备份恢复、CDN、公网 DNS/TLS 仍需独立验收。
  • 复杂 WordPress 站点的全量 URL/SEO/图片及插件迁移还不能直接宣称 1:1 全部完成。