nns/food-market
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
food-market/docs/sklad-port-20261005-progress.md
nns 6b0fc68f77
Some checks are pending
Auto-tag / Create date-tag (push) Waiting to run
Details
CI / Backend (.NET 8) (push) Waiting to run
Details
CI / Web (React + Vite) (push) Waiting to run
Details
CI / POS (WPF, Windows) (push) Waiting to run
Details
Docker API / Build + push API (push) Waiting to run
Details
Docker API / Deploy API on stage (push) Blocked by required conditions
Details
Docker Web / Build + push Web (push) Waiting to run
Details
Docker Web / Deploy Web on stage (push) Blocked by required conditions
Details
feat(invoices+inventory): порт улучшений 05.10.2026 из sklad 
Диапазон коммитов f455fa9..b7eb637 + 3ced706 (handoff).

Backend (src/food-market.api/Infrastructure/Invoices):
- Ean.cs — контрольная цифра EAN-8/13/UPC-A/GTIN-14 (ловит одну ошибку в цифре).
- TableReader.cs — своя читалка .xlsx/.csv без библиотек, UTF-8/1251,
  .xls → понятная ошибка; TableInvoiceParser — шаблон накладной.
- InvoiceModels: +Photo/BarcodeSource/Note в InvoiceLine, PhotoHint,
  IInvoiceExtractor.ExtractPhotosAsync.
- InvoiceMatcher.FindByBarcode — для photo-matching.
- InvoiceProcessor: ветки photos/excel/vision, MatchFromPhoto с EAN-проверкой
  (barcode_source="read" → валидация), SweepAbandonedPhotosAsync раз в час
  убирает папки needs_review старше 24ч; DeleteStored (owner-policy: НЕ копить).
- ClaudeCliInvoiceExtractor: ExtractPhotosAsync + BuildPhotosPrompt +
  FromPhotosJson (barcode_source → BarcodeSource, comment → Note, unmatched_photos
  → Warnings); дефолт модели claude-sonnet-5-5, PhotoTimeoutSeconds=600.

Backend (Controllers):
- POST /purchases/invoices/upload-photos (≤80 файлов, 60 МБ) +
  GET /purchases/invoices/{id}/photo/{n}; Apply/Delete убирают папку (не только файл).
- InvoiceDetailDto +Source/+HasFiles — клиент не ломится за 404 миниатюрами.
- POST /inventory/inventories/import — xlsx/csv → {found, unknown}, повторы ШК
  суммируются, документ не создаётся.
- Program.cs: UseResponseCompression + GzipCompressionProvider для application/json.
- InventoriesController.mobile-catalog: weak ETag + If-None-Match → 304;
  Cache-Control private max-age=60. Замер 31k: JSON 3.60 МБ → gzip 0.98 МБ.

Frontend:
- lib/shots.ts — ZXing TRY_HARDER на 1x+1600; compress JPEG 0.85 до 2400.
- components/PhotoSession.tsx — полноэкранная пачка (камера + готовые фото).
- components/CameraScanner.tsx: onCodeRef + эффект [], камера не закрывается
  после каждого скана.
- pages/InvoicesPage.tsx — четыре способа: камера одиночными, файл (xlsx/csv/img/pdf),
  камера многостраничная, фото-приёмка (камера или готовые фото) + «Отправить ещё раз».
- pages/InvoiceReviewPage.tsx — автосохранение 700 мс + индикатор; row-picker панель
  «в какую строку?» если fuzzy-match неуверен; linesRef; глобальный keydown; миниатюра
  снимка у строки; пометки Note.
- pages/SupplyScanPage.tsx + InventoryMobilePage.tsx — глобальный keydown.
- InventoryMobilePage: поле сканера на виду + импорт Excel/CSV.
- docs/supplier-invoice-template.xlsx — шаблон для поставщиков (9-я строка заголовки).

Хранение файлов (owner-policy 2026-10-05): фото НЕ копим.
- Обычная загрузка → удаление сразу после разбора.
- Фото-приёмка → удаление при Apply/Delete/24h abandoned.
- KeepFilesDays удалён из флоу (конфиг-ключ игнорируется).

Тесты (unit, зелёные):
- EanTests (6): валидные/невалидные/one-digit error.
- TableReaderTests (5): xlsx cells, шапка «Поставщик/Номер/Дата», CSV UTF-8+BOM,
  CSV Windows-1251, .xls friendly error.
- ClaudeCliInvoicePhotosParseTests (4): decoded проходит, source=null чистит Barcode,
  unmatched_photos → Warnings, comment → Note.
- InvoicePhotoRetentionTests (3): DeleteStored файл/папка/идемпотентность.

Preexisting ApiReferenceDocsJob (Sprint 28) failure не связан с портом.

Прогресс: docs/sklad-port-20261005-progress.md. Пользовательская инструкция:
docs/supply-inventory.md обновлена.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-10-06 00:02:13 +05:00

6.6 KiB
Raw Blame History

Порт улучшений накладных/инвентаризации из sklad (05.10.2026)

Источник: ~/ref/sklad (read-only), handoff: ~/ref/sklad/docs/handoff-2026-10-05-nakladnye-inventarizaciya.md, диапазон коммитов f455fa9..b7eb637 + 3ced706 (readme).

Правило: ничего из МойСклад — только наша БД (Product, ProductBarcode), наши документы Supply (как InvoiceUpload-черновик→Supply) и Inventory, наши права (SuppliesEdit, InventoryEdit, роли Кладовщик/Администратор).

