Files
certificate-system/backend/app/services/certificate_templates.py
2026-08-13 18:06:05 +08:00

62 lines
2.3 KiB
Python

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