"""
Хранилище файлов: акты ремонта и, дальше, документы по процессам.

Почему не в базе. Файлы копятся годами. Внутри базы каждый из них уезжал бы
в каждую резервную копию, и дамп вырос бы с сотен мегабайт до десятков
гигабайт. Поэтому в базе — только сведения о файле (имя, тип, размер,
контрольная сумма), а сам файл лежит в папке.

Где папка:
  1. переменная окружения `FILES_DIR`, если задана — так её назначит сервер;
  2. иначе `%LOCALAPPDATA%\\ooucr\\files` — рядом с каталогом базы и
     резервными копиями, то есть вне папки приложения: обновление меняет код
     и папку не трогает;
  3. иначе `files` рядом с приложением.

Имя на диске своё, а не то, под которым файл прислали: присланное имя может
быть чем угодно, включая `..\\..\\` и повторы. Раскладка по годам и месяцам —
чтобы в одной папке не лежали десятки тысяч файлов.

Тип определяется по содержимому, а не по расширению: переименованный .exe
не должен стать «фотографией акта».
"""

from __future__ import annotations

import hashlib
import os
import pathlib
import uuid
from dataclasses import dataclass
from datetime import date

#  20 МБ: фото с телефона весит 3–8 МБ, многостраничный скан в PDF — до 15.
#  Больше — почти наверняка не тот файл
MAX_BYTES = 20 * 1024 * 1024

EXTENSION = {
    "image/jpeg": ".jpg",
    "image/png": ".png",
    "image/webp": ".webp",
    "application/pdf": ".pdf",
}

KIND_RU = {
    "image/jpeg": "фото",
    "image/png": "изображение",
    "image/webp": "изображение",
    "application/pdf": "PDF",
}


class FileRejected(ValueError):
    """Файл не принят: пустой, слишком большой или не того типа."""


@dataclass
class Stored:
    stored_name: str
    mime_type: str
    size_bytes: int
    sha256: str


def root() -> pathlib.Path:
    env = os.environ.get("FILES_DIR")
    if env:
        return pathlib.Path(env)
    local = os.environ.get("LOCALAPPDATA")
    if local:
        return pathlib.Path(local) / "ooucr" / "files"
    return pathlib.Path(__file__).resolve().parents[2] / "files"


def sniff(data: bytes) -> str | None:
    """Тип файла по первым байтам. None — не фото и не PDF."""
    if data[:3] == b"\xff\xd8\xff":
        return "image/jpeg"
    if data[:8] == b"\x89PNG\r\n\x1a\n":
        return "image/png"
    if data[:4] == b"RIFF" and data[8:12] == b"WEBP":
        return "image/webp"
    if data[:5] == b"%PDF-":
        return "application/pdf"
    return None


def save(data: bytes, area: str, when: date | None = None) -> Stored:
    """
    Проверить и записать файл. Возвращает то, что нужно положить в базу.

    `area` — раздел хранилища (`repair`), чтобы акты не смешивались с
    будущими документами других процессов.
    """
    if not data:
        raise FileRejected("Файл пустой")
    if len(data) > MAX_BYTES:
        raise FileRejected(
            f"Файл больше {MAX_BYTES // (1024 * 1024)} МБ. Если это фото, "
            f"уменьшите его; если скан — разбейте на части")
    mime = sniff(data)
    if mime is None:
        raise FileRejected(
            "Принимаются фото (JPEG, PNG, WEBP) и PDF. Этот файл ни тем, ни "
            "другим не является")

    day = when or date.today()
    stored = f"{area}/{day:%Y}/{day:%m}/{uuid.uuid4().hex}{EXTENSION[mime]}"
    path = root() / stored
    path.parent.mkdir(parents=True, exist_ok=True)
    #  Пишем во временный файл и переименовываем: оборванная запись не должна
    #  оставить на месте акта половину файла
    tmp = path.with_suffix(path.suffix + ".part")
    tmp.write_bytes(data)
    tmp.replace(path)
    return Stored(stored, mime, len(data), hashlib.sha256(data).hexdigest())


def path_of(stored_name: str) -> pathlib.Path:
    """
    Путь к файлу на диске. Имя приходит из базы, но проверяем и его: путь
    обязан остаться внутри хранилища.
    """
    base = root().resolve()
    path = (base / stored_name).resolve()
    if base not in path.parents:
        raise FileRejected("Неверное имя файла в хранилище")
    return path


def remove(stored_name: str) -> None:
    """Удалить файл. Если его уже нет — не ошибка: цель достигнута."""
    try:
        path_of(stored_name).unlink(missing_ok=True)
    except FileRejected:
        pass
