feat(issue#3 方案B): 系统配置页(/system/config KV 管理)+ SrcID 两级回退链(账号 ext_code 优先→系统默认 cmpp.default_ext_code)

This commit is contained in:
2026-11-18 10:58:18 +08:00
parent ed40942a4c
commit 7d34130079
14 changed files with 607 additions and 24 deletions
+11
View File
@@ -2,6 +2,17 @@
> 本仓 CHANGELOG 自重建起记(POC 明细见归档仓 /data/poc-archive/repos/go-sms.git 的 CHANGELOG.md,已冻结)。
## 2026-11-16(晚二)· Issue#3 方案B:系统配置页 + 系统级默认接入码回退链
- **范围(用户拍板 A+B)**:「系统配置」占位页做实(system_config KV 管理面)+ SrcID 校验两级回退链(账号 ext_code 优先 → 系统默认 cmpp.default_ext_code 兜底 → 均空放行)。
- **sysconfig 域**(新包):Get(30s TTL 读缓存+缺行空值缓存)/List(cfg_key 升序)/Set(uk UPSERT:值/备注/操作人/时间;**写即刻失效缓存——区别于账号 ext_code 的 30s accCache 窗口,管理页改完即生效**);DB 错误降级空串=放行口径与账号级缺省一致。
- **回退链(access)**:`effectiveExtCode`(账号 ext_code 优先,空读系统默认;getter 未注入=行为不变);precheck 改返 (cfg,ext,result)——直发/长短信 submitFragment/SMPP SubmitSM 三路径统一用生效前缀(扩展码剥离口径一致);拒收日志加 from_system_default 辨识来源。
- **端点**:GET /system/config(登录即可)/ PUT /system/config(system:write——admin 直通,同 error-codes 口径;AuditTrail 写方法自动留痕 updated_by)。与 error-codes 同口径未进 openapi.yaml paths。
- **前端**:系统配置页 views/system(占位页转正:KV 表格+新增/编辑对话框,已知键下拉 cmpp.default_ext_code/uplink.blacklist.keywords 带运营提示,defineOptions name=system 守门);api/system.ts;路由 meta 加 subtitle;AccountDetail 两处文案改「未配置时回退系统默认接入码」。
- **真机闭环实证**(第三方 2.0 探针四态矩阵):账号 ext 空+系统默认 SYSDEF:106 → SYSDEF:10699 过(10)/10690331 拒(9)=**系统级接管**;恢复账号 10690331 → 10690331 过(10)/SYSDEF:10699 拒(9)=**账号级优先不叠加**;GET/PUT/UPSERT(updated_by 留痕+created_at 保留首插)全链过。生产值已设 **cmpp.default_ext_code=10690331**(未配置账号开箱即校验;账号级可覆盖)。
- **测试 +8**:sysconfig 4 件(缺行空串/UPSERT+缓存即刻失效(长 TTL 反证)/List 顺序/键值校验)+ access 回退 3 件(系统默认放行+拒/账号优先不叠加/双空放行回归)。
- **门禁**:vet 0/**-race 42 包全绿**(+1 新包)/lint 0;eslint 0/vue-tsc 0/vitest **165**/build 9.91s;gateway 串行部署(md5 比对 ✓)。
## 2026-11-16(晚)· Issue#3:CMPP 服务端连接报 -1 + 充值无响应 + SrcID 核验口径
- **工单**:Gitea Issue#3「Bug:服务端CMPP链接-1」——s2demo 作服务端账号客户连接报 -1;页面充值点击无响应;通道号(接入码)SrcID(≤21位)是否需要核验。
+10
View File
@@ -35,6 +35,7 @@ import (
"go-sms/internal/service/router"
"go-sms/internal/service/send"
"go-sms/internal/service/settle"
"go-sms/internal/service/sysconfig"
"go-sms/internal/service/template"
"go-sms/internal/service/uplink"
"go-sms/internal/util"
@@ -230,6 +231,9 @@ func main() {
}
a.OnShutdown(func() { _ = chConn.Close() })
}
// Issue#3 方案B:系统参数配置服务(system_config KV;/system/config
// 管理端点 + access 系统默认接入码回退源;30s 读缓存+写即刻失效)。
sysCfgSvc := sysconfig.New(db, 30*time.Second)
v1.Register(rg, v1.Deps{
Account: svc,
Warning: warnSvc,
@@ -261,6 +265,9 @@ func main() {
Callback: cbSvc,
// S4·D3:/record/history 冷查(CH;nil=不注册)
Archive: arcSvc,
// Issue#3 方案B:系统参数配置(/system/config;access 系统默认
// 接入码回退数据源)。30s 读缓存+写即刻失效。
SysConfig: sysCfgSvc,
})
// Day68:运营总览汇总刷新(回补 30 天+60s ticker 增量 UPSERT stats_daily;
// 幂等多实例无害,详见 stats_handler.go StartStatsRefresher)。
@@ -320,6 +327,9 @@ func main() {
SubmitRate: cfg.Server.CMPP.SubmitRatePerConn,
LongSmsWindow: cfg.Server.CMPP.LongSmsWindow, // Day 71:≤0 默认 72h
})
// Issue#3 方案B:系统配置源注入——账号 ext_code 为空时回退系统默认
// 接入码 cmpp.default_ext_code(/system/config 可配)。
accSvc.SetSystemConfig(sysCfgSvc)
// Day 71:长短信挂起制——重启恢复+72h 到期扫描(不齐不发,LP 失败
// 终态+UNDELIV 回执经 Kafka cmpp-deliver 回环推下家在线连接)。
{
+8
View File
@@ -32,6 +32,7 @@ import (
"go-sms/internal/service/router"
"go-sms/internal/service/send"
"go-sms/internal/service/settle"
"go-sms/internal/service/sysconfig"
"go-sms/internal/service/template"
)
@@ -76,6 +77,9 @@ type Deps struct {
// Archive S4·D3:明细冷热归档(/record/history 冷查走 ClickHouse;
// nil=不注册 history 端点,前端 404 优于半可用)。
Archive *archive.Service
// SysConfig Issue#3 方案B:系统参数配置(/system/config GET/PUT;
// access 系统默认接入码回退的数据源;nil=不注册)。
SysConfig *sysconfig.Service
}
// Register 注册 v1 路由组。
@@ -187,6 +191,10 @@ func Register(rg *gin.RouterGroup, deps Deps) {
if deps.ErrorCode != nil {
registerErrorCodeRoutes(protected, deps.Perm, deps.ErrorCode)
}
// Issue#3 方案B:系统参数配置(system_config KV 管理页数据源)。
if deps.SysConfig != nil {
registerSysConfigRoutes(protected, deps.Perm, deps.SysConfig)
}
// Day 53(runbook §6.4/§6.2 P0):前端错误上报(POST public/GET 排障)+
// Alertmanager webhook 接收(AM 推送→日志留痕,告警通道验收抓手)。
registerFeErrorRoutes(rg, protected, deps.DB, deps.Perm)
+66
View File
@@ -0,0 +1,66 @@
// sysconfig_handler.go Issue#3 方案B:系统参数配置端点(system_config KV 表)。
// - GET /system/config 全量列表(登录即可,管理页数据源)
// - PUT /system/config 新增/更新(system:write——admin 直通;UPSERT+缓存即刻失效)
// 已知键:cmpp.default_ext_code(系统默认接入码前缀,账号 ext_code 空时回退,
// 受理热路径 30s 读缓存)/uplink.blacklist.keywords(上行拉黑词表,uplink 域
// 自刷新 60s 生效)。表结构无白名单约束,新键=新能力按需扩展。
package v1
import (
"github.com/gin-gonic/gin"
"go-sms/internal/middleware"
"go-sms/internal/pkg/errors"
"go-sms/internal/pkg/response"
"go-sms/internal/service/sysconfig"
)
type sysConfigHandler struct{ svc *sysconfig.Service }
func registerSysConfigRoutes(protected *gin.RouterGroup, perm middleware.PermissionChecker, svc *sysconfig.Service) {
h := &sysConfigHandler{svc: svc}
protected.GET("/system/config", h.list)
protected.PUT("/system/config", middleware.RequirePermission(perm, "system", "write"), h.set)
}
// list GET /system/config(全量,cfg_key 升序)。
func (h *sysConfigHandler) list(c *gin.Context) {
rows, err := h.svc.List(c.Request.Context())
if err != nil {
response.Error(c, errors.InternalError)
return
}
response.Success(c, gin.H{"list": rows})
}
// sysConfigReq PUT 请求体。
type sysConfigReq struct {
CfgKey string `json:"cfg_key" binding:"required"`
CfgValue string `json:"cfg_value"` // 空串=合法值(清空语义)
Remark string `json:"remark"`
}
// set PUT /system/config(cfg_key 唯一 UPSERT;审计由 AuditTrail 写方法自动留痕)。
func (h *sysConfigHandler) set(c *gin.Context) {
var req sysConfigReq
if err := c.ShouldBindJSON(&req); err != nil {
response.ErrorWithMsg(c, errors.InvalidParam, "参数错误: "+err.Error())
return
}
claims := operatorClaims(c)
operator := ""
if claims != nil {
operator = claims.Username
}
row, err := h.svc.Set(c.Request.Context(), req.CfgKey, req.CfgValue, req.Remark, operator)
if err != nil {
if bizErr, ok := err.(*errors.Error); ok {
response.Error(c, bizErr)
return
}
c.Set("biz_error", err.Error())
response.Error(c, errors.InternalError)
return
}
response.Success(c, row)
}
+45 -15
View File
@@ -23,6 +23,7 @@ import (
"go-sms/internal/service/openapi"
"go-sms/internal/service/report"
"go-sms/internal/service/send"
"go-sms/internal/service/sysconfig"
"go.uber.org/zap"
"gorm.io/gorm"
)
@@ -80,8 +81,19 @@ type Service struct {
// 长短信片聚合器(批次 2278141 修复):入向 UDH 拼接多片按组聚合,
// 到齐合并为一条逻辑 task;超时逐片退化直发。见 longsms.go。
grouper *longSmsGrouper
// sysCfg Issue#3 方案B:系统配置源(账号 ext_code 空时回退系统默认接入码
// cmpp.default_ext_code);nil=无系统回退(行为不变,测试/降级场景)。
sysCfg SystemConfigGetter
}
// SystemConfigGetter 系统配置读取接口(由 sysconfig.Service 实现;解耦包依赖)。
type SystemConfigGetter interface {
Get(ctx context.Context, key string) string
}
// SetSystemConfig 注入系统配置源(可选;gateway 装配调用,nil=无系统回退)。
func (s *Service) SetSystemConfig(g SystemConfigGetter) { s.sysCfg = g }
// accountCacheEntry 账号缓存条目(u/cfg nil=查无,负缓存防穿透)。
type accountCacheEntry struct {
u, cfg any // *entity.AccountUser | *entity.AccountConfig | nil
@@ -271,31 +283,47 @@ func (s *Service) Submit(sourceAddr, srcID string, dest []string,
defer func() { submitStats.record(time.Since(t0)) }()
ctx := context.Background()
if udh != nil && udh.Total > 1 && len(dest) == 1 {
cfg, result := s.precheck(ctx, sourceAddr, srcID)
cfg, ext, result := s.precheck(ctx, sourceAddr, srcID)
if cfg == nil {
return 0, result
}
return s.grouper.submitFragment(s.api, cfg, sourceAddr, srcID,
return s.grouper.submitFragment(s.api, cfg, ext, sourceAddr, srcID,
dest[0], content, udh, msgFmt == cmpp.MsgFmtUCS2)
}
return s.submitDirect(ctx, sourceAddr, srcID, dest, content, msgFmt)
}
// precheck 账号加载+通道号前缀校验(cfg=nil 时返回值为 CMPP 拒绝码)。
// precheck 账号加载+通道号校验(cfg=nil 时返回值为 CMPP 拒绝码)。
// 直发与长短信聚合共用(聚合组以首片账号快照为准)。
func (s *Service) precheck(ctx context.Context, sourceAddr, srcID string) (*entity.AccountConfig, byte) {
// Issue#3 方案B:返回生效校验前缀 ext——账号 ext_code 优先,空则回退系统默认
// cmpp.default_ext_code(账号级定制>系统级统一;两层均空=不校验)。
func (s *Service) precheck(ctx context.Context, sourceAddr, srcID string) (*entity.AccountConfig, string, byte) {
_, cfg := s.loadAccount(ctx, sourceAddr)
if cfg == nil {
return nil, cmpp.SubmitRejected
return nil, "", cmpp.SubmitRejected
}
// 通道号前缀:账号 ext_code 非空时 SrcID 必须以其为前缀(UT:0012 语义)。
if cfg.ExtCode != "" && !strings.HasPrefix(srcID, cfg.ExtCode) {
ext := s.effectiveExtCode(ctx, cfg)
// 通道号前缀:ext 非空时 SrcID 必须以其为前缀(UT:0012 语义;系统默认同)。
if ext != "" && !strings.HasPrefix(srcID, ext) {
logger.L().Warn("cmpp_submit_src_prefix_mismatch",
zap.String("source_addr", sourceAddr), zap.String("src_id", srcID),
zap.String("ext_code", cfg.ExtCode))
return nil, cmpp.SubmitBadCode
zap.String("ext_code", ext),
zap.Bool("from_system_default", cfg.ExtCode == ""))
return nil, "", cmpp.SubmitBadCode
}
return cfg, cmpp.SubmitOK
return cfg, ext, cmpp.SubmitOK
}
// effectiveExtCode 生效校验前缀:账号 ext_code 优先;空则回退系统默认
// (Issue#3 方案B;sysCfg 未注入/系统键未配置=空=不校验)。
func (s *Service) effectiveExtCode(ctx context.Context, cfg *entity.AccountConfig) string {
if cfg.ExtCode != "" {
return cfg.ExtCode
}
if s.sysCfg != nil {
return s.sysCfg.Get(ctx, sysconfig.KeyDefaultExtCode)
}
return ""
}
// submitDirect 普通提交(原 Submit 主体):P0-1(Day 63)快路径受理。
@@ -303,7 +331,7 @@ func (s *Service) precheck(ctx context.Context, sourceAddr, srcID string) (*enti
func (s *Service) submitDirect(ctx context.Context, sourceAddr, srcID string,
dest []string, content string, msgFmt uint8) (uint64, byte) {
tAcc := time.Now()
cfg, result := s.precheck(ctx, sourceAddr, srcID)
cfg, ext, result := s.precheck(ctx, sourceAddr, srcID)
tAccCost := time.Since(tAcc)
if cfg == nil {
return 0, result
@@ -316,7 +344,7 @@ func (s *Service) submitDirect(ctx context.Context, sourceAddr, srcID string,
PhoneList: dest,
Content: content,
SignName: "", // CMPP 内容自带【签名】,与 Day41 验收二变口径一致
ExtCode: strings.TrimPrefix(srcID, cfg.ExtCode),
ExtCode: strings.TrimPrefix(srcID, ext),
// Day 70:按 MsgFmt 分流计费口径(UCS2=8:每码元 2B;fee≡上游真实片数)。
ContentEncoding: ucs2Encoding(msgFmt == cmpp.MsgFmtUCS2),
}, remoteIPPlaceholder)
@@ -356,7 +384,8 @@ func (s *Service) Bind(systemID, password, clientIP string) smpp.Status {
return smpp.StatusOK
}
// SubmitSM 实现 smpp.ServerHandler:源地址前缀校验→SendMass 受理。
// SubmitSM 实现 smpp.ServerHandler:源地址校验(账号 ext_code 优先,空回退系统
// 默认接入码——Issue#3 方案B,与 CMPP precheck 同口径)→SendMass 受理。
func (s *Service) SubmitSM(systemID, srcAddr, destAddr, content string,
registeredDelivery uint8) (string, smpp.Status) {
ctx := context.Background()
@@ -364,7 +393,8 @@ func (s *Service) SubmitSM(systemID, srcAddr, destAddr, content string,
if cfg == nil {
return "", smpp.StatusSysErr
}
if cfg.ExtCode != "" && !strings.HasPrefix(srcAddr, cfg.ExtCode) {
ext := s.effectiveExtCode(ctx, cfg)
if ext != "" && !strings.HasPrefix(srcAddr, ext) {
return "", smpp.StatusSysErr
}
resp := s.api.SendMass(ctx, &openapi.AuthContext{
@@ -373,7 +403,7 @@ func (s *Service) SubmitSM(systemID, srcAddr, destAddr, content string,
}, &openapi.MassReq{
PhoneList: []string{destAddr},
Content: content,
ExtCode: strings.TrimPrefix(srcAddr, cfg.ExtCode),
ExtCode: strings.TrimPrefix(srcAddr, ext),
}, remoteIPPlaceholder)
if resp.Code != openapi.CodeOK {
return "", smpp.StatusSysErr
+7 -5
View File
@@ -90,14 +90,16 @@ func longSmsKey(accountID int64, srcID, mobile string, ref uint8) string {
}
// submitFragment 片提交:入组缓存(未齐回组ID 不发)/到齐合并单次受理。
// precheck(账号+通道号前缀)已由调用方 Submit 完成,cfg 为验过快照。
// precheck(账号+通道号校验)已由调用方 Submit 完成,cfg 为验过快照;
// ext=生效校验前缀(账号 ext_code 或系统默认,Issue#3 方案B)——扩展码
// 剥离口径与直发一致(TrimPrefix(srcID, ext))。
func (g *longSmsGrouper) submitFragment(api longSmsAPI, cfg *entity.AccountConfig,
sourceAddr, srcID, mobile, content string, udh *cmpp.UDHInfo, ucs2 bool) (uint64, byte) {
ext, sourceAddr, srcID, mobile, content string, udh *cmpp.UDHInfo, ucs2 bool) (uint64, byte) {
auth := &openapi.AuthContext{
AccountID: cfg.AccountID, Username: sourceAddr, Config: cfg,
Source: send.TaskSourceCMPP, // Day 60:受理来源打标(CMPP 接入)
}
ext := strings.TrimPrefix(srcID, cfg.ExtCode)
extCode := strings.TrimPrefix(srcID, ext)
key := longSmsKey(cfg.AccountID, srcID, mobile, udh.Ref)
isNew := false
@@ -112,7 +114,7 @@ func (g *longSmsGrouper) submitFragment(api longSmsAPI, cfg *entity.AccountConfi
zap.String("source_addr", sourceAddr), zap.String("mobile", mobile),
zap.Uint8("ref", udh.Ref), zap.Uint8("group_total", grp.total),
zap.Uint8("frag_total", udh.Total))
return directSubmit(api, auth, mobile, ext, content, ucs2)
return directSubmit(api, auth, mobile, extCode, content, ucs2)
}
if !ok {
if len(g.groups) >= g.maxGroup {
@@ -127,7 +129,7 @@ func (g *longSmsGrouper) submitFragment(api longSmsAPI, cfg *entity.AccountConfi
}
grp = &pendingLong{
groupID: uint64(api.NextMsgID()),
auth: auth, srcID: srcID, mobile: mobile, extCode: ext,
auth: auth, srcID: srcID, mobile: mobile, extCode: extCode,
total: udh.Total, ref: udh.Ref, ucs2: ucs2, frags: make(map[uint8]string),
}
g.groups[key] = grp
@@ -0,0 +1,87 @@
// sysconfig_fallback_test.go Issue#3 方案B:SrcID 校验两级回退链——
// 账号 ext_code 优先 > 系统默认 cmpp.default_ext_code > 均空放行。
package access
import (
"context"
"testing"
"go-sms/internal/model/entity"
"go-sms/internal/protocol/cmpp"
)
// sysCfgStub 固定值系统配置桩。
type sysCfgStub struct{ v string }
func (s sysCfgStub) Get(_ context.Context, _ string) string { return s.v }
// TestSubmit_SystemDefaultFallback 账号 ext_code 空 → 回退系统默认:
// 匹配系统前缀受理、不匹配回 9、命中日志可辨识。
func TestSubmit_SystemDefaultFallback(t *testing.T) {
db := newAccessDB(t)
u := entity.AccountUser{Username: "noext_user", Status: 1, Balance: 10000}
if err := db.Create(&u).Error; err != nil {
t.Fatal(err)
}
cfg := entity.AccountConfig{AccountID: u.ID, Business: "sms",
ApiSecret: "shared-secret-32hex", AuditMode: 0} // ExtCode 留空
if err := db.Create(&cfg).Error; err != nil {
t.Fatal(err)
}
s, _ := newSvc(t, db)
s.SetSystemConfig(sysCfgStub{v: "SYS:1069"})
// 系统前缀+扩展 → 过(方案C 动态扩展同口径)。
if _, result := s.Submit("noext_user", "SYS:1069001",
[]string{"13800138000"}, "【签名】你好", nil, 1, cmpp.MsgFmtGBK); result != cmpp.SubmitOK {
t.Fatalf("系统默认前缀应放行: result=%d", result)
}
// 不匹配系统前缀 → 9。
if _, result := s.Submit("noext_user", "XX:9999",
[]string{"13800138000"}, "【签名】你好", nil, 1, cmpp.MsgFmtGBK); result != cmpp.SubmitBadCode {
t.Fatalf("不匹配系统默认应拒: result=%d", result)
}
}
// TestSubmit_AccountExtTakesPriority 账号 ext_code 非空时账号优先——系统默认
// 不参与(系统前缀的 SrcID 也拒,证明两级不叠加)。
func TestSubmit_AccountExtTakesPriority(t *testing.T) {
db := newAccessDB(t)
seedAccount(t, db) // ExtCode=UT:0012
s, _ := newSvc(t, db)
s.SetSystemConfig(sysCfgStub{v: "SYS:1069"})
if _, result := s.Submit("cmpp_user", "SYS:1069001",
[]string{"13800138000"}, "【签名】你好", nil, 1, cmpp.MsgFmtGBK); result != cmpp.SubmitBadCode {
t.Fatalf("账号 ext 优先:系统前缀应拒(不叠加放行), result=%d", result)
}
if _, result := s.Submit("cmpp_user", "UT:001299",
[]string{"13800138000"}, "【签名】你好", nil, 1, cmpp.MsgFmtGBK); result != cmpp.SubmitOK {
t.Fatalf("账号前缀应放行: result=%d", result)
}
}
// TestSubmit_NoSysCfgNoExt 双空放行(getter 未注入/ext 空/系统键空=回归原行为)。
func TestSubmit_NoSysCfgNoExt(t *testing.T) {
db := newAccessDB(t)
u := entity.AccountUser{Username: "noext_user", Status: 1, Balance: 10000}
if err := db.Create(&u).Error; err != nil {
t.Fatal(err)
}
cfg := entity.AccountConfig{AccountID: u.ID, Business: "sms",
ApiSecret: "shared-secret-32hex", AuditMode: 0}
if err := db.Create(&cfg).Error; err != nil {
t.Fatal(err)
}
s, _ := newSvc(t, db) // 未注入 sysCfg
if _, result := s.Submit("noext_user", "ANY:THING",
[]string{"13800138000"}, "【签名】你好", nil, 1, cmpp.MsgFmtGBK); result != cmpp.SubmitOK {
t.Fatalf("双空应放行(原行为): result=%d", result)
}
// 注入但系统键空值=同语义。
s.SetSystemConfig(sysCfgStub{v: ""})
if _, result := s.Submit("noext_user", "ANY:THING",
[]string{"13800138000"}, "【签名】你好", nil, 1, cmpp.MsgFmtGBK); result != cmpp.SubmitOK {
t.Fatalf("系统键空应放行: result=%d", result)
}
}
+106
View File
@@ -0,0 +1,106 @@
// Package sysconfig 系统参数配置域(Issue#3 方案B):system_config KV 表统一
// 读(Get 带 TTL 缓存)/写(Set UPSERT+缓存即刻失效)/列(List)。
// 消费方:access(系统默认接入码回退,见 KeyDefaultExtCode)、uplink 拉黑词表
// (uplink.blacklist.keywords,该域自刷新不走本缓存,页面改后 60s 生效)。
package sysconfig
import (
"context"
"strings"
"sync"
"time"
"go-sms/internal/model/entity"
"go-sms/internal/pkg/errors"
"go-sms/internal/pkg/logger"
"go.uber.org/zap"
"gorm.io/gorm"
"gorm.io/gorm/clause"
)
// KeyDefaultExtCode 系统默认接入码前缀(账号 ext_code 为空时回退;Issue#3 方案B:
// 账号级优先、系统级兜底——新账号开箱即有码校验,无需逐账号配置)。
const KeyDefaultExtCode = "cmpp.default_ext_code"
const defaultTTL = 30 * time.Second
type cacheEntry struct {
value string
expireAt time.Time
}
// Service 系统配置服务。
type Service struct {
db *gorm.DB
ttl time.Duration
mu sync.RWMutex
cache map[string]cacheEntry
}
// New 构造(ttl≤0=30s,与 access 账号缓存同量级;Set 主动失效兜底即刻生效)。
func New(db *gorm.DB, ttl time.Duration) *Service {
if ttl <= 0 {
ttl = defaultTTL
}
return &Service{db: db, ttl: ttl, cache: map[string]cacheEntry{}}
}
// Get 读配置(未配置/缺行=空串;DB 错误降级空串记日志且不缓存——校验语义=不拦,
// 与账号级 ext_code 缺省放行口径一致)。
func (s *Service) Get(ctx context.Context, key string) string {
now := time.Now()
s.mu.RLock()
e, ok := s.cache[key]
s.mu.RUnlock()
if ok && now.Before(e.expireAt) {
return e.value
}
var row entity.SystemConfig
err := s.db.WithContext(ctx).Where("cfg_key = ?", key).First(&row).Error
value := ""
if err == nil {
value = row.CfgValue
} else if err != gorm.ErrRecordNotFound {
logger.L().Warn("sysconfig_get_failed", zap.String("key", key), zap.Error(err))
return ""
}
s.mu.Lock()
s.cache[key] = cacheEntry{value: value, expireAt: now.Add(s.ttl)}
s.mu.Unlock()
return value
}
// List 全量(cfg_key 升序;管理页数据源)。
func (s *Service) List(ctx context.Context) ([]entity.SystemConfig, error) {
var rows []entity.SystemConfig
err := s.db.WithContext(ctx).Order("cfg_key").Find(&rows).Error
return rows, err
}
// Set UPSERT(uk cfg_key 冲突→更新值/备注/操作人/时间)并即刻失效该键缓存
// (改完即生效——区别于账号 ext_code 的 30s accCache 窗口,管理页操作即时可验)。
func (s *Service) Set(ctx context.Context, key, value, remark, updatedBy string) (*entity.SystemConfig, error) {
key = strings.TrimSpace(key)
if key == "" || len(key) > 64 {
return nil, errors.InvalidParam.WithMsg("cfg_key 须 1~64 字符")
}
if len(value) > 1024 {
return nil, errors.InvalidParam.WithMsg("cfg_value 超 1024 字符")
}
if len(remark) > 255 {
return nil, errors.InvalidParam.WithMsg("remark 超 255 字符")
}
row := &entity.SystemConfig{CfgKey: key, CfgValue: value, Remark: remark, UpdatedBy: updatedBy}
if err := s.db.WithContext(ctx).Clauses(clause.OnConflict{
Columns: []clause.Column{{Name: "cfg_key"}},
DoUpdates: clause.AssignmentColumns([]string{"cfg_value", "remark", "updated_by", "updated_at"}),
}).Create(row).Error; err != nil {
return nil, err
}
s.mu.Lock()
delete(s.cache, key)
s.mu.Unlock()
return row, nil
}
@@ -0,0 +1,95 @@
// service_test.go Issue#3 方案B:system_config 读写/缓存失效/UPSERT/校验。
package sysconfig
import (
"context"
"strings"
"testing"
"time"
"github.com/glebarez/sqlite"
"gorm.io/gorm"
"go-sms/internal/model/entity"
)
func newDB(t *testing.T) *gorm.DB {
t.Helper()
db, err := gorm.Open(sqlite.Open(":memory:"), &gorm.Config{})
if err != nil {
t.Fatal(err)
}
if err := db.Migrator().CreateTable(&entity.SystemConfig{}); err != nil {
t.Fatal(err)
}
return db
}
// TestGet_MissingKeyIsEmpty 缺行=空串(=不校验语义),不报错。
func TestGet_MissingKeyIsEmpty(t *testing.T) {
s := New(newDB(t), 0)
if v := s.Get(context.Background(), "no.such.key"); v != "" {
t.Fatalf("缺行应空串, got %q", v)
}
}
// TestSetUpsertAndCacheInvalidation Set 后 Get 立即读到新值(写即刻失效缓存,
// 不吃 30s TTL 窗口);同 key 二次 Set=更新不报错。
func TestSetUpsertAndCacheInvalidation(t *testing.T) {
db := newDB(t)
s := New(db, time.Minute) // 长 TTL:若失效逻辑缺失本测试必红
ctx := context.Background()
if _, err := s.Set(ctx, KeyDefaultExtCode, "10690", "系统默认接入码", "admin"); err != nil {
t.Fatal(err)
}
if v := s.Get(ctx, KeyDefaultExtCode); v != "10690" {
t.Fatalf("Get=%q", v)
}
// 覆盖更新(UPSERT):缓存里已有旧值,Set 后必须立即新值。
if _, err := s.Set(ctx, KeyDefaultExtCode, "1069033", "改", "admin2"); err != nil {
t.Fatal(err)
}
if v := s.Get(ctx, KeyDefaultExtCode); v != "1069033" {
t.Fatalf("Set 后缓存未失效: %q", v)
}
var rows []entity.SystemConfig
if err := db.Find(&rows).Error; err != nil || len(rows) != 1 {
t.Fatalf("UPSERT 应单行: rows=%d err=%v", len(rows), err)
}
if rows[0].UpdatedBy != "admin2" {
t.Fatalf("updated_by 应更新: %q", rows[0].UpdatedBy)
}
}
// TestListOrdered 全量 cfg_key 升序。
func TestListOrdered(t *testing.T) {
s := New(newDB(t), 0)
ctx := context.Background()
for _, k := range []string{"b.key", "a.key"} {
if _, err := s.Set(ctx, k, "v", "", "op"); err != nil {
t.Fatal(err)
}
}
rows, err := s.List(ctx)
if err != nil || len(rows) != 2 {
t.Fatalf("rows=%d err=%v", len(rows), err)
}
if rows[0].CfgKey != "a.key" {
t.Fatalf("应 cfg_key 升序: %s", rows[0].CfgKey)
}
}
// TestSetValidation 键空/超长、值超长拒绝。
func TestSetValidation(t *testing.T) {
s := New(newDB(t), 0)
ctx := context.Background()
if _, err := s.Set(ctx, " ", "v", "", "op"); err == nil {
t.Fatal("空键应拒绝")
}
if _, err := s.Set(ctx, strings.Repeat("k", 65), "v", "", "op"); err == nil {
t.Fatal("超长键应拒绝")
}
if _, err := s.Set(ctx, "k", strings.Repeat("v", 1025), "", "op"); err == nil {
t.Fatal("超长值应拒绝")
}
}
+3 -1
View File
@@ -1,6 +1,8 @@
# 当前工作上下文(最近更新:2026-11-16 晚)
## 当前状态快照(2026-11-16,**Issue#3 已修复入库,S4 泳道收官,一期 18/27 计划日**)
## 当前状态快照(2026-11-16,**Issue#3 三连修复+方案B 系统配置落地,S4 泳道收官,一期 18/27 计划日**)
- **Issue#3 方案B(2026-11-16 晚二)**:系统配置页(views/system 占位转正;system_config KV:GET/PUT /system/config)+ **SrcID 两级回退链**(账号 ext_code 优先→系统默认 cmpp.default_ext_code→均空放行;access.effectiveExtCode 三路径统一:直发/长短信/SMPP)。sysconfig 域新包(Get 30s 缓存/Set UPSERT+**写即刻失效缓存**);真机四态矩阵实证系统级接管+账号级优先;**生产值 cmpp.default_ext_code=10690331 已设**(未配置账号开箱即校验);uplink.blacklist.keywords 键现可页面管理(uplink 域 60s 自刷新照旧)。门禁 -race 42 包/vitest 165/build 全绿;gateway 已部署。
- **Issue#3 三连修复(2026-11-16 晚)**:①CMPP 连接报 -1 根因=`ConnectResp` 误按 **3.0 的 1B Status** 编码(标准 2.0 客户端按 4B 大端解析恒非 0)→ 修复=Marshal 4B(21B 包体)+AuthenticatorISMG 4B 参与 MD5+`ParseConnectResp` 自适应双布局(≥20B/2.0,17~19B/3.0);标准 2.0 探针真机实证 18B/垃圾值→21B/Status=0,**教训:2.0 与 3.0 在 CONNECT_RESP.Status/SUBMIT_RESP.Result 上互为镜像(2.0=4B/1B),自家 client+server 同源对称自测掩盖协议错位——同 Day39 坑**;②充值无响应=前端发 `{count}` 后端要 `{amount}`+submit 无 catch 静默吞错 → API/mock/组件三处修复;③SrcID 核验**用户裁定方案 C(前缀+动态扩展,行业惯例)**——s2demo 已配 ext_code=10690331(通道码即前缀),客户 SrcID 须以 10690331 开头+可追加扩展(≤21 位);真机四场景实证(纯码→10 过/码+扩展→10 过/不匹配→9/空→9);**运营口径:ext_code 变更后 30s 缓存生效(Day63 accCache)**。顺手修 TestClient_LoginOK 时序竞争(轮询吸收);门禁 -race 41 包/vitest 165/build 全绿;gateway 已串行部署(md5 比对 ✓)。
- **仓库**:main 已推 Gitea;每日 bundle+push 双轨。
+36
View File
@@ -0,0 +1,36 @@
import { get, put } from './request'
/** Issue#3 方案B:系统参数配置(system_config KV;admin)。 */
export interface SystemConfigRow {
id: number
cfg_key: string
cfg_value: string
remark: string
updated_by: string
updated_at: string
}
export interface SystemConfigSaveReq {
cfg_key: string
cfg_value: string
remark?: string
}
/** 已知键说明(表结构无白名单,新键=新能力;此处仅运营提示)。 */
export const KNOWN_CFG_KEYS: { key: string; label: string; hint: string }[] = [
{
key: 'cmpp.default_ext_code',
label: '系统默认接入码前缀',
hint: 'CMPP/SMPP 账号未配置扩展码(ext_code)时回退此值校验 SrcID 前缀;改后受理侧 ≤30s 生效',
},
{
key: 'uplink.blacklist.keywords',
label: '上行自动拉黑词表',
hint: '逗号分隔等值匹配(如 R,TD,退订,拒收);空=内置默认词表;改后 ≤60s 生效',
},
]
export const systemApi = {
list: () => get<{ list: SystemConfigRow[] }>('/system/config'),
update: (body: SystemConfigSaveReq) => put<SystemConfigRow>('/system/config', body),
}
+1 -1
View File
@@ -75,7 +75,7 @@ export const asyncRoutes: RouteRecordRaw[] = [
{ path: 'logs', name: 'logs', component: () => import('@/views/coming/ComingSoon.vue'), meta: { title: '日志报表', icon: 'Document', menu: true, group: '系统管理', roles: ['admin', 'ops', 'service'] } },
{ path: 'system', name: 'system', component: () => import('@/views/coming/ComingSoon.vue'), meta: { title: '系统配置', icon: 'Setting', menu: true, group: '系统管理', roles: ['admin'] } },
{ path: 'system', name: 'system', component: () => import('@/views/system/index.vue'), meta: { title: '系统配置', icon: 'Setting', menu: true, group: '系统管理', roles: ['admin'], subtitle: '系统级参数 KV · 默认接入码 · 拉黑词表' } },
{ path: 'faq', name: 'faq', component: () => import('@/views/coming/ComingSoon.vue'), meta: { title: '常见问题', icon: 'QuestionFilled', menu: true, group: '系统管理', roles: ['admin', 'ops', 'service', 'group', 'customer'] } },
// 隐藏页(不在菜单)
+2 -2
View File
@@ -47,7 +47,7 @@
<el-button link type="primary" :disabled="!apiCfg.cmpp_password" @click="copyText(apiCfg.cmpp_password, 'CMPP密码')">复制</el-button>
</el-descriptions-item>
<el-descriptions-item label="通道号(接入码)">
提交时 SrcID 自带(CMPP 2.0 协议定长 ≤21 位){{ apiCfg.ext_code ? `;须以 ${apiCfg.ext_code} 为前缀,不匹配拒收(Result=9)` : ';未配置扩展码,暂不校验前缀' }}
提交时 SrcID 自带(CMPP 2.0 协议定长 ≤21 位){{ apiCfg.ext_code ? `;须以 ${apiCfg.ext_code} 为前缀,不匹配拒收(Result=9)` : ';未配置时回退系统默认接入码(系统配置→cmpp.default_ext_code)' }}
</el-descriptions-item>
<el-descriptions-item label="最大连接数">
{{ apiCfg.cmpp_max_conns_effective }}{{ apiCfg.cmpp_max_conns ? '' : '(系统默认)' }}
@@ -269,7 +269,7 @@ function deliveryText(): string {
`连接端口:${c.cmpp_access?.port ?? '-'}`,
`企业ID:${acc.value?.username ?? '-'}`,
`CMPP密码:${c.cmpp_password}`,
`通道号(接入码):提交时 SrcID 自带(CMPP 2.0 定长 ≤21 位${c.ext_code ? `;须以 ${c.ext_code} 为前缀` : ''})`,
`通道号(接入码):提交时 SrcID 自带(CMPP 2.0 定长 ≤21 位${c.ext_code ? `;须以 ${c.ext_code} 为前缀` : ';未配置时回退系统默认接入码'})`,
`单链接速度:${c.cmpp_speed_effective} 条/秒`,
`最大连接数:${c.cmpp_max_conns_effective}`,
`协议版本:${c.cmpp_access?.version ?? 'CMPP 2.0'}`,
+130
View File
@@ -0,0 +1,130 @@
<template>
<section class="card sc-card" data-testid="system-config">
<div class="sc-head">
<span class="card-head-title">系统参数配置</span>
<el-button type="primary" size="small" data-testid="btn-cfg-new" @click="openNew">新增 / 编辑参数</el-button>
<el-button size="small" :loading="loading" @click="reload">刷新</el-button>
</div>
<el-alert v-for="k in KNOWN_CFG_KEYS" :key="k.key" class="sc-hint" type="info" :closable="false">
<template #title>
<span class="sc-hint-key">{{ k.key }}</span>({{ k.label }}):{{ k.hint }}
</template>
</el-alert>
<el-table v-loading="loading" :data="rows" data-testid="cfg-table">
<el-table-column prop="cfg_key" label="配置键" min-width="220">
<template #default="{ row }">
<span class="sc-key">{{ row.cfg_key }}</span>
</template>
</el-table-column>
<el-table-column prop="cfg_value" label="配置值" min-width="180" show-overflow-tooltip>
<template #default="{ row }">
<span class="sc-val">{{ row.cfg_value === '' ? '(空)' : row.cfg_value }}</span>
</template>
</el-table-column>
<el-table-column prop="remark" label="备注" min-width="160" show-overflow-tooltip />
<el-table-column prop="updated_by" label="操作人" width="110" />
<el-table-column prop="updated_at" label="更新时间" width="170" />
<el-table-column label="操作" width="90" fixed="right">
<template #default="{ row }">
<el-button link type="primary" @click="openEdit(row)">编辑</el-button>
</template>
</el-table-column>
<template #empty>
<el-empty description="暂无配置——点「新增 / 编辑参数」配置系统默认接入码等参数" />
</template>
</el-table>
<el-dialog v-model="dlg" :title="editing ? '编辑参数' : '新增参数'" width="520px">
<el-form label-width="90px">
<el-form-item label="配置键">
<el-select v-model="form.cfg_key" filterable allow-create default-first-option
:disabled="editing" placeholder="选择已知键或输入新键" style="width: 100%" data-testid="cfg-key">
<el-option v-for="k in KNOWN_CFG_KEYS" :key="k.key" :value="k.key" :label="`${k.key}(${k.label})`" />
</el-select>
</el-form-item>
<el-form-item label="配置值">
<el-input v-model="form.cfg_value" type="textarea" :rows="2" maxlength="1024" show-word-limit
placeholder="空值=清除语义(如拉黑词表回默认)" data-testid="cfg-value" />
</el-form-item>
<el-form-item label="备注">
<el-input v-model="form.remark" maxlength="255" placeholder="变更说明(留痕)" />
</el-form-item>
</el-form>
<template #footer>
<el-button @click="dlg = false">取消</el-button>
<el-button type="primary" :loading="saving" data-testid="btn-cfg-save" @click="save">保存</el-button>
</template>
</el-dialog>
</section>
</template>
<script setup lang="ts">
// Issue#3 方案B:系统配置页(keep-alive 缓存锚点——组件名必须=路由 name)。
defineOptions({ name: 'system' })
import { onMounted, ref } from 'vue'
import { ElMessage } from 'element-plus'
import { KNOWN_CFG_KEYS, systemApi, type SystemConfigRow } from '@/api/system'
const rows = ref<SystemConfigRow[]>([])
const loading = ref(false)
const dlg = ref(false)
const saving = ref(false)
const editing = ref(false)
const form = ref({ cfg_key: '', cfg_value: '', remark: '' })
async function reload() {
loading.value = true
try {
const data = await systemApi.list()
rows.value = data.list
} catch (e) {
ElMessage.error(e instanceof Error ? `加载失败:${e.message}` : '加载失败')
} finally {
loading.value = false
}
}
onMounted(reload)
function openNew() {
editing.value = false
form.value = { cfg_key: '', cfg_value: '', remark: '' }
dlg.value = true
}
function openEdit(row: SystemConfigRow) {
editing.value = true
form.value = { cfg_key: row.cfg_key, cfg_value: row.cfg_value, remark: row.remark }
dlg.value = true
}
async function save() {
if (!form.value.cfg_key.trim()) {
ElMessage.warning('配置键不能为空')
return
}
saving.value = true
try {
await systemApi.update({ ...form.value, cfg_key: form.value.cfg_key.trim() })
ElMessage.success('已保存(写即刻生效,读侧按各消费域刷新周期生效)')
dlg.value = false
await reload()
} catch (e) {
ElMessage.error(e instanceof Error ? `保存失败:${e.message}` : '保存失败')
} finally {
saving.value = false
}
}
</script>
<style scoped>
.sc-card { padding: 16px 18px 14px; }
.sc-head { display: flex; align-items: center; gap: 8px; margin-bottom: 10px; flex-wrap: wrap; }
.card-head-title { font-size: var(--gosms-fs-md); font-weight: 600; color: var(--gosms-text-bright); margin-right: 8px; }
.sc-hint { margin-bottom: 8px; }
.sc-hint-key { font-family: monospace; }
.sc-key { font-family: monospace; }
.sc-val { font-family: monospace; }
</style>