zuevav
d5b5597c67
Содержимое первого коммита:
- Структура моно-репо: cmd/{lk-gateway,m2m-core,nsd-adapter,lk-emulator,notify}/,
internal/{m2m,nsdxml,fansystore,notify}/, services/crypto-service/,
web/admin-ui/, deploy/docker-compose/, migrations/, docs/.
- Заглушки main.go во всех cmd/ — make build проходит из коробки.
- Makefile с целями build/test/lint/fmt/vet/tidy/ci/compose-up/compose-down.
- .golangci.yml, .gitignore, README.md (на русском).
- .claude/settings.json — общие ограничения Claude Code для команды
(запрет sudo, rm -rf, доступа к /etc/cryptopro, /var/cryptopro).
- README в каждом каталоге — назначение и стадия (M1..M5).
- docs/architecture/overview.md — выжимка из плана проекта.
- docs/fansy-contract/v1/, docs/lk-contract/v1/ — точки сборки контрактов
с командами Fansy и ЛК клиента.
- deploy/docker-compose/docker-compose.yml — dev-стек (PostgreSQL, MinIO).
- scripts/setup-dev-vm.sh — первичная подготовка dev-ВМ под РЕД ОС 7.x
и Ubuntu 22.04+ (для компаний без бюджета на лицензии); ставит Go 1.23,
Liberica JDK 21, Node.js 20 LTS, Podman, podman-compose, Claude Code CLI;
создаёт пользователя dev, /srv/dev, аудит-history. Идемпотентен.
- scripts/README.md — описание скрипта и ограничений.
Что НЕ коммитим:
- Секреты, ключи, сертификаты — закрыто в .gitignore.
- Локальные настройки Claude Code (settings.local.json) и сессионные
каталоги (.claude/projects/, .claude/worktrees/, .claude/logs/).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
34 lines
2.1 KiB
Markdown
34 lines
2.1 KiB
Markdown
# docs/fansy-contract/v1 — контракт данных с командой Fansy
|
|
|
|
ETL Fansy → принимающая БД (`fansy-store`) реализует **другая команда
|
|
разработки**. С нашей стороны:
|
|
|
|
1. Спроектировать таблицы по требованиям документации НРД к данным M2M.
|
|
2. Передать команде Fansy DDL и контракт данных.
|
|
3. Согласовать тип load (UPSERT в staging), окна обновления, SLA на
|
|
свежесть данных.
|
|
4. Не давать ETL-роли DDL-прав в принимающей схеме.
|
|
|
|
Состав каталога (создаём в M1, отправляем в начале M2):
|
|
|
|
- `ddl/` — `*.sql` миграции PostgreSQL для всех таблиц.
|
|
- `data-dictionary.md` — семантика каждого поля (источник в Fansy,
|
|
nullable, единицы, примеры).
|
|
- `etl-requirements.md` — требования к процессу выгрузки: тип load,
|
|
расписание, способ записи, окна простоя, обработка ошибок,
|
|
конфиденциальность.
|
|
- `examples/` — пример заявки M2M «end-to-end», 5–10 тестовых клиентов
|
|
и заявок для совместного приёмочного теста.
|
|
|
|
Минимальный набор таблиц (см. план):
|
|
|
|
- Депоненты / клиенты.
|
|
- Документы инвестора (`IdentityDocumentCodeEnum`).
|
|
- ИИС-договоры (`IIAContractTypeEnum ∈ {T12, T03}`).
|
|
- Депо-счета и разделы (`AccountId`, `SectionId`, `DeponentCode`).
|
|
- Реквизиты расчётов (ИНН депозитария).
|
|
- Портфели и остатки (Whole / Fractional, `IsolationStatus = SGDN`).
|
|
- Справочник ЦБ (`SecurityCode`, `ISIN`, `Classification`, `Category`).
|
|
- Контрагенты-участники сервиса MOST (Справочник пользователей).
|
|
- Audit / staging-таблицы для каждой основной.
|