# SiteForge Enterprise V8.27 — 易上手工作台与操作指引

## 本轮交付性质

V8.27.0-dev.1 是 V8.26 完整源码上的**增量集成版**，不替换原后台 API，也不改变原数据库结构和静态构建引擎。历史版本功能继续保留。

## 改动范围

| 位置 | 已实现的操作 |
|---|---|
| 网站创建弹窗 | 拆成三步：基本信息 → 选择行业风格 → 预览和确认；支持上一步、必填校验、避免重复提交 |
| 当前网站操作指引 | 根据已保存内容、构建状态、Worker 任务与远程发布历史生成步骤；逐项有“开始操作”跳转 |
| 网站概览 | 突出“下一步应该做什么”，常用操作缩减为内容、设计、生成与预览 |
| 术语说明 | 区分内容保存、静态构建、检查与审批、正式部署；不把下载 ZIP、发布设计误称为上线 |
| 数据状态 | 仅自动建立的示例首页不会使“内容准备”自动完成；用户主动修改初始首页或添加正式内容才计入 |
| 手机界面 | 创建设计向导与引导列表适配窄屏，侧栏默认关闭，不增加底部固定遮挡 |

### 操作路径

1. 登录 → 工作台 → 创建网站。
2. 分三步填写网站名称、模式、主题和可选域名。
3. 系统创建项目，自动切换到“建站操作指引”。
4. 根据引导准备内容（旧站模式自动跳转迁移入口），可进入可视化编辑器修改样式。
5. 执行静态构建，进入构建页面查看任务、预览和质量报告。
6. 人工检查后由审批人员批准，再发起正式环境发布；必须核查实际域名。

### 使用者可读的状态定义

- **已保存**：写入 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 回归描述为一键全绿**。

## 推荐复核命令

```bash
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/发布服务器的独立验收。