From 8d7a0be485676431b6019b9d7a31a1a1eee12331 Mon Sep 17 00:00:00 2001 From: Moldabayev_d Date: Mon, 21 Sep 2026 08:16:41 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=D1=82=D0=BE=D1=87=D0=BD=D1=8B=D0=B9=20?= =?UTF-8?q?README=20=D0=B1=D0=B5=D0=B7=20=D0=B2=D1=8B=D0=B4=D1=83=D0=BC?= =?UTF-8?q?=D0=B0=D0=BD=D0=BD=D0=BE=D0=B9=20=D1=81=D1=82=D1=80=D1=83=D0=BA?= =?UTF-8?q?=D1=82=D1=83=D1=80=D1=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 50 ++++++-------------------------------------------- 1 file changed, 6 insertions(+), 44 deletions(-) diff --git a/README.md b/README.md index fac2b78..0d17c33 100644 --- a/README.md +++ b/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. Учебный пример содержит синтетические данные.