package ledger

// HostSalarySettlementBatchCommand 是 cron 或测试触发结算批处理的最小输入。
type HostSalarySettlementBatchCommand struct {
	AppCode        string
	RunID          string
	WorkerID       string
	BatchSize      int
	SettlementType string
	// TriggerMode 只决定本次入账动作读取 automatic 还是 manual 政策；待结算账单展示可以同时读取两类政策。
	TriggerMode string
	// SettlementRole 为空或 all 时完整结算主播和代理权益；后台人工入口传 host/agency 时只推进对应身份钱包。
	SettlementRole string
	CycleKey       string
	// UserIDs 为空时扫描全量候选；后台人工批量结算会传入勾选主播，防止跨区域或跨周期误结算。
	UserIDs []int64
	NowMs   int64
}

// HostSalarySettlementBatchResult 汇总一个结算批次的扫描和入账结果。
type HostSalarySettlementBatchResult struct {
	ClaimedCount   int
	ProcessedCount int
	SuccessCount   int
	FailureCount   int
	HasMore        bool
}

// HostSalaryPolicy 是 wallet-service 结算读取的后台政策运行快照。
type HostSalaryPolicy struct {
	PolicyID uint64
	// CycleKey 与 PolicyVersion 共同标识已发布的不可变周期快照；结算只能按账户 cycle_key 精确命中。
	CycleKey                        string
	PolicyVersion                   uint64
	Name                            string
	RegionID                        int64
	Status                          string
	SettlementMode                  string
	SettlementTriggerMode           string
	GiftCoinToDiamondRatio          string
	ResidualDiamondToUSDRate        string
	CoinSellerWithdrawalLimitPeriod string
	CoinSellerWithdrawalLimitCount  int64
	PlatformWithdrawalLimitPeriod   string
	PlatformWithdrawalLimitCount    int64
	EffectiveFromMs                 int64
	EffectiveToMs                   int64
	Levels                          []HostSalaryPolicyLevel
}

// HostSalaryPolicyLevel 使用累计值表达工资和奖励，结算时只发放“当前累计 - 已发累计”的差额。
type HostSalaryPolicyLevel struct {
	LevelNo              int
	RequiredDiamonds     int64
	HostSalaryUSDMinor   int64
	HostCoinReward       int64
	AgencySalaryUSDMinor int64
	Status               string
	SortOrder            int
}

// HostSalaryProgress 是主播当前工资周期的钻石累计投影，用于 H5 按工资政策计算距离下一等级的差值。
type HostSalaryProgress struct {
	HostUserID        int64
	CycleKey          string
	RegionID          int64
	AgencyOwnerUserID int64
	TotalDiamonds     int64
	GiftDiamondTotal  int64
	UpdatedAtMS       int64
}

// TeamHostSalaryStatsQuery 按 Agency 收款人集合聚合主播工资统计的查询条件。
// 收款人集合由调用方（gateway）从 user-service 组织树解析，wallet 只按周期账户上的 agency_owner_user_id 快照聚合。
type TeamHostSalaryStatsQuery struct {
	AgencyOwnerUserIDs []int64
	CycleKeys          []string
	// NowMs 只保留调用兼容；工资估算必须按每个 CycleKey 读取绑定版本，不能按查询执行时间选政策。
	NowMs int64
}

// TeamHostSalaryCycleStat 是一组 Agency 收款人名下主播在单个工资周期的工资统计。
// Estimated 是“预收入”口径：按当前累计钻石命中的档位累计工资 + 超出档位的剩余钻石按月底费率折美元，
// 与已结算累计取大；已关闭周期读出来即真实发放值，进行中周期是“立刻月结能拿多少”的估算。
type TeamHostSalaryCycleStat struct {
	CycleKey                    string
	EstimatedHostSalaryUSDMinor int64
	// SettledHostSalaryUSDMinor 含月底剩余钻石折美元部分，等于该周期实际入账主播工资钱包的美元累计。
	SettledHostSalaryUSDMinor int64
	// ActiveHostCount 统计该周期内累计钻石大于 0 的主播数。
	ActiveHostCount int
	TotalDiamonds   int64
}