django-chassis 1.0.1__py3-none-any.whl

django_chassis/__init__.py

@@ -0,0 +1 @@
+

django_chassis/admins/__init__.py

@@ -0,0 +1,15 @@
+from django_chassis.admins.admin_audit_log import AdminAuditLogAdmin
+from django_chassis.admins.group import GroupAdmin
+from django_chassis.admins.login_attempt import LoginAttemptAdmin
+from django_chassis.admins.login_attempt_schedule import LoginAttemptScheduleAdmin
+from django_chassis.admins.user import UserAdmin
+from django_chassis.admins.user_session import UserSessionAdmin
+
+__all__ = [
+    'AdminAuditLogAdmin',
+    'GroupAdmin',
+    'LoginAttemptAdmin',
+    'LoginAttemptScheduleAdmin',
+    'UserAdmin',
+    'UserSessionAdmin'
+]

django_chassis/admins/admin_audit_log.py

@@ -0,0 +1,107 @@
+from django.contrib import admin
+from django.db.models import Model
+from django.http import HttpRequest
+from django.utils.translation import gettext_lazy as _
+
+from django_chassis.mixins.admin import ChassisAdminMixin
+from django_chassis.mixins.read_only_admin import ReadOnlyAdminMixin
+from django_chassis.options import FiltersOption, SearchOption
+
+
+class AdminAuditLogAdmin(ChassisAdminMixin, ReadOnlyAdminMixin, admin.ModelAdmin):
+    """
+    Просматривать журнал HTTP-действий Django Admin.
+    """
+
+    options = [
+        SearchOption(fields=['username', 'path', 'object_repr', 'client_ip']),
+        FiltersOption(fields=['action', 'result', 'is_superuser'])
+    ]
+    fieldsets = [
+        (
+            _('Действие'),
+            {
+                'classes': ['wide'],
+                'fields': [
+                    'id',
+                    'user',
+                    'username',
+                    'is_superuser',
+                    'action',
+                    'result',
+                    'action_name',
+                    'created_at',
+                    'completed_at',
+                    'status_code',
+                    'response_time_ms'
+                ]
+            }
+        ),
+        (
+            _('Объект'),
+            {
+                'classes': ['wide'],
+                'fields': ['app_label', 'model_name', 'object_id', 'object_repr', 'object_count', 'changes']
+            }
+        ),
+        (
+            _('Запрос'),
+            {
+                'classes': ['wide'],
+                'fields': [
+                    'method',
+                    'path',
+                    'route_name',
+                    'query_params',
+                    'client_ip',
+                    'remote_ip',
+                    'forwarded_for',
+                    'user_agent',
+                    'browser',
+                    'operating_system',
+                    'is_mobile',
+                    'referer',
+                    'session_hash'
+                ]
+            }
+        )
+    ]
+    readonly_fields = [
+        'id',
+        'user',
+        'username',
+        'is_superuser',
+        'action',
+        'result',
+        'action_name',
+        'created_at',
+        'completed_at',
+        'status_code',
+        'response_time_ms',
+        'app_label',
+        'model_name',
+        'object_id',
+        'object_repr',
+        'object_count',
+        'changes',
+        'method',
+        'path',
+        'route_name',
+        'query_params',
+        'client_ip',
+        'remote_ip',
+        'forwarded_for',
+        'user_agent',
+        'browser',
+        'operating_system',
+        'is_mobile',
+        'referer',
+        'session_hash'
+    ]
+
+    def has_view_permission(self, request: HttpRequest, obj: Model | None = None) -> bool:
+        """
+        Сохранить стандартную проверку view журнала.
+        """
+        del obj
+        return getattr(request.user, 'has_perm')('django_chassis.view_adminauditlog')

django_chassis/admins/group.py

