浅念
5c7643fcf2
- Overlay 26 changed files from SiteForge_Enterprise_V8_12 (UI layer only: professional-ui.js/css, workspace/factory-v2/operations/editor templates, +2 test files, compose/ci/scripts/docs) - Re-apply v8_workflows type-mapping fix (类型/分类) lost in upgrade - Pin compose project name to siteforge-v8-10 so existing data volumes (hesupipe site 483295c29ea0, 193 entries) keep attached - Drop stray .s10_* state files; ignore .s10_*/.sf_*/.s87_* patterns - Plan/spec revisions per plan-review round 1 (icons are new design, real test assertions, recorded deviations) Tests: 226 passed / 1 env-only failure (test needs node binary in PATH, absent in python:3.12-slim container; host node v24 --check all 9 JS OK) Co-Authored-By: Claude Code <noreply@anthropic.com>
58 lines
4.4 KiB
Markdown
58 lines
4.4 KiB
Markdown
# SiteForge Enterprise V8.11 — 专业后台统一化验收
|
|
|
|
版本：`8.12.0-dev.1`。以 V8.10 完整项目为基线，**保留所有已有业务 API、数据库与构建 Worker**，仅重构统一界面层及选站导航。
|
|
|
|
## 1. 核心问题与对应处理
|
|
|
|
| 旧体验 | 新实现 | 代码位置 |
|
|
|---|---|---|
|
|
| 5 个专业页面各自导航，反复跳转找不到入口 | 共享顶部导航、面包屑、当前任务说明、返回业务工作台入口 | `app/static/professional-ui.js`, `professional-ui.css` |
|
|
| 当前网站在不同工具间失效或被重置 | 使用同域 `siteforge:selected-site` 偏好记录，**再次经过 API 可见网站列表校验**；旧控件联动 | `professional-ui.js`, `workspace.js`, `factory-v2.js`, `operations.js` |
|
|
| 编辑器按钮密集，草稿、构建、发布混在一起 | 操作区域分组，草稿和正式发布文案清楚区分 | `professional-ui.js`, `professional-ui.css` |
|
|
| 手机后台打不开属性/结构面板 | 结构、预览、属性三种移动/平板面板切换 | `professional-ui.js`, `professional-ui.css` |
|
|
| 任务中心 CMS、构建、发布全部长列表堆在一页 | 三个任务阶段切换，不删除已有控件或修改业务逻辑 | `professional-ui.js`, `professional-ui.css` |
|
|
| 高级建站中心重复侧边栏 | 压缩为水平业务选项卡，共享站点导航 | `professional-ui.css` |
|
|
| 表单视觉、按钮焦点不统一 | 统一输入焦点、主次操作、危险色与必填校验可见状态 | `professional-ui.css`, `professional-ui.js` |
|
|
| 用户不知道复杂工具做什么 | 每页一行任务提示，可展开查看完整操作顺序和下一步 | `professional-ui.js` |
|
|
|
|
## 2. 页面覆盖
|
|
|
|
- `/` 默认简洁工作台（原入口保留，支持 `?view=...&site=...` 深链接）。
|
|
- `/editor/{site}/{entry}` 可视化页面编辑器。
|
|
- `/theme-gallery` 主题版本与设备预览。
|
|
- `/factory-studio` 高级网站设计与数据映射。
|
|
- `/production-v8` WordPress / Excel / XML / API / MySQL / 整站模板。
|
|
- `/operations` 迁移复核、Worker 任务、审批发布。
|
|
- `/classic` 旧式后台保留，不作为默认入口。
|
|
|
|
## 3. UX 规则
|
|
|
|
1. 顶层统一入口按照业务目标：工作台、内容管理、外观设计、导入迁移、构建交付。
|
|
2. 每个高级页面只显示当前任务的主要内容，原有专业功能通过局部 Tab 展示。
|
|
3. 按钮样式统一：蓝色主操作、白色次操作、危险操作文字红色。**危险操作仍使用既有权限校验与业务确认，不依赖 CSS。**
|
|
4. 页面选择网站必须校验 `GET /api/sites` 返回的可见 ID；编辑器跨网站切换时跳到目标站点的设计入口，而不拼接旧页面 ID。
|
|
5. 新增表单有效性提示使用浏览器原生校验，继续使用既有 `X-SiteForge-CSRF`。
|
|
6. 不把设计草稿误显示为网站正式已发布版本。
|
|
|
|
## 4. 自动化验证
|
|
|
|
- `python -m pytest -q --disable-warnings` 验证全套回归：**218 项通过**。
|
|
- `tests/test_professional_ui_v811.py` 为 8 项专项测试，覆盖受保护页面、资源、选站联动、表单、编辑器、任务分步和旧业务 API。
|
|
- `node --check app/static/professional-ui.js` 及既有 JS 文件语法检查。
|
|
- `python scripts/verify_release.py` 校验版本标识，CI/Compose 使用 `8.12.0-dev.1`。
|
|
|
|
## 5. 本轮边界
|
|
|
|
- 本轮统一的是 **SiteForge 原生管理后台**，不是已经编译完成的 Art Design Pro 官方工程。
|
|
- 流程界面优化不代表 CMS 深度迁移、SFTP/S3、公网发布、PostgreSQL/Redis 高可用已经完成。
|
|
- 当前执行环境没有完成真实 Docker Engine 和浏览器跨设备 E2E，因此不声称生产视觉验收通过。
|
|
- `SiteForge_V8_11_统一专业后台_交互预览.html` 为离线演示，包含模拟数据，**不连接真实 API**。以部署后的后台为实际行为依据。
|
|
|
|
## 6. 浏览器人工验收要点
|
|
|
|
- 登录 → 工作台选择站 A → 进入编辑器/主题预览/数据工具/任务中心，当前网站保持为 A；切换 B 后各工具使用 B 的记录。
|
|
- 在编辑器检查草稿、预览与发布按钮的分组；移动 390px / 360px 宽度下可切换结构、预览、属性并继续编辑。
|
|
- 任务中心切换“迁移 → 构建 → 审批发布”，原有按钮按权限可操作，错误及危险操作有明确反馈。
|
|
- 检查页面键盘焦点、必填校验、主次按钮色、系统 401 登录过期回退。
|
|
- Docker Compose 部署、升级/回滚后健康接口版本与后台版本一致。
|