"""Templates (single editable draft) and immutable published versions (TZ 2.2.4-2.2.5).

App label is ``doctemplates`` (``templates`` collides with Django template directories); tables keep
the TZ names ``templates`` / ``template_versions``.
"""

from __future__ import annotations

from typing import Any

from django.db import models
from django.utils import timezone

from snapfile.core.fields import UUIDv7Field
from snapfile.projects.models import Project

DEFAULT_OUTPUT = {"format": "pdf", "dpi": 150, "raster": "png", "split": "per_sheet", "quality": 85, "pdfa": False}


class Template(models.Model):
    id = UUIDv7Field(primary_key=True)
    project = models.ForeignKey(Project, on_delete=models.CASCADE, related_name="templates")
    key = models.CharField(max_length=64)
    name = models.CharField(max_length=255)
    description = models.TextField(null=True, blank=True)
    language = models.CharField(max_length=16, null=True, blank=True)
    # API group: /templates/{group_key}/render picks the group's default template for the requested language
    group_key = models.CharField(max_length=64, null=True, blank=True, db_index=True)
    is_default = models.BooleanField(default=False)
    variant_of = models.ForeignKey("self", null=True, blank=True, on_delete=models.SET_NULL, related_name="variants")
    # [{"id": external user id, "name": snapshot}]; empty = everyone in the project.
    allowed_users = models.JSONField(default=list, blank=True)
    tags = models.JSONField(null=True, blank=True)
    draft_document = models.JSONField()
    draft_revision = models.PositiveIntegerField(default=1)
    draft_hash = models.CharField(max_length=64)
    current_version = models.ForeignKey(
        "TemplateVersion", null=True, blank=True, on_delete=models.SET_NULL, related_name="+"
    )
    output_defaults = models.JSONField(default=dict)
    variables_override = models.JSONField(null=True, blank=True)
    sample_data = models.JSONField(null=True, blank=True)
    # Additional named test data sets of the editor: [{"id", "name", "data"}]; ``sample_data`` stays the
    # primary set (publish check, preview default, public A5).
    test_data_sets = models.JSONField(null=True, blank=True)
    thumbnail_path = models.CharField(max_length=512, null=True, blank=True)
    locked_by = models.JSONField(null=True, blank=True)
    locked_until = models.DateTimeField(null=True, blank=True)
    created_by = models.JSONField(null=True, blank=True)
    updated_by = models.JSONField(null=True, blank=True)
    created_at = models.DateTimeField(default=timezone.now)
    updated_at = models.DateTimeField(auto_now=True)
    archived_at = models.DateTimeField(null=True, blank=True)
    deleted_at = models.DateTimeField(null=True, blank=True)

    class Meta:
        db_table = "templates"
        constraints = [models.UniqueConstraint(fields=["project", "key"], name="templates_project_key")]
        indexes = [models.Index(fields=["project", "id"], name="templates_project_id")]

    def __str__(self) -> str:
        return f"{self.key} ({self.name})"


class ImmutableVersionError(RuntimeError):
    pass


class TemplateVersion(models.Model):
    MUTABLE_FIELDS = frozenset({"plan_status", "plan_ref", "plan_hash", "status"})

    id = UUIDv7Field(primary_key=True)
    template = models.ForeignKey(Template, on_delete=models.CASCADE, related_name="versions")
    project = models.ForeignKey(Project, on_delete=models.CASCADE, related_name="+")
    number = models.PositiveIntegerField()
    status = models.CharField(max_length=16, default="published")
    document = models.JSONField()
    document_hash = models.CharField(max_length=64)
    schema_snapshot = models.JSONField(default=list)
    json_schema = models.JSONField(default=dict)
    format_version = models.PositiveSmallIntegerField(default=1)
    engine_version = models.CharField(max_length=16)
    plan_status = models.CharField(max_length=16, default="pending")
    plan_ref = models.CharField(max_length=512, null=True, blank=True)
    plan_hash = models.CharField(max_length=64, null=True, blank=True)
    dependencies = models.JSONField(default=dict)
    comment = models.TextField(null=True, blank=True)
    published_by = models.JSONField(default=dict)
    published_at = models.DateTimeField(default=timezone.now)
    created_at = models.DateTimeField(default=timezone.now)

    class Meta:
        db_table = "template_versions"
        constraints = [models.UniqueConstraint(fields=["template", "number"], name="versions_template_number")]

    def save(self, *args: Any, **kwargs: Any) -> None:
        """Published versions are immutable except ``plan_*`` and ``status`` (TZ 2.1.3)."""
        if not self._state.adding:
            fields = kwargs.get("update_fields")
            if fields is None or not set(fields) <= self.MUTABLE_FIELDS:
                raise ImmutableVersionError("Published template versions are immutable")
        super().save(*args, **kwargs)
