package dto

// AuditEventListRequest 是平台审计事件列表的组合筛选参数。
type AuditEventListRequest struct {
	CreatedFrom   string `json:"created_from" query:"created_from" description:"开始时间，RFC3339且含时区" example:"2026-08-01T00:00:00+08:00"`
	CreatedTo     string `json:"created_to" query:"created_to" description:"结束时间，RFC3339且含时区，不包含该时刻" example:"2026-08-08T00:00:00+08:00"`
	Action        string `json:"action" query:"action" description:"稳定动作编码；直接使用事件响应的action_code，不按中文名称猜测"`
	Category      string `json:"category" query:"category" enum:"configuration,reliability,asset,security,identity,business" description:"动作类别 (configuration:配置, reliability:可靠性, asset:资产, security:安全, identity:身份, business:业务)"`
	ActorKind     string `json:"actor_kind" query:"actor_kind" enum:"account,personal_customer,openapi,system_task,scheduled_job,external_system" description:"操作者类型 (account:人工账号, personal_customer:个人客户, openapi:开放接口账号, system_task:系统任务, scheduled_job:计划任务, external_system:外部系统)"`
	ActorID       string `json:"actor_id" query:"actor_id" description:"操作者稳定ID"`
	Source        string `json:"source" query:"source" enum:"admin_api,personal_api,openapi,worker,scheduler,callback" description:"操作入口来源 (admin_api:后台管理API, personal_api:个人客户API, openapi:代理OpenAPI, worker:异步Worker, scheduler:计划任务, callback:外部系统回调)"`
	Result        string `json:"result" query:"result" enum:"success,failed,denied,partial,unknown" description:"结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
	Risk          string `json:"risk" query:"risk" enum:"low,normal,high,critical" description:"风险等级 (low:低, normal:普通, high:高, critical:严重)"`
	ScopeType     string `json:"scope_type" query:"scope_type" enum:"platform,shop,personal_customer" description:"业务范围类型 (platform:平台, shop:店铺, personal_customer:个人客户)"`
	ScopeID       string `json:"scope_id" query:"scope_id" description:"业务范围稳定ID"`
	ResourceType  string `json:"resource_type" query:"resource_type" description:"Resource Registry 注册类型"`
	ResourceID    string `json:"resource_id" query:"resource_id" description:"资源内部稳定ID"`
	ResourceKey   string `json:"resource_key" query:"resource_key" description:"资源业务稳定Key"`
	RequestID     string `json:"request_id" query:"request_id" description:"HTTP请求关联ID"`
	CorrelationID string `json:"correlation_id" query:"correlation_id" description:"跨步骤业务链路ID"`
	Page          int    `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize      int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// AuditEventIDParams 是审计事件详情路径参数。
type AuditEventIDParams struct {
	EventID string `json:"event_id" path:"event_id" required:"true" description:"稳定审计事件ID"`
}

// AuditActorEventsRequest 是操作者行为时间线参数。
type AuditActorEventsRequest struct {
	Kind         string `json:"kind" path:"kind" required:"true" enum:"account,personal_customer,openapi,system_task,scheduled_job,external_system" description:"操作者类型 (account:人工账号, personal_customer:个人客户, openapi:开放接口账号, system_task:系统任务, scheduled_job:计划任务, external_system:外部系统)"`
	ID           string `json:"id" path:"id" required:"true" description:"操作者稳定ID"`
	Action       string `json:"action" query:"action" description:"稳定动作编码；直接使用事件响应的action_code"`
	Result       string `json:"result" query:"result" enum:"success,failed,denied,partial,unknown" description:"事件结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
	Risk         string `json:"risk" query:"risk" enum:"low,normal,high,critical" description:"风险等级 (low:低, normal:普通, high:高, critical:严重)"`
	ResourceType string `json:"resource_type" query:"resource_type" description:"Resource Registry注册类型；直接使用事件resources或investigation_refs返回的resource_type"`
	ResourceID   string `json:"resource_id" query:"resource_id" description:"资源内部稳定ID"`
	CreatedFrom  string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）"`
	CreatedTo    string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）"`
	Page         int    `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// AuditResourceSearchRequest 是首批注册资源的精确搜索参数。
type AuditResourceSearchRequest struct {
	ResourceType string `json:"resource_type" query:"resource_type" required:"true" enum:"iot_card,device,shop,order,refund" description:"资源类型 (iot_card:IoT卡, device:设备, shop:店铺, order:订单, refund:退款单)"`
	Keyword      string `json:"keyword" query:"keyword" required:"true" description:"精确业务标识；卡支持ICCID/VirtualNo，设备支持VirtualNo/IMEI/SN"`
	Page         int    `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// AuditResourceTimelineRequest 是通用资源时间线参数。
type AuditResourceTimelineRequest struct {
	ResourceType string `json:"resource_type" path:"resource_type" required:"true" description:"Resource Registry 注册类型"`
	ResourceID   string `json:"resource_id" path:"resource_id" required:"true" description:"资源内部稳定ID"`
	CreatedFrom  string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）"`
	CreatedTo    string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）"`
	Action       string `json:"action" query:"action" description:"稳定动作编码；直接使用事件响应的action_code"`
	Result       string `json:"result" query:"result" enum:"success,failed,denied,partial,unknown" description:"事件结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
	Page         int    `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// AuditRequestTimelineParams 是请求链路时间线的路径参数。
type AuditRequestTimelineParams struct {
	RequestID string `json:"request_id" path:"request_id" required:"true" description:"HTTP请求关联ID，来自审计或外部集成节点，也可从Access Log粘贴"`
}

// AuditCorrelationTimelineParams 是业务关联时间线的路径参数。
type AuditCorrelationTimelineParams struct {
	CorrelationID string `json:"correlation_id" path:"correlation_id" required:"true" description:"跨请求、异步任务和外部交互的稳定业务链路ID"`
}

// AuditFinanceTimelineRequest 是资金调查时间线的稳定业务筛选参数。
type AuditFinanceTimelineRequest struct {
	ShopID             uint   `json:"shop_id" query:"shop_id" description:"店铺ID"`
	WalletID           uint   `json:"wallet_id" query:"wallet_id" description:"代理或资产钱包ID"`
	OrderID            uint   `json:"order_id" query:"order_id" description:"订单ID"`
	OrderNo            string `json:"order_no" query:"order_no" description:"订单编号"`
	PaymentID          uint   `json:"payment_id" query:"payment_id" description:"支付记录ID"`
	PaymentNo          string `json:"payment_no" query:"payment_no" description:"支付单号"`
	RefundID           uint   `json:"refund_id" query:"refund_id" description:"退款单ID"`
	RefundNo           string `json:"refund_no" query:"refund_no" description:"退款单号"`
	RechargeID         uint   `json:"recharge_id" query:"recharge_id" description:"代理充值或个人资产充值ID"`
	RechargeNo         string `json:"recharge_no" query:"recharge_no" description:"充值单号"`
	ApprovalInstanceID uint   `json:"approval_instance_id" query:"approval_instance_id" description:"审批实例ID"`
	ThirdPartyTradeNo  string `json:"third_party_trade_no" query:"third_party_trade_no" description:"第三方交易号"`
	ActorKind          string `json:"actor_kind" query:"actor_kind" enum:"account,personal_customer,openapi,system_task,scheduled_job,external_system" description:"操作者类型；与actor_id同时提供 (account:人工账号, personal_customer:个人客户, openapi:开放接口账号, system_task:系统任务, scheduled_job:计划任务, external_system:外部系统)"`
	ActorID            string `json:"actor_id" query:"actor_id" description:"操作者稳定ID；与actor_kind同时提供"`
	CorrelationID      string `json:"correlation_id" query:"correlation_id" description:"跨步骤业务链路ID"`
	CreatedFrom        string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）"`
	CreatedTo          string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）"`
	Page               int    `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize           int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// AuditRiskFilterRequest 是风险总览和明细共用的受控筛选参数。
type AuditRiskFilterRequest struct {
	CreatedFrom string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）；默认从在线窗口开始"`
	CreatedTo   string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻，最长31天）；默认当前时间"`
	Risk        string `json:"risk" query:"risk" enum:"low,normal,high,critical" description:"风险等级 (low:低, normal:普通, high:高, critical:严重)"`
	Result      string `json:"result" query:"result" enum:"success,failed,denied,partial,unknown" description:"结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
	Action      string `json:"action" query:"action" description:"稳定动作编码；直接使用事件响应的action_code"`
	Source      string `json:"source" query:"source" enum:"admin_api,personal_api,openapi,worker,scheduler,callback" description:"来源 (admin_api:后台管理API, personal_api:个人客户API, openapi:代理OpenAPI, worker:异步Worker, scheduler:计划任务, callback:外部系统回调)"`
}

// AuditRiskOverviewRequest 是风险总览请求参数。
type AuditRiskOverviewRequest struct {
	AuditRiskFilterRequest
}

// AuditRiskEventsRequest 是风险事件明细请求参数。
type AuditRiskEventsRequest struct {
	AuditRiskFilterRequest
	Page     int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// SubjectResourceActivityRequest 是代理安全资源活动的路径及分页参数。
type SubjectResourceActivityRequest struct {
	ResourceType string `json:"resource_type" path:"resource_type" required:"true" enum:"iot_card,device,asset_allocation_record,exchange_order,shop,enterprise" description:"代理资源类型 (iot_card:IoT卡, device:设备, asset_allocation_record:资产分配记录, exchange_order:换货单, shop:店铺, enterprise:企业)"`
	Identifier   string `json:"identifier" path:"identifier" required:"true" description:"业务稳定标识；卡使用ICCID，设备使用VirtualNo，其他资源使用对应业务编号"`
	CreatedFrom  string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）；默认从在线窗口开始"`
	CreatedTo    string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）；默认当前时间"`
	Page         int    `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// EnterpriseResourceActivityRequest 是企业安全资源活动的路径及分页参数。
type EnterpriseResourceActivityRequest struct {
	ResourceType string `json:"resource_type" path:"resource_type" required:"true" enum:"iot_card,device" description:"企业资源类型 (iot_card:IoT卡, device:设备)"`
	Identifier   string `json:"identifier" path:"identifier" required:"true" description:"业务稳定标识；卡使用ICCID，设备使用VirtualNo"`
	CreatedFrom  string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）；默认从在线窗口开始"`
	CreatedTo    string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）；默认当前时间"`
	Page         int    `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// IntegrationFilterRequest 是外部集成调查的公共受控筛选参数。
type IntegrationFilterRequest struct {
	CreatedFrom    string `json:"created_from" query:"created_from" description:"开始时间（RFC3339，含时区）；默认从在线窗口开始"`
	CreatedTo      string `json:"created_to" query:"created_to" description:"结束时间（RFC3339，含时区，不包含该时刻）；默认当前时间"`
	IntegrationID  string `json:"integration_id" query:"integration_id" description:"稳定外部集成记录ID"`
	Provider       string `json:"provider" query:"provider" enum:"ctcc,cmcc,cucc,wechat_pay,alipay,fuiou,wecom,gateway" description:"外部服务提供方 (ctcc:中国电信, cmcc:中国移动, cucc:中国联通, wechat_pay:微信支付, alipay:支付宝, fuiou:富友, wecom:企业微信, gateway:设备网关)"`
	Direction      string `json:"direction" query:"direction" enum:"inbound,outbound" description:"交互方向 (inbound:入站, outbound:出站)"`
	Operation      string `json:"operation" query:"operation" enum:"realname_callback,realname_removal_callback,payment_precreate,payment_query,payment_callback,get_access_token,list_visible_members,list_visible_departments,get_template_detail,upload_approval_attachment,submit_approval,approval_callback,get_approval_detail,get_approval_info,query_realname_status,query_flow,query_card_status,query_device_info,set_speed_tier,stop_card,start_card,set_device_wifi,set_device_switch_mode,switch_device_card,reboot_device,reset_device" description:"外部操作稳定编码；直接使用列表或详情响应的operation，不按中文名称猜测"`
	Result         string `json:"result" query:"result" enum:"pending,success,failed,unknown,not_found,invalid_payload,conflict,ignored,merged,rate_limited,completed,cancelled" description:"原始结果 (pending:待处理, success:成功, failed:失败, unknown:结果未知, not_found:未找到, invalid_payload:无效载荷, conflict:冲突, ignored:已忽略, merged:已合并, rate_limited:已限频, completed:已提前完成, cancelled:已取消)"`
	ResultCategory string `json:"result_category" query:"result_category" enum:"processing,succeeded,indeterminate,failed,not_sent" description:"派生结果类别 (processing:处理中, succeeded:成功, indeterminate:结果不确定, failed:失败, not_sent:未发送)"`
	ExternalID     string `json:"external_id" query:"external_id" description:"外部系统业务或请求标识"`
	ResourceType   string `json:"resource_type" query:"resource_type" description:"本地主要资源类型；直接使用列表resource.type或调查引用的resource_type"`
	ResourceID     string `json:"resource_id" query:"resource_id" description:"本地主要资源稳定ID"`
	ResourceKey    string `json:"resource_key" query:"resource_key" description:"本地主要资源稳定Key"`
	TriggerSource  string `json:"trigger_source" query:"trigger_source" description:"触发来源稳定编码"`
	TriggerScene   string `json:"trigger_scene" query:"trigger_scene" description:"触发业务场景"`
	TriggerSeries  string `json:"trigger_series" query:"trigger_series" description:"显式技术尝试序列ID"`
	StateChanged   *bool  `json:"state_changed" query:"state_changed" description:"是否改变本地业务状态"`
	HTTPStatus     *int   `json:"http_status" query:"http_status" minimum:"100" maximum:"599" description:"外部HTTP响应状态码"`
	ProviderCode   string `json:"provider_code" query:"provider_code" description:"外部服务稳定结果码"`
	RequestID      string `json:"request_id" query:"request_id" description:"来源HTTP请求ID"`
	CorrelationID  string `json:"correlation_id" query:"correlation_id" description:"跨步骤业务链路ID"`
}

// IntegrationOverviewRequest 是外部集成交互总览参数。
type IntegrationOverviewRequest struct {
	IntegrationFilterRequest
	Bucket string `json:"bucket" query:"bucket" enum:"hour,day" default:"hour" description:"趋势时间粒度 (hour:小时, day:自然日)"`
}

// IntegrationListRequest 是外部集成交互列表参数。
type IntegrationListRequest struct {
	IntegrationFilterRequest
	Page     int `json:"page" query:"page" minimum:"1" default:"1" description:"页码"`
	PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" default:"20" description:"每页数量，最大100"`
}

// IntegrationIDParams 是外部集成详情路径参数。
type IntegrationIDParams struct {
	IntegrationID string `json:"integration_id" path:"integration_id" required:"true" description:"稳定外部集成记录ID，来自列表、通知target_key或调查节点"`
}