@@ -0,0 +1,56 @@
+from django.contrib.auth.admin import GroupAdmin as DjangoGroupAdmin
+from django.db.models import Model
+from django.http import HttpRequest
+
+from django_chassis.mixins.admin import ChassisAdminMixin
+from django_chassis.options import SearchOption
+from django_chassis.protocols import cast_admin_user
+
+
+class GroupAdmin(ChassisAdminMixin, DjangoGroupAdmin):
+    """
+    Управлять стандартными группами Django через Chassis Admin.
+    """
+
+    options = [SearchOption(fields=['name'])]
+
+    @classmethod
+    def _is_active_staff_superuser(cls, request: HttpRequest) -> bool:
+        """
+        Разрешить управление группами только полному суперпользователю.
+        """
+        user = cast_admin_user(request.user)
+        return user.is_authenticated and user.is_active and user.is_staff and user.is_superuser
+
+    def has_module_permission(self, request: HttpRequest) -> bool:
+        """
+        Скрыть раздел групп от несуперпользователей.
+        """
+        return self._is_active_staff_superuser(request)
+
+    def has_view_permission(self, request: HttpRequest, obj: Model | None = None) -> bool:
+        """
+        Закрыть список, карточку и прямые URL групп.
+        """
+        del obj
+        return self._is_active_staff_superuser(request)
+
+    def has_add_permission(self, request: HttpRequest) -> bool:
+        """
+        Запретить создание групп несуперпользователям.
+        """
+        return self._is_active_staff_superuser(request)
+
+    def has_change_permission(self, request: HttpRequest, obj: Model | None = None) -> bool:
+        """
+        Запретить изменение группы несуперпользователям.
+        """
+        del obj
+        return self._is_active_staff_superuser(request)
+
+    def has_delete_permission(self, request: HttpRequest, obj: Model | None = None) -> bool:
+        """
+        Запретить удаление группы несуперпользователям.
+        """
+        del obj
+        return self._is_active_staff_superuser(request)

django_chassis/admins/login_attempt.py

@@ -0,0 +1,69 @@
+from django.contrib import admin, messages
+from django.contrib.auth.base_user import AbstractBaseUser
+from django.db.models import Model
+from django.http import HttpRequest, HttpResponse
+from django.utils.translation import gettext_lazy as _
+
+from django_chassis.decorators import object_action
+from django_chassis.enums import ButtonColor
+from django_chassis.mixins.admin import ChassisAdminMixin
+from django_chassis.mixins.read_only_admin import ReadOnlyAdminMixin
+from django_chassis.models.login_attempt import LoginAttempt
+from django_chassis.options import ObjectActionsOption, SearchOption
+from django_chassis.services.login_attempt_limit_service import LoginAttemptLimitService
+from django_chassis.validators.login_attempt_unlock import can_unlock_login_attempt
+
+class LoginAttemptAdmin(ChassisAdminMixin, ReadOnlyAdminMixin, admin.ModelAdmin):
+    """
+    Просматривать журнал попыток входа и снимать блокировку области.
+    """
+
+    options = [SearchOption(fields=['username', 'client_ip', 'browser']), ObjectActionsOption(actions=['unlock_scope'])]
+    fieldsets = [
+        (_('Попытка'), {'classes': ['wide'], 'fields': [
+            'id',
+            'username',
+            'user',
+            'client_ip',
+            'browser',
+            'attempt_number',
+            'is_successful',
+            'is_unlock',
+            'created_at'
+        ]})
+    ]
+    readonly_fields = [
+        'id',
+        'username',
+        'user',
+        'client_ip',
+        'browser',
+        'attempt_number',
+        'is_successful',
+        'is_unlock',
+        'created_at'
+    ]
+
+    @object_action(
+        description=_('Снять блокировку'),
+        permission='unlock_loginattempt',
+        confirmation=_('Снять блокировку входа для этой области логин/IP/браузер?'),
+        color=ButtonColor.WARNING,
+        condition=can_unlock_login_attempt
+    )
+    def unlock_scope(self, request: HttpRequest, obj: LoginAttempt) -> HttpResponse | None:
+        """
+        Начать новый цикл ограничений для области этой записи.
+        """
+        if not isinstance(request.user, AbstractBaseUser):
+            return None
+        LoginAttemptLimitService().unlock(username=obj.username, client_ip=obj.client_ip, browser=obj.browser)
+        messages.success(request, _('Блокировка входа снята.'))
+        return None
+
+    def has_view_permission(self, request: HttpRequest, obj: Model | None = None) -> bool:
+        """
+        Сохранить стандартную проверку view журнала попыток.
+        """
+        del obj
+        return getattr(request.user, 'has_perm')('django_chassis.view_loginattempt')

django_chassis/admins/login_attempt_schedule.py

