// Package model 定义 TCS-IPTV 的领域模型，
// 对应需求16的四类核心数据结构与 CTID 双锚定模型。
package model

import "time"

// Party 三方角色标识。
type Party string

const (
	PartyCP       Party = "cp"       // 内容提供商
	PartyReviewer Party = "reviewer" // 审核和监管部门（审核主体：CSPS/媒资库）
	PartyOperator Party = "operator" // 运营商
)

// Content 内容主表（Content Registry）。
type Content struct {
	ContentTwinID string    `json:"content_twin_id"`
	MACode        string    `json:"ma_code"`
	MAType        string    `json:"ma_type"`
	Title         string    `json:"title"`
	EpisodeCount  int       `json:"episode_count"`
	Status        string    `json:"status"`
	Issuer        string    `json:"issuer"`
	IssueDate     string    `json:"issue_date"`
	FileHash      string    `json:"file_hash,omitempty"` // 传输便利：列表时附带整剧文件哈希（供运营商演示注入）
	CreatedAt     time.Time `json:"created_at"`
}

// HashType 哈希类型。
type HashType string

const (
	HashFile       HashType = "file_sha256"
	HashPerceptual HashType = "perceptual"
	HashTranscoded HashType = "transcoded"
)

// HashBinding 哈希绑定（Hash Binding）。
type HashBinding struct {
	ContentTwinID string   `json:"content_twin_id"`
	HashType      HashType `json:"hash_type"`
	HashValue     string   `json:"hash_value"`
	MerkleRoot    string   `json:"merkle_root"`
	Episode       int      `json:"episode"` // 集号；0 表示整剧/单体（非分集）
	FileFormat    string   `json:"file_format"`
	Resolution    string   `json:"resolution"`
	Duration      int      `json:"duration"`
	Version       string   `json:"version"`
	ParentHash    string   `json:"parent_hash"` // 转码版指向母版哈希
	Revoked       bool     `json:"revoked"`     // 集级下架标记（true=该集已下架）
	RevokedReason string   `json:"revoked_reason,omitempty"`
	CreatedBy     string   `json:"created_by"`
}

// EpisodeHash 单集哈希（送审时按集提交）。
type EpisodeHash struct {
	Episode    int    `json:"episode"`
	FileSHA256 string `json:"file_sha256"`
	MerkleRoot string `json:"merkle_root"`
	Perceptual string `json:"perceptual_hash"`
	Duration   int    `json:"duration"`
	Resolution string `json:"resolution"`
}

// Mapping 三方编码映射（Identity Mapping）。
type Mapping struct {
	ContentTwinID string `json:"content_twin_id"`
	Party         Party  `json:"party"`
	PartyID       string `json:"party_id"`
	PartyName     string `json:"party_name"`
	CDNEndpoint   string `json:"cdn_endpoint"`
}

// VersionChange 版本变更（Version History）。
type VersionChange struct {
	ContentTwinID   string `json:"content_twin_id"`
	Version         string `json:"version"`
	ChangeReason    string `json:"change_reason"`
	PrevHash        string `json:"prev_hash"`
	NewHash         string `json:"new_hash"`
	ReauditRequired bool   `json:"reaudit_required"`
	ReauditStatus   string `json:"reaudit_status"`
	AffectedEpisode int    `json:"affected_episode"`
}

// 内容审核状态。
const (
	StatusPending     = "pending"      // 待审
	StatusPreChecking = "pre_checking" // 预检中
	StatusReviewing   = "reviewing"    // CSPS 审核中
	StatusApproved    = "approved"     // 审核通过（待发码）
	StatusIssued      = "issued"       // 已发码（送审单完结）
	StatusRejected    = "rejected"     // 驳回
	StatusInLibrary   = "in_library"   // 已入媒资库
	StatusPublished   = "published"    // 已发布
	StatusRevoked     = "revoked"      // 已下架
	StatusMerged      = "merged"       // 已合并入其他MA码
	StatusSplit       = "split"        // 已拆分为多个MA码
)

// ContentQueryResult 多维度标识查询的统一返回结果。
// 支持按 Hash、省级内容编码、片库文件 ID 等多种维度反查内容标识信息。
type ContentQueryResult struct {
	Found    bool         `json:"found"`     // 是否找到匹配记录
	Content  Content      `json:"content"`   // 内容主记录
	Bindings []HashBinding `json:"bindings"` // 哈希绑定列表
	Mappings []Mapping    `json:"mappings"`  // 三方编码映射列表
}

// MergeRequest MA 合并请求（将多个 MA 码合并为一个主 MA 码）。
type MergeRequest struct {
	PrimaryMACode   string   `json:"primary_ma_code"`   // 合并后保留的主 MA 码
	SecondaryMACodes []string `json:"secondary_ma_codes"` // 被合并的 MA 码列表（合并后标记为 merged）
	Reason          string   `json:"reason"`            // 合并原因
	Operator        string   `json:"operator"`          // 操作人
}

// MergeResult MA 合并结果。
type MergeResult struct {
	PrimaryMACode    string   `json:"primary_ma_code"`    // 主 MA 码
	MergedMACodes    []string `json:"merged_ma_codes"`    // 已合并的 MA 码列表
	MigratedBindings int      `json:"migrated_bindings"`  // 迁移的哈希绑定数
	MigratedMappings int      `json:"migrated_mappings"`  // 迁移的映射数
	TxID             string   `json:"tx_id"`              // 链上交易 ID
}

// SplitRequest MA 拆分请求（将一个 MA 码拆分为多个独立 MA 码）。
type SplitRequest struct {
	SourceMACode string          `json:"source_ma_code"`  // 被拆分的源 MA 码
	Splits       []SplitTarget   `json:"splits"`          // 拆分目标列表
	Reason       string          `json:"reason"`          // 拆分原因
	Operator     string          `json:"operator"`        // 操作人
}

// SplitTarget 拆分目标：每集或每组内容拆分后的新 MA 码信息。
type SplitTarget struct {
	NewMACode  string `json:"new_ma_code"`   // 拆分后新分配的 MA 码
	Title      string `json:"title"`         // 拆分后内容标题
	Episodes   []int  `json:"episodes"`      // 关联的集号列表（空表示整剧拆分）
}

// SplitResult MA 拆分结果。
type SplitResult struct {
	SourceMACode     string   `json:"source_ma_code"`     // 源 MA 码
	NewMACodes       []string `json:"new_ma_codes"`       // 拆分后生成的新 MA 码列表
	MigratedBindings int      `json:"migrated_bindings"`  // 迁移的哈希绑定数
	MigratedMappings int      `json:"migrated_mappings"`  // 迁移的映射数
	TxID             string   `json:"tx_id"`              // 链上交易 ID
}