Corp/docs/reports/DOCUMENTS_REPLACEMENT_ANALYSIS.md

Анализ замены приложения documents готовыми решениями

Дата: 28 февраля 2026
Статус: 🔍 Анализ завершен
Ветка: develop (после мерджа feature/django-rules)

---

Текущий функционал documents

Модели:

1. Document (88 строк в models.py):

   • title, file, description
   • uploaded_by (кто загрузил)
   • sent_to_all (разослать всем)
   • departments (M2M - отделы-получатели)
   • recipients (M2M - конкретные получатели)

2. DocumentAcknowledgement:

   • document, user, acknowledged_at
   • Уникальность: (document, user)
   • Трекинг ознакомления с документами

Функционал:

• ✅ Загрузка файлов (FileField)
• ✅ Рассылка по отделам/сотрудникам
• ✅ Трекинг ознакомления (acknowledged)
• ✅ Уведомления (notification_signals.py)
• ✅ Django Admin с inline ознакомлений
• ✅ API для работы с документами (views.py ~436 строк)
• ✅ Права доступа через django-rules (rules.py)
• ✅ Celery tasks для фоновой обработки

Размер кастомного кода:

models.py:              88 строк
views.py:              436 строк  
admin.py:              131 строк
rules.py:              296 строк
notification_signals:   ~50 строк
tasks.py:              178 строк (закомментированы)
─────────────────────────────────
ИТОГО:                ~1180 строк

---

Доступные Django пакеты

1. django-filer ⭐⭐⭐⭐⭐

GitHub: https://github.com/django-cms/django-filer
Звёзды: 1.8k ⭐
Статус: Активно развивается
Последний релиз: 2024

Возможности:

• ✅ Мощная система управления файлами/папками
• ✅ Thumbnails для изображений
• ✅ ACL (Access Control List) на уровне файлов/папок
• ✅ Групповые права доступа
• ✅ Drag & drop загрузка
• ✅ Поиск по файлам
• ✅ Интеграция с Django Admin
• ✅ REST API (django-filer-rest)

Что ОТСУТСТВУЕТ:

• ❌ Рассылка документов по отделам/пользователям
• ❌ Трекинг ознакомления
• ❌ Интеграция с корпоративной структурой
• ❌ Уведомления о новых документах

Установка:

pip install django-filer
pip install easy-thumbnails  # зависимость

Оценка покрытия: 60%

Покрывает хранение, права доступа, админку. НЕ покрывает рассылку и ознакомление.

---

2. Django Reversion ⭐⭐⭐⭐

GitHub: https://github.com/etianen/django-reversion
Звёзды: 3.1k ⭐
Статус: Активно развивается
Последний релиз: 2024

Возможности:

• ✅ Версионирование любых моделей
• ✅ История изменений
• ✅ Откат к предыдущим версиям
• ✅ Интеграция с Django Admin
• ✅ Сравнение версий

Применимость:

Не замена documents, но полезное дополнение для версионирования документов.

Установка:

pip install django-reversion

Оценка покрытия: 15% (только версионирование)

---

3. Mayan EDMS 🏢

GitHub: https://github.com/mayan-edms/Mayan-EDMS
Звёзды: 2.3k ⭐
Статус: Enterprise-ready DMS
Последний релиз: 2024

Возможности:

• ✅ Полноценная система электронного документооборота
• ✅ OCR (распознавание текста)
• ✅ Workflow для согласования
• ✅ Метаданные документов
• ✅ Тегирование и категоризация
• ✅ Поиск по содержимому
• ✅ Права доступа
• ✅ REST API
• ✅ Интеграция с LDAP/AD

Недостатки:

• ⚠️ Отдельное приложение на Django (не библиотека)
• ⚠️ Сложность интеграции в существующий проект
• ⚠️ Требует PostgreSQL, Redis, Elasticsearch
• ⚠️ Heavyweight решение

Оценка покрытия: 95%, но НЕ библиотека

