Files
mtusi2026lab2/docs/architecture/README.md
T
2026-10-09 15:48:03 +03:00

27 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Граф модулей NestJS
Артефакты в этой папке генерируются командой `npm run graph` из `app/`
и описывают реальный граф зависимостей приложения:
| Файл | Содержимое |
|---|---|
| `nest-module-details.json` | Модули, imports, providers, controllers, exports и constructor-зависимости (из compiled metadata). |
| `nest-module-graph.mmd` | Mermaid-граф: сплошные стрелки — imports модулей, пунктирные — внедрения провайдеров. |
| `nest-dependency-graph.md` | Тот же граф плюс таблицы по каждому модулю (удобно смотреть в Markdown-preview). |
Генератор: `app/scripts/graph-modules.ts` (использует `nestjs-spelunker`).
Команда не подключается к PostgreSQL или Redis: для неё подставляются фиктивные
`DATABASE_URL`/`REDIS_URL`, поэтому стенд поднимать не нужно.
Перегенерация:
```sh
cd app && npm run graph
```
Зачем это в отчёте: граф показал, где зависимости держались на глобальном scope
и где объявления модулей не отражали реальное устройство DI — именно это привело
к падению API с `UnknownDependenciesException` (см. `evidence/level3-4-verification.md`
§13). Ссылки на разбор: [`../../REPORT.md`](../../REPORT.md),
[`../../evidence/README.md`](../../evidence/README.md).