浅念
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>
4.4 KiB
4.4 KiB
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-v8WordPress / Excel / XML / API / MySQL / 整站模板。/operations迁移复核、Worker 任务、审批发布。/classic旧式后台保留，不作为默认入口。
3. UX 规则
- 顶层统一入口按照业务目标：工作台、内容管理、外观设计、导入迁移、构建交付。
- 每个高级页面只显示当前任务的主要内容，原有专业功能通过局部 Tab 展示。
- 按钮样式统一：蓝色主操作、白色次操作、危险操作文字红色。危险操作仍使用既有权限校验与业务确认，不依赖 CSS。
- 页面选择网站必须校验
GET /api/sites返回的可见 ID；编辑器跨网站切换时跳到目标站点的设计入口，而不拼接旧页面 ID。 - 新增表单有效性提示使用浏览器原生校验，继续使用既有
X-SiteForge-CSRF。 - 不把设计草稿误显示为网站正式已发布版本。
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 部署、升级/回滚后健康接口版本与后台版本一致。