---

4. django-documents ⚠️

GitHub: https://github.com/stefanfoulis/django-documents
Звёзды: ~50 ⭐
Статус: ⚠️ Заброшен (последний коммит 2015)

Вердикт: НЕ РЕКОМЕНДУЕТСЯ (устарел)

---

5. django-file-manager

GitHub: Несколько реализаций, все мелкие
Статус: ⚠️ Нет зрелого решения

Вердикт: НЕ РЕКОМЕНДУЕТСЯ

---

6. django-wiki ⭐⭐⭐

GitHub: https://github.com/django-wiki/django-wiki
Звёзды: 1.8k ⭐
Статус: Активно развивается

Возможности:

• ✅ Управление статьями/документами
• ✅ Markdown редактор
• ✅ Версионирование
• ✅ Права доступа
• ✅ Attachments (вложения)
• ✅ Поиск

Недостатки:

• ❌ Заточен под wiki-статьи, не под файловый документооборот
• ❌ Нет рассылки по отделам
• ❌ Нет трекинга ознакомления

Оценка покрытия: 40% (если документы = статьи)

---

7. django-attachments

GitHub: https://github.com/bartTC/django-attachments
Звёзды: ~200 ⭐
Статус: Поддерживается

Возможности:

• ✅ Generic файловые вложения к любым моделям
• ✅ Простое API
• ✅ Права доступа

Недостатки:

• ❌ Слишком простой (нет рассылки, ознакомления)

Оценка покрытия: 25%

---

Рекомендации по замене

Вариант 1: Полная замена на django-filer + кастом (рекомендуется) ⭐

Что заменяется:

• Хранение файлов → django-filer
• Права доступа → django-filer ACL + django-rules
• Версионирование → django-reversion (опционально)

Что остается кастомным:

• Модель DocumentDistribution (кто, кому, когда)
• Модель DocumentAcknowledgement (ознакомление)
• Логика рассылки по отделам
• Уведомления через Celery

Преимущества:

• ✅ Профессиональное хранилище файлов
• ✅ Готовая админка с drag & drop
• ✅ Thumbnails для превью
• ✅ Папки, теги, поиск
• ✅ Сокращение кода на ~600 строк (views, admin для файлов)

Недостатки:

• ⚠️ Нужна миграция данных (Document → filer.File)
• ⚠️ Кастомные модели всё равно нужны (~400 строк)

Оценка трудозатрат: 3-5 дней

Код сокращается с: 1180 строк → ~580 строк (~50%)

---

Вариант 2: Интеграция с Mayan EDMS (для enterprise)

Архитектура:

EUSRR Backend (Django) ← REST API → Mayan EDMS (отдельный сервис)

Что даёт:

• ✅ Полноценная DMS с OCR, Workflow, метаданными
• ✅ Масштабируемость
• ✅ Профессиональный UI для работы с документами

Недостатки:

• ❌ Сложность развертывания (отдельный сервис)
• ❌ Дублирование пользователей (синхронизация)
• ❌ Накладные расходы на интеграцию

Оценка трудозатрат: 2-3 недели

Рекомендуется только если:

• В компании >500 сотрудников
• Документооборот >10000 документов/год
• Нужен OCR и workflow

---

Вариант 3: Оставить как есть + улучшения

Что улучшить в текущем documents:

1. Добавить django-filer только для хранения:

   # Вместо FileField использовать FilerFileField
   from filer.fields.file import FilerFileField
   
   class Document(models.Model):
       file = FilerFileField(on_delete=models.CASCADE)
   

2. Добавить версионирование через django-reversion:

   import reversion
   
   @reversion.register()
   class Document(models.Model):
       ...
   

3. Добавить поиск через django-watson (уже есть в проекте):

   import watson
   
   watson.register(Document, fields=('title', 'description'))
   

4. Улучшить права через django-rules (уже сделано ✅)

5. Добавить preview для файлов:

   pip install django-file-preview
   

