Skip to content

[Team] Миграция модуля управления командами на принципы DDD #45

Closed

Description

@soorq

Контекст

Модуль Teams управляет сложными связями между пользователями, ролями и доступами внутри рабочих групп. Текущая реализация страдает от логики, разбросанной по сервисам, что приводит к нарушению инвариантов (например, команда может остаться без владельца). Необходимо внедрить агрегат Team, который будет жестко контролировать свои границы, правила вступления и иерархию участников.


Технические требования

  • Локация логики: src/modules/teams/
  • Инструменты: NestJS, Drizzle ORM, TypeScript.
  • Логика работы:
    1. Aggregate Root: Определение сущности Team как корня агрегата. Все изменения участников (Members) должны проходить через методы корня.
    2. Value Objects: Реализация объектов TeamName, inviteCode, Permissions.
    3. Invariant Enforcement: Корень агрегата должен гарантировать, что у команды всегда есть ровно один Owner.
    4. Domain Services: Если бизнес-логика требует проверки данных из других модулей (например, лимиты создаваемых команд для конкретного типа пользователя), использовать TeamCreationService.

Цель и критерии приемки (Definition of Done)

  • База: Описана доменная модель Team и коллекция Members внутри неё.
  • Функционал: Реализованы методы addMember(), removeMember() и transferOwnership() внутри агрегата.
  • Лимиты/SLA: Операции изменения состава команды должны быть атомарными и выполняться в рамках одной транзакции в репозитории.
  • Интеграция: Добавлен TeamRepository с методом save(), который корректно сохраняет состояние агрегата и его участников в БД.

Важные указания

  • Производительность: При удалении или добавлении участника загружать только необходимые данные для проверки прав, а не всю историю активности команды.
  • Ошибки: Бросать DomainException, если попытка удаления последнего владельца или добавления участника сверх лимита.
  • Безопасность: Проверка прав (Role-Based Access Control) должна инициироваться в Application Layer, но правила того, что "Админ может всё, а Участник — только чтение", должны быть зашиты в домене.

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions