655e039aad
原实现是 Canvas 画笔画板，与「文字白板/记事本」需求不符。重做为纯文本实时协作： - model：strokes JSON -> content TEXT + version INT（乐观锁）+ edit_count； schema/dao/service 同步重构，append_stroke/replace_strokes -> update_content。 - WS 协议：stroke -> edit（发完整文本，debounce 400ms）；init 下发 content/version。 update 帧广播给他人，cleared 广播给所有人。 - 前端：canvas -> textarea；收到远端 update 用最长公共前后缀算变更区间， 仅替换该区间并保留光标（区间前不动/后平移/内移末尾）；清空/复制文本按钮。 - schema.sql 更新 whiteboard 表 DDL；DB 旧表 DROP 重建（开发环境）。 - 测试脚本与 README 同步更新。
43 lines
1.7 KiB
Python
43 lines
1.7 KiB
Python
"""共享白板实体（文本记事本）。
|
||
|
||
一个白板由 board_id 唯一标识（用户可读的 url id），content 存完整文本，
|
||
version 是乐观锁版本号（每次编辑 +1）。白板长期留存，进程重启后仍可恢复；
|
||
实时协作由 WebSocket hub 在内存中维护在线连接，文本变更经 service 落库后
|
||
由 hub 广播给同 board 的其它在线连接。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from datetime import datetime
|
||
|
||
from sqlalchemy import BigInteger, DateTime, Integer, String, Text, func
|
||
from sqlalchemy.orm import Mapped, mapped_column
|
||
|
||
from ..database import Base
|
||
|
||
|
||
class Whiteboard(Base):
|
||
__tablename__ = "whiteboard"
|
||
|
||
id: Mapped[int] = mapped_column(BigInteger, primary_key=True, autoincrement=True)
|
||
# 用户可读的 url id（[a-zA-Z0-9_-]{1,64}），全局唯一
|
||
board_id: Mapped[str] = mapped_column(String(64), nullable=False, unique=True, index=True)
|
||
# 白板文本内容（记事本）
|
||
content: Mapped[str] = mapped_column(Text, nullable=False, default="")
|
||
# 乐观锁版本号：每次编辑 +1
|
||
version: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
|
||
# 编辑次数（累计修改次数，含清空），供管理页统计
|
||
edit_count: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
|
||
created_at: Mapped[datetime] = mapped_column(
|
||
DateTime, server_default=func.now(), nullable=False
|
||
)
|
||
updated_at: Mapped[datetime] = mapped_column(
|
||
DateTime, server_default=func.now(), onupdate=func.now(), nullable=False
|
||
)
|
||
|
||
def __repr__(self) -> str: # pragma: no cover
|
||
return (
|
||
f"<Whiteboard board_id={self.board_id!r} "
|
||
f"len={len(self.content)} v={self.version} mods={self.edit_count}>"
|
||
)
|