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

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

backend/app/schemas/certificate_template.py

@@ -1,10 +1,20 @@
 from pydantic import BaseModel
 
 
+class CertificateTemplateFieldOut(BaseModel):
+    key: str
+    label: str
+    field_type: str
+    required: bool
+    example: str
+    description: str
+
+
 class CertificateTemplateOut(BaseModel):
     code: str
     name: str
     description: str
     dynamic_fields: list[str]
+    fields: list[CertificateTemplateFieldOut]
     preview_url: str
     status: str

backend/app/schemas/learner.py

@@ -25,7 +25,22 @@ class LearnerOut(BaseModel):
     student_no: str | None
     status: str
     remark: str | None
+    certificate_count: int = 0
     created_at: datetime
     updated_at: datetime
 
     model_config = {"from_attributes": True}
+
+
+class LearnerImportError(BaseModel):
+    row_no: int
+    message: str
+
+
+class LearnerImportResult(BaseModel):
+    total_rows: int
+    created_rows: int
+    updated_rows: int
+    unchanged_rows: int
+    failed_rows: int
+    errors: list[LearnerImportError]