docs: точный README без выдуманной структуры
This commit is contained in:
parent
de6a2b3c28
commit
8d7a0be485
50
README.md
50
README.md
@ -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. Учебный пример содержит синтетические данные.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user