数据事件触发(界面):定时页新建时选「定时 / 事件触发」、事件那一节、列表与详情的等待状态、触发历史和运行详情的「由事件触发」

做了什么:
- 新建定时任务(目标是工作流时)先选怎么触发:定时 / 事件触发(TriggerEditor 的 TriggerModePicker);修改时只读地写出触发方式、
  说明建好之后不能改。选了事件触发,频率那一节换成事件(EventSection):三种事件、对象下拉(能选哪些、不能选的原因由新接口
  GET /api/schedules/trigger-options 给,界面照着画、选不了的置灰并写原因)、上传表格的期次(只认新增的一期)、上游工作流的
  只认应用 / 只认来源和触发链上限的说明、去抖、时区;换事件种类时对象和过滤清掉。
- 预览按一次事件渲染输入(对象最近一次的事件,没有时照实说是示例值),不列触发时间;变量按事件种类取(api.schedules.eventVariables),
  插得进 {{ event.* }};请求体带 trigger_kind、trigger,cron 交空串;修改时只交改了的触发条件。model.ts 加 TriggerForm 与
  triggerBody / switchEvent,表单问题里事件触发不查频率、要求选对象;服务端 422 指 trigger 时落到事件那一节。
- 列表、详情:「事件触发」标签,频率处写触发说明;下次运行写在等什么(去抖中收到几次、何时合成一次触发;有事件等待派发;调度
  没开时照实说不会派发)。触发历史:类型「事件」,写「由事件触发:…」、合并了几次、第几层;立即运行按最近一次事件发起的写
  「按事件:…」并标示例值。运行详情页头写「由事件触发:…(定时任务「X」)」(RunDetailView 只多传一个 trigger 属性),立即运行
  按事件发起的写「立即运行定时任务「X」,按事件:…」,不说成由事件触发;应用页印章同样不算。
- 文案进 lib/termsTrigger.ts;SCHEDULE_TEXT 只补触发类型「事件」和「还需处理」里的「触发事件」。立即运行按示例事件的说法
  不再在服务端加「(示例值)」后缀,是不是示例值看 real。

为什么:总方案 §4 要求定时页能建事件触发的任务、列表 / 详情 / 触发历史 / 记录页照实显示;能不能选、为什么由服务端判,界面不放逻辑。

