Техническая документация

app/
├── api/                # API Route Handlers
│   ├── segments/       # CRUD сегментов + overview отчёт
│   ├── programs/       # CRUD программ + overview отчёт
│   ├── initiatives/    # CRUD инициатив
│   ├── tasks/          # CRUD задач
│   ├── relations/      # EntityRelation CRUD
│   ├── history/        # EntityHistory (GET)
│   ├── decision-forks/ # DecisionFork CRUD
│   ├── milestones/     # Milestone CRUD (с toggle completed)
│   ├── qa/             # QAItem CRUD
│   ├── health/         # Расчёт здоровья (инициативы, программы, сегменты)
│   ├── health-trend/   # Снимки здоровья для графика тренда
│   ├── attention/      # Элементы, требующие внимания
│   ├── stats/          # Агрегированная статистика для дашборда
│   ├── settings/       # Настройки (GET/PUT)
│   └── excel/          # Импорт/экспорт Excel
├── segments/           # Страницы сегментов
├── programs/           # Страницы программ
├── initiatives/        # Страницы инициатив
├── tasks/              # Страницы задач
├── graph/              # Страница графа
├── roadmap/            # Страница роадмапа
├── settings/           # Настройки (тема, Jira, типы связей, блоки отчёта)
└── docs/               # Документация

components/
├── graph/              # GraphView, CustomNode, CustomEdge, FilterPanel, Legend
├── roadmap/            # RoadmapTimeline
├── layout/             # Sidebar, Header, SidebarContext, LayoutShell
├── providers/          # ThemeProvider
└── ui/                 # Card, Badge, Modal, RelationsSection, QABlock,
                        # HealthBadge, HealthTrendChart и др.

lib/
├── db.ts               # Prisma-клиент (PrismaPg adapter)
├── health.ts           # Расчёт здоровья (инициативы, программы, сегменты, каскад)
├── progress.ts         # Расчёт прогресса (инициативы, программы)
├── constants.ts        # Метки, цвета, статусы, матрица влияния
└── relations.ts        # Навигация по иерархии (getTaskInitiativeId и др.)

InvestmentSegment
├── id, name, description, status (LifecycleStatus), owner, label (EntityLabel)
├── startDate, endDate
├── asIs, limitations, targetState, coreDescription
├── impact (Json), attributes (String[])
├── jiraKey (String?)
├── healthStatus, healthIssues (Json), healthUpdatedAt
├── manualStatus, manualStatusDescription
├── manualStatusProblems (Json), manualStatusUpdatedAt
└── programs: Program[]

Program
├── segmentId → InvestmentSegment
├── (те же поля: status, owner, label, dates, narrative, health, manual...)
├── jiraKey (String?)
└── initiatives: Initiative[]

Initiative
├── programId → Program
├── healthStatus, healthIssues (Json), healthUpdatedAt
├── manualStatus, manualStatusDescription
├── manualStatusProblems (Json), manualStatusUpdatedAt
├── risks (Json) — массив {id, description, severity, mitigationDate, status}
├── jiraKey (String?)
├── tasks: Task[]
└── milestones: Milestone[]

Task
├── initiativeId → Initiative
├── id, name, description, status, owner, startDate, endDate
└── jiraKey (String?)

Milestone
├── description, date, completed (Boolean)
└── initiativeId → Initiative (cascade delete)

EntityRelation (полиморфная)
├── sourceType, sourceId → targetType, targetId
├── type: PART_OF | PREREQUISITE | ENABLES
├── sourceAnchor, targetAnchor (default "FINISH"/"START")
└── decisionForkId, decisionForkOptionIdx (условные связи)

EntityHistory (полиморфная)
├── entityType, entityId, entityName
├── field, oldValue, newValue
└── changedAt, changedBy

DecisionFork (полиморфная)
├── entityType, entityId
├── question, status: OPEN | RESOLVED | DEFERRED
├── date (DateTime?)
└── options (Json) — массив {title, approved}

QAItem (полиморфная)
├── entityType, entityId
├── question, answer
└── createdAt

HealthSnapshot (тренды здоровья)
├── entityType, entityId
├── healthStatus, manualStatus
└── snapshotDate (с кулдауном 1 час)

Settings (key-value)
├── key (unique)
└── value (Json)