ecc789667f
- financial_statement_line: снята уникальность (meta_id, line_code); row_index, source_ref (частичный уникальный индекс), line_status (enum statement_line_status), line_code_text, parent_row_index, needs_review, is_confirmed - financial_statement_value: source_text, needs_review (хранится — пересмотр п. 4 v5.13), is_confirmed, confirmed_by/at; financial_statement_column: period_kind, label_confidence; financial_statement_meta: form_variant (enum statement_form_variant), needs_review_fields - новая таблица document_issue + enum document_issue_kind, issue_severity, issue_source - recognition_job.statements_version; document: file_ordinal, уникальность типа на файл — только не для BALANCE/INCOME (Р-10); related_group.crm_id (arm-core#112) - changelog и правила заполнения миграции в шапке; entities-v5.19.md; диаграммы части 01, 04, 06 (document_issue — в части 06); ссылки на текущую модель и DBML в Makefile — v5.19 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BJKMLHdxMwSUeYcdkwqX4W
66 lines
9.0 KiB
Markdown
66 lines
9.0 KiB
Markdown
# 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 — историческое |
|
||
|
||
## Макет UI
|
||
|
||
`dkb_24.09.26` — HTML-макет экранов (у пользователя; в экспорт не вошёл). В DBML ссылки «Макет: …» указывают на экран
|
||
и элемент. Экраны: Группы компаний, Юридические лица, ГСК/ГСЗ, Пользователи, Изменение ролей и прав, Консолидации,
|
||
Первичные документы, Чек-лист, Проверка распознавания, Сводная ОСВ, Шахматка, Таблица корректировки, Гудвилл, КФО,
|
||
Подтверждение КФО клиента, Единое хранилище, Журнал действий.
|
||
|
||
## Тестовые данные
|
||
|
||
См. `06-test-data.md`.
|