docs: document canvas inheritance and integrated session policy

This commit is contained in:
2026-11-06 13:02:42 +08:00
parent 373582906d
commit 56c6588ad6
6 changed files with 167 additions and 11 deletions
+39
View File
@@ -1,5 +1,44 @@
# 本地验收记录
## 双击编辑、纯图片、节点名称、完整图标库与会话策略(2026-11-06)
- CanvasTextEditor 统一文本卡片、脚本与纯文本:单击选择,原生 dblclick 编辑;拖动不进入编辑,Esc/失焦退出。纯文本移除左上角手柄,选中后整块区域可拖动。
- 右下角缩放符号在未选中时也显示,拖动先选中;抓手模式仍可见但不响应缩放。连接点保持仅选中显示。
- 新增 PlainImageElement / PlainImageNode,按图片原始尺寸等比插入及缩放,支持旋转、拖动与分区归属,无卡片标题和连线。新增可撤销节点改名。
- 修复 Frame 的 NodeToolbar 默认 zIndex=0 被画布交互层覆盖的问题,工具栏显式设为 zIndex=100、pointerEvents=auto;分区名称输入和模式选择可响应。
- Lucide 改为包内完整动态目录,2317 个名称合并数字别名后提供 2313 个唯一存储标识。支持中英文关键词、每批 80 项和按需图标模块加载;测试校验全部标识满足 Core 格式且无冲突。
- 前端 Cookie 改为 30 天上限,并按 Core 的 X-Foundry-Session-Expires-In 续期;保留 HttpOnly/SameSite/HTTPS Secure,401 和非法续期头不续期。Core 策略使用独立工作分支 PR,不直接推送或合并 Core main。
- 51 项前端测试、类型检查及隔离生产构建通过;接口冒烟验证 30 天 Cookie、绝对期限附近缩短到剩余秒数、非法头与 401 不续期,并保持已有快照和路由流程通过。
- Core 会话策略提交 34c461a 的远程 CI #881 通过,包含构建、迁移和隔离数据库测试;PR #10 已合并。纯图片配套 Core 提交 460b05f 的 CI #883 同样通过,PR #11 也已合并;最新主线 7847167 的 CI #888 与部署 #889 均通过。代理未调用合并或部署操作。
- 未访问项目浏览器,因此双击/拖动手感、弹层视觉与真实账户体验仍待用户试用;前端按首页、工作台、文档分组提交,统一推送;原有 next-env.d.ts 与 pnpm 未提交文件保留。
## 框选区、服务端快照、slug 与新首页(2026-11-06)
- 框选区采用独立 FrameElement,支持命名、hidden/fixed/scaled 三种标签显示,固定字号通过逆视图缩放保持屏幕尺寸;分区不旋转、不连线。成员记录使用绝对坐标和 frameId,只有内容拖动结束时更新归属;移动框及调整大小不会收纳被覆盖内容。
- 单个或多选内容拖入/拖出可加入/退出,移动已有分区会同步移动成员,显式选中的成员不会移动两遍。删除框保留成员,撤销可恢复框与归属。Frame/成员/标签设置均通过草稿和 JSON 往返校验。
- 对照已部署 Core 57aab71 接入 Canvas GET/PATCH、5 MiB、ETag/If-Match 与独立版本。加载失败不创建空快照;自动保存串行提交并合并等待更新,拒绝写入后停止自动重试。412 提供重新读取和导出,其他错误允许明确重试。
- 旧草稿与未同步恢复记录通过原生模态对话框由用户选择,默认服务端优先;草稿与服务端不一致时不自动覆盖。导航/关闭时同步写入本地恢复记录,成功服务器保存后标记为干净备份。
- workspace 与 board 的 ID/slug 四种组合可读取同一个 canonical 资源,恢复记录与保存使用 canonical ID;侧栏高亮、当前名称及改名修复不再把 slug 当作 ID 比较。
- 首页以 CSS Module 隔离重做:留白与分栏、黑色按钮、衬线文字、SVG 线稿与交互预览、三段工作方式、FAQ、真实本地演示入口;匿名/登录入口分流保持。包含窄屏样式和减少动态效果设置。
- 46 项自动测试通过,包含分区拖入/拖出及不误收纳、成员移动与删除撤销、三种标签序列化、串行保存/合并/失败重试/412停止、旧草稿迁移决策,以及全部 ID/slug 路径组合。
- 隔离 Webpack 生产构建及扩展 API 冒烟通过;HTTP 回归覆盖 Canvas 读写、1 MiB 以上快照还原、ETag/If-Match、412、5 MiB 限制、四种 slug/ID 组合,既有会话/路由/88 个品牌资源保持通过。
- Core 随后通过 PR #9 交付分区字段,022086b 的部署 #877 已确认成功。对照 normalizeCanvas 与后端分区测试核对 frame/frameId/labelMode,前端代理模拟往返覆盖三种标签及成员归属;真实账号的数据库写入及跨设备恢复尚未操作,没有修改真实用户数据。
- 按用户约定未访问项目浏览器;实际视觉、拖动手感和真实账户跨设备验收待用户反馈。本阶段尚未 commit / push。
## 移除大加号与连线端点修正(2026-11-06)
- 选中时不再放大连接点或显示加号,四边中心的小连接点仅选中时淡入显示,取消选中后淡出,保留拖线及点击打开节点类型菜单。未选中节点仍可作为连线终点;隐藏连接点不支持发起拖线。
- React Flow 默认曲线端点落在 Handle 外沿,选中时尺寸变化和旋转后的测量会带来偏移。新增共享卡片边缘锚点计算,已连接曲线与拖线预览都直接使用实际尺寸、位置、角度计算起终点,兼容旧无名左右连接。
- 新增几何回归覆盖缩放、旋转、选中状态变化和路径两端坐标。31 项测试、类型检查、隔离 Webpack 生产构建和差异检查通过。按约定未访问项目浏览器,改动暂留本地。
## 首页按登录态分流(2026-11-06)
- `/` 改为服务端页面:无 foundry_session 时显示 landing page;有 Cookie 时向 Core profile 验证,有效会话 307 跳转 `/dashboard`;失效或无法验证的会话显示 landing page。验证请求 no-store,不把会话值传入客户端组件。
- 原有 landing 页面移至 src/components/landing-page.tsx,保留 FAQ 交互;`/dashboard` 继续使用现有无画布工作台,图谱独立路由不变。
- 类型检查、独立临时目录的 Webpack 生产构建通过;生产输出将 `/` 标记为动态路由。
- 完整 API 冒烟通过,新增有效会话首页 307/Location、私有响应缓存、会话值不进入响应内容、无会话和失效会话 landing,以及 dashboard 不渲染 canvas 的检查;既有 API 和 88 个品牌资源回归通过。
- 未访问项目浏览器。本次保留本地改动,按用户最新要求将提交/推送留到合适阶段统一管理。
## 连接交互、样式栏与图标(2026-11-06)
- 移除“保存在此浏览器”状态行;卡片连接点恢复四边中心,未选中显示点,选中后动画变为加号。同一个 React Flow Handle 支持拖出贝塞尔线;点击加号打开文本/图片/脚本菜单,图片需用户选图,取消不会创建空节点。选中卡片拖线到空白处,在释放位置打开菜单。