浅念
8884e100f9
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>
4.8 KiB
4.8 KiB
SiteForge Enterprise V8.27 — 易上手工作台与操作指引
本轮交付性质
V8.27.0-dev.1 是 V8.26 完整源码上的增量集成版，不替换原后台 API，也不改变原数据库结构和静态构建引擎。历史版本功能继续保留。
改动范围
| 位置 | 已实现的操作 |
|---|---|
| 网站创建弹窗 | 拆成三步：基本信息 → 选择行业风格 → 预览和确认；支持上一步、必填校验、避免重复提交 |
| 当前网站操作指引 | 根据已保存内容、构建状态、Worker 任务与远程发布历史生成步骤；逐项有“开始操作”跳转 |
| 网站概览 | 突出“下一步应该做什么”，常用操作缩减为内容、设计、生成与预览 |
| 术语说明 | 区分内容保存、静态构建、检查与审批、正式部署；不把下载 ZIP、发布设计误称为上线 |
| 数据状态 | 仅自动建立的示例首页不会使“内容准备”自动完成；用户主动修改初始首页或添加正式内容才计入 |
| 手机界面 | 创建设计向导与引导列表适配窄屏，侧栏默认关闭，不增加底部固定遮挡 |
操作路径
- 登录 → 工作台 → 创建网站。
- 分三步填写网站名称、模式、主题和可选域名。
- 系统创建项目，自动切换到“建站操作指引”。
- 根据引导准备内容（旧站模式自动跳转迁移入口），可进入可视化编辑器修改样式。
- 执行静态构建，进入构建页面查看任务、预览和质量报告。
- 人工检查后由审批人员批准，再发起正式环境发布；必须核查实际域名。
使用者可读的状态定义
- 已保存：写入 SiteForge 内容数据库；访客网站可能尚未变化。
- 已构建：成功生成了一个静态版本；不能推断质量检查或发布已通过。
- 正式发布记录：有成功记录；仍需要在实际域名核实当前可用性。
- 构建可能过期：已保存内容/站点在最近完成构建之后变更，提示人工复核。
- 设计：始终视为可优化，不因为选择主题自动声明设计验收完成。
代码结构
app/templates/workspace.html：三步创建表单、引导导航入口。app/static/workspace-guide.js：纯函数SiteForgeJourney.plan；无本地跨用户数据缓存、无额外业务接口。app/static/workspace.js：向导控制、流程状态渲染、已有 API 调用。app/static/workspace.css：清晰的步骤条、状态列表、移动端布局。tests_js/workspace_guide_v827.test.cjs：引导状态单元测试。tests/test_v827_guided_workspace.py：真实测试客户端页面/接口联通。scripts/browser_guide_v827.py：实际工作台 JS 的 Chromium 隔离交互检查（模拟 API，不经过用户真实账号）。scripts/regression_v827.py：原项目分批 pytest 入口。
本轮测试及证据
- 原项目 Python 测试模块合计 379 条用例通过（24 批运行，其中 22 批直接通过；第 10 批组合运行超时、两模块拆开后 7+7 通过；第 22 批原断言对老结构写死而失败，更新以新模块校验后重新运行 21 项通过）。一键回归稳定性未通过。
- Node.js JavaScript 测试 23 项通过（原有 13 项 + 新增 10 项）。
- 原项目
scripts/http_end_to_end.py已通过真实 Web + Worker 隔离端到端链路。 scripts/browser_guide_v827.py：实际 V8.27 workspace 代码，模拟网络接口在 Chromium 隔离页测试，验证三步表单、空名称阻断、只在最后创建、创建后显示状态、手机不溢出、0 页面脚本错误。scripts/verify_release.py、python -m compileall -q app和node --check通过。
尚未完成/生产上线限制
- 正式 Art Design Pro 官方工程的
pnpm build及统一 SSO 登录未验收。 - 已登录真实服务器浏览器 E2E、真实手机测试尚未完成；Chromium 测试使用了模拟 API。
- PostgreSQL/Redis 多 Worker 真实压力及灾备、远程发布/回滚尚未在真实生产环境完整验收。
- 生产上线路径需要继续按原 P5 发布审批执行；本轮不绕过角色、审批或安全检查。
- 因原回归执行器存在组合批次偶发停滞，不得将本轮 Python 回归描述为一键全绿。
推荐复核命令
python -m pytest -q tests/test_v827_guided_workspace.py tests/test_workspace_v812.py
node --test tests_js/*.test.cjs
python scripts/http_end_to_end.py
python scripts/browser_guide_v827.py
python scripts/verify_release.py
python scripts/regression_v827.py --group-size 2 --timeout 35
最后一条命令的运行环境可能出现分组超时，查看
reports/v827-regression/result.json与原始批次日志。正式发布前仍需要真实 Web/Art/PG/Redis/发布服务器的独立验收。