# 08. Индекс исходных документов

Где что лежит, насколько актуально и как пользоваться. Актуальность: ✅ актуально; ⚠️ алгоритм актуален, имена таблиц v4;
🕰 историческое, читать только для контекста; ⬜ пусто.

## Confluence — «АРМ КА. Техническое задание» (экспорт в `docs/source/tz/`)

| Код | Страница | Файл | Статус | Что брать |
|---|---|---|---|---|
| DOC-019855 | АРМ КА. Техническое задание (корень) | `АРМ КА.Техническое задание.md` | 🕰 | только «Описание этапов» 2.2 как общий сценарий |
| DOC-019834 | 2. Модель данных (сущности) | `… - 01_2. Модель данных (сущности).md` | 🕰 | DBML v4 — не использовать; принципы те же, что в v5.13 |
| DOC-036960 | 5. Ролевая модель | `… - 02_5. Ролевая модель.md` | ✅ | матрица ролей по статусам → §10 правил |
| DOC-221273 | 9. Загрузка документов для КФО | `… - 03_9. Загрузка документов для КФО.md` | ⚠️ | UI панели «Первичные документы», чек-лист, экран проверки; UC-01…05 |
| DOC-259006 | Периоды загружаемой отчётности | `… - 03_9 … - 01_Периоды загружаемой отчетности.md` | ✅ | §2 правил |
| DOC-037736 | 3. Пользовательский сценарий | `… - 04_3. Пользовательский сценарий.md` | ⚠️ | критерии приёмки (50 МБ, 5 мин, UUID v4); схемы — картинки |
| DOC-221274 | Пользовательские сценарии подробно | `… - 04_3 … - 01_Пользовательские сценарии подробно.md` | 🕰 | черновик |
| DOC-036826 | 1. Аутентификация и авторизация | `… - 05_1. Аутентификация и авторизация.md` | ⚠️ | JWT РАИСА → email → пользователь; роли назначает администратор |
| DOC-037739 | 7. Функциональные требования | `… - 06_7. Функциональные требования.md` | ⬜ | — |
| DOC-037740 | FNR01 Модуль загрузки документов и создания записи | `… - 06_7 … - 01_FNR01 ….md` | ⚠️ | маппинг ОСВ, периодов, JSON OCR → §1, §11 правил |
| DOC-260010 | Парсинг ОСВ | `… - 01_FNR01 … - 01_Парсинг ОСВ.md` | ✅ | §1 правил — главный документ парсера |
| DOC-221275 | FNR02 Передача PDF в ИС Сканирование | `… - 02_FNR02 ….md` | ⚠️ | контракт горячих папок и JSON; маппинг в старые таблицы игнорировать |
| DOC-221276 | FNR03 Работа с созданной записью | `… - 03_FNR03 ….md` | ⚠️ | пары счетов ББ/ОФР, пороги, шаги консолидации (самый полный, самый старый по именам) |
| DOC-221279 | 8. Формирование отчётов | `… - 07_8. Формирование отчетов.md` | ⬜ | — |
| DOC-221277 | «Шахматка» | `… - 07_8 … - 01__Шахматка_.md` | ⚠️ | §6 правил |
| DOC-223044 | Автоматическое сопоставление ВГО | `… - 07_8 … - 02_Автоматическое сопоставление ВГО.md` | ✅ | §4–5 правил — главный документ матчинга |
| DOC-259025 | Гудвилл | `… - 07_8 … - 03_Гудвилл.md` | ⚠️ | §8 правил |
| DOC-227278 | Корректировка данных | `… - 07_8 … - 04_Корректировка данных.md` | ✅ | §8 правил |
| DOC-221278 | Сводная ОСВ | `… - 07_8 … - 05_Сводная ОСВ.md` | ⚠️ | §3 правил, алгоритм ручного сопоставления |
| DOC-037734 | 4. Статусная модель | `… - 08_4. Статусная модель.md` | ✅ | §9 правил |
| DOC-221280 | 6. Справочник «Группы компаний и организации» | `… - 09_6. Справочник ….md` | ⚠️ | первая половина (модалки, импорт) актуальна; UC-01…05 — старая модель |
| DOC-221281 | 10. Автоматические логические проверки отчётности | `… - 10_10 ….md` | ✅ | §7 правил |

