arm-ka-docs/context/08-source-docs-index.md
2026-10-02 23:02:44 +04:00

65 lines
8.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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), подходы | «Методика» |
Конвертировать в markdown (`pandoc --to gfm --wrap=none`) и положить рядом с docx — агенту удобнее искать по тексту.
## Модель и артефакты (`docs/model/`)
| Файл | Что |
|---|---|
| `data-model-v5.13.dbml` | источник истины; changelog v5.1…v5.13 в шапке; блоки «ИСТОЧНИК» над каждой таблицей |
| `entities-v5.13.md` | описание сущностей по частям 01–09, сценарий «как читать модель», открытые вопросы |
| `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`.