Skip to content

Latest commit

 

History

History
56 lines (39 loc) · 3.83 KB

refactor-progress.md

File metadata and controls

56 lines (39 loc) · 3.83 KB

重构实施记录

协作方式

每批先展示方案、获得用户同意,再实现、验收、提交和推送。未经批准不开始下一批。旧项目只读保留,不纳入新仓库。

项目定位与更名

2026-11-17:新项目命名为 FlowPage(流页),定位为个人独立学习项目,目标是完整实现拖拽或 Agent 生成移动端营销页的搭建、编辑和发布链路。

本次仅更新新仓库的界面品牌、默认公告文案、根包名与文档名称;旧项目与父目录原始文档保持不变。GitHub 仓库地址保持 ceinez/lowcode-platform,内部 @lowcode/* 包名作为通用技术命名保留。整体架构和后端设计将在单独批准的批次落实。

第 1 批:工程化基础 + 公告编辑闭环

批准日期:2026-11-17。目标仓库:ceinez/lowcode-platform,公开。

范围与验收

  1. 编辑器、渲染端、共享契约和通信包组成独立 Monorepo。
  2. 添加公告,修改文字与颜色,在 iframe 看到实时结果;可选中并删除公告。
  3. 保存草稿后刷新可恢复;损坏草稿提示错误并打开空白页面。
  4. lint、类型检查、核心契约单测、生产构建以及浏览器端到端测试通过。
  5. 提交锁文件并配置 GitHub Actions,保证干净环境可重复安装。

本批技术决策

  • 使用 npm workspaces:本机已有 npm,第一批减少额外包管理器依赖;保留文档要求的 Monorepo 包边界。原始技术方案中的 pnpm 尚未采用。
  • 数据统一为 schemaVersion: 1、components 和节点 type/props;原始文档的 componentList/data 属于旧数据格式,本批不处理自动迁移。
  • 公告先支持纯文本及两项颜色属性,不支持 HTML。文案使用 Vue 文本插值渲染。
  • 注册元信息驱动表单;目前只有公告,后续新增组件需要补齐 Schema 判别联合和渲染映射。
  • 公告最多一个,沿用旧项目的数量限制;没有虚设不可用的其他组件入口。
  • iframe 接收消息时同时验证 event.origin、event.source、协议标记和消息数据;发送时使用明确的 origin。
  • 预览 URL 通过 editorOrigin 指定父窗口。它是编辑预览配置,不是生产授权机制;正式发布与访问控制待后续设计。
  • 草稿只手动保存到本地,不宣称已实现服务端持久化或自动保存。
  • 第一批用原生表单元素和 CSS 完成界面;Element Plus、Vant、独立 components 包按后续批次需求引入。

验证记录

2026-11-17 本地验收结果:

  • npm run check 通过:Prettier、零警告 ESLint、vue-tsc、6 个单元测试、两端生产构建。
  • PLAYWRIGHT_CHANNEL=chrome npm run test:e2e 通过:2 个端到端用例,覆盖公告添加、数量限制、文字与颜色同步、本地保存与恢复、选中与删除、损坏草稿处理。
  • 已查看测试截图,确认三栏布局、手机画布及属性表单正常显示。
  • 首次安装发现旧测试依赖存在漏洞,已更新至 Vitest 5.1.0;更新安装报告为 0 个已知漏洞。
  • 标准 Chromium 下载连接中断,本地改用已安装的 Chrome 独立临时实例。CI 仍配置下载标准 Chromium,远程结果需以实际运行记录为准。
  • 构建存在第三方 Zod 代码注释的 Rollup 提示,不影响产物生成。
  • 原始渲染端的 Git 差异指纹与开始时一致;原有未提交修改保留。

后续候选批次(均需单独批准)

  1. 完善组件注册和渲染分发,加入更多基础组件。
  2. 拖拽添加、排序、复制及组件位置通信。
  3. 后端页面 CRUD、数据库、服务端草稿与发布闭环。
  4. AI 页面生成与校验,再逐步支持局部编辑。

原始 PRD、前端方案和完整架构保留为设计参考。其性能收益和业务指标未在重构版中测量,不作为当前交付结果。