8. Юридическое досье — Workflow через Service Layer

Date: 2026-01-22

Status

Accepted

Context

Переходы между статусами заключения имеют сложную бизнес-логику: валидация, расчёт скора, создание версий, уведомления.

Decision

Вынести бизнес-логику в сервисный слой LegalConclusionService с методами:

• create_request() — создание запроса
• take_to_work() — взятие в работу
• submit_for_review() — отправка на проверку
• approve() / reject() / return_for_revision() — действия руководителя
• cancel() — отмена

Обоснование

1. Тестируемость — сервисы легко тестировать в изоляции
2. Переиспользование — логика доступна из API, админки, Celery-задач
3. Транзакционность — @transaction.atomic гарантирует консистентность
4. Расширяемость — легко добавить хуки для уведомлений

Альтернативы

• Логика в ViewSet — отвергнуто из-за дублирования и сложности тестирования
• Django Signals — отвергнуто из-за неявности и сложности отладки
• django-fsm — рассмотрено, но избыточно для данного случая

Consequences

• (+) Явная, читаемая бизнес-логика
• (+) Легко расширять и тестировать
• (-) Дополнительный слой абстракции

---

Источник: backend/narmak_v2/app/legal_dossier/ADR.md (ADR-003)