@@ -0,0 +1,44 @@
+from django.contrib import admin
+from django.db.models import Model
+from django.http import HttpRequest
+from django.utils.translation import gettext_lazy as _
+
+from django_chassis.mixins.admin import ChassisAdminMixin
+from django_chassis.mixins.no_delete_admin import NoDeleteAdminMixin
+from django_chassis.models.login_attempt_schedule import LoginAttemptSchedule
+from django_chassis.options import SearchOption
+from django_chassis.protocols import cast_admin_user
+
+class LoginAttemptScheduleAdmin(ChassisAdminMixin, NoDeleteAdminMixin, admin.ModelAdmin):
+    """
+    Настраивать задержки между попытками локального входа.
+    """
+
+    options = [SearchOption(fields=['attempt_number'])]
+    fieldsets = [(_('Правило'), {'classes': ['wide'], 'fields': ['attempt_number', 'delay_seconds', 'is_active']})]
+
+    def has_module_permission(self, request: HttpRequest) -> bool:
+        """
+        Показать расписание только суперпользователю.
+        """
+        return bool(cast_admin_user(request.user).is_superuser)
+
+    def has_view_permission(self, request: HttpRequest, obj: Model | None = None) -> bool:
+        """
+        Закрыть карточку расписания от несуперпользователей.
+        """
+        del obj
+        return bool(cast_admin_user(request.user).is_superuser)
+
+    def has_add_permission(self, request: HttpRequest) -> bool:
+        """
+        Разрешить создание правил только суперпользователю.
+        """
+        return bool(cast_admin_user(request.user).is_superuser)
+
+    def has_change_permission(self, request: HttpRequest, obj: Model | None = None) -> bool:
+        """
+        Разрешить изменение правил только суперпользователю.
+        """
+        del obj
+        return bool(cast_admin_user(request.user).is_superuser)

django_chassis/admins/user.py

@@ -0,0 +1,52 @@
+from django.contrib.auth.admin import UserAdmin as DjangoUserAdmin
+from django.contrib.auth.models import AbstractUser
+from django.db.models import QuerySet
+from django.http import HttpRequest
+from django.utils.translation import gettext_lazy as _
+
+from django_chassis.decorators import chassis_related_items
+from django_chassis.mixins.admin import ChassisAdminMixin
+from django_chassis.models.user_session import UserSession
+from django_chassis.options import (
+    RelatedEntitiesOption,
+    RelatedEntityOption,
+    SearchOption,
+    TableColumnOption,
+    TableOption
+)
+
+class UserAdmin(ChassisAdminMixin, DjangoUserAdmin):
+    """
+    Управлять стандартными пользователями Django через Chassis Admin.
+    """
+
+    options = [
+        SearchOption(fields=['username', 'first_name', 'last_name', 'email']),
+        RelatedEntitiesOption(
+            sections=[
+                RelatedEntityOption(
+                    slug='sessions',
+                    title=_('Сессии'),
+                    get_items_method='get_user_sessions',
+                    table=TableOption(
+                        columns=[
+                            TableColumnOption(field='started_at', label=_('Начало')),
+                            TableColumnOption(field='client_ip', label=_('IP')),
+                            TableColumnOption(field='country_code', label=_('Страна')),
+                            TableColumnOption(field='browser', label=_('Браузер')),
+                            TableColumnOption(field='last_seen_at', label=_('Активность')),
+                            TableColumnOption(field='is_active', label=_('Активна'))
+                        ]
+                    )
+                )
+            ]
+        )
+    ]
+
+    @classmethod
+    @chassis_related_items
+    def get_user_sessions(cls, _request: HttpRequest, obj: AbstractUser) -> QuerySet[UserSession]:
+        """
+        Показать сессии выбранного пользователя.
+        """
+        return UserSession.objects.filter(user=obj).order_by('-last_seen_at', '-started_at')

django_chassis/admins/user_session.py

