refactor(media): unify media identity and chain responsibilities

2026-09-06 16:07:01 +08:00 · 2026-08-12 18:31:09 +08:00
parent cbb969e0ff
commit ca32922a7f
155 changed files with 8371 additions and 4526 deletions
@@ -0,0 +1,38 @@
+from pydantic import model_validator
+
+
+class OptionalMediaIdentityMixin:
+    """为可选媒体身份模型统一校验来源枚举与原生 ID 的成对约束。"""
+
+    @model_validator(mode="after")
+    def _validate_optional_media_identity(self):
+        """规范化 ID，并拒绝显式半对、空白或零值身份。"""
+        source_provided = "media_source" in self.model_fields_set
+        id_provided = "media_id" in self.model_fields_set
+        if source_provided != id_provided:
+            raise ValueError("media_source 和 media_id 必须同时提供")
+        normalized_id = (
+            str(self.media_id).strip()
+            if self.media_id is not None
+            else None
+        )
+        if bool(self.media_source) != bool(normalized_id):
+            raise ValueError("media_source 和 media_id 必须同时提供")
+        if normalized_id == "0":
+            raise ValueError("media_id 不能为 0")
+        # 校验器内部的规范化不能伪装成请求显式提交字段，否则 PATCH 会误清空存量身份。
+        object.__setattr__(self, "media_id", normalized_id)
+        return self
+
+
+class RequiredMediaIdentityMixin:
+    """为必填媒体身份模型统一校验来源枚举与原生 ID。"""
+
+    @model_validator(mode="after")
+    def _validate_required_media_identity(self):
+        """去除 ID 两端空白，并拒绝空白或零值身份。"""
+        normalized_id = str(self.media_id).strip()
+        if not normalized_id or normalized_id == "0":
+            raise ValueError("media_id 必须是非零的来源原生 ID")
+        self.media_id = normalized_id
+        return self