验证:tsc、check-copy;check-schedules 加纯函数一段(表单 ⇄ 请求体)和三段页面(新建的请求体、列表 / 详情 / 触发历史、运行详情
页头,含 390px 浅色),假接口加了触发选项、事件预览、事件变量、事件触发任务的夹具,写请求断言请求体;原有各段照过;check-runs 照过。
This commit is contained in:
ThearchyHelios
2026-10-18 16:11:55 +08:00
parent a1ab3247f9
commit 3f1eeff841
17 changed files with 1010 additions and 74 deletions
+1 -1
View File
@@ -530,8 +530,8 @@ async def _schedule_outs(session: AsyncSession, rows: list[Schedule]) -> list[di
"""触发方式:cron 的 trigger、trigger_text、trigger_state 为 null;事件触发的给规范化后的触发条件、说法、在等的事件。"""
if not _event_kind(r):
return {"trigger_kind": "cron", "trigger": None, "trigger_text": None, "trigger_state": None}
# subject_name 是保存时记下的对象名(对象删掉之后界面写它);带回来时不认(triggers.normalize)
stored = dict(r.trigger or {}) if isinstance(r.trigger, dict) else {}
stored.pop("subject_name", None)
return {"trigger_kind": "event", "trigger": stored, "trigger_text": _trigger_text(r, trigger_names),
"trigger_state": states.get(r.id)}
+3 -2
View File
@@ -290,9 +290,10 @@ async def _from_text(session: AsyncSession, source: Source) -> str:
n = await session.scalar(select(func.count(Run.id)).where(
Run.schedule_id == run.schedule_id, Run.created_at <= run.created_at))
name = schedule.name if schedule is not None else "已删除的定时任务"
# 由数据事件触发的(scheduler/outbox:运行来源里记着 trigger)照实写是什么事件
# 由数据事件触发的(scheduler/outbox:运行来源里记着 trigger)照实写是什么事件;立即运行按示例事件发起的不算
trigger = (run.origin or {}).get("trigger") if isinstance(run.origin, dict) else None
lead = f"由事件触发:{trigger['text']}," if isinstance(trigger, dict) and trigger.get("text") else ""
event = isinstance(trigger, dict) and trigger.get("text") and not trigger.get("sample")
lead = f"由事件触发:{trigger['text']}," if event else ""
return f"{lead}定时任务「{name}」第 {int(n or 1)} 次"
return "正式运行"
+2
View File
@@ -6,6 +6,8 @@
- webhook.py:通知推送(通用 / 飞书 / 企业微信 / 钉钉)
- auto_compare.py:运行成功结束后和同一定时任务上一次成功的运行自动对比,结果记在触发记录上,通知里只带计数摘要和
对比页链接
- triggers.py、outbox.py:数据事件触发(trigger_kind=event,docs/design/orchestration-round/00-总方案.md §4)——触发条件的
规则和说法、防环;待派发事件的写入(发生处)与每一拍的派发、去抖
服务启动时(main.py 的 lifespan)只在 scheduler_enabled() 时调 start,关闭时总是调 stop——stop 要能在没 start
过时安全返回。start 自己也看一次开关:拷来的数据目录(检查脚本的 --stacks、验收副本)不管从哪条路径起服务,
+4 -3
View File
@@ -148,15 +148,16 @@ class EventFire:
return {"kind": "event", "event": self.event, "subject_id": self.subject_id, "subject_name": self.subject_name,
"event_id": self.event_ids[-1] if self.event_ids else None, "event_ids": self.event_ids[-MERGED_KEEP:],
"merged": len(self.event_ids), "depth": self.depth, "chain": self.chain[-CHAIN_KEEP:],
"text": self.text, "sample": self.sample}
"text": self.text, "sample": self.sample, "real": self.real}
def sample_fire(sample: triggers.Sample, tz: str) -> EventFire:
"""立即运行:按示例事件发起(触发链从这里起算,第 1 层)。"""
"""立即运行:按示例事件发起(触发链从这里起算,第 1 层)。是不是示例值记在 real 上,说法不另加后缀:界面、印章按
sample / real 自己说「立即运行,按最近一次事件」「事件为示例值」。"""
text = triggers.event_text(sample.event, sample.subject_name, sample.payload)
return EventFire(event=sample.event, subject_id=sample.subject_id, subject_name=sample.subject_name,
values=triggers.values(sample.event, sample.payload, tz, outputs=sample.outputs),
text=text if sample.real else f"{text}(示例值)", sample=True, real=sample.real,
text=text, sample=True, real=sample.real,
chain=[sample.payload["run_id"]] if sample.event == "workflow.finished" and sample.payload.get(
"run_id") else [])
+11 -2
View File
@@ -124,7 +124,9 @@ async def test_create_table_version_schedule(client):
assert r.status_code == 201, r.text
s = r.json()
assert (s["trigger_kind"], s["cron"], s["next_run_at"], s["target_kind"]) == ("event", "", None, "workflow")
assert s["trigger"] == {"event": "table.version", "source_id": table, "period": "new", "debounce_s": 60}
assert {k: v for k, v in s["trigger"].items() if k != "subject_name"} == {
"event": "table.version", "source_id": table, "period": "new", "debounce_s": 60}
assert s["trigger"]["subject_name"].startswith("门店销售-") # 保存时记下的对象名
assert s["trigger_text"].startswith("上传表格「门店销售-") and "(只认新增的一期;去抖 1 分钟)" in s["trigger_text"]
assert s["description_text"] == s["trigger_text"]
assert s["trigger_state"] == {"events": 0, "waiting": 0, "due_at": None, "scheduler_on": False}
@@ -282,7 +284,7 @@ async def test_preview_and_run_now_with_a_sample_event(client):
"workflow_id": b})
assert r.status_code == 200, r.text
p = r.json()
assert p["next"] == [] and p["event"]["real"] is False and "示例值" in p["event"]["text"]
assert p["next"] == [] and p["event"]["real"] is False and p["event"]["text"].startswith(f"工作流「{a_name}」")
s = (await client.post("/api/schedules", json=body(b, trigger, input_template=template))).json()
early = (await client.post(f"/api/schedules/{s['id']}/run")).json()
assert early["run_id"] is None and early["fire"]["status"] == "failed_to_start"
@@ -303,6 +305,13 @@ async def test_preview_and_run_now_with_a_sample_event(client):
done = await settle(run["run_id"])
assert done.input == {"basis": f"日报完成 · {a_name}"}
assert done.origin["trigger"]["sample"] is True and done.origin["trigger"]["event"] == "workflow.finished"
assert done.origin["trigger"]["real"] is True and done.origin["trigger"]["chain"] == [up.id]
# 应用页印章:立即运行按示例事件发起的不说「由事件触发」
from app.apps import resolve
async with SessionLocal() as session:
said = await resolve._from_text(session, resolve.Source(id="v", kind="latest_sealed", state="ok", run=done))
assert said.startswith("定时任务「下游汇总」第 ")
# 触发历史:事件的说明照写
[newest, *_] = (await client.get(f"/api/schedules/{s['id']}/fires")).json()["items"]
assert newest["event"]["text"].startswith(f"工作流「{a_name}」的正式运行成功结束(#{up.id[:6]})")