"""
批量填充任务与填充记录模型

本模块定义 BatchFillTask (批量填充任务) 和 FillRecord (填充记录) 数据模型,
用于记录外部模板的填充操作历史.

Requirements: 14.6, 15.2, 15.4, 16.5, 18.1, 18.2
"""

from __future__ import annotations

import logging
from typing import ClassVar

from django.db import models
from django.utils.translation import gettext_lazy as _

from .external_template import ExternalTemplate

logger: logging.Logger = logging.getLogger(__name__)


class BatchFillTask(models.Model):
    """
    批量填充任务

    记录一次批量填充操作的元数据, 包含案件、选择的模板列表、
    操作者、时间、ZIP 文件路径和汇总报告.

    Requirements: 14.6, 16.5
    """

    id: int
    case = models.ForeignKey(
        "cases.Case",
        on_delete=models.CASCADE,
        verbose_name=_("关联案件"),
        help_text=_("批量填充关联的案件"),
    )
    templates = models.ManyToManyField(
        ExternalTemplate,
        verbose_name=_("选择的模板"),
        help_text=_("本次批量填充选择的外部模板"),
    )
    initiated_by = models.ForeignKey(
        "organization.Lawyer",
        on_delete=models.SET_NULL,
        null=True,
        verbose_name=_("操作者"),
        related_name="initiated_batch_fill_tasks",
    )
    started_at = models.DateTimeField(
        auto_now_add=True,
        verbose_name=_("发起时间"),
    )
    finished_at = models.DateTimeField(
        null=True,
        blank=True,
        verbose_name=_("完成时间"),
    )
    zip_file_path = models.CharField(
        max_length=500,
        blank=True,
        default="",
        verbose_name=_("ZIP文件路径"),
        help_text=_("批量填充生成的 ZIP 压缩包路径"),
    )
    summary_json = models.JSONField(
        default=dict,
        blank=True,
        verbose_name=_("汇总报告"),
        help_text=_("批量填充的汇总报告 JSON"),
    )

    class Meta:
        app_label = "documents"
        verbose_name = _("批量填充任务")
        verbose_name_plural = _("批量填充任务")
        ordering: ClassVar = ["-started_at"]

    def __str__(self) -> str:
        return f"BatchFillTask #{self.id}"


class FillRecord(models.Model):
    """
    填充记录

    记录单次填充操作的历史, 包含案件、模板、当事人、操作者、
    时间、生成文件路径、填充报告和自定义填充值.

    Requirements: 15.2, 15.4, 18.1, 18.2
    """

    id: int
    batch_task = models.ForeignKey(
        BatchFillTask,
        on_delete=models.CASCADE,
        null=True,
        blank=True,
        related_name="records",
        verbose_name=_("批量任务"),
        help_text=_("所属的批量填充任务, 单次填充时为空"),
    )
    case = models.ForeignKey(
        "cases.Case",
        on_delete=models.CASCADE,
        verbose_name=_("关联案件"),
    )
    template = models.ForeignKey(
        ExternalTemplate,
        on_delete=models.CASCADE,
        verbose_name=_("关联模板"),
    )
    party = models.ForeignKey(
        "cases.CaseParty",
        on_delete=models.SET_NULL,
        null=True,
        blank=True,
        verbose_name=_("关联当事人"),
    )
    filled_by = models.ForeignKey(
        "organization.Lawyer",
        on_delete=models.SET_NULL,
        null=True,
        verbose_name=_("操作者"),
        related_name="fill_records",
    )
    filled_at = models.DateTimeField(
        auto_now_add=True,
        verbose_name=_("填充时间"),
    )
    file_path = models.CharField(
        max_length=500,
        verbose_name=_("生成文件路径"),
        help_text=_("填充生成的文件相对于 MEDIA_ROOT 的路径"),
    )
    original_output_name = models.CharField(
        max_length=255,
        verbose_name=_("输出文件名"),
        help_text=_("填充生成的文件原始名称"),
    )
    report_json = models.JSONField(
        default=dict,
        blank=True,
        verbose_name=_("填充报告"),
        help_text=_("填充操作的详细报告 JSON"),
    )
    custom_values = models.JSONField(
        default=dict,
        blank=True,
        verbose_name=_("自定义填充值"),
        help_text=_("用户手动输入的自定义字段值"),
    )
    file_available = models.BooleanField(
        default=True,
        verbose_name=_("文件是否可用"),
        help_text=_("生成的文件是否仍然可访问"),
    )

    class Meta:
        app_label = "documents"
        verbose_name = _("填充记录")
        verbose_name_plural = _("填充记录")
        ordering: ClassVar = ["-filled_at"]
        indexes: ClassVar = [
            models.Index(fields=["case", "-filled_at"]),
            models.Index(fields=["template", "-filled_at"]),
        ]

    def __str__(self) -> str:
        return f"FillRecord #{self.id}"