浅念
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>
68 lines
5.3 KiB
Markdown
68 lines
5.3 KiB
Markdown
# 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`：双击即可打开的模拟数据界面，可点击“模拟另一位审核人批准”。
|
||
|
||
### 本地检查命令
|
||
|
||
```bash
|
||
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 全部完成。
|