# КФУ — финансовая устойчивость

Рабочее веб-приложение для расчёта коэффициентов финансовой устойчивости (К1 Debt/EBITDA, К2 EBITDA/Int, К3 Debt/Equity) по группам компаний и дочерним обществам.

## Запуск в preview

Проект собирается в `dist/` и раздаётся статикой. Для предпросмотра:

```bash
npm run build
npx vite preview --port 4173
```

Или просто открой вкладку **«Предпросмотр»** в интерфейсе — приложение обновляется при каждом изменении файлов.

## Шаблон «Факт 2025»

Исходный Excel-файл должен содержать листы:

| Лист | Что читается |
|------|-------------|
| **Долг** | Группы (блок 1, строки 7–24) и дочерние (блок 2, строки 33–45): долг, EBITDA |
| **Капитал** | Капитал для группы 1 (строки 36–45), группы 2 (строки 24–32), дочерних (строка 34) |
| **Int** | Нормативы по利息 (K1/K2/K3 цель/порог) |
| **Диагностика** | Ошибки ячеек (`#REF!`, `#DIV/0!` и т.п.) |
| **Итог** | Итоговые строки (группы 55 и 59) |

Структура: 14 дочерних, 2 группы, итого 16 расчётных объектов.

## Ограничение на сохранённые значения Excel

Приложение читает **только сохранённые (cached) значения** ячеек Excel — формулы не вычисляются на клиенте. Если файл был сохранён без пересчёта (например, после копирования формул), в ячейках могут быть устаревшие или пустые значения. Перед загрузкой убедись, что в Excel все формулы пересчитаны (`F9` → сохранить).

## Инструкция

1. **Загрузка** — выбери Excel-файл «Факт 2025» (или оставь учебные данные).
2. **Карточка** — клик по строке в таблице: открываются исходные значения, формулы, источники ячеек, зоны (зелёная/жёлтая/красная) по каждому коэффициенту.
3. **Сценарий** — в карточке введи дельту (изменение долга / EBITDA / капитала / процентов). Коэффициенты, зоны и итог в таблице обновляются; выгрузка Excel содержит значения «с учётом сценария». Базовая сверка — без изменения.
4. **Выгрузка** — кнопка «Скачать отчёт»: Excel-файл с листами «Расчёт», «Сверка», «Диагностика», «Пояснения».

## Подтверждённые проверки

- Реальный импорт: 64/64 ячеек (долг 14+14, EBITDA 16, капитал 34, intExp 14, нормы 12, итог 12).
- Сценарий «Казахтелеком» +500 000: таблица, KPI, зонный фильтр реагируют на дельту; при смене объекта/сброса — возврат к базовым значениям.
- Выгрузка Excel: коэффициенты с учётом сценария, 64 строки в листе «Сверка», 71 ошибка в листе «Диагностика».
- 5 колонок таблицы (Объект, Итог, К1, К2, К3) помещаются на 1280px без горизонтальной прокрутки страницы.
- При EBITDA ≤ 0 у К1/К2 показывается «EBITDA ≤ 0» (красная зона) вместо «нет данных».

## Не включено

Реальные суммы, фактический Excel-файл, выгруженные отчёты — в репозиторий не попадают (см. `.gitignore`).