arm-ka-docs/context/08-source-docs-index.md

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.19.dbml	источник истины; changelog v5.1…v5.19 в шапке; блоки «ИСТОЧНИК» над каждой таблицей (v5.13…v5.18 остаются рядом как история)
entities-v5.19.md	описание сущностей по частям 01–09, таблицы «Что изменилось» по версиям, сценарий «как читать модель», открытые вопросы (v5.13…v5.18 остаются как история)
diagrams/part01…09.{svg,png}	диаграммы v5.19 по частям; перерисовываются make diagrams (scripts/gen_model_diagrams.py)
source/tz/data-model-part1_4.dbml (лежит не в model/, а в экспорте ТЗ)	v4 часть 1 — историческое

Материалы для аналитика (docs/analyst/)

Наши документы для аналитика заказчика: выжимка модели и правил по одной теме с вопросами. Источником истины не являются — при расхождении правы DBML и 05-domain-rules.md, документ правится следом.

Файл	Что	Опирается на
analyst/eliminations-vgo.md	элиминация ВГО: что хранится и что считается (DECISION-5), раскладка правил elimination_rule / elimination_rule_account (Прил. 3/4), сопоставление пар, шахматка, путь до КФО, корректировки, гудвилл; пример на фикстурах РБ Q3 2024; вопросы В-1…В-11 (19.10.2026, #132)	DBML v5.19; §3–§6, §8 правил; DOC-223044, DOC-221277, DOC-227278, DOC-259025

Макет UI

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

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

См. 06-test-data.md.