sozday-rabochee-veb-prilozhe/README.md

52 lines
4.3 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.

# КФУ — финансовая устойчивость
Рабочее веб-приложение для расчёта коэффициентов финансовой устойчивости (К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`).