汉秋
cbf2db649e
MaterialItem 兼容 Android 缺失字段默认值，优化素材详情/列表/标签布局与上下架开关交互，修复个人空间时间选择器初始值。 Co-authored-by: Cursor <cursoragent@cursor.com>
559 lines
20 KiB
Swift
559 lines
20 KiB
Swift
//
|
||
// MaterialManagementModels.swift
|
||
// suixinkan
|
||
//
|
||
|
||
import Foundation
|
||
|
||
/// 素材管理筛选状态，对齐 Android `MaterialListViewModel` 的四档筛选。
|
||
enum MaterialFilterStatus: Int, CaseIterable, Sendable, Equatable {
|
||
case all = 0
|
||
case approved = 1
|
||
case pending = 2
|
||
case rejected = 3
|
||
|
||
/// 展示文案。
|
||
var title: String {
|
||
switch self {
|
||
case .all: "全部"
|
||
case .approved: "已通过"
|
||
case .pending: "待审核"
|
||
case .rejected: "未通过"
|
||
}
|
||
}
|
||
|
||
/// 服务端 `status` 参数，Android 映射为：全部 4、已通过 1、待审核 0、未通过 2。
|
||
var apiStatus: Int {
|
||
switch self {
|
||
case .all: 4
|
||
case .approved: 1
|
||
case .pending: 0
|
||
case .rejected: 2
|
||
}
|
||
}
|
||
}
|
||
|
||
/// 素材媒体类型，对齐 Android `mediaType`：1 图片，2 视频。
|
||
enum MaterialMediaType: Int, CaseIterable, Sendable, Equatable {
|
||
case image = 1
|
||
case video = 2
|
||
|
||
/// 展示文案。
|
||
var title: String {
|
||
switch self {
|
||
case .image: "图片"
|
||
case .video: "视频"
|
||
}
|
||
}
|
||
|
||
/// 最大可选数量。
|
||
var maxCount: Int {
|
||
switch self {
|
||
case .image: 9
|
||
case .video: 1
|
||
}
|
||
}
|
||
|
||
/// OSS 文件类型，Android 上传任务中视频为 1、图片为 2。
|
||
var uploadFileType: Int {
|
||
switch self {
|
||
case .image: 2
|
||
case .video: 1
|
||
}
|
||
}
|
||
|
||
}
|
||
|
||
/// 素材列表项，对齐 Android `MaterialItemEntity`。
|
||
struct MaterialItem: Decodable, Sendable, Equatable, Hashable, Identifiable {
|
||
let id: Int
|
||
let name: String
|
||
let coverUrl: String
|
||
let createdAt: String
|
||
let status: Int
|
||
let downloadCount: Int
|
||
let likesCount: Int
|
||
let collectCount: Int
|
||
let shareCount: Int
|
||
let scenicSpotName: String
|
||
let projectName: String
|
||
let listingStatus: Int
|
||
|
||
enum CodingKeys: String, CodingKey {
|
||
case id
|
||
case name
|
||
case coverUrl = "cover_url"
|
||
case createdAt = "created_at"
|
||
case status
|
||
case downloadCount = "download_count"
|
||
case likesCount = "likes_count"
|
||
case collectCount = "collect_count"
|
||
case shareCount = "share_count"
|
||
case scenicSpotName = "scenic_spot_name"
|
||
case projectName = "project_name"
|
||
case listingStatus = "listing_status"
|
||
}
|
||
|
||
init(
|
||
id: Int = 0,
|
||
name: String = "",
|
||
coverUrl: String = "",
|
||
createdAt: String = "",
|
||
status: Int = 0,
|
||
downloadCount: Int = 0,
|
||
likesCount: Int = 0,
|
||
collectCount: Int = 0,
|
||
shareCount: Int = 0,
|
||
scenicSpotName: String = "",
|
||
projectName: String = "",
|
||
listingStatus: Int = 0
|
||
) {
|
||
self.id = id
|
||
self.name = name
|
||
self.coverUrl = coverUrl
|
||
self.createdAt = createdAt
|
||
self.status = status
|
||
self.downloadCount = downloadCount
|
||
self.likesCount = likesCount
|
||
self.collectCount = collectCount
|
||
self.shareCount = shareCount
|
||
self.scenicSpotName = scenicSpotName
|
||
self.projectName = projectName
|
||
self.listingStatus = listingStatus
|
||
}
|
||
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
id = try container.decodeIfPresent(Int.self, forKey: .id) ?? 0
|
||
name = try container.decodeIfPresent(String.self, forKey: .name) ?? ""
|
||
coverUrl = try container.decodeIfPresent(String.self, forKey: .coverUrl) ?? ""
|
||
createdAt = try container.decodeIfPresent(String.self, forKey: .createdAt) ?? ""
|
||
status = try container.decodeIfPresent(Int.self, forKey: .status) ?? 0
|
||
downloadCount = try container.decodeIfPresent(Int.self, forKey: .downloadCount) ?? 0
|
||
likesCount = try container.decodeIfPresent(Int.self, forKey: .likesCount) ?? 0
|
||
collectCount = try container.decodeIfPresent(Int.self, forKey: .collectCount) ?? 0
|
||
shareCount = try container.decodeIfPresent(Int.self, forKey: .shareCount) ?? 0
|
||
scenicSpotName = try container.decodeIfPresent(String.self, forKey: .scenicSpotName) ?? ""
|
||
projectName = try container.decodeIfPresent(String.self, forKey: .projectName) ?? ""
|
||
listingStatus = try container.decodeIfPresent(Int.self, forKey: .listingStatus) ?? 0
|
||
}
|
||
}
|
||
|
||
/// 素材列表响应，对齐 Android `MaterialListResponse`。
|
||
struct MaterialListResponse: Decodable, Sendable, Equatable {
|
||
let total: Int
|
||
let list: [MaterialItem]
|
||
let order: MaterialOrderInfo?
|
||
|
||
init(total: Int = 0, list: [MaterialItem] = [], order: MaterialOrderInfo? = nil) {
|
||
self.total = total
|
||
self.list = list
|
||
self.order = order
|
||
}
|
||
}
|
||
|
||
/// 素材订单统计信息，对齐 Android `MaterialOrderInfo`。
|
||
struct MaterialOrderInfo: Decodable, Sendable, Equatable, Hashable {
|
||
let totalNum: Int
|
||
let avgOrderAmount: String
|
||
let refundTotal: String
|
||
let avgChange: Int
|
||
|
||
enum CodingKeys: String, CodingKey {
|
||
case totalNum = "total_num"
|
||
case avgOrderAmount = "avg_order_amount"
|
||
case refundTotal = "refund_total"
|
||
case avgChange = "avg_change"
|
||
}
|
||
|
||
init(totalNum: Int = 0, avgOrderAmount: String = "0", refundTotal: String = "0", avgChange: Int = 0) {
|
||
self.totalNum = totalNum
|
||
self.avgOrderAmount = avgOrderAmount
|
||
self.refundTotal = refundTotal
|
||
self.avgChange = avgChange
|
||
}
|
||
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
totalNum = try container.decodeIfPresent(Int.self, forKey: .totalNum) ?? 0
|
||
avgOrderAmount = try container.decodeIfPresent(String.self, forKey: .avgOrderAmount) ?? "0"
|
||
refundTotal = try container.decodeIfPresent(String.self, forKey: .refundTotal) ?? "0"
|
||
avgChange = try container.decodeIfPresent(Int.self, forKey: .avgChange) ?? 0
|
||
}
|
||
}
|
||
|
||
/// 素材详情响应，对齐 Android `MaterialDetailResponse`。
|
||
struct MaterialDetail: Decodable, Sendable, Equatable {
|
||
let id: Int
|
||
let name: String?
|
||
let type: String?
|
||
let ossUrl: String?
|
||
let coverUrl: String?
|
||
let coverSize: Int?
|
||
let description: String?
|
||
let scenicSpotId: Int64?
|
||
let scenicAreaId: Int?
|
||
let materialTag: [MaterialTagItem]?
|
||
let uploaderId: Int?
|
||
let status: Int
|
||
let likesCount: Int
|
||
let downloadCount: Int
|
||
let collectCount: Int
|
||
let isRecommended: Bool
|
||
let createdAt: String?
|
||
let updatedAt: String?
|
||
let deletedAt: String?
|
||
let listingStatus: Int
|
||
let reviewNotes: String?
|
||
let reviewTime: String?
|
||
let reviewerId: Int?
|
||
let reviewer: String?
|
||
let provinceId: Int?
|
||
let cityId: Int?
|
||
let shareCount: Int
|
||
let isWeb: Int
|
||
let isMini: Int
|
||
let uploaderName: String?
|
||
let uploaderAvatar: String?
|
||
let uploaderDescription: String?
|
||
let platformCertification: Bool
|
||
let scenicCertification: Bool
|
||
let mediaList: [MaterialDetailMediaItem]?
|
||
|
||
enum CodingKeys: String, CodingKey {
|
||
case id
|
||
case name
|
||
case type
|
||
case ossUrl = "oss_url"
|
||
case coverUrl = "cover_url"
|
||
case coverSize = "cover_size"
|
||
case description
|
||
case scenicSpotId = "scenic_spot_id"
|
||
case scenicAreaId = "scenic_area_id"
|
||
case materialTag = "material_tag"
|
||
case uploaderId = "uploader_id"
|
||
case status
|
||
case likesCount = "likes_count"
|
||
case downloadCount = "download_count"
|
||
case collectCount = "collect_count"
|
||
case isRecommended = "is_recommended"
|
||
case createdAt = "created_at"
|
||
case updatedAt = "updated_at"
|
||
case deletedAt = "deleted_at"
|
||
case listingStatus = "listing_status"
|
||
case reviewNotes = "review_notes"
|
||
case reviewTime = "review_time"
|
||
case reviewerId = "reviewer_id"
|
||
case reviewer
|
||
case provinceId = "province_id"
|
||
case cityId = "city_id"
|
||
case shareCount = "share_count"
|
||
case isWeb = "is_web"
|
||
case isMini = "is_mini"
|
||
case uploaderName = "uploader_name"
|
||
case uploaderAvatar = "uploader_avatar"
|
||
case uploaderDescription = "uploader_description"
|
||
case platformCertification = "platform_certification"
|
||
case scenicCertification = "scenic_certification"
|
||
case mediaList = "media_list"
|
||
}
|
||
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
id = try container.decodeIfPresent(Int.self, forKey: .id) ?? 0
|
||
name = try container.decodeIfPresent(String.self, forKey: .name)
|
||
type = try container.decodeFlexibleString(forKey: .type)
|
||
ossUrl = try container.decodeIfPresent(String.self, forKey: .ossUrl)
|
||
coverUrl = try container.decodeIfPresent(String.self, forKey: .coverUrl)
|
||
coverSize = try container.decodeIfPresent(Int.self, forKey: .coverSize)
|
||
description = try container.decodeIfPresent(String.self, forKey: .description)
|
||
scenicSpotId = try container.decodeFlexibleInt64(forKey: .scenicSpotId)
|
||
scenicAreaId = try container.decodeIfPresent(Int.self, forKey: .scenicAreaId)
|
||
materialTag = try container.decodeIfPresent([MaterialTagItem].self, forKey: .materialTag)
|
||
uploaderId = try container.decodeIfPresent(Int.self, forKey: .uploaderId)
|
||
status = try container.decodeIfPresent(Int.self, forKey: .status) ?? 0
|
||
likesCount = try container.decodeIfPresent(Int.self, forKey: .likesCount) ?? 0
|
||
downloadCount = try container.decodeIfPresent(Int.self, forKey: .downloadCount) ?? 0
|
||
collectCount = try container.decodeIfPresent(Int.self, forKey: .collectCount) ?? 0
|
||
isRecommended = try container.decodeIfPresent(Bool.self, forKey: .isRecommended) ?? false
|
||
createdAt = try container.decodeIfPresent(String.self, forKey: .createdAt)
|
||
updatedAt = try container.decodeIfPresent(String.self, forKey: .updatedAt)
|
||
deletedAt = try container.decodeIfPresent(String.self, forKey: .deletedAt)
|
||
listingStatus = try container.decodeIfPresent(Int.self, forKey: .listingStatus) ?? 0
|
||
reviewNotes = try container.decodeIfPresent(String.self, forKey: .reviewNotes)
|
||
reviewTime = try container.decodeIfPresent(String.self, forKey: .reviewTime)
|
||
reviewerId = try container.decodeIfPresent(Int.self, forKey: .reviewerId)
|
||
reviewer = try container.decodeIfPresent(String.self, forKey: .reviewer)
|
||
provinceId = try container.decodeIfPresent(Int.self, forKey: .provinceId)
|
||
cityId = try container.decodeIfPresent(Int.self, forKey: .cityId)
|
||
shareCount = try container.decodeIfPresent(Int.self, forKey: .shareCount) ?? 0
|
||
isWeb = try container.decodeIfPresent(Int.self, forKey: .isWeb) ?? 0
|
||
isMini = try container.decodeIfPresent(Int.self, forKey: .isMini) ?? 0
|
||
uploaderName = try container.decodeIfPresent(String.self, forKey: .uploaderName)
|
||
uploaderAvatar = try container.decodeIfPresent(String.self, forKey: .uploaderAvatar)
|
||
uploaderDescription = try container.decodeIfPresent(String.self, forKey: .uploaderDescription)
|
||
platformCertification = try container.decodeIfPresent(Bool.self, forKey: .platformCertification) ?? false
|
||
scenicCertification = try container.decodeIfPresent(Bool.self, forKey: .scenicCertification) ?? false
|
||
mediaList = try container.decodeIfPresent([MaterialDetailMediaItem].self, forKey: .mediaList)
|
||
}
|
||
}
|
||
|
||
/// 素材标签项。
|
||
struct MaterialTagItem: Codable, Sendable, Equatable, Hashable, Identifiable {
|
||
let id: Int
|
||
let name: String
|
||
}
|
||
|
||
/// 素材详情媒体项，对齐 Android `MaterialDetailMediaItem`。
|
||
struct MaterialDetailMediaItem: Decodable, Sendable, Equatable, Hashable, Identifiable {
|
||
let id: Int
|
||
let originalName: String?
|
||
let paidMaterialId: Int?
|
||
let ossUrl: String?
|
||
let thumbnailUrl: String?
|
||
let type: Int
|
||
let size: Int64?
|
||
let createdAt: String?
|
||
let updatedAt: String?
|
||
let deletedAt: String?
|
||
let likesCount: Int
|
||
let downloadCount: Int
|
||
let showUrl: String?
|
||
let width: Int?
|
||
let height: Int?
|
||
|
||
enum CodingKeys: String, CodingKey {
|
||
case id
|
||
case originalName = "original_name"
|
||
case paidMaterialId = "paid_material_id"
|
||
case ossUrl = "oss_url"
|
||
case thumbnailUrl = "thumbnail_url"
|
||
case type
|
||
case size
|
||
case createdAt = "created_at"
|
||
case updatedAt = "updated_at"
|
||
case deletedAt = "deleted_at"
|
||
case likesCount = "likes_count"
|
||
case downloadCount = "download_count"
|
||
case showUrl = "show_url"
|
||
case width
|
||
case height
|
||
}
|
||
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
id = try container.decodeIfPresent(Int.self, forKey: .id) ?? 0
|
||
originalName = try container.decodeIfPresent(String.self, forKey: .originalName)
|
||
paidMaterialId = try container.decodeIfPresent(Int.self, forKey: .paidMaterialId)
|
||
ossUrl = try container.decodeIfPresent(String.self, forKey: .ossUrl)
|
||
thumbnailUrl = try container.decodeIfPresent(String.self, forKey: .thumbnailUrl)
|
||
type = try container.decodeIfPresent(Int.self, forKey: .type) ?? 1
|
||
size = try container.decodeIfPresent(Int64.self, forKey: .size)
|
||
createdAt = try container.decodeIfPresent(String.self, forKey: .createdAt)
|
||
updatedAt = try container.decodeIfPresent(String.self, forKey: .updatedAt)
|
||
deletedAt = try container.decodeIfPresent(String.self, forKey: .deletedAt)
|
||
likesCount = try container.decodeIfPresent(Int.self, forKey: .likesCount) ?? 0
|
||
downloadCount = try container.decodeIfPresent(Int.self, forKey: .downloadCount) ?? 0
|
||
showUrl = try container.decodeIfPresent(String.self, forKey: .showUrl)
|
||
width = try container.decodeIfPresent(Int.self, forKey: .width)
|
||
height = try container.decodeIfPresent(Int.self, forKey: .height)
|
||
}
|
||
|
||
/// 详情轮播优先展示地址。
|
||
var displayURL: String {
|
||
(ossUrl?.trimmingCharacters(in: .whitespacesAndNewlines).sxkNonEmpty)
|
||
?? (showUrl?.trimmingCharacters(in: .whitespacesAndNewlines).sxkNonEmpty)
|
||
?? ""
|
||
}
|
||
}
|
||
|
||
/// 素材上传与编辑请求，对齐 Android `UploadMaterialRequest` / `EditMaterialRequest`。
|
||
struct MaterialUploadRequest: Encodable, Sendable, Equatable {
|
||
let id: Int?
|
||
let name: String
|
||
let type: String
|
||
let mediaType: String
|
||
let mediaList: [MaterialUploadMediaItem]
|
||
let coverUrl: String
|
||
let coverSize: String
|
||
let scenicSpotId: Int64
|
||
let description: String
|
||
let materialTag: String
|
||
|
||
enum CodingKeys: String, CodingKey {
|
||
case id
|
||
case name
|
||
case type
|
||
case mediaType = "media_type"
|
||
case mediaList = "media_list"
|
||
case coverUrl = "cover_url"
|
||
case coverSize = "cover_size"
|
||
case scenicSpotId = "scenic_spot_id"
|
||
case description
|
||
case materialTag = "material_tag"
|
||
}
|
||
|
||
init(
|
||
id: Int? = nil,
|
||
name: String,
|
||
mediaType: MaterialMediaType,
|
||
mediaList: [MaterialUploadMediaItem],
|
||
coverUrl: String,
|
||
coverSize: String,
|
||
scenicSpotId: Int64,
|
||
materialTag: String
|
||
) {
|
||
self.id = id
|
||
self.name = name
|
||
self.type = "1"
|
||
self.mediaType = String(mediaType.rawValue)
|
||
self.mediaList = mediaList
|
||
self.coverUrl = coverUrl
|
||
self.coverSize = coverSize
|
||
self.scenicSpotId = scenicSpotId
|
||
self.description = ""
|
||
self.materialTag = materialTag
|
||
}
|
||
|
||
func encode(to encoder: Encoder) throws {
|
||
var container = encoder.container(keyedBy: CodingKeys.self)
|
||
try container.encodeIfPresent(id, forKey: .id)
|
||
try container.encode(name, forKey: .name)
|
||
try container.encode(type, forKey: .type)
|
||
try container.encode(mediaType, forKey: .mediaType)
|
||
try container.encode(mediaList, forKey: .mediaList)
|
||
try container.encode(coverUrl, forKey: .coverUrl)
|
||
try container.encode(coverSize, forKey: .coverSize)
|
||
try container.encode(scenicSpotId, forKey: .scenicSpotId)
|
||
try container.encode(description, forKey: .description)
|
||
try container.encode(materialTag, forKey: .materialTag)
|
||
}
|
||
}
|
||
|
||
/// 素材上传媒体项，对齐 Android `MediaItem`。
|
||
struct MaterialUploadMediaItem: Encodable, Sendable, Equatable {
|
||
let originalName: String
|
||
let ossUrl: String
|
||
let size: Int64
|
||
let fileWidthSize: MaterialUploadFileSize
|
||
|
||
enum CodingKeys: String, CodingKey {
|
||
case originalName = "original_name"
|
||
case ossUrl = "oss_url"
|
||
case size
|
||
case fileWidthSize = "file_width_size"
|
||
}
|
||
}
|
||
|
||
/// 素材上传文件宽高。
|
||
struct MaterialUploadFileSize: Encodable, Sendable, Equatable {
|
||
let width: Int
|
||
let height: Int
|
||
}
|
||
|
||
/// 上传页本地媒体项，不依赖 UIKit，供 ViewModel 管理上传状态。
|
||
struct MaterialUploadedMediaItem: Sendable, Equatable, Hashable, Identifiable {
|
||
let id: String
|
||
let data: Data
|
||
let thumbnailData: Data?
|
||
let previewURL: String?
|
||
let fileName: String
|
||
let size: Int64
|
||
let width: Int
|
||
let height: Int
|
||
var ossUrl: String
|
||
var isUploading: Bool
|
||
var uploadProgress: Int
|
||
|
||
init(
|
||
id: String = UUID().uuidString,
|
||
data: Data,
|
||
thumbnailData: Data? = nil,
|
||
previewURL: String? = nil,
|
||
fileName: String,
|
||
size: Int64? = nil,
|
||
width: Int = 0,
|
||
height: Int = 0,
|
||
ossUrl: String = "",
|
||
isUploading: Bool = false,
|
||
uploadProgress: Int = 0
|
||
) {
|
||
self.id = id
|
||
self.data = data
|
||
self.thumbnailData = thumbnailData
|
||
self.previewURL = previewURL
|
||
self.fileName = fileName
|
||
self.size = size ?? Int64(data.count)
|
||
self.width = width
|
||
self.height = height
|
||
self.ossUrl = ossUrl
|
||
self.isUploading = isUploading
|
||
self.uploadProgress = uploadProgress
|
||
}
|
||
}
|
||
|
||
/// 素材上传进度弹窗状态。
|
||
struct MaterialUploadDialogState: Sendable, Equatable {
|
||
let title: String
|
||
let progress: Int
|
||
}
|
||
|
||
/// 素材 UI 展示格式化工具。
|
||
enum MaterialDisplayFormatter {
|
||
/// 格式化计数，超过 1000 按 Android 规则显示 k。
|
||
static func formatCount(_ count: Int) -> String {
|
||
guard count >= 1000 else { return String(count) }
|
||
let value = Double(count) / 1000.0
|
||
if value.truncatingRemainder(dividingBy: 1) == 0 {
|
||
return "\(Int(value))k"
|
||
}
|
||
return String(format: "%.1fk", value)
|
||
}
|
||
|
||
/// 格式化整数，增加千位分隔符。
|
||
static func formatNumber(_ number: Int) -> String {
|
||
let formatter = NumberFormatter()
|
||
formatter.numberStyle = .decimal
|
||
return formatter.string(from: NSNumber(value: number)) ?? String(number)
|
||
}
|
||
|
||
/// 审核状态文案。
|
||
static func reviewStatusText(_ status: Int) -> String {
|
||
switch status {
|
||
case 1: "已通过"
|
||
case 0: "待审核"
|
||
case 2: "未通过"
|
||
default: "未知"
|
||
}
|
||
}
|
||
}
|
||
|
||
private extension KeyedDecodingContainer {
|
||
func decodeFlexibleString(forKey key: Key) throws -> String? {
|
||
if let value = try decodeIfPresent(String.self, forKey: key) {
|
||
return value
|
||
}
|
||
if let value = try decodeIfPresent(Int.self, forKey: key) {
|
||
return String(value)
|
||
}
|
||
return nil
|
||
}
|
||
|
||
func decodeFlexibleInt64(forKey key: Key) throws -> Int64? {
|
||
if let value = try decodeIfPresent(Int64.self, forKey: key) {
|
||
return value
|
||
}
|
||
if let value = try decodeIfPresent(Int.self, forKey: key) {
|
||
return Int64(value)
|
||
}
|
||
if let value = try decodeIfPresent(String.self, forKey: key) {
|
||
return Int64(value)
|
||
}
|
||
return nil
|
||
}
|
||
}
|
||
|
||
private extension String {
|
||
var sxkNonEmpty: String? { isEmpty ? nil : self }
|
||
}
|