Files
persionalBrand/docs/visual-editor-next-steps.md
que01 12a3bf2f3b
CI / Static checks (pull_request) Successful in 1m34s
CI / Browser smoke (pull_request) Successful in 1m43s
CI / API integration (pull_request) Successful in 2m21s
CI / Production build (pull_request) Successful in 4m1s
fix: 修复 runner 迁移后的部署状态检查
2026-10-23 16:59:26 +08:00

6.6 KiB
Raw Permalink Blame History

可视化编辑后续任务

当前基线

Admin 直接复用 Taro renderer,模板原始 CSS 按 750 设计宽度转换为预览容器单位,模板图片经 Vite 打包。已有区域点击、选中样式、品牌字段筛选、即时草稿和显式保存;保留 H5 iframe 作为回退。当前不代表所有页面、记录与字段均已完成编辑闭环。

1. 统一选区契约

  • 统一 selection 为模板、页面、targetKey、实体类型、recordId;重复餐品和信任卡片必须带记录标识。
  • 从 manifest 解析中文名称、binding、编辑能力,不在 Admin 中新增行业条件分支。
  • 校验 target 存在、binding 可解析、页面归属正确;切页、删记录和换模板清理无效选区。
  • 验收:嵌套区块选最近目标,重复卡片准确选中对应记录,未知目标不打开错误表单。

2. 完成点选与高亮交互

  • 区分浏览模式与编辑模式;编辑模式阻止咨询提交、导航等真实操作。
  • 使用独立覆盖层显示悬停边框、选中边框及中文区域名,避免改变模板背景、尺寸和布局。
  • 覆盖层随滚动、容器尺寸、图片加载和字段换行更新;支持空白取消、Escape 取消及键盘选择。
  • 验收:320/390 画布、长页面、滚动及图片加载后边框仍准确,不遮挡按钮和表单。

3. 打通绑定值编辑

  • 右侧固定显示区域名称、数据来源、对应字段、未保存状态;点字段时定位关联区域。
  • 品牌配置、业务记录、信任内容、咨询表单使用各自现有 API 和验证规则;记录 ID 由选区携带。
  • 把当前仅跳转管理页的记录区域接入对应编辑器,复用原有表单与 mutation。
  • 图片、列表、条件字段按模板声明渲染;空值、默认值、继承值明确区分。
  • 验收:改值即时预览;保存后重新读取仍一致;失败保留输入并可重试;未保存切页给出明确选择。

4. 自动化验收和部署

  • 按模板包自动发现 renderer、页面与资源,去掉现有 renderer 注册的手工二选一;未知模板明确显示不支持。
  • 对每个模板覆盖首页、列表、详情、信任区及表单:选择→字段→草稿→保存→重载。
  • 覆盖非空真实结构数据、嵌套/重复目标、授权失败、图片实际解码、样式尺寸和溢出;仅 DOM 存在不能作为视觉通过。
  • 校验发布前后隔离:草稿不影响公开页面,发布后访客读取新值;受保护接口覆盖无凭证、错误角色及成功路径。
  • 验收生产静态构建及子路径部署,不按模板新增 Vite 服务。

推进顺序

以下计划以 feat/admin-component-preview / 541304a 为基线。已有交互仅部分通过测试,不能视为逐页完成。实施状态以 .codex-tasks/visual-editor-closure/SUBTASKS.csv 为准,旧任务记录保留。

第一阶段:覆盖清单与绑定修复

  1. 逐页盘点餐饮、林境模板,建立 coverage.csv:模板、页面、区域、实际读取字段、声明 binding、实体来源、记录定位、编辑入口、缺陷和验证证据。区分业务内容、访客输入、导航及装饰;空数据区域也纳入。
  2. 优先复现首页身份区域缺少点选标记、咨询区域标为 inquiry 却包含 brand 文案导致字段过滤、咨询字段缺少独立目标。继续逐页排查,不将这些示例视为全部缺陷。
  3. 补充 ADR 0020 后统一解析:区域表示页面位置,binding 决定字段来源;记录用稳定 ID,咨询字段用表单 ID 与字段 key。混合来源不能依赖 section.target 单一分类。模板包声明,Admin 通用解析。
  4. 修复嵌套目标、重复记录、无效选区与空区域新增入口;模板和 renderer 从包目录发现,建立可主动检出缺失映射的契约测试。

验收:所有声明页面进入清单;首页身份、咨询文案和重复卡片可准确定位;有意破坏映射时测试失败。

第二阶段:区域编辑面板

  • 显示页面、区域、具体记录和未保存状态。未选择时显示区域导航,选中后只显示对应字段。
  • 普通字段默认单列,图片有预览与替换入口,列表支持逐项增删排序。依据面板宽度安排布局,消除强制双列和固定空白,不堆叠重复卡片。
  • 字段焦点与选区双向定位,高亮随滚动、图片加载、长文本更新且不改变模板布局。
  • 保存范围明确;失败保留值并可重试;有草稿时切区域、页面或品牌提供保存、放弃、取消选择。

验收:窄面板无溢出,长表单操作可达;图片、长文本、列表及保存失败、切换路径均有浏览器验证。

第三阶段:咨询表单编辑

  • 区分页面文案、表单结构和访客试填。点击具体字段后编辑标题、提示、必填、类型及适用选项,复用现有验证规则。
  • 支持增删排序、空表单创建及条件显隐配置,检查条件引用有效性。
  • 复用 InquiryForm API、版本与发布语义;类型变更和删除不得破坏历史提交快照。预览不创建真实咨询、不读取客户记录。

验收:修改即时展示且保存重载一致;选择题、日期、长文本、条件字段、空状态均覆盖。接口若有变更,必须覆盖授权、品牌隔离、校验失败及成功持久化。

第四阶段:全页面与部署验收

  • 按清单逐项验证点选、字段、草稿、保存、刷新;结合自动发现的契约检查与关键浏览器场景,不仅检查 DOM 存在。
  • 使用隔离品牌验证真实 API 保存、草稿与公开内容隔离、发布后读取一致,不覆盖用户开发数据。
  • 对照两套模板视觉;验证 320/390 画布、图片解码、页脚、表单;运行 H5 和小程序构建检查共享组件回归。
  • 运行 format:check、lint、相关 typecheck、validate:templates、Admin tests/build、浏览器测试及涉及的 API/API Client 测试。生产静态与子路径部署可用,无按模板单独运行服务需求。

验收:本轮覆盖项都有通过证据;未完成项保持显式状态。按依赖提交可运行单元,提供预览与验证记录,合并仍等待用户确认。

本轮边界

截至 2026-10-23,.codex-tasks/visual-editor-closure/SUBTASKS.csv 中的 5 个子任务均已标记 DONE;本文保留为实现范围、验收标准和后续回归依据,当前状态以该 CSV 和实际验证记录为准。本轮仍聚焦内容编辑,不做任意拖拽布局或 HTML 入库。保留模板视觉和 H5 回退;不重置数据库或 seed,必要结构调整先制定兼容迁移。