新增多证书模板管理流程

backend/app/services/certificate_templates.py

@@ -0,0 +1,61 @@
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass(frozen=True)
+class CertificateTemplateDefinition:
+    code: str
+    name: str
+    description: str
+    asset_filename: str
+    dynamic_fields: tuple[str, ...]
+    status: str = "active"
+
+    @property
+    def asset_path(self) -> Path:
+        return Path(__file__).resolve().parents[1] / "assets" / self.asset_filename
+
+    def to_dict(self) -> dict[str, object]:
+        return {
+            "code": self.code,
+            "name": self.name,
+            "description": self.description,
+            "dynamic_fields": list(self.dynamic_fields),
+            "preview_url": f"/api/admin/certificate-templates/{self.code}/preview",
+            "status": self.status,
+        }
+
+
+CLASSIC_TEMPLATE_CODE = "classic"
+PRACTICE_CAMP_TEMPLATE_CODE = "practice-camp"
+
+CERTIFICATE_TEMPLATES = {
+    CLASSIC_TEMPLATE_CODE: CertificateTemplateDefinition(
+        code=CLASSIC_TEMPLATE_CODE,
+        name="经典结业证书",
+        description="通用课程结业证书，正文包含课程名称、阶段、课程时间和发证日期。",
+        asset_filename="certificate-template.png",
+        dynamic_fields=("姓名", "课程名称", "阶段名称", "课程开始日期", "课程结束日期", "发证日期"),
+    ),
+    PRACTICE_CAMP_TEMPLATE_CODE: CertificateTemplateDefinition(
+        code=PRACTICE_CAMP_TEMPLATE_CODE,
+        name="实修大本营结业证书",
+        description="人本智慧五个月线上实修大本营专用版，只填写姓名、课程开始日期、课程结束日期和发证日期。",
+        asset_filename="certificate-template-practice-camp.png",
+        dynamic_fields=("姓名", "课程开始日期", "课程结束日期", "发证日期"),
+    ),
+}
+
+
+def list_certificate_templates() -> list[CertificateTemplateDefinition]:
+    return list(CERTIFICATE_TEMPLATES.values())
+
+
+def get_certificate_template(code: str | None) -> CertificateTemplateDefinition:
+    normalized_code = (code or CLASSIC_TEMPLATE_CODE).strip().lower()
+    template = CERTIFICATE_TEMPLATES.get(normalized_code)
+    if not template or template.status != "active":
+        raise ValueError(f"未知或已停用的证书模板：{normalized_code}")
+    if not template.asset_path.exists():
+        raise FileNotFoundError(f"证书模板图片不存在：{template.asset_filename}")
+    return template