Files
Bridge-and-Join-s/docs/fansy-contract/v1
zuevav d5b5597c67 chore: каркас моно-репо и скрипт первичной подготовки dev-ВМ
Содержимое первого коммита:
- Структура моно-репо: 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>
2026-05-05 14:42:18 +03:00
..

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-таблицы для каждой основной.