| """案件模板绑定 API |
| |
| 管理案件与文书模板的绑定关系. |
| """ |
|
|
| from __future__ import annotations |
|
|
| from typing import Any |
| from urllib.parse import quote |
|
|
| from django.http import HttpRequest, HttpResponse |
| from ninja import Router |
|
|
| from apps.cases.schemas import UnifiedGenerateRequest |
| from apps.cases.schemas.template_binding_schemas import ( |
| AvailableTemplateSchema, |
| BindingsResponseSchema, |
| BindTemplateRequestSchema, |
| GenerateTemplateRequestSchema, |
| SuccessResponseSchema, |
| TemplateBindingSchema, |
| ) |
|
|
| router = Router() |
|
|
|
|
| |
|
|
|
|
| def _get_binding_service() -> Any: |
| """工厂函数:获取案件模板绑定服务""" |
| from apps.cases.services.template.wiring import get_case_template_binding_service |
|
|
| return get_case_template_binding_service() |
|
|
|
|
| def _get_generation_service() -> Any: |
| """工厂函数:获取案件模板生成服务""" |
| from apps.cases.services import CaseTemplateGenerationService |
|
|
| return CaseTemplateGenerationService() |
|
|
|
|
| def _get_unified_template_generation_service() -> Any: |
| """工厂函数:获取统一模板生成服务""" |
| from apps.cases.services import UnifiedTemplateGenerationService |
|
|
| return UnifiedTemplateGenerationService() |
|
|
|
|
| |
|
|
|
|
| @router.get("/{case_id}/template-bindings", response=BindingsResponseSchema) |
| def get_case_template_bindings(request: HttpRequest, case_id: int) -> Any: |
| """ |
| 获取案件绑定的模板列表 |
| |
| 按模板分类(case_sub_type)分组返回. |
| """ |
| service = _get_binding_service() |
| return service.get_bindings_for_case(case_id) |
|
|
|
|
| @router.post("/{case_id}/template-bindings", response=TemplateBindingSchema) |
| def bind_template_to_case(request: HttpRequest, case_id: int, payload: BindTemplateRequestSchema) -> Any: |
| """ |
| 绑定模板到案件 |
| |
| 创建手动绑定记录(binding_source='manual_bound'). |
| """ |
| service = _get_binding_service() |
| return service.bind_template(case_id, payload.template_id) |
|
|
|
|
| @router.delete("/{case_id}/template-bindings/{binding_id}", response=SuccessResponseSchema) |
| def unbind_template_from_case(request: HttpRequest, case_id: int, binding_id: int) -> dict[str, bool]: |
| """ |
| 解绑模板 |
| |
| 删除指定的绑定记录. |
| """ |
| service = _get_binding_service() |
| service.unbind_template(case_id, binding_id) |
| return {"success": True} |
|
|
|
|
| @router.get("/{case_id}/available-templates", response=list[AvailableTemplateSchema]) |
| def get_available_templates(request: HttpRequest, case_id: int) -> Any: |
| """ |
| 获取可绑定的模板列表 |
| |
| 返回所有活跃的案件模板,排除已绑定的模板. |
| """ |
| service = _get_binding_service() |
| return service.get_available_templates(case_id) |
|
|
|
|
| @router.post("/{case_id}/generate-template") |
| def generate_template_document( |
| request: HttpRequest, case_id: int, payload: GenerateTemplateRequestSchema |
| ) -> HttpResponse: |
| """ |
| 生成模板文档并返回文件流 |
| |
| case_id: 案件ID |
| payload.template_id: 模板ID |
| payload.client_id: 当事人ID(可选,用于法定代表人身份证明书、单独授权) |
| payload.client_ids: 当事人ID列表(可选,用于合并授权) |
| payload.mode: 授权模式(可选): 'individual' | 'combined' |
| |
| HttpResponse: docx 文件流 |
| |
| Requirements: 2.1, 2.2, 2.3, 2.4, 6.2, 6.3, 7.2, 7.3, 7.4 |
| """ |
| service = _get_generation_service() |
| content, filename = service.generate_document( |
| case_id=case_id, |
| template_id=payload.template_id, |
| client_id=payload.client_id, |
| client_ids=payload.client_ids, |
| mode=payload.mode, |
| ) |
|
|
| response = HttpResponse( |
| content, content_type="application/vnd.openxmlformats-officedocument.wordprocessingml.document" |
| ) |
| |
| response["Content-Disposition"] = f"attachment; filename*=UTF-8''{filename}" |
| return response |
|
|
|
|
| |
|
|
|
|
| def _build_file_response(content: bytes, filename: str) -> HttpResponse: |
| """ |
| 构建文件下载响应 |
| |
| content: 文件字节流 |
| filename: 文件名 |
| |
| HttpResponse: 文件下载响应 |
| """ |
| response = HttpResponse( |
| content, content_type="application/vnd.openxmlformats-officedocument.wordprocessingml.document" |
| ) |
| |
| encoded_filename = quote(filename) |
| response["Content-Disposition"] = f"attachment; filename*=UTF-8''{encoded_filename}" |
| return response |
|
|
|
|
| |
|
|
|
|
| @router.post("/{case_id}/unified-generate") |
| def unified_generate_template(request: HttpRequest, case_id: int, payload: UnifiedGenerateRequest) -> HttpResponse: |
| """ |
| 统一模板生成 API(新端点) |
| |
| 支持通过 template_id 或 function_code 生成文档. |
| |
| case_id: 案件ID |
| payload.template_id: 模板ID(可选,优先使用) |
| payload.function_code: 功能标识(可选,当 template_id 为空时使用) |
| payload.client_id: 当事人ID(可选,用于法定代表人身份证明书、单独授权) |
| payload.client_ids: 当事人ID列表(可选,用于合并授权) |
| payload.mode: 授权模式(可选): 'individual' | 'combined' |
| |
| HttpResponse: docx 文件流 |
| |
| Requirements: 1.5 |
| """ |
| service = _get_unified_template_generation_service() |
| content, filename = service.generate_document( |
| case_id=case_id, |
| template_id=payload.template_id, |
| function_code=payload.function_code, |
| client_id=payload.client_id, |
| client_ids=payload.client_ids, |
| mode=payload.mode, |
| ) |
| return _build_file_response(content, filename) |
|
|
