docs: точный README без выдуманной структуры

This commit is contained in:
Moldabayev_d 2026-09-21 08:16:41 +00:00
parent de6a2b3c28
commit 8d7a0be485

View File

@ -1,51 +1,13 @@
# КФУ — финансовая устойчивость
Рабочее веб-приложение для расчёта коэффициентов финансовой устойчивости (К1 Debt/EBITDA, К2 EBITDA/Int, К3 Debt/Equity) по группам компаний и дочерним обществам.
Статическое приложение, созданное через чат Vibe AI. Запуск: откройте вкладку Превью проекта; сборка npm не требуется.
## Запуск в preview
Пилот работает с предоставленным шаблоном факта 2025: 15 компаний и одна консолидированная группа. Источники: ДОЛГ 4Q2025_24042026; EBITDA 2025_06042026; BS 4Q2025_06042026; Группа Фонда 4Q 2025. Контрольный свод: План 2026!G5:J20.
Проект собирается в `dist/` и раздаётся статикой. Для предпросмотра:
Загрузите .xlsx, откройте строку компании, при необходимости измените прочие/гарантии в млн тенге. Другие показатели сценарий не редактирует. Кнопка Вернуть сбрасывает изменение. Выгрузить отчёт .xlsx сохраняет снимок текущего сценария. Листы отчёта: КФУ, Источники, Диагностика, Сверка, Пояснения.
```bash
npm run build
npx vite preview --port 4173
```
Проверены 64/64 исходных показателя (16 объектов × 4 показателя), сценарий/сброс, фильтры, пропуски данных, отрицательные показатели и экспорт. Сверка всегда относится к исходным данным без сценария.
Или просто открой вкладку **«Предпросмотр»** в интерфейсе — приложение обновляется при каждом изменении файлов.
Формулы Excel не пересчитываются: читаются сохранённые значения исходных ячеек, затем коэффициенты рассчитываются приложением. Перед загрузкой пересчитайте и сохраните книгу в Excel.
## Шаблон «Факт 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`).
Пользовательский Excel читается в браузере, не отправляется приложением на сервер. Исходная книга и отчёты исключены из Git. Учебный пример содержит синтетические данные.