Files

63 lines
3.2 KiB
Go

// event.go S1-B 拆包:submit 事件契约(原 consumer.go 顶部三类型;生产者持有契约,
// consume 消费侧经 import submit 引用——依赖方向 consume→submit 单向)。
// 状态契约常量族(原 dispatch/timer.go;跨三子包共用,迁契约所有者=submit 并导出)。
package submit
// 审核态/任务态稳定契约值(与 audit 包常量一致;避免 send→audit 本体依赖)。
const (
AuditReadyExempt = 3 // 免审(可发)
TaskStSending = 1
TaskStDone = 2
DetailStSubmitted = 1 // 明细:已提交
DetailStFailed = 3 // 明细:失败
)
// SubmitEvent sms-submit 事件载荷(Day46 openapi 五字段向后兼容+Day48 扩展+Day52 R2 明细全量)。
type SubmitEvent struct {
TaskID int64 `json:"task_id"`
TaskNo string `json:"task_no"`
AccountID int64 `json:"account_id"`
SendType int8 `json:"send_type"`
PassCount int `json:"pass_count"` // 过拦截条数(0=全拦,消费者跳过;Day52 起由 details 推导)
Source string `json:"source"`
CreatedAt string `json:"created_at"`
Business string `json:"business,omitempty"` // Day 49:sms/video(biz_type 路由;空=sms 兼容 Day48 旧载荷)
// Day52 R2:明细全量(入口预生成雪花 ID+拦截终态;消费侧批量落库,入口事务零明细写)。
// 空=Day48 旧格式/兜底扫描场景,消费侧不落(明细已由降级路径或旧版本落库)。
Details []EventDetail `json:"details,omitempty"`
// P0-1(Day 63)接入异步化:Deferred=true 表示受理侧走 SubmitFast 快路径
// (Validate+预扣+DetailID 预生成+投递,零 DB 写),task 落库/拦截判定/退费/
// 审核分流全部由消费侧补全(handleDeferred);TaskID=0(自增主键消费侧生成)。
Deferred bool `json:"deferred,omitempty"`
// TaskMeta Deferred 专用:任务行补建字段(与 entity.MessageTask 对齐;
// 旧事件零携带,消费侧按非 Deferred 老路径处理)。
TaskMeta *SubmitTaskMeta `json:"task_meta,omitempty"`
}
// SubmitTaskMeta 快路径任务补建载荷(受理侧未落库,消费侧 INSERT 重建)。
type SubmitTaskMeta struct {
Content string `json:"content"`
Sign string `json:"sign"`
MobileCount int `json:"mobile_count"`
FeeTotal float64 `json:"fee_total"`
SubmitIP string `json:"submit_ip"`
CallData string `json:"call_data"`
Source int8 `json:"source"` // 任务来源 int8(WEB=4/CMPP=2/SMPP=3/API=1)
ScheduleAt string `json:"schedule_at,omitempty"` // RFC3339,空=非定时
}
// EventDetail 明细行载荷(task_id/account_id 公共字段在事件级;字段与 entity.MessageDetail 对齐)。
type EventDetail struct {
ID int64 `json:"id"` // 雪花主键(入口预生成,回执配对键)
Mobile string `json:"mobile"`
Content string `json:"content"`
Status int8 `json:"status"` // 0=存活 5=拦截终态(受理期已退费)
Fee float64 `json:"fee"` // 计费条数
ErrorCode string `json:"error_code,omitempty"`
ExtCode string `json:"ext_code,omitempty"`
CallData string `json:"call_data,omitempty"`
// Day66:明细单表化冗余(空=旧载荷,persistDetailsDB 兜底 ev.Business/'sms')。
Business string `json:"business,omitempty"`
Source int8 `json:"source,omitempty"` // 0=旧载荷→兜底 API
}