浅念
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>
74 lines
4.8 KiB
Markdown
74 lines
4.8 KiB
Markdown
# 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/发布服务器的独立验收。
|