sync: 同步 v1.0.4 开源代码并脱敏

api/common/v1/common.go

@@ -27,8 +27,11 @@ type BatchSimSubscribeReq struct {
 	Remark    string                  `json:"remark,omitempty"`
 }
 
+// RenewReq 历史批量续费兼容入口，与 /batch-sim-subscribe 共用 SubmitRenew 实现。
+// 说明：g.Meta 的 deprecated 标签在 GoFrame v2.9.6 中不被解析，无任何运行时或文档生成效果，
+// 不能替代对外废弃告知；对外说明见 openapi-docs「标准入口与兼容入口」一节。
 type RenewReq struct {
-	g.Meta `path:"/renew" method:"POST" tags:"V3 Common API" summary:"Renewal compatibility endpoint"`
+	g.Meta `path:"/renew" method:"POST" tags:"V3 Compatibility API" summary:"Deprecated compatibility endpoint; use /change/batch-sim-subscribe"`
 	model.CommonRenewParam
 }
 
@@ -51,7 +54,11 @@ type BatchSimTrafficCutoffReq struct {
 	model.CommonTrafficCutoffConfigParam
 }
 
+// TrafficCutoffConfigReq 历史批量达量断网变更入口，已决定下线：不登记资源、不授权，
+// 调用返回 10014。与 /batch-sim-traffic-cutoff 的参数类型与实现完全相同，客户应改用标准入口。
+// 路由与结构体保留以便可逆恢复（取消登记 SQL 文末注释即可），故不删除代码。
+// 说明：deprecated 标签在 GoFrame v2.9.6 中不被解析，无运行时效果。
 type TrafficCutoffConfigReq struct {
-	g.Meta `path:"/traffic-cutoff-config" method:"POST" tags:"V3 Common API" summary:"Batch traffic cutoff compatibility endpoint"`
+	g.Meta `path:"/traffic-cutoff-config" method:"POST" tags:"V3 Compatibility API" summary:"Deprecated write endpoint; use /change/batch-sim-traffic-cutoff"`
 	model.CommonTrafficCutoffConfigParam
 }