Archived

This repository has been archived on 2026-09-13. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

T

ChaiHaoandClaude Opus 5 8d50ceda6a 三面拆分⑭:宽进收敛 —— 起单不卡缺项,进活动受理归一,信息不全派补全单

用户定的逻辑:「调用活动,输入数据可以不定或者为空;进入活动后受理归一,
信息不全派补全单。」把收敛点从门口挪进活动 —— 三道门口闸全撤:

  · 触发装配:缺必填**不再入死信**(AssemblyResult 的 missing 改 partial,带上已装配的);
    装到多少带多少照样起单。死信只留给真错误(勾了确认没指定人这类配置错误)。
  · process.start:撤掉调用接口缺项闸 —— 从前缺一个字段整条流都起不来,
    现实是客户来信本来就常缺客户码,拦在门外等于要求外界替系统把信息备齐。
  · task.start(替代旧 AM 12.1「缺项不得启动」):缺必填的任务落成「等人」,
    缺的字段做成**补全卡**(elicitation,标签取 schema 的 title)发到负责人的
    任务对话流,并武装 human 监听(IntakeDesk 端口;不占活动的人卡预算)。
    答复只收契约声明过的键,合并进 data;齐了或答「没法填」才转 running 开跑;
    答一半就就缺的部分再派一张卡。等人期间谱一步不走、不扣步数。

  · 测试台预检改成**信息**不是闸:灯灭不拦起单,文案直说
    「抽不出的键由受理补全单找人收齐」。

5 条受理归一单测 + 全链实测:投一封只写「想问下工控板价格」的信(零键)→
流照起 → A1 落负责人工位、等人、补全卡在对话流 → 答卡(customerCode/rfqRef)→
任务醒、合并、谱跑 3 步到验收。修一处接线错误:监听 deadline 要 ISO-8601
时长(P2D)不是时刻,传错整个补全监听静默没装上。

trigger/task/process 三份 CONTRACT.md 与产品设计.md 同步(宽进纪律成文)。
五闸绿;契约快照随本提交入库。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m

2026-07-29 13:46:13 +08:00

2.6 KiB

Raw Blame History

module: trigger

职责: 触发器三类(周期两型 / 事件 / 登记)的配置、判定与经调用接口起单; 起单幂等;数据日历型的逐行扫描不负责: 流程包的结构与流转(见 process)、事件的投递(见 event —— 触发器是它的一个消费方)

公开出口: index.ts

类型:TriggerService TriggerConfig EventScope FireOutcome AssemblyResult
错误:TriggerInputMissingError
端口类型:TriggerStore ProcessGateway Sfeel DeadLetterSink LedgerScanner
用例工厂:createTriggerService(deps): TriggerService
纯函数:matchesEvent assembleInput triggerIdempotencyKey nextCalendarFire dataCalendarKey applyOffset scopeOf
adapter:createTriggerStore;Drizzle 表:triggerTable triggerClaimTable

层级: L7(编码规范 §4) 依赖: @contracts;@shared/db;process(L7 同层 → 经 ProcessGateway 端口由 app 注入); port:Sfeel / DeadLetterSink(message)/ LedgerScanner(ledger) 被依赖: event(经 TriggerMatcher 端口,由 app 注入 —— event 是 L1,不反向依赖本模块)、app

不变量(OS 3.1 / 6.3):

命中不等于必起(2026-07-30 触发确认链路):触发器可勾「需人工确认」(运营配置, 设计面的 upsert 不写 confirm 两列,只有 setConfirm 动)。勾了,命中后装配好的入参存成待确认单(sys.trigger_pending),带来件内容的系统消息(ConfirmDesk 端口)送指定人工作台;confirmPending 才起单。先认领后起单(consumed_at 空才认得到), 并发确认只有一个赢;起单失败退回认领,不留死票。登记触发不走确认 —— 登记那一下本身就是人在确认;勾了确认没指定人 = 配置错误入死信,不静默直起。
触发器与流程包平级:配置独立存放,增删启停不改流程包的任何版本
只负责起单:经调用接口调起流程包;流程包与活动内部不含任何触发逻辑
同一事件流,不另设通路:match 供 event 的三级消费判定使用
同一事件对同一触发器至多起一单:以事件 ID 为幂等键
宽进(2026-07-30,用户定,替代旧「缺必填即入死信」):缺必填照样起单 —— 装到多少带多少(AssemblyResult.partial);收敛点在活动:受理归一、信息不全派补全单。死信只留给真错误(勾了确认没指定人、包无生效版这类配置错误)
数据日历型同一行同一日期只触发一次(键含日期值);字段值变更后可再触发
命中规则求值失败按不命中处置 —— 规则写坏了不让事件流停摆

2.6 KiB Raw Blame History

module: trigger

2.6 KiB

Raw Blame History