sharix-open-backend/models/documents.py

import re
import os

from django.db import models
from django.urls import reverse
from django.contrib.auth import get_user_model
from django.contrib.contenttypes.models import ContentType

from dbsynce.models.company import Company
from tickets.models import Ticket


class Documents(models.Model):
    """
    Documents - это одна таблица со всеми документами.
    Вообще в концепции предполагалось, что таких таблиц должно быть много под каждый тип для удобства поиска. 
    То есть отдельно таблица с паспортами, отдельно с правами, отдельно с какими-нибудь разрешениями и так далее. 
    Что пока непонятно - документов может быть много разных.
    """
    DOC_TYPES = [
        ("01", "Паспорт"),
        ("02", "ИНН"),
        ("03", "СНИЛС"),
        ("04", "Cвидетельство о регистрации компании"),
        ("05", "Cистема налогообложения"),
        ("06", "Доверенность / Приказ"),
        ("07", "Права / Лицензия"),
        ("08", "Документ, подтверждающий собственность"),
        ("09", "Документ об образовании"),
        ("10", "Медицинская книжка"),
        ("11", "Cправка об отсутствии судимости"),
        ("12", "Договор (в том числе о трудоустройстве)"),
        ("13", "Фотография"),
        ("99", "Иное"),
    ]
    DOC_TYPES_DICT = dict(DOC_TYPES)
    
    # FIXME: id_metaservice должно принимать текущий идентификатор метасервиса, на котором происходит создание записи
    id_metaservice = models.BigIntegerField(default=1, help_text="уникальный идентификатор мета-сервиса, необходимый для синхронизации данных. Если при синхронизации возникает конфликт (несовместимость) с другим сервисом, предлагается или форсировать изменения везде (если возможно), либо is_global выставляется как false.")
    check_date = models.DateTimeField(auto_now_add=True, help_text="timestamp проверки")
    check_level = models.IntegerField(null=True, blank=True, help_text="информация об уровне проверки. Документ может быть проверен как платформой, так и мета-сервисом, так и партнером мета-сервиса, а может быть и никем (просто загружен). Указывается, так как достоверность проверки разная. Документ, проверенный только на низком уровне, не принимается во внимание как имеющийся до прохождения более высокоуровневой проверки. Информацию об уровнях проверки можно посмотреть по словарю Requirements. В данной таблице хранится информация о наиболее высоком уровне проверки.")
    expire_date = models.DateField(null=True, blank=True, help_text="срок окончания действия документа.")
    # FIXME: requirements должно иметь другое значение поумолчанию
    requirements = models.CharField(max_length=150, default="fixme")
    # FIXME: status должен иметь другое значение поумолчанию
    status = models.CharField(max_length=150, default="deactivated", help_text="активность на основе системы заявок")
    ticket_status = models.ForeignKey(Ticket, null=True, blank=True, on_delete=models.SET_NULL, help_text="id последнего актуального тикета, касающийся статуса. Если он меняет статус на закрытый - вызывается проверка, которая смотрит, нет ли другого открытого по пользователю.")
    doc_type = models.CharField(max_length=2, choices=DOC_TYPES, help_text="тип документа (паспорт/паспорт 1 страница и т д) в соответствии с классификатором типов документов (см описание в Requirements)")
    user_id = models.ForeignKey(get_user_model(), related_name="user_id_doc", on_delete=models.DO_NOTHING, help_text="уникальный идентификатор пользователя (конкретного клиентского аккаунта) являющегося владельцем данного документа")
    company_id = models.ForeignKey(Company, on_delete=models.DO_NOTHING, null=True, help_text="идентификатор компании, к которой относится документ, если таковая есть (может не быть)")
    is_global = models.BooleanField(default=False, help_text="доступны ли документы для хранения в глобальном сервисе/нужна синхронизация")
    is_visible = models.BooleanField(default=False, help_text="доступна ли информация о наличии документов для планирования в цепочке с другими услугами в глобальном сервисе")
    checked_by = models.ForeignKey(get_user_model(), null=True, blank=True, related_name="checked_by_doc", on_delete=models.DO_NOTHING, help_text="userid проверившего")

    @staticmethod
    def parse_requirements(requirements: str):
        """
        Метод позволяет разобрать строку requirements в удобочитаемый вид.
        """
        return sorted(set(re.findall(r'\d{2}', requirements)))

    def get_admin_url(self):
        """
        Возвращает URL-адрес текущего объекта в административной панели Django.

        Returns:
            str: URL-адрес текущего объекта в административной панели Django
        """
        content_type = ContentType.objects.get_for_model(self.__class__)
        return reverse("admin:%s_%s_change" % (content_type.app_label, content_type.model), args=(self.id,))

    class Meta:
        db_table = "documents"
        verbose_name = "Документ"
        verbose_name_plural = "Документы"


class DocumentFile(models.Model):
    document = models.ForeignKey(Documents, related_name='files', on_delete=models.CASCADE)
    file = models.FileField(upload_to=f'uploads/partners_docs/')

    def __str__(self):
        return os.path.basename(self.file.name)