Repository navigation
Labels
api-designEndpoint and CRUD'sEndpoint and CRUD'sdocumentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Description
Контекст
Текущая система требует перехода от простых проверок ролей к гибкому управлению доступом на основе атрибутов (ABAC) и разрешений. Использование библиотеки casl позволит централизовать логику авторизации, упростить масштабирование прав доступа для различных сущностей (команд, досок, задач) и обеспечить консистентность проверок как на бэкенде, так и в перспективе на фронтенде.
Технические требования
- Локация логики:
src/features/auth/abilities,src/shared/guards - Инструменты:
@casl/ability,@casl/prisma(или аналог для используемой ORM). - Логика работы:
- Создать фабрику
AbilityFactory, которая на основеuser.roleиuser.permissionsгенерирует объектAbility. - Описать базовые правила для сущностей:
Project,Board,Task,Team. Например: участник команды может читать доски, но толькоADMINилиOWNERможет их удалять. - Реализовать декораторы и глобальный
Guardдля автоматической проверкиAbilityв контроллерах/резолверах. - Интегрировать проверку владения ресурсом (например,
user_id === task.author_id).
- Создать фабрику
Цель и критерии приемки (Definition of Done)
- База: Установлены зависимости
@casl/ability. Созданы базовые типыAppAbility,Actions(manage,create,read, etc.) иSubjects. - Функционал: Все эндпоинты защищены проверкой разрешений. Роли
ADMIN,MEMBER,GUESTимеют корректно разграниченные уровни доступа. - Лимиты/SLA: Оценка прав доступа должна происходить в памяти (O(1)) после загрузки профиля пользователя, не создавая избыточных запросов к БД.
- Интеграция: Логика авторизации встроена в текущий процесс JWT-валидации; обновлены юнит-тесты для проверки сценариев Forbidden (403).
Важные указания
- Производительность: Использовать ленивую загрузку правил авторизации только при необходимости. Кешировать инстанс
Abilityв рамках жизненного цикла запроса. - Ошибки: Выбрасывать
ForbiddenException(HTTP 403) при недостаточном уровне прав. - Безопасность: Реализовать принцип "Default Deny" — если правило не описано явно, доступ должен быть запрещен. Обеспечить проверку принадлежности пользователя к команде перед проверкой детальных прав на доску.
Metadata
Metadata
Assignees
Labels
api-designEndpoint and CRUD'sEndpoint and CRUD'sdocumentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or request
Activity