a12c0779db
§5: два уровня по тройке (правило × A × B) — сумма элиминации (агрегат min(ΣA, ΣB), порог 5 %, идёт в КФО) и упаковка строк 1:1 / 1:N / N:1 (N ≤ 5, N:M нет, минимальная по числу строк, ничья → ручное). §8: eliminated_auto — Σ троек. OQ-07 закрыт решением владельца 19.10.2026; новый OQ-169 — пересечение счетов правил (двойная элиминация). Документ для аналитика: разделы 3.2, 3.3, 5, вопросы В-2 (решён), В-4, В-12. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
10 KiB
10 KiB
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…В-12 (19.10.2026, #132; сопоставление по OQ-07 — #136) |
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.