Repository navigation
Closed
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or requestperformance
Description
Контекст
Модуль Projects является центральным узлом системы, координирующим задачи, сроки и ресурсы. Текущая реализация представляет собой набор CRUD-операций, что приводит к размытию жизненного цикла проекта (например, проект может перейти в статус «Завершен» при наличии активных задач). Необходимо перевести логику на рельсы DDD, чтобы гарантировать соблюдение бизнес-инвариантов и изолировать логику управления проектами от деталей персистентности.
Технические требования
- Локация логики:
src/modules/projects/ - Инструменты: NestJS, TypeScript, Drizzle ORM.
- Логика работы:
- Aggregate Root: Сущность
Projectвыступает корнем агрегата. Управление вложенными сущностями (например,Milestones,ProjectSettings) осуществляется строго через корень. - Жизненный цикл (State Machine): Реализация переходов состояний (
Draft->Active->Archived/Completed) внутри доменной модели с проверкой условий перехода. - Value Objects: Создание объектов
ProjectPeriod(дата начала/конца),Budget,ProjectTitle. - Domain Events: Публикация событий
ProjectStarted,ProjectArchivedдля уведомления других модулей (например,NotificationsилиAnalytics).
- Aggregate Root: Сущность
Цель и критерии приемки (Definition of Done)
- База: Реализован класс
Projectс инкапсулированным состоянием и методами изменения данных. - Функционал: Перенос логики архивации и завершения проектов в доменный слой с проверкой блокирующих факторов.
- Лимиты/SLA: Транзакционная целостность агрегата при обновлении настроек и метаданных проекта.
- Интеграция: Реализация
ProjectRepositoryдля маппинга доменной модели на схемуprojectsв БД.
Важные указания
- Производительность: Оптимизировать выборку связанных данных (Milestones) через
Repository, используя стратегии ленивой загрузки, где это допустимо. - Ошибки: Использование
ProjectDomainExceptionдля случаев нарушения бизнес-логики (например, «Нельзя завершить проект с незакрытыми этапами»). - Безопасность: Проверка принадлежности проекта к команде/владельцу должна выполняться на уровне Application Layer перед вызовом доменных методов.
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or requestperformance
Activity