Files
go-sms-V2/memory-bank/docs/Go-sms-重建设计规范.md
T

3.0 KiB

Go-sms 重建设计规范(强制)

【文档状态】🔄 生效(2026-11-12)——C 层踩坑结论的结构化沉淀;任何 v2 设计/评审与本文冲突时,以本文为准(除非有 POC 验收单级的新证据推翻并留痕)。

一、结构裁决

  1. 以 POC 实际演化结构为基础,不照搬技术方案 §11 纸面结构(35 包 -race 全绿的实测结构 > 纸面设计);
  2. 修正项:internal/router 空壳归位;send 按受理/消费/下发拆子包;测试命名去 dayNN 改语义;message_detail 建表即单表化(v17 口径)+ 按天分区热 5 天;
  3. 服务边界:gateway 大单体拆分评估放 S5 基线期(性能数据齐后裁决),搬运期不强拆。

二、性能三律(Day64/67 三轮优化 82s→1.0s 的代价换来的)

  1. 筛选列随查询下沉明细表:业务筛选禁止依赖 JOIN task(单表化冗余列);
  2. 聚合 JOIN 一律改按页 id 的相关子查询:派生表全表物化会随业务量静默劣化(每页请求都付全表聚合代价);
  3. 延迟关联三段式只救宽行排序,救不了 JOIN 计数随机回表。

三、语义与口径(不可妥协)

  • 计费:fee≡上游真实拆分片数;FeeSegments>0 直接采信 > UCS2 按 SmsLengthUCS2 > GBK 默认;
  • MsgID = DetailID 雪花,全链统一(受理 Resp / 回执配对 / 跨重启一致);
  • 长短信:完整性优先,72h 不齐 = 失败终态(LSM:NOTCMPL / 零费 / UNDELIV);组 ID=首片雪花;持久化-还原键字段必须成对审计(Day71 ref 字段教训);
  • UNKNOWN:出向回执 72h 窗后保持 UNKNOWN(部分段事实送达,不标失败);
  • 幂等三锚:task_no uk / detail pk / OnConflict DoNothing——重复扫描/重投/并发至多一次生效。

四、门禁纪律

  • 七件套:go vet+test(-race 必须全量,aggregator 教训)→ lint → 前端四件 → 人工验收单归档 → 本人走查 → CHANGELOG → 日历/进度回填;
  • 救火日七件套不豁免(Day59-65 破窗教训);救火缓冲 5+1;
  • 部署串行:build→kill→确认退出→nohup→md5sum /proc/PID/exe 比对(并行 build+kill=旧 inode 幽灵进程)。

五、SSD 环境基线

buffer_pool 16~24G(按 64G 内存)/ innodb_io_capacity=2000, io_capacity_max=10000 / redo≥1G / Kafka flush 放宽靠副本兜底;workers:4 与消费顶 55/s 是 HDD 数字,S5 必须重标定;正式基线前置 24h 稳定性门槛(dmesg 零新增 + 进程零重启)。

六、CPU 缺陷基线 Plan B(决策树)

S0 开荒实测(stress-ng avx2/memcpy/vm + 20 轮编译循环):

  • 复现率 = 0 → 正常推进;
  • 0 < 复现 < 1 次/天 → 开发容忍(「偶发 SEGV 先查 dmesg 再重试」入 runbook);压测基线外置(借健康机器)或带脚注;
  • ≥ 1 次/天 → 基线必须外置;建议机房换整机(重建 30+ 工作日不值概率性地基)。

七、备份与安全

  • cron 每日 git bundle create /data/backup/v2-$(date +%F).bundle --all + rsync 拉回本地(单人纪律不可靠,自动化);
  • 凭证/密钥永不入库;公网机器仅密钥登录 + fail2ban + 最小端口面。