重构学员证书签发与批量导入流程

backend/app/schemas/certificate.py

@@ -4,7 +4,8 @@ from pydantic import BaseModel, Field, ValidationInfo, field_validator
 
 
 class CertificateCreate(BaseModel):
-    learner_id: int
+    learner_name: str = Field(min_length=1, max_length=64)
+    learner_phone: str = Field(min_length=6, max_length=32)
     project_code: str = Field(min_length=2, max_length=16)
     certificate_name: str | None = Field(default=None, max_length=128)
     class_name: str | None = Field(default=None, max_length=128)
@@ -21,6 +22,11 @@ class CertificateCreate(BaseModel):
     def normalize_project_code(cls, value: str) -> str:
         return value.strip().upper()
 
+    @field_validator("learner_name", "learner_phone")
+    @classmethod
+    def strip_identity(cls, value: str) -> str:
+        return value.strip()
+
     @field_validator("course_end_date")
     @classmethod
     def validate_course_period(cls, value: date, info: ValidationInfo) -> date:
@@ -34,6 +40,7 @@ class CertificateOut(BaseModel):
     id: int
     learner_id: int
     learner_name: str | None = None
+    learner_phone: str | None = None
     import_batch_id: int | None = None
     project_code: str
     certificate_no: str