Skip to content

[Project] Миграция модуля проектов на доменную модель (DDD) #46

Closed

Description

@soorq

Контекст

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


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

  • Локация логики: src/modules/projects/
  • Инструменты: NestJS, TypeScript, Drizzle ORM.
  • Логика работы:
    1. Aggregate Root: Сущность Project выступает корнем агрегата. Управление вложенными сущностями (например, Milestones, ProjectSettings) осуществляется строго через корень.
    2. Жизненный цикл (State Machine): Реализация переходов состояний (Draft -> Active -> Archived/Completed) внутри доменной модели с проверкой условий перехода.
    3. Value Objects: Создание объектов ProjectPeriod (дата начала/конца), Budget, ProjectTitle.
    4. Domain Events: Публикация событий ProjectStarted, ProjectArchived для уведомления других модулей (например, Notifications или Analytics).

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

  • База: Реализован класс Project с инкапсулированным состоянием и методами изменения данных.
  • Функционал: Перенос логики архивации и завершения проектов в доменный слой с проверкой блокирующих факторов.
  • Лимиты/SLA: Транзакционная целостность агрегата при обновлении настроек и метаданных проекта.
  • Интеграция: Реализация ProjectRepository для маппинга доменной модели на схему projects в БД.

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

  • Производительность: Оптимизировать выборку связанных данных (Milestones) через Repository, используя стратегии ленивой загрузки, где это допустимо.
  • Ошибки: Использование ProjectDomainException для случаев нарушения бизнес-логики (например, «Нельзя завершить проект с незакрытыми этапами»).
  • Безопасность: Проверка принадлежности проекта к команде/владельцу должна выполняться на уровне 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