package dto

// AuditEventListRequest 是平台审计事件列表的组合筛选参数。
type AuditEventListRequest struct {
	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:"稳定动作编码"`
	Category      string `json:"category" query:"category" description:"动作类别"`
	ActorKind     string `json:"actor_kind" query:"actor_kind" description:"操作者类型"`
	ActorID       string `json:"actor_id" query:"actor_id" description:"操作者稳定ID"`
	Source        string `json:"source" query:"source" description:"操作入口来源"`
	Result        string `json:"result" query:"result" description:"结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
	Risk          string `json:"risk" query:"risk" description:"风险等级 (low:低, normal:普通, high:高, critical:严重)"`
	ScopeType     string `json:"scope_type" query:"scope_type" description:"业务范围类型"`
	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" description:"页码，默认1"`
	PageSize      int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" description:"每页数量，默认20，最大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" description:"操作者类型 (account:人工账号, openapi:开放接口账号, system_task:系统任务, scheduled_job:计划任务, external_system:外部系统)"`
	ID           string `json:"id" path:"id" required:"true" description:"操作者稳定ID"`
	Action       string `json:"action" query:"action" description:"稳定动作编码"`
	Result       string `json:"result" query:"result" description:"事件结果"`
	Risk         string `json:"risk" query:"risk" description:"风险等级"`
	ResourceType string `json:"resource_type" query:"resource_type" description:"资源类型"`
	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" description:"页码，默认1"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" description:"每页数量，默认20，最大100"`
}

// AuditResourceSearchRequest 是首批注册资源的精确搜索参数。
type AuditResourceSearchRequest struct {
	ResourceType string `json:"resource_type" query:"resource_type" required:"true" 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" description:"页码，默认1"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" description:"每页数量，默认20，最大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:"稳定动作编码"`
	Result       string `json:"result" query:"result" description:"事件结果"`
	Page         int    `json:"page" query:"page" minimum:"1" description:"页码，默认1"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" description:"每页数量，默认20，最大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" description:"操作者类型；与actor_id同时提供"`
	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" description:"页码，默认1"`
	PageSize           int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" description:"每页数量，默认20，最大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" description:"风险等级 (low:低, normal:普通, high:高, critical:严重)"`
	Result      string `json:"result" query:"result" description:"结果 (success:成功, failed:失败, denied:拒绝, partial:部分成功, unknown:未知)"`
	Action      string `json:"action" query:"action" description:"稳定动作编码"`
	Source      string `json:"source" query:"source" 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" description:"页码，默认1"`
	PageSize int `json:"page_size" query:"page_size" minimum:"1" maximum:"100" description:"每页数量，默认20，最大100"`
}

// SubjectResourceActivityRequest 是代理和企业安全资源活动的路径及分页参数。
type SubjectResourceActivityRequest struct {
	ResourceType string `json:"resource_type" path:"resource_type" required:"true" 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" description:"页码，默认1"`
	PageSize     int    `json:"page_size" query:"page_size" minimum:"1" maximum:"100" description:"每页数量，默认20，最大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" description:"外部服务提供方稳定编码"`
	Direction      string `json:"direction" query:"direction" description:"交互方向 (inbound:入站, outbound:出站)"`
	Operation      string `json:"operation" query:"operation" description:"外部操作稳定编码"`
	Result         string `json:"result" query:"result" description:"原始结果 (pending:待处理, success:成功, failed:失败, unknown:结果未知, not_found:未找到, invalid_payload:无效载荷, conflict:冲突, ignored:已忽略, merged:已合并, rate_limited:已限频, completed:已提前完成, cancelled:已取消)"`
	ResultCategory string `json:"result_category" query:"result_category" 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:"本地主要资源类型"`
	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" description:"趋势时间粒度 (hour:小时, day:自然日)，默认hour"`
}

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

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