package dto

import (
	"quyun/v2/app/requests"
	"quyun/v2/database/models"
	"quyun/v2/pkg/consts"
)

// AdminOrderListFilter defines query filters for tenant-admin order listing.
type AdminOrderListFilter struct {
	// Pagination controls paging parameters (page/limit).
	requests.Pagination `json:",inline" query:",inline"`
	// UserID filters orders by buyer user id.
	UserID *int64 `json:"user_id,omitempty" query:"user_id"`
	// Status filters orders by order status.
	Status *consts.OrderStatus `json:"status,omitempty" query:"status"`
}

// AdminOrderRefundForm defines payload for tenant-admin to refund an order.
type AdminOrderRefundForm struct {
	// Force indicates bypassing the default refund window check (paid_at + 24h).
	// 强制退款：true 表示绕过默认退款时间窗限制（需审计）。
	Force bool `json:"force,omitempty"`
	// Reason is the human-readable refund reason used for audit.
	// 退款原因：建议必填（由业务侧校验）；用于审计与追责。
	Reason string `json:"reason,omitempty"`
	// IdempotencyKey ensures refund request is processed at most once.
	// 幂等键：同一笔退款重复请求时返回一致结果，避免重复退款/重复回滚。
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

// AdminOrderDetail returns a tenant-admin order detail payload.
type AdminOrderDetail struct {
	// Order is the order with items preloaded.
	Order *models.Order `json:"order,omitempty"`
}