@@ -0,0 +1,100 @@
+from django.contrib import admin, messages
+from django.contrib.auth.base_user import AbstractBaseUser
+from django.db.models import Model
+from django.http import HttpRequest, HttpResponse
+from django.utils.translation import gettext_lazy as _
+
+from django_chassis.decorators import object_action
+from django_chassis.enums import ButtonColor, UserSessionEndReason
+from django_chassis.filters.user_session_state import UserSessionStateFilter
+from django_chassis.mixins.admin import ChassisAdminMixin
+from django_chassis.mixins.read_only_admin import ReadOnlyAdminMixin
+from django_chassis.models.user_session import UserSession
+from django_chassis.options import FiltersOption, ObjectActionsOption, SearchOption
+from django_chassis.services.user_session_service import UserSessionService
+from django_chassis.validators.user_session_termination import can_terminate_user_session
+
+class UserSessionAdmin(ChassisAdminMixin, ReadOnlyAdminMixin, admin.ModelAdmin):
+    """
+    Просматривать карточки сессий и завершать доступные сессии.
+    """
+
+    options = [
+        SearchOption(fields=['user__username', 'client_ip', 'browser', 'country_code']),
+        FiltersOption(fields=[UserSessionStateFilter, 'is_mobile']),
+        ObjectActionsOption(actions=['terminate_session'])
+    ]
+    fieldsets = [
+        (
+            _('Сессия'),
+            {
+                'classes': ['wide'],
+                'fields': [
+                    'id',
+                    'user',
+                    'is_active',
+                    'started_at',
+                    'last_seen_at',
+                    'expires_at',
+                    'ended_at',
+                    'end_reason',
+                    'revoked_by'
+                ]
+            }
+        ),
+        (
+            _('Клиент'),
+            {
+                'classes': ['wide'],
+                'fields': ['client_ip', 'country_code', 'browser', 'operating_system', 'device_label', 'user_agent']
+            }
+        )
+    ]
+    readonly_fields = [
+        'id',
+        'user',
+        'is_active',
+        'started_at',
+        'last_seen_at',
+        'expires_at',
+        'ended_at',
+        'end_reason',
+        'revoked_by',
+        'client_ip',
+        'country_code',
+        'browser',
+        'operating_system',
+        'device_label',
+        'user_agent'
+    ]
+
+    @object_action(
+        description=_('Завершить сессию'),
+        permission='terminate_usersession',
+        confirmation=_('Завершить эту сессию? Пользователь будет разлогинен.'),
+        color=ButtonColor.DANGER,
+        condition=can_terminate_user_session
+    )
+    def terminate_session(self, request: HttpRequest, obj: UserSession) -> HttpResponse | None:
+        """
+        Отозвать выбранную активную сессию.
+        """
+        actor = request.user
+        if not isinstance(actor, AbstractBaseUser):
+            return None
+        terminated = UserSessionService().terminate(
+            user_session=obj,
+            actor=actor,
+            reason=UserSessionEndReason.REVOKED,
+            delete_backend=True
+        )
+        if terminated:
+            messages.success(request, _('Сессия завершена.'))
+        return None
+
+    def has_view_permission(self, request: HttpRequest, obj: Model | None = None) -> bool:
+        """
+        Сохранить стандартную проверку view и разрешить карточку для object action.
+        """
+        del obj
+        return getattr(request.user, 'has_perm')('django_chassis.view_usersession')

django_chassis/apps.py

@@ -0,0 +1,18 @@
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class Config(AppConfig):
+    """
+    Конфигурация общих компонентов интерфейса Django Admin.
+    """
+
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_chassis'
+    verbose_name = _('Компоненты интерфейса Django Admin')
+
+    def ready(self) -> None:
+        """
+        Подключить создание и нормализацию разрешений Chassis.
+        """
+        from django_chassis import signals  # noqa: F401

django_chassis/components/__init__.py

@@ -0,0 +1,22 @@
+from django_chassis.components.actions import DashboardAction
+from django_chassis.components.alerts import DashboardAlert
+from django_chassis.components.base import DashboardComponent
+from django_chassis.components.charts import DashboardChart
+from django_chassis.components.geo_ip_database_alert import GeoIpDatabaseDashboardAlert
+from django_chassis.components.metrics import DashboardMetric
+from django_chassis.components.navbar import AdminNavbarButton, AdminNavbarDropdown, AdminNavbarItem, AdminUserMenuItem
+from django_chassis.components.toggle_actions import DashboardToggleAction
+
+__all__ = [
+    'AdminNavbarButton',
+    'AdminNavbarDropdown',
+    'AdminNavbarItem',
+    'AdminUserMenuItem',
+    'DashboardAction',
+    'DashboardAlert',
+    'DashboardChart',
+    'DashboardComponent',
+    'DashboardMetric',
+    'DashboardToggleAction',
+    'GeoIpDatabaseDashboardAlert'
+]

django_chassis/components/actions.py

