package countryregion

// createCountryRequest 是后台创建国家的 HTTP 入参。
// countryCode 创建后不可变，因此创建接口要求显式提交，更新接口不会接收这个字段。
type createCountryRequest struct {
	// CountryName 是稳定英文或拼音名称。
	CountryName string `json:"countryName" binding:"required"`
	// CountryCode 是 App canonical 国家码；admin-server 会统一 trim、转大写并校验 2-3 位字母。
	CountryCode string `json:"countryCode" binding:"required"`
	// CountryDisplayName 是后台和 App 注册页展示名。
	CountryDisplayName string `json:"countryDisplayName" binding:"required"`
	// SortOrder 控制国家选择器排序。
	SortOrder int32 `json:"sortOrder"`
	// ISOAlpha3 是 ISO alpha-3 或 user-assigned 辅助码。
	ISOAlpha3 string `json:"isoAlpha3"`
	// ISONumeric 必须保持字符串，避免前导零丢失。
	ISONumeric string `json:"isoNumeric"`
	// PhoneCountryCode 是 E.164 国家呼叫码，例如 +86。
	PhoneCountryCode string `json:"phoneCountryCode"`
	// Enabled 使用指针保留“前端未传”和“前端显式传 false”的区别。
	Enabled *bool `json:"enabled"`
	// Flag 是展示字段，不参与国家归属和权限判断。
	Flag string `json:"flag"`
}

// updateCountryRequest 只修改国家展示和辅助字段，不允许修改 countryCode。
type updateCountryRequest struct {
	CountryName        string `json:"countryName" binding:"required"`
	CountryDisplayName string `json:"countryDisplayName" binding:"required"`
	SortOrder          int32  `json:"sortOrder"`
	ISOAlpha3          string `json:"isoAlpha3"`
	ISONumeric         string `json:"isoNumeric"`
	PhoneCountryCode   string `json:"phoneCountryCode"`
	Flag               string `json:"flag"`
}

// createRegionRequest 创建业务区域，并提交首版 active 国家码列表。
type createRegionRequest struct {
	// RegionCode 是稳定业务编码；user-service 负责唯一性和格式校验。
	RegionCode string `json:"regionCode" binding:"required"`
	// Name 是后台展示名。
	Name string `json:"name" binding:"required"`
	// Countries 是该区域 active 国家码列表；不能为空，且不能包含重复国家。
	Countries []string `json:"countries" binding:"required"`
	// SortOrder 控制区域选择器排序。
	SortOrder int32 `json:"sortOrder"`
}

// updateRegionRequest 只修改区域展示字段，不替换国家归属。
type updateRegionRequest struct {
	RegionCode string `json:"regionCode" binding:"required"`
	Name       string `json:"name" binding:"required"`
	SortOrder  int32  `json:"sortOrder"`
}

// replaceRegionCountriesRequest 原子替换区域国家归属。
// user-service 会在同一业务流程内释放旧映射、写新映射，并创建用户区域重算任务。
type replaceRegionCountriesRequest struct {
	Countries []string `json:"countries" binding:"required"`
}