Экспорт неполный: вложения (xlsx состава ГК, DBML part1), картинки макетов и BPMN не выгружены. Актуальные версии БФТ и BPMN
живут в Confluence банка; версии из прежних чатов — устарели.

## Первоисточники требований (docx, `docs/source/biq/`)

| Документ | Что это | Как ссылаются |
|---|---|---|
| ТЗ бизнес-инициативы BIQ-34 «…создание Единой базы финансовых данных клиентов и автоматизация процесса консолидации отчетности» | основное ТЗ АРМ КА: разделы 5.1 (сценарии/подходы), 6.1–6.10 (функции), 7 (нефункциональные), 8.1–8.4 (роли, журнал, хранение), Прил. 2 (сущности), Прил. 3 (статьи ББ и пары счетов), Прил. 4 (ОФР), Прил. 8 (гудвилл), Прил. 9 (корректировки), Прил. 10 (КФО) | «ТЗ 6.4», «Прил. 3», «сноска 29» |
| ТЗ BIQ-34649 «…создание Единого хранилища финансовых данных клиентов» | ЕХ: разделы 5.2–5.3, 6.1–6.7, 7, 8.3 | «ЕХ ТЗ 6.2», «ЕХ 7» |
| Методика КФО ГСК (ред. 10.03.2026, правки приняты) | методология консолидации, пороги, правило «процент к наименьшему» (сноска 14), подходы | «Методика» |
| `source/biq/ecp-export-lagal-entity.xlsx` — выгрузка ЕЦП CRM (лист «Выписки_01.04.26») | реальная выгрузка справочника клиентов: 8400 строк, колонки `ИНН`, `iD ГК`, `Базовый РФ ГК в CRM`, `Группа компаний`, `Организация`, `ГСК`, `ГСЗ`, `Тип`; 345 ГК. Первоисточник формата импорта `05-domain-rules.md` §13. Добавлена владельцем 04.10.2026; **внутренние данные** (реальные ИНН и названия клиентов) — наружу не передавать, в тесты берётся срез `fixtures/directories/` | «выгрузка ЕЦП», §13 |

Конвертировать в markdown (`pandoc --to gfm --wrap=none`) и положить рядом с docx — агенту удобнее искать по тексту.

## Модель и артефакты (`docs/model/`)

| Файл | Что |
|---|---|
| `data-model-v5.14.dbml` | источник истины; changelog v5.1…v5.14 в шапке; блоки «ИСТОЧНИК» над каждой таблицей (v5.13 остаётся рядом как история) |
| `entities-v5.14.md` | описание сущностей по частям 01–09, таблицы «Что изменилось в v5.14 / v5.13», сценарий «как читать модель», открытые вопросы (v5.13 остаётся как история) |
| `diagrams/part01…09.{svg,png}` | диаграммы v5.12 (на шаг старше) |
| `data-model-part1_4.dbml` | v4 часть 1 — историческое |

## Макет UI

`dkb_24.09.26` — HTML-макет экранов (у пользователя; в экспорт не вошёл). В DBML ссылки «Макет: …» указывают на экран
и элемент. Экраны: Группы компаний, Юридические лица, ГСК/ГСЗ, Пользователи, Изменение ролей и прав, Консолидации,
Первичные документы, Чек-лист, Проверка распознавания, Сводная ОСВ, Шахматка, Таблица корректировки, Гудвилл, КФО,
Подтверждение КФО клиента, Единое хранилище, Журнал действий.

## Тестовые данные

См. `06-test-data.md`.