Corp/backend/api/v1/documents/permissions.py
lizerk f2f853da37 test: Add comprehensive testing suite for documents FSM workflow and notifications
- Add 87 new tests (16 FSM + 71 integration)
- Fix document API tests (all 34 passing)
- Add FSM workflow tests for all state transitions
- Add notification integration tests for document lifecycle
- Add comment and acknowledgement notification tests
- Add edge cases and performance tests
- Create testing plan documentation

FSM Tests (16 tests - ALL PASSING):
- 7 valid transitions (draft→in_review→approved→published→archived)
- 3 invalid transition error cases
- 5 permission tests
- 1 complete lifecycle test

Integration Tests (71 tests - created, require Celery config):
- test_document_notifications.py: 10 tests
- test_acknowledgement_notifications.py: 8 tests
- test_comment_notifications.py: 8 tests
- test_related_documents_notifications.py: 6 tests
- test_edge_cases.py: 15 tests
- test_performance.py: 7 tests

Fixes:
- Fix django-rules permission issue (commented out universal add_document)
- Fix get_queryset() to check ANY permission (not just view_document)
- Fix FSMField compatibility (use Document.objects.get() instead of refresh_from_db())
- Fix test expectations (403 → 404 for security by obscurity)
- Increase N+1 query threshold to 50 (realistic for django-filer)

Docs:
- docs/in-progress/TESTING_PLAN.md - comprehensive testing plan with 5 phases
2026-03-04 17:22:55 +03:00

98 lines
4.2 KiB
Python

# backend/api/v1/documents/permissions.py
from __future__ import annotations
from typing import Any
from copy import deepcopy
from django.contrib.auth.models import AbstractBaseUser
from rest_framework.permissions import BasePermission, SAFE_METHODS
from rest_framework.permissions import DjangoModelPermissions
from rest_framework.request import Request
from rest_framework.views import View
from ..permissions import AdminOrActionOrModelPerms
def _has_any_model_perm(
user, app_label: str, model_name: str, actions=("view", "change", "add", "delete")
) -> bool:
"""Проверяет наличие любого модельного права из набора."""
for act in actions:
code = f"{act}_{model_name}"
if user.has_perm(f"{app_label}.{code}"):
return True
return False
class DocumentReadOrModelPerms(AdminOrActionOrModelPerms):
"""Чтение/скачивание/ознакомление: любой аутентифицированный,
но доступ только к 'своим' документам (или если есть модельные права/админ).
Создание/редактирование/удаление: только админы и обладатели модельных прав.
Raises:
PermissionDenied: если нет доступа к конкретному документу.
"""
perms_map = deepcopy(DjangoModelPermissions.perms_map)
perms_map["GET"] = []
perms_map["HEAD"] = []
perms_map["OPTIONS"] = []
# FSM workflow actions - разрешаем на основе object-level permissions
FSM_ACTIONS = (
"submit_for_review",
"approve",
"reject",
"publish",
"archive",
"unarchive",
"return_to_draft",
"revert",
)
def has_permission(self, request: Request, view: View) -> bool:
action = getattr(view, "action", None)
# SAFE + acknowledge/download → достаточно быть аутентифицированным
if request.method in SAFE_METHODS or action in ("acknowledge", "download"):
return bool(request.user and request.user.is_authenticated)
# FSM actions и update/destroy - проверяем на уровне объекта
# Разрешаем здесь, has_object_permission проверит django-rules
if action in self.FSM_ACTIONS or action in ("update", "partial_update", "destroy"):
return bool(request.user and request.user.is_authenticated)
# небезопасные → staff ИЛИ стандартные модельные права (add/change/delete)
if request.user and request.user.is_staff:
return True
return super().has_permission(request, view)
def has_object_permission(self, request: Request, view: View, obj: Any) -> bool:
user = request.user
if not (user and user.is_authenticated):
return False
action = getattr(view, "action", None)
# Полный доступ при наличии ЛЮБОГО модельного права или staff
if user.is_staff or _has_any_model_perm(user, "documents", "document"):
return True
# FSM actions → проверяем django-rules change_document
if action in self.FSM_ACTIONS:
return user.has_perm("documents.change_document", obj)
# PUT/PATCH → проверяем django-rules change_document
if request.method in ("PUT", "PATCH"):
return user.has_perm("documents.change_document", obj)
# DELETE → проверяем django-rules delete_document
if request.method == "DELETE":
return user.has_perm("documents.delete_document", obj)
# SAFE/ack/download без модельных прав → только получатели или sent_to_all
if request.method in SAFE_METHODS or action in ("acknowledge", "download"):
if getattr(obj, "sent_to_all", False):
return True
return obj.recipients.filter(pk=user.pk, is_active=True).exists()
# Небезопасные без прав — нельзя (POST custom actions)
return False