@@ -0,0 +1,145 @@
+import logging
+from abc import ABC, abstractmethod
+from collections.abc import Callable
+
+from django.contrib import messages
+from django.core.exceptions import PermissionDenied
+from django.http import HttpRequest, HttpResponse
+from django.shortcuts import redirect
+from django.urls import URLPattern, path, reverse
+from django.utils.encoding import force_str
+from django.utils.translation import gettext_lazy as _
+
+from django_chassis.components.base import DashboardComponent
+from django_chassis.dto import DashboardActionDTO
+from django_chassis.enums import ButtonColor
+from django_chassis.type_aliases import LocalizedString
+
+logger = logging.getLogger(__name__)
+
+
+class DashboardAction(DashboardComponent, ABC):
+    """
+    Базовое действие главной страницы Django Admin.
+    """
+
+    description: LocalizedString = ''
+    style: ButtonColor = ButtonColor.PRIMARY
+    route_prefix: str = 'dashboard/actions'
+
+    @property
+    def url_name(self) -> str:
+        """
+        Получить имя маршрута действия.
+        """
+        return f'dashboard_action_{self.slug}'
+
+    def get_urls(self) -> list[URLPattern]:
+        """
+        URL отдельной страницы действия.
+        """
+        return [
+            path(f'{self.route_prefix}/{self.slug}/', self.admin_site.admin_view(self.dispatch), name=self.url_name)
+        ]
+
+    def get_url(self) -> str:
+        """
+        Получить URL страницы действия.
+        """
+        return reverse(f'{self.admin_site.name}:{self.url_name}')
+
+    def get_label(self, request: HttpRequest) -> LocalizedString:
+        """
+        Получить заголовок действия.
+        """
+        return self.label
+
+    def get_description(self, request: HttpRequest) -> LocalizedString:
+        """
+        Получить описание действия.
+        """
+        return self.description
+
+    def get_style(self, request: HttpRequest) -> ButtonColor:
+        """
+        Получить визуальный стиль действия.
+        """
+        return self.style
+
+    def complete_action(
+        self,
+        request: HttpRequest,
+        message: LocalizedString,
+        message_level: int = messages.SUCCESS
+    ) -> HttpResponse:
+        """
+        Завершить действие и вернуться на главную админки.
+        """
+        messages.add_message(request=request, level=message_level, message=force_str(message))
+        return redirect(f'{self.admin_site.name}:index')
+
+    def execute_and_complete(
+        self,
+        request: HttpRequest,
+        action: Callable[[], None],
+        success_message: LocalizedString
+    ) -> HttpResponse:
+        """
+        Выполнить action, показать alert и перенаправить.
+        """
+        action()
+        return self.complete_action(request=request, message=success_message)
+
+    def complete_unavailable_action(self, request: HttpRequest) -> HttpResponse:
+        """
+        Обработать переход к недоступному действию.
+        """
+        raise PermissionDenied
+
+    @staticmethod
+    def get_exception_message(exception: Exception) -> LocalizedString:
+        """
+        Сформировать сообщение об ошибке действия.
+        """
+        exception_text = str(exception) or exception.__class__.__name__
+        return _('Ошибка выполнения действия: %(exception)s') % {'exception': exception_text}
+
+    def dispatch(self, request: HttpRequest) -> HttpResponse:
+        """
+        Проверить доступ и обработать исключения действия.
+        """
+        if not self.is_visible(request):
+            raise PermissionDenied
+        if not self.is_available(request):
+            return self.complete_unavailable_action(request)
+
+        try:
+            return self.view(request)
+        except Exception as e:
+            logger.exception({'message': 'Dashboard action failed.', 'data': {'action_slug': self.slug}})
+            return self.complete_action(
+                request=request,
+                message=self.get_exception_message(e),
+                message_level=messages.ERROR
+            )
+
+    def as_dto(self, request: HttpRequest) -> DashboardActionDTO:
+        """
+        Преобразовать действие в DTO для шаблона.
+        """
+        return DashboardActionDTO(
+            slug=self.slug,
+            label=self.get_label(request),
+            description=self.get_description(request),
+            url=self.get_url(),
+            style=self.get_style(request),
+            status=self.get_status(request),
+            is_available=self.is_available(request)
+        )
+
+    @abstractmethod
+    def view(self, request: HttpRequest) -> HttpResponse:
+        """
+        GET/POST-представление отдельной страницы действия.
+        """
+        raise NotImplementedError