1

2026-08-10 16:29:26 +08:00
parent e364c46ce4
commit d1e8eb7316
18 changed files with 1335 additions and 819 deletions
@@ -81,3 +81,55 @@ class InvoiceOut(BaseModel):
    created_at: NaiveDatetimeOptional = None
    updated_at: NaiveDatetimeOptional = None
    orders: list[InvoiceOrderOut] = []
+
+
+# ── 发票抬头 ──────────────────────────────────────────────
+
+class InvoiceHeaderCreate(BaseModel):
+    """创建发票抬头请求。"""
+    type: str = Field(..., pattern="^(personal|company)$", description="抬头类型")
+    name: str = Field(..., min_length=1, max_length=128, description="抬头名称")
+    tax_no: str | None = Field(None, max_length=32, description="税号")
+    register_address: str | None = Field(None, max_length=256, description="注册地址")
+    register_phone: str | None = Field(None, max_length=32, description="注册电话")
+    bank_name: str | None = Field(None, max_length=128, description="开户行")
+    bank_account: str | None = Field(None, max_length=64, description="银行账号")
+    email: str | None = Field(None, max_length=128, description="接收邮箱")
+    is_default: bool = Field(False, description="是否设为默认")
+
+    @model_validator(mode="after")
+    def validate_company_fields(self) -> "InvoiceHeaderCreate":
+        if self.type == "company" and not self.tax_no:
+            raise ValueError("企业抬头必须填写税号")
+        return self
+
+
+class InvoiceHeaderUpdate(BaseModel):
+    """更新发票抬头请求。"""
+    name: str | None = Field(None, min_length=1, max_length=128, description="抬头名称")
+    tax_no: str | None = Field(None, max_length=32, description="税号")
+    register_address: str | None = Field(None, max_length=256, description="注册地址")
+    register_phone: str | None = Field(None, max_length=32, description="注册电话")
+    bank_name: str | None = Field(None, max_length=128, description="开户行")
+    bank_account: str | None = Field(None, max_length=64, description="银行账号")
+    email: str | None = Field(None, max_length=128, description="接收邮箱")
+    is_default: bool | None = Field(None, description="是否设为默认")
+
+
+class InvoiceHeaderOut(BaseModel):
+    """发票抬头响应体。"""
+    model_config = {"from_attributes": True}
+
+    id: str
+    user_id: str
+    type: str
+    name: str
+    tax_no: str | None = None
+    register_address: str | None = None
+    register_phone: str | None = None
+    bank_name: str | None = None
+    bank_account: str | None = None
+    email: str | None = None
+    is_default: bool = False
+    created_at: NaiveDatetimeOptional = None
+    updated_at: NaiveDatetimeOptional = None