AOKB/onboard
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f107ebd167e65f279d068a509435bd1f1a0767a4
onboard/docs/report-domain-migration-handoff.md

6.7 KiB
Raw Blame History

Handoff: миграция отчётов на Domain-архитектуру

Дата: 2026-04-26

Что уже сделано

1. Базовый каркас Domain / Application / Infrastructure

Добавлены новые слои:

  • app/Domain/Reports
  • app/Application/Reports
  • app/Infrastructure/Reports

Ключевые элементы:

  • Domain/Reports/ValueObjects/MetrikaConfig
  • Domain/Reports/Models/ReportSnapshot
  • Domain/Reports/Contracts/*
  • Application/Reports/DTO/*
  • Application/Reports/GenerateReportUseCase
  • Application/Reports/CompareLegacyAndNewReportUseCase
  • Infrastructure/Reports/Repositories/EloquentReportRepository
  • Infrastructure/Reports/Adapters/LegacyReportServiceAdapter
  • Infrastructure/Reports/Logging/ReportsAuditLogger

2. Save-path уже переведён на strangler-схему

Новый save-flow работает рядом со старым кодом:

  • старый ReportService не удалён
  • новый путь включается через feature-flag
  • legacy остаётся fallback
  • сравнение old/new идёт через comparator и audit logger

Точки входа уже знают про новый flow:

  • app/Http/Controllers/Web/ReportController.php
  • app/Http/Controllers/Api/ReportController.php
  • app/Services/AutoReportService.php

3. Вынесена существенная часть persistence и orchestration

Из ReportService уже выделены:

  • Infrastructure/Reports/Services/ReportStorageService
  • Infrastructure/Reports/Services/ReportMetricsFinalizer
  • Infrastructure/Reports/Services/CalculatedMetricsSynchronizer
  • Infrastructure/Reports/Services/SnapshotPersistenceService
  • Infrastructure/Reports/Services/AutoFillReportPayloadBuilder

4. Вынесены источники данных

Сейчас выделены отдельные источники:

  • Infrastructure/Reports/Sources/MisPatientSource
  • Infrastructure/Reports/Sources/SpecialPatientSource
  • Infrastructure/Reports/Sources/SnapshotPatientSource
  • Infrastructure/Reports/Sources/MisClinicalDataSource
  • Infrastructure/Reports/Sources/LegacyAutoFillPatientSource

5. Вынесены Domain-calculators

Сейчас в Domain уже есть:

  • BedDaysCalculator
  • PreoperativeDaysCalculator
  • DepartmentLoadCalculator

6. Read-path пациентов тоже вынесен

Добавлены:

  • Infrastructure/Reports/Services/ReportPatientsReadService
  • Infrastructure/Reports/Services/ReportReadContextResolver

Теперь ReportService уже делегирует туда:

  • getPatientsByStatus
  • getPatientsCountByStatus
  • getPatientsCountsMap
  • getPatientsFromSnapshots

Это важный шаг: ReportService постепенно становится legacy facade, а не местом, где живёт вся логика.

Что ещё специально НЕ сделано

  • старый код не удалён
  • полный cutover на новую архитектуру не выполнен
  • getReportStatistics пока ещё остаётся внутри ReportService
  • часть legacy read/statistics логики ещё не вынесена в отдельный infrastructure/application слой
  • integration tests на SQLite здесь не гонялись, потому что в окружении нет pdo_sqlite

Проверки и тесты

Проходит:

php artisan test tests/Unit/Reports

Сейчас зелёные unit-тесты для:

  • MetrikaConfig
  • ReportSnapshot
  • GenerateReportUseCase
  • CompareLegacyAndNewReportUseCase
  • ReportInputFactory
  • ReportPatientsReadService
  • domain calculators

Важный контекст по БД и тестам

Основное приложение работает с pgsql из .env, но тесты не обязаны использовать это окружение.

Важно:

  • в phpunit.xml тестовый runtime жёстко переключён на sqlite
  • в текущем окружении отсутствует pdo_sqlite
  • поэтому feature/integration тесты здесь не были полноценно прогнаны

Если завтра нужно будет запускать integration-тесты на PostgreSQL, надо отдельно переводить test-конфиг.

Дополнительные важные замечания

1. В worktree есть изменённые файлы

Нужно быть осторожным и не перетирать чужие правки.

Особенно внимательно смотреть на:

  • app/Http/Controllers/Api/ReportController.php
  • app/Services/ReportService.php
  • app/Services/Reports/PatientQueryBuilder.php

2. Есть защитный фикс в конфиге Excel

Ранее был добавлен безопасный guard в config/excel.php, чтобы bootstrap не падал, если в окружении нет нужных excel-классов.

3. Комментарии в новом слое частично русифицированы

Русифицированы PHPDoc в основных новых infrastructure/application классах миграции. При желании можно отдельным проходом довести до конца все новые DTO, адаптеры и domain models.

Самый логичный следующий шаг

Следующая итерация:

  1. Вынести getReportStatistics из ReportService в отдельный read-service.
  2. Затем вынести snapshot/replica statistics orchestration в новый infrastructure/application слой.
  3. После этого ещё сильнее сузить ReportService до legacy facade.

Рекомендуемое направление:

  • создать что-то вроде Infrastructure/Reports/Services/ReportStatisticsReadService
  • перевести туда:
    • getStatisticsFromSnapshots
    • getStatisticsFromReplica
    • вспомогательные read-context части, если они ещё не покрыты ReportReadContextResolver

Если нужно быстро продолжить завтра

Сначала открыть:

  • docs/report-domain-migration-handoff.md
  • app/Services/ReportService.php
  • app/Infrastructure/Reports/Services/ReportPatientsReadService.php
  • app/Infrastructure/Reports/Services/ReportReadContextResolver.php

Потом проверить:

php artisan test tests/Unit/Reports

И дальше брать следующий шаг:

  • перенос getReportStatistics в отдельный сервис