food-market/docs/mobile-api-progress.md

Доработки сервера для iOS «FM Склад» — прогресс

Автономная задача владельца (08.10.2026). Приложение (SwiftUI) на Маке владельца использует API стенда; серверу не хватает ряда возможностей. Стенд — не трогаем прод.

План (пункты владельца)

1. /api/inventory/stock?groupId= — фильтр по группе с вложенными подгруппами (через денормализованный ProductGroup.Path, helper DescendantGroupIdsAsync).
2. POST /api/catalog/products/{id}/barcodes {code, kind} — добавление штрихкода, уникальность в орг ((OrganizationId,Code)), 409 «штрихкод уже у товара X» + название, идемпотентно при повторе тому же товару, 400 на пустой, автоопределение типа по длине.
3. /api/me → permissions (эффективные флаги RolePermissions с учётом роли и простого/расширенного режима; единый источник RolePermissions.Effective). Веб — хук useCan() на том же источнике (раньше гейтил по именам ролей/advancedMode).
4. Офлайн-каталог (ProductSyncDto): добавлен явный isWeighed (+ уже были packaging, unitCode).
5. Весовые этикетки: настройки организации (WeightBarcode*: enabled/префиксы веса/ префиксы цены/длина кода), миграция Phase35; парсер вынесен в food-market.shared/Barcodes/WeightedBarcode (кассы pos.core делегирует туда); by-barcode разбирает весовую этикетку → товар + количество (вес) / встроенная цена. GET/PUT /api/organization/settings отдаёт/принимает настройки (round-trip-safe).
6. Тесты: unit 10 (WeightedBarcode + RolePermissions.Effective) + 4 integration (группа/штрихкод/me-права/весовая этикетка); docs/mobile-api.md. Деплой на стенд — см. ниже.

НЕ трогать: прод, shared-postgres, global.json, gateway nginx, sklad. — соблюдено.

Изученная база

• /api/inventory/stock — StockController.GetStock (storeId/productId/search/includeZero/ page/sort). Группы: ProductGroup иерархична, есть денормализованный Path («Родитель/Дочь/Внук») → фильтр по вложенным через префикс Path.
• Штрихкоды: ProductBarcode(Code, Type:BarcodeType, IsPrimary), уникальный индекс (OrganizationId, Code). Поиск — GET /api/catalog/products/by-barcode/{value} и quick-search.
• /api/me — minimal-endpoint в Program.cs: sub/name/email/roles/orgId/hasLiveOrg/ hasActiveEmployee/advancedMode. Прав (RolePermissions) НЕ отдаёт.
• Права: RolePermissions (флаги) на роль сотрудника; PermissionAuthorizationHandler (SuperAdmin/Admin → все; иначе роль активного Employee). RequiresAdvancedMode гейтит модули Demands/Transfers/Loyalty/Promotions/PriceTypes/ABC/Audit/Telegram/Presets. Веб гейтит по именам ролей + advancedMode (дублирование — свести к единому источнику).
• POS-синк каталога: ProductSyncDto (есть Packaging 1/2/3 + UnitCode), нужен явный IsWeighed.
• Весовой парсер уже есть в pos.core/Logic/BarcodeParser.cs (префикс 20–24 вес, 25–29 цена) — вынести в food-market.shared, сделать настраиваемым, использовать и на сервере, и в кассе.
• Миграции — ручные Phase-файлы (raw SQL, IF NOT EXISTS) с [DbContext]+[Migration].

Итог

Все 6 пунктов выполнены. Тесты зелёные: 10 unit (WeightedBarcode + RolePermissions.Effective)

• 4 integration (группа/штрихкод/me-права/весовая этикетка) + регресс POS 9/9. Задеплоено на стенд (~/deploy-stage.sh): guard isolation OK, api+web собраны/запушены, stage-api Healthy, миграция Phase35 применена (4 колонки WeightBarcode* в organizations на stage-БД проверены), https://test.admin.food-market.kz OK. Прод/shared-postgres/global.json/gateway/sklad — не трогали.

Для мобильного клиента см. docs/mobile-api.md.

Коммиты

• 5173eaa feat(catalog): штрихкоды товара — добавление + весовые этикетки
• 7231c83 feat(inventory): фильтр остатков по группе товаров с вложенными
• 2a4ba14 feat(auth): эффективные права пользователя в /api/me (единый источник)
• 1400106 test(mobile-api): unit + integration доработок для «FM Склад»
• ad812ee docs(mobile-api): описание API для мобильного клиента + прогресс

Журнал

• 08.10 — старт; изучена база; план зафиксирован.
• 08.10 — реализованы все 6 пунктов; 14 новых тестов зелёные; деплой на стенд, миграция применена.