Задачи

  • 1. Серверное автосохранение правок накладной + индикатор + lines до черновика + refetchOnWindowFocus:false
  • 2. Общее поле скана с панелью «в какую строку?» (цветные сообщения, linesRef)
  • 3. CameraScanner без перезапуска + глобальный hardware keydown на страницах накл/приёмки/инв
  • 4. Фото-приёмка (PhotoSession + shots.ts + upload-photos + Claude photos + EAN + миниатюры)
  • 5. Хранение фото: удаление на draft/delete, 24h для брошенных; без KeepFilesDays
  • 6. «Файлы» и «камера» в обоих способах приёмки
  • 7. Excel/CSV через TableReader + шаблон xlsx в docs/
  • 8. Инвентаризация: камера + видимое поле + импорт Excel/CSV
  • 9. Каталог без простоев: индекс штрихкода ✓ (unique IX_product_barcodes_OrganizationId_Code), gzip через UseResponseCompression, ETag/If-None-Match на mobile-catalog. Синтетический замер 31 000 позиций: JSON 3.60 МБ → gzip 0.98 МБ (ratio 27%).
  • 10. Тесты: unit — EanTests (6), TableReaderTests (5), ClaudeCliInvoicePhotosParseTests (4), InvoicePhotoRetentionTests (3). Build integration/e2e — зелёный.
  • 11. deploy-stage, ретест, docs/supply-inventory.md

Решения владельца

  • Хранение фото: НЕ копить. Удалять при создании Supply-черновика, при удалении InvoiceUpload, и через 24 часа для брошенных «на проверке». Никакого Invoices:KeepFilesDays.
  • Модель Claude: claude-sonnet-5-5 (Haiku сочиняет данные).
  • Тайм-аут фото-пачки: Invoices:ClaudeCli:PhotoTimeoutSeconds = 600 с.
  • Каталог: наша БД, права SuppliesEdit/InventoryEdit.
  • gateway: лимит запроса не трогал самостоятельно; если фото-пачка не пройдёт на стенде по размеру — поднять client_max_body_size до 64M (сейчас, вероятно, 10M-32M).

Что лежит где

Backend

Что Файл
Контрольная цифра EAN src/food-market.api/Infrastructure/Invoices/Ean.cs
Табличная читалка .xlsx/.csv + парсер шаблона src/food-market.api/Infrastructure/Invoices/TableReader.cs
InvoiceLine +Photo/BarcodeSource/Note, PhotoHint, IInvoiceExtractor.ExtractPhotosAsync .../InvoiceModels.cs
InvoiceMatcher.FindByBarcode .../InvoiceMatcher.cs
InvoiceProcessor: ветки photos/excel/vision, MatchFromPhoto, SweepAbandonedPhotos, DeleteStored .../InvoiceProcessor.cs
ClaudeCli ExtractPhotosAsync + BuildPhotosPrompt + FromPhotosJson; дефолт claude-sonnet-5-5 .../ClaudeCliInvoiceExtractor.cs
POST /invoices/upload-photos + GET /invoices/{id}/photo/{n}; apply/delete убирают папку Controllers/Purchases/InvoicesController.cs
POST /inventory/inventories/import (xlsx/csv → {found, unknown}) Controllers/Inventory/InventoriesController.cs
gzip response-compression + ETag на mobile-catalog Program.cs, InventoriesController.cs

Frontend

Что Файл
Общий модуль ZXing TRY_HARDER + compress 2400/0.85 + fileToCanvas src/food-market.web/src/lib/shots.ts
Полноэкранная пачка снимков (камера + готовые фото) .../components/PhotoSession.tsx
CameraScanner: onCodeRef + эффект [] (нет перезапуска камеры) .../components/CameraScanner.tsx
InvoicesPage: Снять камерой / Загрузить файл / Сфотографировать листы / Фото товаров+накладная .../pages/InvoicesPage.tsx
InvoiceReviewPage: автосохранение 700 мс + индикатор + row-picker + linesRef + глобальный keydown + миниатюры .../pages/InvoiceReviewPage.tsx
SupplyScanPage: глобальный keydown (аппаратный сканер вне фокуса) .../pages/SupplyScanPage.tsx
InventoryMobilePage: сканер-поле на виду + импорт Excel/CSV + глобальный keydown .../pages/InventoryMobilePage.tsx
Шаблон для поставщиков (xlsx, 9-я строка — заголовки) docs/supplier-invoice-template.xlsx (scripts/make_supplier_template.py)

Тесты

Что Файл
EAN корректность + 1-digit error ловится tests/food-market.UnitTests/EanTests.cs
xlsx/csv UTF-8/1251 + шаблон + .xls friendly error tests/food-market.UnitTests/TableReaderTests.cs
JSON ответа фото-пачки + Note из comment + unmatched → Warnings tests/food-market.UnitTests/ClaudeCliInvoicePhotosParseTests.cs
DeleteStored: файл, папка, идемпотентность tests/food-market.UnitTests/InvoicePhotoRetentionTests.cs

Пре-существующий отказ ApiReferenceDocsJobTests.Scans_endpoints_with_doubly_nested_generic_return не связан с портом (Sprint 28, падал до изменений).

Deploy и retest

  • ~/deploy-stage.sh (отдельно) после commit → ретест на https://test.admin.food-market.kz
  • tests/e2e/scenarios/menu-walk-demo-*.ts — не упал на новом экране (на локале web-build зелёный)

Журнал

  • 05.10.2026: порт выполнен в один проход; API build зелёный, web tsc+vite build зелёный, 18 новых unit-тестов зелёные.