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"`
}

// 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，其他资源使用对应业务编号"`
	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" required:"true" description:"开始时间（RFC3339，含时区，必填）"`
	CreatedTo      string `json:"created_to" query:"created_to" required:"true" 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或调查节点"`
}