汉秋
ffb16eca29
实现任务列表、详情与创建页面，对接 API，支持云端/本地附件，并添加单元测试。 Co-authored-by: Cursor <cursoragent@cursor.com>
394 lines
15 KiB
Swift
394 lines
15 KiB
Swift
//
|
||
// TaskModels.swift
|
||
// suixinkan
|
||
//
|
||
// Created by Codex on 2026/6/23.
|
||
//
|
||
|
||
import Foundation
|
||
|
||
/// 摄影师任务列表实体，表示任务管理页中的一条任务记录。
|
||
struct PhotographerTaskItem: Decodable, Identifiable, Hashable {
|
||
let id: Int
|
||
let name: String
|
||
let type: Int
|
||
let orderNumber: String
|
||
let taskStatus: Int
|
||
let statusName: String
|
||
let createdAt: String
|
||
let updatedAt: String
|
||
let photogRemark: String
|
||
let editorName: String
|
||
let operateTime: String
|
||
let orderUserNickname: String
|
||
let orderUserPhone: String
|
||
let orderUserId: String
|
||
let media: [TaskMediaItem]
|
||
|
||
/// 任务列表字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case id
|
||
case name
|
||
case type
|
||
case orderNumber = "order_number"
|
||
case taskStatus = "task_status"
|
||
case statusName = "status_name"
|
||
case createdAt = "created_at"
|
||
case updatedAt = "updated_at"
|
||
case photogRemark = "photog_remark"
|
||
case editorName = "editor_name"
|
||
case operateTime = "operate_time"
|
||
case orderUserNickname = "order_user_nickname"
|
||
case orderUserPhone = "order_user_phone"
|
||
case orderUserId = "order_user_id"
|
||
case media
|
||
}
|
||
|
||
/// 宽松解码任务列表字段，避免后端数字和字符串混用导致页面不可用。
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
id = try container.decodeLossyInt(forKey: .id) ?? 0
|
||
name = try container.decodeLossyString(forKey: .name)
|
||
type = try container.decodeLossyInt(forKey: .type) ?? 0
|
||
orderNumber = try container.decodeLossyString(forKey: .orderNumber)
|
||
taskStatus = try container.decodeLossyInt(forKey: .taskStatus) ?? 0
|
||
statusName = try container.decodeLossyString(forKey: .statusName)
|
||
createdAt = try container.decodeLossyString(forKey: .createdAt)
|
||
updatedAt = try container.decodeLossyString(forKey: .updatedAt)
|
||
photogRemark = try container.decodeLossyString(forKey: .photogRemark)
|
||
editorName = try container.decodeLossyString(forKey: .editorName)
|
||
operateTime = try container.decodeLossyString(forKey: .operateTime)
|
||
orderUserNickname = try container.decodeLossyString(forKey: .orderUserNickname)
|
||
orderUserPhone = try container.decodeLossyString(forKey: .orderUserPhone)
|
||
orderUserId = try container.decodeLossyString(forKey: .orderUserId)
|
||
media = (try? container.decode([TaskMediaItem].self, forKey: .media)) ?? []
|
||
}
|
||
}
|
||
|
||
/// 任务媒体实体，表示任务附件或任务结果中的图片、视频文件。
|
||
struct TaskMediaItem: Decodable, Identifiable, Hashable {
|
||
let id: Int
|
||
let photogTaskId: Int
|
||
let userId: Int
|
||
let fileName: String
|
||
let fileType: Int
|
||
let fileUrl: String
|
||
let fileSize: Int64
|
||
let coverUrl: String
|
||
let duration: Int
|
||
let remark: String
|
||
let createdAt: String
|
||
let updatedAt: String
|
||
|
||
/// 判断当前媒体是否应按视频展示。
|
||
var isVideo: Bool {
|
||
fileType == 1 || Self.hasVideoExtension(fileName) || Self.hasVideoExtension(fileUrl)
|
||
}
|
||
|
||
/// 返回用于缩略图展示的 URL，优先使用封面图。
|
||
var displayURL: String {
|
||
coverUrl.isEmpty ? fileUrl : coverUrl
|
||
}
|
||
|
||
/// 根据文件扩展名判断是否是常见视频格式。
|
||
private static func hasVideoExtension(_ value: String) -> Bool {
|
||
["mp4", "mov", "m4v", "avi"].contains(URL(string: value)?.pathExtension.lowercased() ?? URL(fileURLWithPath: value).pathExtension.lowercased())
|
||
}
|
||
|
||
/// 任务媒体字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case id
|
||
case photogTaskId = "photog_task_id"
|
||
case userId = "user_id"
|
||
case fileName = "file_name"
|
||
case fileType = "file_type"
|
||
case fileUrl = "file_url"
|
||
case fileSize = "file_size"
|
||
case coverUrl = "cover_url"
|
||
case duration
|
||
case remark
|
||
case createdAt = "created_at"
|
||
case updatedAt = "updated_at"
|
||
}
|
||
|
||
/// 宽松解码任务媒体字段。
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
id = try container.decodeLossyInt(forKey: .id) ?? 0
|
||
photogTaskId = try container.decodeLossyInt(forKey: .photogTaskId) ?? 0
|
||
userId = try container.decodeLossyInt(forKey: .userId) ?? 0
|
||
fileName = try container.decodeLossyString(forKey: .fileName)
|
||
fileType = try container.decodeLossyInt(forKey: .fileType) ?? 0
|
||
fileUrl = try container.decodeLossyString(forKey: .fileUrl)
|
||
fileSize = Int64(try container.decodeLossyInt(forKey: .fileSize) ?? 0)
|
||
coverUrl = try container.decodeLossyString(forKey: .coverUrl)
|
||
duration = try container.decodeLossyInt(forKey: .duration) ?? 0
|
||
remark = try container.decodeLossyString(forKey: .remark)
|
||
createdAt = try container.decodeLossyString(forKey: .createdAt)
|
||
updatedAt = try container.decodeLossyString(forKey: .updatedAt)
|
||
}
|
||
}
|
||
|
||
/// 任务详情实体，表示任务详情页展示的完整任务信息。
|
||
struct TaskDetailResponse: Decodable, Identifiable, Hashable {
|
||
let id: Int
|
||
let name: String
|
||
let createdAt: String
|
||
let taskStatus: Int
|
||
let taskStatusLabel: String
|
||
let acceptedAt: String
|
||
let editorName: String
|
||
let editorPhone: String
|
||
let urgentHour: Int
|
||
let photogRemark: String
|
||
let order: TaskDetailOrder?
|
||
let taskResult: [TaskMediaItem]
|
||
|
||
/// 任务详情字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case id
|
||
case name
|
||
case createdAt = "created_at"
|
||
case taskStatus = "task_status"
|
||
case taskStatusLabel = "task_status_label"
|
||
case acceptedAt = "accepted_at"
|
||
case editorName = "editor_name"
|
||
case editorPhone = "editor_phone"
|
||
case urgentHour = "urgent_hour"
|
||
case photogRemark = "photog_remark"
|
||
case order
|
||
case taskResult = "task_result"
|
||
}
|
||
|
||
/// 宽松解码任务详情字段。
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
id = try container.decodeLossyInt(forKey: .id) ?? 0
|
||
name = try container.decodeLossyString(forKey: .name)
|
||
createdAt = try container.decodeLossyString(forKey: .createdAt)
|
||
taskStatus = try container.decodeLossyInt(forKey: .taskStatus) ?? 0
|
||
taskStatusLabel = try container.decodeLossyString(forKey: .taskStatusLabel)
|
||
acceptedAt = try container.decodeLossyString(forKey: .acceptedAt)
|
||
editorName = try container.decodeLossyString(forKey: .editorName)
|
||
editorPhone = try container.decodeLossyString(forKey: .editorPhone)
|
||
urgentHour = try container.decodeLossyInt(forKey: .urgentHour) ?? 0
|
||
photogRemark = try container.decodeLossyString(forKey: .photogRemark)
|
||
order = try? container.decode(TaskDetailOrder.self, forKey: .order)
|
||
taskResult = (try? container.decode([TaskMediaItem].self, forKey: .taskResult)) ?? []
|
||
}
|
||
}
|
||
|
||
/// 任务关联订单实体，表示任务详情中的订单摘要。
|
||
struct TaskDetailOrder: Decodable, Hashable {
|
||
let projectName: String
|
||
let orderNumber: String
|
||
let payTime: String
|
||
let userPhone: String
|
||
|
||
/// 任务关联订单字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case projectName = "project_name"
|
||
case orderNumber = "order_number"
|
||
case payTime = "pay_time"
|
||
case userPhone = "user_phone"
|
||
}
|
||
|
||
/// 宽松解码订单摘要字段。
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
projectName = try container.decodeLossyString(forKey: .projectName)
|
||
orderNumber = try container.decodeLossyString(forKey: .orderNumber)
|
||
payTime = try container.decodeLossyString(forKey: .payTime)
|
||
userPhone = try container.decodeLossyString(forKey: .userPhone)
|
||
}
|
||
}
|
||
|
||
/// 可关联订单实体，表示发布任务时可选择的订单。
|
||
struct AvailableOrderResponse: Decodable, Identifiable, Hashable {
|
||
var id: String { orderNumber }
|
||
let projectName: String
|
||
let orderNumber: String
|
||
let orderStatus: Int
|
||
let orderStatusLabel: String
|
||
let payTime: String
|
||
let userPhone: String
|
||
|
||
/// 可关联订单字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case projectName = "project_name"
|
||
case orderNumber = "order_number"
|
||
case orderStatus = "order_status"
|
||
case orderStatusLabel = "order_status_label"
|
||
case payTime = "pay_time"
|
||
case userPhone = "user_phone"
|
||
}
|
||
|
||
/// 宽松解码可关联订单字段。
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
projectName = try container.decodeLossyString(forKey: .projectName)
|
||
orderNumber = try container.decodeLossyString(forKey: .orderNumber)
|
||
orderStatus = try container.decodeLossyInt(forKey: .orderStatus) ?? 0
|
||
orderStatusLabel = try container.decodeLossyString(forKey: .orderStatusLabel)
|
||
payTime = try container.decodeLossyString(forKey: .payTime)
|
||
userPhone = try container.decodeLossyString(forKey: .userPhone)
|
||
}
|
||
}
|
||
|
||
/// 发布任务请求实体，描述提交给后端的新任务内容。
|
||
struct AddTaskRequest: Encodable, Equatable {
|
||
let scenicId: String
|
||
let name: String
|
||
let orderNumber: String?
|
||
let remark: String
|
||
let urgentHour: Int
|
||
let cloudFile: [CloudFileItem]
|
||
let uploadFile: [UploadFileItem]
|
||
|
||
/// 发布任务请求字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case scenicId = "scenic_id"
|
||
case name
|
||
case orderNumber = "order_number"
|
||
case remark = "photog_remark"
|
||
case urgentHour = "urgent_hour"
|
||
case cloudFile = "cloud_file"
|
||
case uploadFile = "upload_file"
|
||
}
|
||
}
|
||
|
||
/// 任务云盘附件请求实体，表示发布任务时选择的云盘文件。
|
||
struct CloudFileItem: Encodable, Equatable {
|
||
let fileId: Int
|
||
let remark: String
|
||
|
||
/// 云盘附件请求字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case fileId = "file_id"
|
||
case remark
|
||
}
|
||
}
|
||
|
||
/// 任务上传附件请求实体，表示发布任务时上传到 OSS 的本地文件。
|
||
struct UploadFileItem: Encodable, Equatable {
|
||
let fileUrl: String
|
||
let fileName: String
|
||
let remark: String
|
||
|
||
/// 上传附件请求字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case fileUrl = "file_url"
|
||
case fileName = "file_name"
|
||
case remark
|
||
}
|
||
}
|
||
|
||
/// 云盘文件实体，表示发布任务时可选择的云盘文件或文件夹。
|
||
struct CloudDriveFile: Decodable, Identifiable, Hashable {
|
||
let id: Int
|
||
let parentFolderId: Int
|
||
let fileUrl: String
|
||
let coverUrl: String
|
||
let updatedAt: String
|
||
let name: String
|
||
let createdAt: String
|
||
let childNum: Int
|
||
let type: Int
|
||
let fileSize: Int64
|
||
|
||
/// 判断当前云盘项是否为文件夹。
|
||
var isFolder: Bool { type == 99 }
|
||
|
||
/// 判断当前云盘项是否为视频文件。
|
||
var isVideo: Bool {
|
||
type == 1 || Self.hasVideoExtension(name) || Self.hasVideoExtension(fileUrl)
|
||
}
|
||
|
||
/// 根据文件扩展名判断是否是常见视频格式。
|
||
private static func hasVideoExtension(_ value: String) -> Bool {
|
||
["mp4", "mov", "m4v", "avi"].contains(URL(string: value)?.pathExtension.lowercased() ?? URL(fileURLWithPath: value).pathExtension.lowercased())
|
||
}
|
||
|
||
/// 云盘文件字段映射，兼容后端下划线命名。
|
||
enum CodingKeys: String, CodingKey {
|
||
case id
|
||
case parentFolderId = "parent_folder_id"
|
||
case fileUrl = "file_url"
|
||
case coverUrl = "cover_url"
|
||
case updatedAt = "updated_at"
|
||
case name
|
||
case createdAt = "created_at"
|
||
case childNum = "child_num"
|
||
case type
|
||
case fileSize = "file_size"
|
||
}
|
||
|
||
/// 构造本地路径根节点，供云盘选择器维护面包屑。
|
||
init(id: Int, name: String) {
|
||
self.id = id
|
||
parentFolderId = 0
|
||
fileUrl = ""
|
||
coverUrl = ""
|
||
updatedAt = ""
|
||
self.name = name
|
||
createdAt = ""
|
||
childNum = 0
|
||
type = 99
|
||
fileSize = 0
|
||
}
|
||
|
||
/// 宽松解码云盘文件字段。
|
||
init(from decoder: Decoder) throws {
|
||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||
id = try container.decodeLossyInt(forKey: .id) ?? 0
|
||
parentFolderId = try container.decodeLossyInt(forKey: .parentFolderId) ?? 0
|
||
fileUrl = try container.decodeLossyString(forKey: .fileUrl)
|
||
coverUrl = try container.decodeLossyString(forKey: .coverUrl)
|
||
updatedAt = try container.decodeLossyString(forKey: .updatedAt)
|
||
name = try container.decodeLossyString(forKey: .name)
|
||
createdAt = try container.decodeLossyString(forKey: .createdAt)
|
||
childNum = try container.decodeLossyInt(forKey: .childNum) ?? 0
|
||
type = try container.decodeLossyInt(forKey: .type) ?? 0
|
||
fileSize = Int64(try container.decodeLossyInt(forKey: .fileSize) ?? 0)
|
||
}
|
||
}
|
||
|
||
private extension KeyedDecodingContainer {
|
||
/// 将 String、数字和 Bool 宽松解码为字符串。
|
||
func decodeLossyString(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)
|
||
}
|
||
if let value = try? decodeIfPresent(Double.self, forKey: key) {
|
||
return String(value)
|
||
}
|
||
if let value = try? decodeIfPresent(Bool.self, forKey: key) {
|
||
return value ? "true" : "false"
|
||
}
|
||
return ""
|
||
}
|
||
|
||
/// 将 Int、Double 或数字字符串宽松解码为整数。
|
||
func decodeLossyInt(forKey key: Key) throws -> Int? {
|
||
if let value = try? decodeIfPresent(Int.self, forKey: key) {
|
||
return value
|
||
}
|
||
if let value = try? decodeIfPresent(String.self, forKey: key) {
|
||
let text = value.trimmingCharacters(in: .whitespacesAndNewlines)
|
||
if let intValue = Int(text) {
|
||
return intValue
|
||
}
|
||
if let doubleValue = Double(text) {
|
||
return Int(doubleValue)
|
||
}
|
||
}
|
||
if let value = try? decodeIfPresent(Double.self, forKey: key) {
|
||
return Int(value)
|
||
}
|
||
return nil
|
||
}
|
||
}
|