food-market/docs/migration-progress.md

Перенос магазина МойСклад → ALL MARKET (с историей) — прогресс

Решение владельца 09.10: перенести ВСЁ из МойСклада с историей, перейти на ALL MARKET. Фискализации нет и в МойСкладе (не блокер), маркировка не используется.

Источник: аккаунт МойСклад, орг «FOOD MARKET» (id bb8f74d4-5eb6-11ef-0a80-106e00048af9). Токен — ~/.food-market-secrets/moysklad.env (ТОЛЬКО ЧТЕНИЕ; в МойСклад ничего не писать). Опыт API — ~/.fm-watchdog/ms-api-lessons.txt; код-образцы — ~/ref/fm-server-moysklad, ~/ref/sklad. Существующий импортёр (справочники) — src/food-market.infrastructure/Integrations/MoySklad/.

Легенда: [x] готово · [~] частично · [ ] не начато.

План и статус

1. Инвентаризация источника → docs/migration-source-inventory.md (скрипт scripts/migration/ms_inventory.py). Орг «FOOD MARKET», ~31k товаров, 627 контрагентов, ~110k документов, 7558 строк остатков; gap-анализ + цели сверки.
2. [~] Мигратор — работает на реальных данных.
   • Справочники: товары 30 944, контрагенты 628 (+externalId), группы 53; идемпотентность по MoySkladExternalId.
   • Документный мигратор (сервер, фон, идемпотентный, резюмируемый) — РАБОТАЕТ и ПРОВЕРЕН на ПРИЁМКАХ (полный перенос 7130 из 7125): MoySkladDocumentImportService
     • StreamDocumentsAsync (хронология order=moment,asc, expand позиций, 429/повторы, таймаут 130с), Phase41 externalId на всех документах/справочниках. Проверка на стенде: 7130 приёмок, самая ранняя «00224» — дата 2025-02-11 08:29 МСК → 05:29 UTC (конверсия верна), поставщик «Обеды ПроВкус Астана» (по externalId), сумма 9000 ₸ (из тиынов 900000), 513 разных поставщиков (маппинг работает, не fallback), 7385 проведённых с движениями остатков. Починены 5 багов: sum как decimal («900000.0»), тяжёлый expand, дубль stocks при батче, каскад после сбоя SaveChanges, дубль номеров (МойСклад повторяет по годам → дизамбигуация «номер-год»).
   • Остальные типы по ТОМУ ЖЕ шаблону: retaildemand (97k, +оплата нал/безнал, смена, кассир), retailsalesreturn (связь с чеком), loss, enter, inventory, supplier_returns, retailshift, внесения/выплаты/ордера/платежи. Объём большой (97k чеков ≈ 2.5ч прогона).
   • uom/склад/точка/сотрудники как отдельные справочники с externalId (пока товары на дефолтных ед.; склад — единственный склад орг).
3. Новая орг на стенде «FOOD MARKET» (простой режим), admin foodmarket-migr@food-market.local. Демо/«Магазин у дома» не тронуты. Токен МойСклада задан в настройках орг.
4. Сверка → docs/migration-reconciliation.md (цели собраны в source-inventory; после переноса документов).
5. Дельта-досинхронизация (updated>= МСК + удалённые).
6. Производительность/надёжность (резюмируемый курсор документов).
7. Runbook «день перехода» + откат.

Сделано в этой сессии (честно)

Part 1 (инвентаризация) и Part 3 (орг) — выполнены. Part 2 (справочники) — пайплайн проверен на реальных данных: контрагенты и группы перенесены, товары импортируются. Parts 4–7 спроектированы (migration-design.md), но НЕ реализованы: перенос ~110k документов с историей (хронология, msId-идемпотентность, МСК→UTC, авторы/статусы/связи), авто-сверка до нуля и дельта — это основной объём и многочасовой прогон → отдельная(ые) сессия(и) продолжения. Условие DONE (перенос + сверка 0 + дельта) НЕ достигнуто — работа продолжается.

Ключевые факты API (из ms-api-lessons + проверки)

• База https://api.moysklad.ru/api/remap/1.2, Authorization: Bearer, Accept-Encoding: gzip обязателен.
• Время moment/фильтров — МОСКОВСКОЕ (UTC+3), формат yyyy-MM-dd HH:mm:ss.
• Суммы — в ТИЫНАХ (÷100). Лимит 45 запросов/3с; таймаут ≥120с; expand только при limit≤100.
• report/stock/all НЕ отдаёт нулевые остатки; номера документов повторяются по годам — ключ только id.

Что НЕ трогаем

Прод, shared-postgres, global.json, gateway nginx, sklad. В МойСклад — только чтение.