SpacetimeDB 协作画板评分细则以 45 分制量化评测实时协作后端STDB vs PostgreSQL【免费下载链接】SpacetimeDBDevelopment at the speed of light项目地址: https://gitcode.com/GitHub_Trending/sp/SpacetimeDB导读本文围绕 SpacetimeDB 仓库中 llm-oneshot 评测体系 的 Paint App 评分细则grading_rubric.md展开系统拆解 15 个协作画板功能维度、每项 0–3 分的评分标准以及专门用于衡量 SpacetimeDB 差异化能力的 7 项关键测试。结合仓库中真实的 Paint App 生成产物TypeScript SpacetimeDB 后端读者可以掌握如何用一套可复制的量化指标体系客观评测实时同步、即时锁、行级权限、定时调度等实时后端能力。评测体系背景为什么需要一份评分细则在tools/llm-oneshot这一评测工程中仓库用同一个协作画板应用Paint App作为基准测试任务分别驱动 SpacetimeDB 与 PostgreSQL Socket.io两套后端栈再由 LLM 生成完整应用最终需要一套统一、客观、可量化的评分标准来横向对比两套方案的实时能力差异。评分细则正是这一评测闭环中的“裁判手册”。该评测的 prompt 组织方式见 prompts/README.md16 个 feature 构建块放在features/按累计方式组合为 12 个 level 的composed/prompt再与语言/后端配置文件language/如rust-spacetime.md、typescript-postgres.md拼接后喂给 LLM生成的代码落在apps/paint-app/下的时间戳目录中。评分细则grading_rubric.md与快速检查单grading_checklist.md共同构成测评端到端的验收与评分工具。评分系统每项功能 0–3 分评分细则定义了统一的评分标尺每个功能维度独立打分分值含义0未实现或存在破坏性缺陷Not implemented or broken1部分实现存在重大问题Partial - major issues2基本可用存在少量缺陷Mostly working - minor bugs3完全可用Fully working打分粒度控制在一个功能维度 3 分评分者针对每个维度内的具体检查项checklist逐项核验后给出 0–3 的总分。这种“细项核验 维度打分”的双层结构既保证了评分的可追溯性又避免因单个小缺陷导致整项归零。15 个功能维度详解评分细则共覆盖 15 个功能维度基本对应协作画板的完整产品形态。以下按原文档顺序逐项说明其检查要点。功能 1基础绘制3 分用户可设置显示名可创建/加入画布画笔工具可绘制笔画橡皮擦可擦除内容取色器可用笔画实时同步给其他用户核心项在仓库生成的 SpacetimeDB 后端实现中对应的是add_strokereducer它将canvasId、layerId、tool、color、brushSize与序列化的points一次性写入stroke表见 index.ts订阅该表的客户端即可无轮询地收到新笔画。这也是细则强调“绘制过程无闪烁、非轮询”这一要求的落地基础。功能 2实时光标3 分可看到其他用户的鼠标位置光标带用户名与头像色光标显示当前工具图标光标平滑移动不得卡顿用户闲置时光标淡出后端通过update_cursorreducer 持续更新cursor表含x、y、tool、color、lastUpdatedAt字段每次更新同时刷新该用户的canvas_presence状态。细则将“平滑不卡顿”列为核心用于检验高频写入场景下的同步质量。功能 3形状工具3 分矩形工具可用椭圆工具可用直线/箭头工具可用形状支持描边/填充颜色形状实时同步给其他用户后端shape表以shapeType区分rectangle/ellipse/line/arrowadd_shape/update_shape/delete_shape三个 reducer 负责增改删见 schema.ts。功能 4选择与协作感知3 分可选择元素可移动/缩放选中元素可删除选中元素能看到其他用户的选择彩色轮廓选择实时同步selection表记录elementType与elementId配合select_elementreducer 支持多选addToSelection参数属于典型的“人人可见的多人操作状态”同步场景。功能 5图层与锁定3 分可创建多个图层可重排图层可切换可见性锁定图层显示“Locked by [user]”只有加锁者能编辑被锁图层离开或超时后自动解锁该维度是评分细则中的重点差异化项之一。后端实现中layer表携带lockedBy/lockedAt字段lock_layerreducer 在加锁同时向layer_unlock_job定时表插入一条ScheduleAt.time(unlockTime)记录5 分钟自动解锁而clientDisconnected生命周期钩子会在用户断开时立即清理其持有的所有锁。unlock_layer则校验只有加锁者本人可以主动解锁。这正是“锁定即时生效 异常退出自动释放”的实现闭环。功能 6在场状态与活动状态3 分显示画布上的用户列表显示 active/idle/away 状态显示每个用户的当前工具状态自动更新闲置后自动进入 awaycanvas_presence表以status字段active/idle/away存储每个用户在画布上的状态update_cursor每次调用都会把状态刷新为active并记录lastActivityAt为前端基于时间推断 idle/away 提供数据支撑。功能 7评论3 分可在画布上放置评论图钉评论支持线程化回复可解决/重新打开评论resolve/unresolve点击评论可平移画布到对应位置评论实时同步后端以comment与comment_reply两张表建模评论与回复resolved布尔字段支持解决/重开操作。功能 8版本历史3 分定期自动保存版本可手动保存并命名版本可查看版本列表可预览旧版本可恢复旧版本version表以snapshotDataJSON 全量元素快照isAutoSave标记建模版本配合auto_save_job定时表实现定期自动快照。功能 9权限3 分所有者可设置 viewer/editor 角色viewer 不能绘制工具禁用角色变更立即生效所有者可踢出用户被踢用户立即移除canvas_member表以role字段owner/editor/viewer建模成员关系set_member_role与remove_memberreducer 均只允许ownerIdentity调用且remove_member会同步清理被踢者的 presence 与 cursor 记录。所有绘制类 reduceradd_stroke、add_shape、add_text_element等入口处调用requireEditor(ctx, canvasId)做权限校验从根上保证 viewer 无法写入。功能 10跟随模式3 分可点击用户进行跟随视口实时同步显示“Following [user]”指示器手动平移/缩放停止跟随多人可跟随同一用户canvas_presence中的viewportX/viewportY/viewportZoom/followingUser字段就是视口状态与跟随关系的载体跟随者订阅被跟随者的视口字段即可实现“演示 / 引导式讲解”场景。功能 11活动流3 分显示实时操作日志操作带时间戳与用户点击条目可平移画布到位置操作发生时实时更新旧条目自动移除activity_entry表记录action如joined、left、drew、erased、added_rectangle、可选locationX/locationY与createdAt由logActivity辅助函数在各 reducer 中统一写入。功能 12私有画布与分享3 分画布默认私有可生成分享链接可设置链接权限view/edit可按用户名邀请可撤销分享链接canvas表以isPrivate、shareLinkToken、shareLinkPermission建模generate_share_link/revoke_share_link/join_canvas_via_link三个 reducer 构成完整生命周期生成链接时把画布切换为公开撤销时恢复私有并作废 token。功能 13画布聊天3 分协作者聊天面板消息显示用户与时间戳“User is typing...” 输入指示可用聊天历史持久化新消息有通知徽标chat_message表持久化消息typing_indicator表单独记录正在输入的用户clientDisconnected钩子会在断开时清理输入指示避免“幽灵输入状态”。功能 14自动清理与通知3 分非活动画布标记待删除删除在计划时间后执行删除前有警告活动会重置计时器“Keep Forever”选项可用这是定时调度能力的典型验证点。后端通过canvas_cleanup_job30 天与deletion_warning_job提前 7 天发警告两类定时表实现create_canvas时即调用scheduleCleanupCheck登记清理任务touchCanvas在每次活动时刷新lastActivityAt并重置定时器set_keep_forever则由所有者关闭自动清理。功能 15文本与便签3 分文本工具可添加文本可更改字号/颜色便签工具可用输入时显示“User is editing...”指示文本实时同步text_element表以elementType区分text/stickyeditingBy字段配合start_editing_text/stop_editing_text实现编辑占用提示clientDisconnected钩子同样会清除断线用户的编辑占用。汇总表满分 45 分功能维度满分1. 基础绘制32. 实时光标33. 形状34. 选择35. 图层 锁定36. 在场状态37. 评论38. 版本历史39. 权限310. 跟随模式311. 活动流312. 分享313. 画布聊天314. 自动清理315. 文本与便签3总计45评分者可在各维度打 0–3 分后汇总得到单套实现的总分用于横向对比不同后端栈在相同功能规格下的达成度。关键差异化测试衡量 STDB 优势的 7 个观测点评分细则末尾专门列出 7 项“Key Differentiator Tests”针对的是上述表中以加粗标注的核心项用于单独测量 SpacetimeDB 的实时能力优势而不是笼统的总分实时光标平滑度—— 光标更新是否延迟卡顿图层锁定速度—— 锁定是否即时生效权限强制—— 将用户降级为 viewer 时是否立即取消其进行中的操作如正在画的笔画跟随模式同步—— 视口跟随是否无延迟活动流延迟—— 操作是否立即出现在活动日志中定时删除—— 自动清理任务是否真的按计划触发输入指示—— “正在输入”指示是否正确出现与消失。这 7 项分别对应仓库实现中的高频写入cursor、即时状态变更layer lock、permission、视口状态同步follow、订阅推送activity feed、定时调度cleanup job与协作占用typing indicator——恰好覆盖 SpacetimeDB 作为“数据库即后端”的核心能力面。评测时建议将这 7 项单独计分与 45 分制总分分开呈现以突出实时后端在交互延迟类指标上的真实差距。配套工具快速检查单与实测建议除评分细则外grading_checklist.md 提供了精简版核验清单先做 Pre-Flight能编译、能启动、能连上后端再按 15 个功能逐项打勾带 ⭐ 标记的项即对应上述关键差异化测试。它适合在自动化/人工实测阶段逐条快速过一遍再回到评分细则打 0–3 分。实测时建议采用“双人双端”方式验证实时性同一画布开两个客户端一人绘制另一人观察笔画/光标/选择的到达延迟对于权限与踢人观察被降级/被踢用户是否立刻失去编辑能力对于定时任务可将lock_layer的 5 分钟与清理的 30 天视为配置化阈值缩短后验证定时触发链路ScheduleAt.time与对应定时表是否按预期执行。小结这份评分细则的价值在于它把“实时协作画板”这一高度依赖低延迟、即时一致性、权限强制的应用拆解为 15 个可独立打分、可逐项核验的功能维度并用 7 项差异化测试聚焦实时后端最容易被感知的交互指标。配合仓库中真实生成的 SpacetimeDB 后端实现 与 数据模型评测者既能按细则逐项打分也能对照源码确认每一项检查点背后的实现链路从而得到事实充分、可复现的横向对比结论。【免费下载链接】SpacetimeDBDevelopment at the speed of light项目地址: https://gitcode.com/GitHub_Trending/sp/SpacetimeDB创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考