break
62419d4b17
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 13m40s
统一时间筛选：新增共享严格解析器 pkg/utils/time_range.go，只接受带显式时区的 RFC3339 秒级时间（拒绝小数秒、无时区、date-only、空格分隔、±hhmm、未补零、非法日期与越界偏移），闭区间含两端、归一为 UTC 瞬时，创建期与执行期共用同一份实现。 端点改造（13 个入口）：IoT 卡导入任务、设备导入任务、导出任务列表、订单列表参数名不变仅收紧解析；换货、分配记录、代理充值、临期列表改名 start_time/end_time（旧参数名显式拒绝）；提现记录两处删除解析失败静默跳过，非法参数一律 1001；授权记录由起始闭结束开改为闭区间含两端；临期列表改按当前生效主套餐最终到期时刻比较，保留剩余天数上下限与既有粗放窗口。 临期导出新建：新场景 expiring_asset 与受控入口 POST /api/admin/expiring-assets/export，复用列表候选预筛与最终到期推算，一行一资产、加油包不单独成行，列序与 111 §18.1 逐列一致，店铺/业务员/用户组按执行时当前归属补充且不超出创建时冻结范围。 佣金明细导出新增按创建时间闭区间筛选（原佣金与回溯两条分支各自创建时间列），记录粒度、列定义与余额口径不变。 冻结与遗留任务：创建期把筛选与时间边界规范化为 UTC RFC3339 秒级串写入既有 query_json，无新列无迁移；执行期只按冻结值严格解析，非法冻结值在任何分片与文件动作前落任务失败并写安全摘要，不放行全量；重试沿用原快照。达量预警导出执行期同样纳入严格解析（其入口契约、列定义与触发快照口径不变）。 归档 add-export-time-filter-standards 并新建主 Spec openspec/specs/export-time-filter/spec.md，同步 requirement-evidence.json 与入口能力矩阵，README 导出场景清单更新为 11 个场景。 验证：junhong_cmp_test + 本地隔离 Redis（DB7，测试部署共享队列 DB6 未被占用）实跑 85 PASS / 0 FAIL（接受/拒绝集合、区间与顺序语义、列表与导出同筛选行集一致、代理 HTTP 全链路与范围冻结、遗留旧格式任务安全失败、列与余额口径回归、表头逐字），门禁 gofmt/go build/gendocs 两次一致/openspec validate/doctor/context-health 全绿；无 Schema 变更、无迁移、无运行时开关。
219 lines
18 KiB
Go
219 lines
18 KiB
Go
package dto
|
||
|
||
import "time"
|
||
|
||
type ListStandaloneIotCardRequest struct {
|
||
Page int `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"`
|
||
Status *int `json:"status" query:"status" validate:"omitempty,min=1,max=4" minimum:"1" maximum:"4" description:"状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)"`
|
||
CarrierID *uint `json:"carrier_id" query:"carrier_id" description:"运营商ID"`
|
||
ShopID *uint `json:"shop_id" query:"shop_id" description:"分销商ID（兼容旧参数，单选）"`
|
||
ShopIDs []uint `json:"shop_ids" query:"shop_ids" validate:"omitempty,dive,min=1" description:"分销商ID列表（多选）"`
|
||
SeriesID *uint `json:"series_id" query:"series_id" description:"套餐系列ID"`
|
||
ICCID string `json:"iccid" query:"iccid" validate:"omitempty,max=20" maxLength:"20" description:"ICCID(模糊查询)"`
|
||
VirtualNo string `json:"virtual_no" query:"virtual_no" validate:"omitempty,max=100" maxLength:"100" description:"卡虚拟号(模糊查询)"`
|
||
MSISDN string `json:"msisdn" query:"msisdn" validate:"omitempty,max=20" maxLength:"20" description:"卡接入号(模糊查询)"`
|
||
IsStandalone *bool `json:"is_standalone" query:"is_standalone" description:"是否为独立卡(true:仅返回未绑定设备的卡, false:仅返回已绑定设备的卡, 不传:返回全部)"`
|
||
BatchNo string `json:"batch_no" query:"batch_no" validate:"omitempty,max=100" maxLength:"100" description:"批次号"`
|
||
PackageID *uint `json:"package_id" query:"package_id" description:"套餐ID"`
|
||
IsDistributed *bool `json:"is_distributed" query:"is_distributed" description:"是否已分销 (true:已分销, false:未分销)"`
|
||
IsReplaced *bool `json:"is_replaced" query:"is_replaced" description:"是否有换卡记录 (true:有换卡记录, false:无换卡记录)"`
|
||
HasActivePackage *bool `json:"has_active_package" query:"has_active_package" description:"是否有生效中的套餐 (true:有生效中套餐, false:无生效中套餐, 不传:不过滤)"`
|
||
ICCIDStart string `json:"iccid_start" query:"iccid_start" validate:"omitempty,max=20" maxLength:"20" description:"ICCID起始号"`
|
||
ICCIDEnd string `json:"iccid_end" query:"iccid_end" validate:"omitempty,max=20" maxLength:"20" description:"ICCID结束号"`
|
||
CarrierName string `json:"carrier_name" query:"carrier_name" validate:"omitempty,max=100" maxLength:"100" description:"运营商名称(模糊查询)"`
|
||
Keyword string `json:"keyword" query:"keyword" validate:"omitempty,max=100" maxLength:"100" description:"关键字搜索，匹配ICCID或卡虚拟号(模糊查询，与iccid/virtual_no独立)"`
|
||
NetworkStatus *int `json:"network_status" query:"network_status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"网络状态 (0:停机, 1:开机)"`
|
||
RealNameStatus *int `json:"real_name_status" query:"real_name_status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"实名状态 (0:未实名, 1:已实名)"`
|
||
AuthorizedEnterpriseID *uint `json:"authorized_enterprise_id" query:"authorized_enterprise_id" description:"按有效授权企业ID过滤（只返回当前授权给该企业的卡）"`
|
||
IsAuthorizedToEnterprise *bool `json:"is_authorized_to_enterprise" query:"is_authorized_to_enterprise" description:"企业授权状态过滤 (true:已授权给某企业, false:未授权任何企业)"`
|
||
}
|
||
|
||
type StandaloneIotCardResponse struct {
|
||
PackageExpiryEstimate
|
||
ID uint `json:"id" description:"卡ID"`
|
||
ICCID string `json:"iccid" description:"ICCID"`
|
||
VirtualNo string `json:"virtual_no" description:"卡虚拟号（用于客服查找资产）"`
|
||
CardCategory string `json:"card_category" description:"卡业务类型 (normal:普通卡, industry:行业卡)"`
|
||
CarrierID uint `json:"carrier_id" description:"运营商ID"`
|
||
CarrierType string `json:"carrier_type" description:"运营商类型 (CMCC:中国移动, CUCC:中国联通, CTCC:中国电信, CBN:中国广电)"`
|
||
CarrierName string `json:"carrier_name" description:"运营商名称"`
|
||
IMSI string `json:"imsi" description:"IMSI"`
|
||
MSISDN string `json:"msisdn" description:"卡接入号"`
|
||
BatchNo string `json:"batch_no" description:"批次号"`
|
||
Supplier string `json:"supplier" description:"供应商"`
|
||
Status int `json:"status" description:"状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)"`
|
||
StatusName string `json:"status_name" description:"状态名称（中文）"`
|
||
ShopID *uint `json:"shop_id" description:"店铺ID"`
|
||
ShopName string `json:"shop_name" description:"店铺名称"`
|
||
ActivatedAt *time.Time `json:"activated_at" description:"激活时间"`
|
||
ActivationStatus int `json:"activation_status" description:"激活状态 (0:未激活, 1:已激活)"`
|
||
ActivationStatusName string `json:"activation_status_name" description:"激活状态名称（中文）"`
|
||
RealNameStatus int `json:"real_name_status" description:"实名状态 (0:未实名, 1:已实名)"`
|
||
RealNameStatusName string `json:"real_name_status_name" description:"实名状态名称（中文）"`
|
||
NetworkStatus int `json:"network_status" description:"网络状态 (0:停机, 1:开机)"`
|
||
NetworkStatusName string `json:"network_status_name" description:"网络状态名称（中文）"`
|
||
GatewayExtend string `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
|
||
GatewayCardIMEI string `json:"gateway_card_imei" description:"插拔卡业务 IMEI（由 Gateway 卡状态接口同步，非设备自身 IMEI，无业务含义，仅供查看）"`
|
||
DataUsageMB int64 `json:"data_usage_mb" description:"累计流量使用(MB)"`
|
||
CurrentMonthUsageMB float64 `json:"current_month_usage_mb" description:"系统自然月累计流量(MB，不等于运营商周期口径)"`
|
||
LastGatewayReadingMB float64 `json:"last_gateway_reading_mb" description:"运营商当前周期累计流量读数(MB，展示运营商口径时使用)"`
|
||
CurrentMonthStartDate *time.Time `json:"current_month_start_date" description:"本月开始日期"`
|
||
LastMonthTotalMB float64 `json:"last_month_total_mb" description:"上月流量总量(MB)"`
|
||
LastDataCheckAt *time.Time `json:"last_data_check_at" description:"最后流量检查时间"`
|
||
LastRealNameCheckAt *time.Time `json:"last_real_name_check_at" description:"最后实名检查时间"`
|
||
EnablePolling bool `json:"enable_polling" description:"是否参与轮询"`
|
||
SeriesID *uint `json:"series_id" description:"套餐系列ID"`
|
||
SeriesName string `json:"series_name" description:"套餐系列名称"`
|
||
DeviceVirtualNo string `json:"device_virtual_no" description:"绑定设备的虚拟号（未绑定时为空字符串）"`
|
||
RealnamePolicy string `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
|
||
// asset_status=3 表示该资产已换货且尚未执行"旧资产转新"，不再流通
|
||
// generation>1 表示该资产历史上曾执行过换货后转新，目前仍在使用
|
||
AssetStatus int `json:"asset_status" description:"业务状态 (1:在库, 2:已销售, 3:已换货, 4:已停用)"`
|
||
AssetStatusName string `json:"asset_status_name" description:"业务状态名称（中文）"`
|
||
Generation int `json:"generation" description:"资产世代编号（初始值1，每次换货转新后+1）"`
|
||
AuthorizedEnterpriseID *uint `json:"authorized_enterprise_id" description:"当前有效授权的企业ID，未授权时为 null"`
|
||
AuthorizedEnterpriseName string `json:"authorized_enterprise_name" description:"当前有效授权的企业名称，未授权时为空字符串"`
|
||
AssociatedPhones []string `json:"associated_phones" description:"当前关联手机号列表（按资产数据范围返回完整手机号，无关联时为空数组）"`
|
||
CreatedAt time.Time `json:"created_at" description:"创建时间"`
|
||
UpdatedAt time.Time `json:"updated_at" description:"更新时间"`
|
||
}
|
||
|
||
type ListStandaloneIotCardResponse struct {
|
||
List []*StandaloneIotCardResponse `json:"items" description:"单卡列表"`
|
||
Total int64 `json:"total" description:"总数"`
|
||
Page int `json:"page" description:"当前页码"`
|
||
PageSize int `json:"size" description:"每页数量"`
|
||
}
|
||
|
||
type ImportIotCardRequest struct {
|
||
CarrierID uint `json:"carrier_id" validate:"required,min=1" required:"true" minimum:"1" description:"运营商ID"`
|
||
BatchNo string `json:"batch_no" validate:"omitempty,max=100" maxLength:"100" description:"批次号"`
|
||
FileKey string `json:"file_key" validate:"required,min=1,max=500" required:"true" minLength:"1" maxLength:"500" description:"对象存储文件路径（通过 /storage/upload-url 获取）"`
|
||
CardCategory string `json:"card_category" validate:"omitempty,oneof=normal industry" description:"卡业务类型 (normal:普通卡, industry:行业卡)，默认 normal"`
|
||
RealnamePolicy string `json:"realname_policy" validate:"omitempty,oneof=none before_order after_order" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)，默认 after_order"`
|
||
}
|
||
|
||
type ImportIotCardResponse struct {
|
||
TaskID uint `json:"task_id" description:"导入任务ID"`
|
||
TaskNo string `json:"task_no" description:"任务编号"`
|
||
Message string `json:"message" description:"提示信息"`
|
||
}
|
||
|
||
type ListImportTaskRequest struct {
|
||
Page int `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"`
|
||
Status *int `json:"status" query:"status" validate:"omitempty,min=1,max=4" minimum:"1" maximum:"4" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:失败)"`
|
||
CarrierID *uint `json:"carrier_id" query:"carrier_id" description:"运营商ID"`
|
||
BatchNo string `json:"batch_no" query:"batch_no" validate:"omitempty,max=100" maxLength:"100" description:"批次号(模糊查询)"`
|
||
StartTime string `json:"start_time" query:"start_time" description:"创建时间起始（带时区的 RFC3339 秒级时间，闭区间含该时刻，如 2026-09-01T00:00:00+08:00）"`
|
||
EndTime string `json:"end_time" query:"end_time" description:"创建时间结束（带时区的 RFC3339 秒级时间，闭区间含该时刻，如 2026-09-30T23:59:59+08:00）"`
|
||
}
|
||
|
||
type ImportTaskResponse struct {
|
||
ID uint `json:"id" description:"任务ID"`
|
||
TaskNo string `json:"task_no" description:"任务编号"`
|
||
Status int `json:"status" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:失败)"`
|
||
StatusText string `json:"status_text" description:"任务状态文本"`
|
||
CarrierID uint `json:"carrier_id" description:"运营商ID"`
|
||
CarrierType string `json:"carrier_type,omitempty" description:"运营商类型 (CMCC:中国移动, CUCC:中国联通, CTCC:中国电信, CBN:中国广电)"`
|
||
CarrierName string `json:"carrier_name,omitempty" description:"运营商名称"`
|
||
BatchNo string `json:"batch_no,omitempty" description:"批次号"`
|
||
CardCategory string `json:"card_category" description:"卡业务类型 (normal:普通卡, industry:行业卡)"`
|
||
RealnamePolicy string `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
|
||
FileName string `json:"file_name,omitempty" description:"文件名"`
|
||
TotalCount int `json:"total_count" description:"总数"`
|
||
SuccessCount int `json:"success_count" description:"成功数"`
|
||
SkipCount int `json:"skip_count" description:"跳过数"`
|
||
FailCount int `json:"fail_count" description:"失败数"`
|
||
StartedAt *time.Time `json:"started_at,omitempty" description:"开始处理时间"`
|
||
CompletedAt *time.Time `json:"completed_at,omitempty" description:"完成时间"`
|
||
ErrorMessage string `json:"error_message,omitempty" description:"错误信息"`
|
||
CreatorName string `json:"creator_name" description:"操作人姓名"`
|
||
CreatedAt time.Time `json:"created_at" description:"创建时间"`
|
||
}
|
||
|
||
type ListImportTaskResponse struct {
|
||
List []*ImportTaskResponse `json:"items" description:"任务列表"`
|
||
Total int64 `json:"total" description:"总数"`
|
||
Page int `json:"page" description:"当前页码"`
|
||
PageSize int `json:"size" description:"每页数量"`
|
||
}
|
||
|
||
type ImportResultItemDTO struct {
|
||
Line int `json:"line" description:"行号"`
|
||
ICCID string `json:"iccid" description:"ICCID"`
|
||
MSISDN string `json:"msisdn,omitempty" description:"接入号"`
|
||
Reason string `json:"reason" description:"原因"`
|
||
}
|
||
|
||
type ImportTaskDetailResponse struct {
|
||
ImportTaskResponse
|
||
SkippedItems []*ImportResultItemDTO `json:"skipped_items" description:"跳过记录详情"`
|
||
FailedItems []*ImportResultItemDTO `json:"failed_items" description:"失败记录详情"`
|
||
}
|
||
|
||
type GetImportTaskRequest struct {
|
||
ID uint `path:"id" description:"任务ID" required:"true"`
|
||
}
|
||
|
||
type GetIotCardByICCIDRequest struct {
|
||
ICCID string `path:"iccid" description:"ICCID" required:"true"`
|
||
}
|
||
|
||
// SetIotCardSpeedTierRequest 设置 IoT 卡固定限速档位请求。
|
||
type SetIotCardSpeedTierRequest struct {
|
||
ICCID string `path:"iccid" description:"IoT 卡 ICCID" required:"true"`
|
||
Code *int `json:"code" validate:"required,oneof=-1 0 1 2 3 4 5 6 7 8" required:"true" enum:"-1,0,1,2,3,4,5,6,7,8" description:"固定限速档位 (-1:恢复不限速, 0:0kbps, 1:128Kbps, 2:512Kbps, 3:1Mbps, 4:2Mbps, 5:10Mbps, 6:20Mbps, 7:50Mbps, 8:100Mbps)"`
|
||
}
|
||
|
||
// SetIotCardSpeedTierResponse 设置 IoT 卡固定限速档位响应。
|
||
type SetIotCardSpeedTierResponse struct {
|
||
IotCardID uint `json:"iot_card_id" description:"IoT 卡ID"`
|
||
ICCID string `json:"iccid" description:"实际调用 Gateway 的卡 ICCID"`
|
||
Code int `json:"code" description:"固定限速档位编码 (-1:恢复不限速, 0:0kbps, 1:128Kbps, 2:512Kbps, 3:1Mbps, 4:2Mbps, 5:10Mbps, 6:20Mbps, 7:50Mbps, 8:100Mbps)"`
|
||
SpeedTierName string `json:"speed_tier_name" description:"固定限速档位名称（中文）"`
|
||
IntegrationID string `json:"integration_id" description:"Gateway 外部交互记录ID"`
|
||
}
|
||
|
||
type IotCardDetailResponse struct {
|
||
StandaloneIotCardResponse
|
||
}
|
||
|
||
// BatchSetCardSeriesBindngRequest 批量设置卡的套餐系列绑定请求
|
||
type BatchSetCardSeriesBindngRequest struct {
|
||
SelectionType string `json:"selection_type" validate:"omitempty,oneof=list range filter" enum:"list,range,filter" description:"选卡方式 (list:ICCID列表, range:号段范围, filter:筛选条件；不传时兼容旧版ICCID列表)"`
|
||
ICCIDs []string `json:"iccids" validate:"omitempty,max=1000,dive,required,max=20" maxItems:"1000" description:"ICCID列表（selection_type=list时使用，最多1000个）"`
|
||
ICCIDStart string `json:"iccid_start" validate:"omitempty,max=20" maxLength:"20" description:"起始ICCID（selection_type=range时使用）"`
|
||
ICCIDEnd string `json:"iccid_end" validate:"omitempty,max=20" maxLength:"20" description:"结束ICCID（selection_type=range时使用）"`
|
||
|
||
Status *int `json:"status" validate:"omitempty,min=1,max=4" minimum:"1" maximum:"4" description:"状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)（selection_type=filter时可选）"`
|
||
CarrierID *uint `json:"carrier_id" description:"运营商ID（selection_type=filter时可选）"`
|
||
ShopID *uint `json:"shop_id" description:"分销商ID（selection_type=filter时可选，兼容旧参数，单选）"`
|
||
ShopIDs []uint `json:"shop_ids" validate:"omitempty,dive,min=1" description:"分销商ID列表（selection_type=filter时可选，多选）"`
|
||
FilterSeriesID *uint `json:"filter_series_id" description:"当前绑定套餐系列ID（selection_type=filter时可选；目标套餐系列仍使用series_id）"`
|
||
ICCID string `json:"iccid" validate:"omitempty,max=20" maxLength:"20" description:"ICCID模糊查询（selection_type=filter时可选）"`
|
||
MSISDN string `json:"msisdn" validate:"omitempty,max=20" maxLength:"20" description:"卡接入号模糊查询（selection_type=filter时可选）"`
|
||
IsStandalone *bool `json:"is_standalone" description:"是否为独立卡（selection_type=filter时可选）"`
|
||
BatchNo string `json:"batch_no" validate:"omitempty,max=100" maxLength:"100" description:"批次号（selection_type=filter时可选）"`
|
||
PackageID *uint `json:"package_id" description:"套餐ID（selection_type=filter时可选）"`
|
||
IsDistributed *bool `json:"is_distributed" description:"是否已分销（selection_type=filter时可选）"`
|
||
IsReplaced *bool `json:"is_replaced" description:"是否有换卡记录（selection_type=filter时可选）"`
|
||
CarrierName string `json:"carrier_name" validate:"omitempty,max=100" maxLength:"100" description:"运营商名称模糊查询（selection_type=filter时可选）"`
|
||
|
||
SeriesID uint `json:"series_id" validate:"required,min=0" required:"true" minimum:"0" description:"目标套餐系列ID（0表示清除关联）"`
|
||
}
|
||
|
||
// CardSeriesBindngFailedItem 卡系列绑定失败项
|
||
type CardSeriesBindngFailedItem struct {
|
||
ICCID string `json:"iccid" description:"ICCID"`
|
||
Reason string `json:"reason" description:"失败原因"`
|
||
}
|
||
|
||
// BatchSetCardSeriesBindngResponse 批量设置卡的套餐系列绑定响应
|
||
type BatchSetCardSeriesBindngResponse struct {
|
||
SuccessCount int `json:"success_count" description:"成功数量"`
|
||
FailCount int `json:"fail_count" description:"失败数量"`
|
||
FailedItems []CardSeriesBindngFailedItem `json:"failed_items" description:"失败详情列表"`
|
||
}
|