Преимущества:

• ✅ Минимальная переработка
• ✅ Постепенная модернизация
• ✅ Сохранение всей логики

Недостатки:

• ❌ Кастомный код остается (~1180 строк)

Оценка трудозатрат: 1-2 дня

---

Сравнительная таблица

Критерий	Текущий documents	django-filer	Mayan EDMS	Вариант 1 (filer+кастом)
Хранение файлов	✅ FileField	⭐⭐⭐⭐⭐ Профессиональное	⭐⭐⭐⭐⭐ Enterprise	⭐⭐⭐⭐⭐ Профессиональное
Рассылка по отделам	✅ Кастом	❌ Нет	⚠️ Сложно	✅ Кастом (~200 строк)
Трекинг ознакомления	✅ Кастом	❌ Нет	⚠️ Через workflow	✅ Кастом (~100 строк)
Права доступа	✅ django-rules	✅ ACL встроен	✅ Встроено	✅ filer ACL + rules
Версионирование	❌ Нет	❌ Нет	✅ Есть	➕ django-reversion
OCR	❌ Нет	❌ Нет	✅ Есть	❌ Нет
Поиск	⚠️ Простой	✅ Есть	⭐⭐⭐⭐⭐ Elasticsearch	✅ django-watson
Admin UI	⚠️ Базовый	⭐⭐⭐⭐⭐ Отличный	⭐⭐⭐⭐⭐ Профессиональный	⭐⭐⭐⭐⭐ Отличный
Код (строк)	1180	0 (библиотека)	0 (сервис)	~580
Сложность интеграции	-	⭐⭐⭐ Средняя	⭐⭐⭐⭐⭐ Высокая	⭐⭐⭐ Средняя
Трудозатраты	-	3-5 дней	2-3 недели	3-5 дней

---

Итоговая рекомендация ⭐

Рекомендуемый подход: Вариант 1 (django-filer + кастом)

План миграции:

Фаза 1: Подготовка (1 день)

pip install django-filer
pip install easy-thumbnails
pip install django-reversion  # опционально

Настройка settings.py:

INSTALLED_APPS = [
    ...
    'easy_thumbnails',
    'filer',
    'mptt',  # зависимость filer
    'reversion',
]

THUMBNAIL_PROCESSORS = (
    'easy_thumbnails.processors.colorspace',
    'easy_thumbnails.processors.autocrop',
    'filer.thumbnail_processors.scale_and_crop_with_subject_location',
    'easy_thumbnails.processors.filters',
)

Фаза 2: Создание новых моделей (1 день)

# documents/models_v2.py
from filer.fields.file import FilerFileField
from django.db import models
import reversion

@reversion.register()
class Document(models.Model):
    """Документ с использованием django-filer"""
    title = models.CharField(max_length=255)
    file = FilerFileField(
        on_delete=models.CASCADE,
        related_name='documents'
    )
    description = models.TextField(blank=True)
    
    # Кастомные поля рассылки
    uploaded_by = models.ForeignKey(User, on_delete=models.SET_NULL, null=True)
    uploaded_at = models.DateTimeField(auto_now_add=True)
    sent_to_all = models.BooleanField(default=True)
    departments = models.ManyToManyField('employees.Department', blank=True)
    recipients = models.ManyToManyField(User, blank=True, related_name='received_documents')


class DocumentAcknowledgement(models.Model):
    """Трекинг ознакомления - остается без изменений"""
    document = models.ForeignKey(Document, on_delete=models.CASCADE)
    user = models.ForeignKey(User, on_delete=models.CASCADE)
    acknowledged_at = models.DateTimeField(auto_now_add=True)
    
    class Meta:
        unique_together = ('document', 'user')

Фаза 3: Миграция данных (1 день)

# documents/management/commands/migrate_to_filer.py
from django.core.management.base import BaseCommand
from documents.models import Document as OldDocument
from documents.models_v2 import Document as NewDocument
from filer.models import File as FilerFile

