初始化

缺陷：主题配色需要优化整体的同风格

app/Models/FileModel.php

@@ -4,14 +4,71 @@ namespace App\Models;
 
 use App\BaseApp\BaseModel;
 
+/**
+ * 文件 / 素材表（nl_file）
+ *
+ * 原表只是上传流水（user_id + url）。素材库扩了对象键、体积、哈希与引用计数之后，
+ * 它同时充当素材主表，type / source 的取值被同步、回收、前端筛选三处共用，
+ * 所以固化成常量，免得三边各写一套魔法数字、还各写错一个。
+ */
 class FileModel extends BaseModel
 {
+    /*
+     * type 取值。0~4 是老表原有语义，5、6 是素材库补的：
+     * 图册 PDF、报价 Excel 这类文件原先全落在「其他」里没法筛。
+     */
+    public const TYPE_IMAGE = 0;
+    public const TYPE_VIDEO = 1;
+    public const TYPE_AUDIO = 2;
+    public const TYPE_EXCEL = 3;
+    public const TYPE_ARCHIVE = 4;
+    public const TYPE_DOCUMENT = 5;
+    public const TYPE_OTHER = 6;
+
+    /** source：经上传接口进来的 */
+    public const SOURCE_UPLOAD = 0;
+    /** source：从 OSS 反向列举补录的历史文件 */
+    public const SOURCE_OSS = 1;
 
     protected $table = 'file';
-    /**
-     * The attributes that are mass assignable.
-     *
-     * @var list<string>
-     */
+
     protected $guarded = [];
+
+    /**
+     * 数值列显式转型：MySQL 驱动会把 bigint / int 读成字符串，
+     * 前端拿 size 做体积换算、拿 ref_count 判断能否回收时会被字符串坑到
+     *
+     * created_at / updated_at 不在此列：BaseModel 已经用访问器格式化成了日期串，
+     * 再加 cast 只会让两套逻辑互相打架
+     */
+    protected $casts = [
+        'user_id' => 'integer',
+        'oss_config_id' => 'integer',
+        'folder_id' => 'integer',
+        'type' => 'integer',
+        'size' => 'integer',
+        'width' => 'integer',
+        'height' => 'integer',
+        'ref_count' => 'integer',
+        'last_scan_at' => 'integer',
+        'source' => 'integer',
+    ];
+
+    /**
+     * 扩展名归类到 type
+     *
+     * 从 OSS 反向同步时手上只有对象键，没有上传时的 MIME，只能按扩展名判断
+     */
+    public static function typeOfExt(string $ext): int
+    {
+        return match (strtolower(trim($ext, " \t\n\r\0\x0B."))) {
+            'jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp', 'svg', 'ico', 'avif', 'heic' => self::TYPE_IMAGE,
+            'mp4', 'mov', 'avi', 'mkv', 'flv', 'wmv', 'webm', 'm3u8', 'ts' => self::TYPE_VIDEO,
+            'mp3', 'wav', 'aac', 'flac', 'ogg', 'm4a', 'amr' => self::TYPE_AUDIO,
+            'xls', 'xlsx', 'csv' => self::TYPE_EXCEL,
+            'zip', 'rar', '7z', 'tar', 'gz', 'bz2' => self::TYPE_ARCHIVE,
+            'pdf', 'doc', 'docx', 'ppt', 'pptx', 'txt', 'md' => self::TYPE_DOCUMENT,
+            default => self::TYPE_OTHER,
+        };
+    }
 }