feat: 岗位会商命令幂等与圆桌后台作业租约调度
岗位会商写操作引入 command_id 幂等与版本锁,前端支持同键重试;圆桌后台作业改为 DB 租约 dispatcher、去重与草稿 outbox 补偿,并持久化 intent turns。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
4f536d9b39
commit
75963c9ad9
51 files changed
+4449
-670
No files matched your search
+44
@@ -60,6 +60,10 @@ class PositionRoundtableSessionRow(Base):
|
||||
# intent_pending -> active -> completed / archived. The router owns legal
|
||||
# transitions; the DB keeps it as a concise, portable string.
|
||||
status: Mapped[str] = mapped_column(String(32), nullable=False, default="intent_pending", index=True)
|
||||
# 乐观并发控制版本号:保护「确定意图 / 激活链 / 归档」等 session 级变更。
|
||||
# 每次 session 写操作自增;传入 expected_version 时做 ``WHERE version=?`` CAS,
|
||||
# 命中 0 行即并发冲突(消除两个用户同时激活/归档同一 session 的竞态)。
|
||||
version: Mapped[int] = mapped_column(Integer, nullable=False, default=0, server_default="0")
|
||||
created_at: Mapped[datetime] = mapped_column(
|
||||
BeijingDateTime(), nullable=False, default=lambda: datetime.now(UTC)
|
||||
)
|
||||
@@ -101,6 +105,11 @@ class PositionRoundtableNodeRow(Base):
|
||||
# position Session removes every recovery snapshot through the FK cascade.
|
||||
conversation_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
revision: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
|
||||
# 乐观并发控制版本号:每次 update_node 自增;传入 expected_version 时做
|
||||
# ``WHERE version=?`` 校验,命中 0 行即并发冲突。与 revision(业务交付计数)
|
||||
# 刻意解耦——revision 仅在真正交付新 Markdown 报告时 +1,version 在任意字段
|
||||
# 变更时 +1,专用于消除「complete_node_turn 多步状态机」并发盲写丢失更新。
|
||||
version: Mapped[int] = mapped_column(Integer, nullable=False, default=0, server_default="0")
|
||||
upstream_revision: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
rejection_count: Mapped[int] = mapped_column(Integer, nullable=False, default=0, server_default="0")
|
||||
last_rejection: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
@@ -114,3 +123,38 @@ class PositionRoundtableNodeRow(Base):
|
||||
default=lambda: datetime.now(UTC),
|
||||
onupdate=lambda: datetime.now(UTC),
|
||||
)
|
||||
|
||||
|
||||
class PositionRoundtableCommandRow(Base):
|
||||
"""命令幂等记录:同一次客户端操作(由 command_id 标识)只执行一次。
|
||||
|
||||
网络重试 / 双击 / beforeunload beacon 可能把同一命令送达多次。靠
|
||||
``UNIQUE(session_id, node_key, command_id)`` 让数据库天然去重:第二次到达时
|
||||
命中已有记录,直接返回 ``result_json``(上次结果),绝不重复推进状态机。
|
||||
``payload_hash`` 防止客户端误复用 command_id 发送不同参数——同 command_id 但
|
||||
payload 不同 → 409。session 级命令(activate/archive)node_key 存空串。
|
||||
"""
|
||||
|
||||
__tablename__ = "position_roundtable_commands"
|
||||
__table_args__ = (
|
||||
UniqueConstraint(
|
||||
"session_id", "node_key", "command_id",
|
||||
name="uq_position_roundtable_commands_session_node_cmd",
|
||||
),
|
||||
)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
session_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
# 命令作用的节点;session 级命令(activate/archive/delete)存空串 ""。
|
||||
node_key: Mapped[str] = mapped_column(String(256), nullable=False, default="")
|
||||
# 客户端生成的幂等键(一次点击/重试共用)。
|
||||
command_id: Mapped[str] = mapped_column(String(64), nullable=False)
|
||||
# complete / bind / reject / conversation / activate / archive / delete
|
||||
command_type: Mapped[str] = mapped_column(String(32), nullable=False)
|
||||
# 规范化 payload 的 sha256;同 command_id 但 hash 不同 → 409(防误复用)。
|
||||
payload_hash: Mapped[str] = mapped_column(String(64), nullable=False)
|
||||
# 上次执行结果的 JSON 序列化,重放时原样返回。
|
||||
result_json: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
created_at: Mapped[datetime] = mapped_column(
|
||||
BeijingDateTime(), nullable=False, default=lambda: datetime.now(UTC)
|
||||
)
|
||||
Reference in new issue
Block a user