class Command(BaseCommand):
    def handle(self, *args, **options):
        for old_doc in OldDocument.objects.all():
            # Создаем FilerFile
            filer_file = FilerFile.objects.create(
                file=old_doc.file,
                name=old_doc.title,
                owner=old_doc.uploaded_by
            )
            
            # Создаем новый Document
            new_doc = NewDocument.objects.create(
                title=old_doc.title,
                file=filer_file,
                description=old_doc.description,
                uploaded_by=old_doc.uploaded_by,
                uploaded_at=old_doc.uploaded_at,
                sent_to_all=old_doc.sent_to_all
            )
            
            # Копируем M2M связи
            new_doc.departments.set(old_doc.departments.all())
            new_doc.recipients.set(old_doc.recipients.all())
            
            # Копируем ознакомления
            for ack in old_doc.acknowledgements.all():
                DocumentAcknowledgement.objects.create(
                    document=new_doc,
                    user=ack.user,
                    acknowledged_at=ack.acknowledged_at
                )

Фаза 4: Обновление Admin (0.5 дня)

# documents/admin.py
from django.contrib import admin
from filer.admin import FolderAdmin as BaseFolderAdmin
from .models_v2 import Document, DocumentAcknowledgement

@admin.register(Document)
class DocumentAdmin(admin.ModelAdmin):
    # Используем встроенный виджет filer для file
    list_display = ('title', 'file_thumbnail', 'uploaded_at', 'sent_to_all')
    filter_horizontal = ('recipients', 'departments')
    
    def file_thumbnail(self, obj):
        if obj.file and obj.file.icons:
            return obj.file.icons['32']
        return '-'
    file_thumbnail.short_description = 'Preview'

Фаза 5: Тестирование (1 день)

• Загрузка документов
• Рассылка по отделам
• Ознакомление
• Права доступа
• API endpoints

Фаза 6: Деплой и откат старой версии (0.5 дня)

---

Экономия ресурсов

Код:

• Было: 1180 строк кастомного кода
• Станет: ~580 строк (50% сокращение)
• Удаляется:
  • ~300 строк views (файловые операции → filer)
  • ~150 строк admin (виджеты → filer)
  • ~150 строк кастомной логики (папки, права → filer)

Функционал:

• Добавляется бесплатно:
  • ✅ Drag & drop загрузка
  • ✅ Thumbnails и превью
  • ✅ Папки и категории
  • ✅ Продвинутый поиск
  • ✅ Массовые операции
  • ✅ ACL на уровне файлов
  • ✅ REST API для файлов

Поддержка:

• Было: 100% кастомный код (баги и развитие на вас)
• Станет: 50% библиотечный код (поддержка сообществом)

---

Альтернатива: Минимальные улучшения (если нет времени на рефакторинг)

Если полная замена не вариант, сделайте минимальные улучшения:

1. Добавьте preview файлов:

   pip install django-file-upload-preview
   

2. Добавьте версионирование:

   pip install django-reversion
   

3. Улучшите поиск через watson:

   watson.register(Document, fields=('title', 'description'))
   

4. Добавьте экспорт списка:

   pip install django-import-export
   

Трудозатраты: 4-6 часов
Результат: +версионирование, +поиск, +экспорт (без рефакторинга)

---

Вывод

НЕТ полной готовой замены для вашего приложения documents, так как специфичная логика (рассылка по отделам + трекинг ознакомления) уникальна для корпоративных систем.

Рекомендуемый путь:

1. Используйте django-filer для хранения файлов (50% функционала)
2. Оставьте кастомные модели для рассылки и ознакомления (50% функционала)
3. Добавьте django-reversion для версионирования (бонус)

Экономия: ~600 строк кода + профессиональное хранилище файлов
Трудозатраты: 3-5 дней
ROI: Высокий (улучшение UX + сокращение кода)

---

Автор: GitHub Copilot
Дата: 28 февраля 2026