sync: 鍚屾灞€鍩熺綉鏈€鏂颁唬鐮?(source master @ b69568e4)
This commit is contained in:
1 parent
4f7f07504a
commit
8bc8b0e082
1651 files changed
+278599
-11416
No files matched your search
+217
@@ -0,0 +1,217 @@
|
||||
"""ORM models for the external-task multi-agent scheduled analysis (任务分析定时).
|
||||
|
||||
Feature summary (design doc in the frontend ``official-task-analysis`` module):
|
||||
an external system pushes tasks via our create API; each task binds 1:1 to a
|
||||
business-chain orchestration plus a cron schedule; the scheduler runs the chain
|
||||
stage-by-stage (seats within a stage in parallel) and persists per-seat process
|
||||
messages plus a content "timeline" version per run. Manual runs wrap the
|
||||
roundtable Step-2 coordinator Q&A and are stored with the same message table
|
||||
(``seat_agent_id`` distinguishes seats; the coordinator uses ``__coordinator__``).
|
||||
|
||||
Tables:
|
||||
- ``task_analysis_tasks`` — external tasks (source_task_id unique)
|
||||
- ``task_analysis_bindings`` — 1:1 binding (chain snapshot + cron + notes)
|
||||
- ``task_analysis_runs`` — executions (trigger: schedule | manual)
|
||||
- ``task_analysis_run_messages`` — per-seat process messages for a run
|
||||
- ``task_analysis_content_versions`` — one timeline version per run
|
||||
- ``task_data_block_defs`` — the 5 fixed data blocks per task (title/sort editable)
|
||||
- ``task_data_periods`` — data-delivery timeline ticks (period_index per task)
|
||||
- ``task_data_blocks`` — merged payload per (task, period, block)
|
||||
- ``task_data_submissions`` — append-only submission log feeding the merge
|
||||
|
||||
JSON payloads are stored as LONGTEXT-backed JSON strings (PortableLongText),
|
||||
mirroring the sibling roundtable persistence modules for headroom.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from datetime import UTC, datetime
|
||||
|
||||
from sqlalchemy import Boolean, Integer, String, Text, UniqueConstraint
|
||||
from sqlalchemy.orm import Mapped, mapped_column
|
||||
|
||||
from deerflow.persistence.base import Base
|
||||
from deerflow.persistence.types import BeijingDateTime, PortableLongText
|
||||
|
||||
|
||||
def _utcnow() -> datetime:
|
||||
return datetime.now(UTC)
|
||||
|
||||
|
||||
class TaskAnalysisTaskRow(Base):
|
||||
__tablename__ = "task_analysis_tasks"
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
# 对方系统任务号(创建接口传入;唯一)。
|
||||
source_task_id: Mapped[str] = mapped_column(String(128), nullable=False, unique=True, index=True)
|
||||
name: Mapped[str] = mapped_column(String(512), nullable=False, default="")
|
||||
# 任务简介:创建时落库的存量即执行时用的版本(不回拉对方接口)。
|
||||
description: Mapped[str | None] = mapped_column(Text, nullable=True)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
updated_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow, onupdate=_utcnow)
|
||||
|
||||
|
||||
class TaskAnalysisBindingRow(Base):
|
||||
__tablename__ = "task_analysis_bindings"
|
||||
__table_args__ = (UniqueConstraint("external_task_id", name="uq_task_analysis_binding_task"),)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
external_task_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
# 引用 roundtable_chains.id;执行前校验,链缺失/停用 → 跳过并标记 chain_missing。
|
||||
chain_id: Mapped[str] = mapped_column(String(64), nullable=False)
|
||||
# 执行编排快照 JSON:{seats, stages, stage_goals, coordinator_prompt}。
|
||||
# 每次执行前刷新(跟随链最新版),历史 run 用自己的 stages_snapshot 回放。
|
||||
chain_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
cron_expr: Mapped[str] = mapped_column(String(64), nullable=False, default="")
|
||||
timezone: Mapped[str] = mapped_column(String(64), nullable=False, default="Asia/Shanghai")
|
||||
# 执行方式:cron = 按频率定时;once = 只执行一次(创建即执行,next_run_at 恒空)。
|
||||
schedule_type: Mapped[str] = mapped_column(String(16), nullable=False, default="cron", server_default="cron")
|
||||
enabled: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True, server_default="1")
|
||||
next_run_at: Mapped[datetime | None] = mapped_column(BeijingDateTime(), nullable=True, index=True)
|
||||
# 绑定级总控提示(与链内 coordinator_prompt 拼接使用)。
|
||||
coordinator_prompt: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
# 问答沉淀的「执行方向备注」JSON 数组(逐条追加,注入后续每次定时执行)。
|
||||
direction_notes: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
last_run_at: Mapped[datetime | None] = mapped_column(BeijingDateTime(), nullable=True)
|
||||
last_status: Mapped[str | None] = mapped_column(String(32), nullable=True)
|
||||
# 执行模型(席位 run 的 model_name;NULL = 系统/席位默认)。
|
||||
model: Mapped[str | None] = mapped_column(String(128), nullable=True)
|
||||
created_by: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
updated_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow, onupdate=_utcnow)
|
||||
|
||||
|
||||
class TaskAnalysisRunRow(Base):
|
||||
__tablename__ = "task_analysis_runs"
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
binding_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
external_task_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
# schedule = cron 定时执行;manual = 总控问答(对方详情页发起)。
|
||||
trigger: Mapped[str] = mapped_column(String(16), nullable=False, default="schedule")
|
||||
# 幂等键:同 binding + scheduled_for 只建一条(对齐 scheduled_tasks.create_run_once)。
|
||||
scheduled_for: Mapped[datetime] = mapped_column(BeijingDateTime(), nullable=False)
|
||||
started_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
finished_at: Mapped[datetime | None] = mapped_column(BeijingDateTime(), nullable=True)
|
||||
# pending | running | succeeded | failed | partial
|
||||
status: Mapped[str] = mapped_column(String(16), nullable=False, default="pending", index=True)
|
||||
# 本次编排快照 JSON:[[seat_id,...],...](回放不受链后续修改影响)。
|
||||
stages_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
stage_goals_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
seat_names_snapshot: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
# 各席位结果 JSON:{agent_id: {state, duration_ms, thread_id, error}}。
|
||||
seat_results: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
error: Mapped[str | None] = mapped_column(Text, nullable=True)
|
||||
retry_count: Mapped[int] = mapped_column(Integer, nullable=False, default=0, server_default="0")
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
updated_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow, onupdate=_utcnow)
|
||||
|
||||
|
||||
class TaskAnalysisRunMessageRow(Base):
|
||||
__tablename__ = "task_analysis_run_messages"
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
run_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
seq: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
|
||||
# 消息归属席位(agent_id);总控消息用固定标识 __coordinator__。
|
||||
seat_agent_id: Mapped[str] = mapped_column(String(128), nullable=False, default="")
|
||||
stage_index: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
|
||||
# input | llm.ai | tool.result | artifact(对齐现有 run messages 事件分类)。
|
||||
event_type: Mapped[str] = mapped_column(String(32), nullable=False, default="llm.ai")
|
||||
content: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
|
||||
|
||||
class TaskAnalysisContentVersionRow(Base):
|
||||
__tablename__ = "task_analysis_content_versions"
|
||||
__table_args__ = (UniqueConstraint("run_id", name="uq_task_analysis_version_run"),)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
external_task_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
# 一次执行 = 一期时间线版本(1:1)。
|
||||
run_id: Mapped[str] = mapped_column(String(64), nullable=False)
|
||||
# JSON:{key: {name, seat_agent_id, content, format}} —— 对方详情的各块内容。
|
||||
blocks: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
|
||||
|
||||
class TaskDataBlockDefRow(Base):
|
||||
"""数据块定义:块 key 定死 block_1~block_6,标题默认「数据块一~六」可改。"""
|
||||
|
||||
__tablename__ = "task_data_block_defs"
|
||||
__table_args__ = (UniqueConstraint("task_id", "block_key", name="uq_task_data_block_def_key"),)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
# 关联 task_analysis_tasks.id(内部任务 id)。
|
||||
task_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
block_key: Mapped[str] = mapped_column(String(32), nullable=False)
|
||||
title: Mapped[str] = mapped_column(String(128), nullable=False, default="")
|
||||
sort_order: Mapped[int] = mapped_column(Integer, nullable=False, default=0, server_default="0")
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
updated_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow, onupdate=_utcnow)
|
||||
|
||||
|
||||
class TaskDataPeriodRow(Base):
|
||||
"""数据交付时间轴刻度:每个任务 period_index 从 1 递增;run_id 作幂等锚点。"""
|
||||
|
||||
__tablename__ = "task_data_periods"
|
||||
__table_args__ = (
|
||||
UniqueConstraint("task_id", "period_index", name="uq_task_data_period_index"),
|
||||
UniqueConstraint("run_id", name="uq_task_data_period_run"),
|
||||
)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
task_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
period_index: Mapped[int] = mapped_column(Integer, nullable=False)
|
||||
opened_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
# cron = 定时执行开期;manual = 手动触发/总控问答开期;external = 首次提交兜底开期。
|
||||
trigger: Mapped[str] = mapped_column(String(16), nullable=False, default="cron")
|
||||
# 触发本期的执行记录(问答/定时执行共用 run 表);提交兜底开的期没有 run。
|
||||
run_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
|
||||
|
||||
class TaskDataBlockRow(Base):
|
||||
"""每期每块的合并结果(由 task_data_submissions 流水按序合并得出)。"""
|
||||
|
||||
__tablename__ = "task_data_blocks"
|
||||
__table_args__ = (
|
||||
UniqueConstraint("task_id", "period_index", "block_key", name="uq_task_data_block_tpb"),
|
||||
)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
task_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
period_index: Mapped[int] = mapped_column(Integer, nullable=False)
|
||||
block_key: Mapped[str] = mapped_column(String(32), nullable=False)
|
||||
# JSON 对象(顶层 key 合并、同 key 后写覆盖)。
|
||||
payload: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
updated_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow, onupdate=_utcnow)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
|
||||
|
||||
class TaskDataSubmissionRow(Base):
|
||||
"""入库流水(追加只读):块 payload 的一致性来源。"""
|
||||
|
||||
__tablename__ = "task_data_submissions"
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
task_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
period_index: Mapped[int] = mapped_column(Integer, nullable=False)
|
||||
block_key: Mapped[str] = mapped_column(String(32), nullable=False)
|
||||
# 本次提交的 JSON 对象片段(合并语义:顶层 key 合并、同 key 后写覆盖)。
|
||||
payload: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
# 提交方(席位 agent id / 用户 id,仅审计)。
|
||||
submitted_by: Mapped[str | None] = mapped_column(String(128), nullable=True)
|
||||
# 同 (task, period, block) 内的提交序号,从 0 递增 —— 合并顺序依据。
|
||||
seq: Mapped[int] = mapped_column(Integer, nullable=False, default=0, server_default="0")
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow)
|
||||
|
||||
|
||||
class TaskAnalysisSettingRow(Base):
|
||||
"""模块级 KV 设置(当前仅默认业务链)。"""
|
||||
|
||||
__tablename__ = "task_analysis_settings"
|
||||
|
||||
key: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
value: Mapped[str] = mapped_column(PortableLongText, nullable=False, default="")
|
||||
updated_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=_utcnow, onupdate=_utcnow)
|
||||
Reference in new issue
Block a user