nns/food-market
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
food-market/docs/sprint2-progress.md
nns ab74d06706 docs(sprint2): P1-2 done 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-28 09:24:52 +05:00

3.7 KiB
Raw Blame History

Спринт 2 — складские документы (P1)

Автономная работа. После каждого пункта: dotnet build (SDK 8.0.126), unit + integration + (где применимо) E2E тесты этого пункта, коммит порцией, отметка [x] здесь, коммит прогресса.

Multi-tenant: все новые сущности — TenantEntity с OrganizationId + query filter. Stock-инвариант: после каждого Post/Unpost Stock.Quantity ≡ Σ StockMovement для (Product, Store).

Чек-лист

  1. P1-1 Оприходование (Enter) — Domain Enter+EnterLine, EF, миграция, контроллер CRUD + Post/Unpost (Stock + StockMovement тип Enter), Web /inventory/enters. Без поставщика (источник — начальные остатки, излишек инвентаризации). ✅ Контроллер api/inventory/enters; миграция Phase6a_Enters; пункт «Оприходования» в сайдбаре Admin/Storekeeper. Тесты: 4 интеграционных (post raise stock, unpost откатывает, double post→409, tenant-изоляция, блокировка unpost при минусе).
  2. P1-2 Списание (Loss) — Domain Loss+LossLine + enum LossReason (Defect/Expired/Damage/Shortage/Other). EF, миграция, контроллер, Web, StockMovement тип WriteOff. ✅ Контроллер api/inventory/losses (CRUD + Post/Unpost) с проверкой «не списать сверх остатка» (409). Миграция Phase6b_Losses. Web с фильтром по причине и колонкой stockAtStore. Тесты: 3 интеграционных (post снижает stock, over-write-off → 409, tenant-изоляция).
  3. P1-3 Перемещение (Transfer) — Domain Transfer+TransferLine (FromStoreId → ToStoreId, обязательны и различны). Атомарная транзакция: TransferOut из From + TransferIn в To. EF, миграция, контроллер + Post/Unpost, Web. Кейс: post→unpost не оставляет orphan-движений.
  4. P1-4 Инвентаризация (Inventory) — Domain Inventory+InventoryLine (productId, bookQty, actualQty, diff). EF, миграция. Контроллер: создание подгружает текущие остатки; Post создаёт InventoryAdjustment на diff. Web: форма со списком товаров склада, импорт CSV факта.
  5. P1-6 Возврат от покупателя (CustomerReturn) — расширение RetailSale опцией возврата (referenceSaleId или без). Контроллер: создание возврата из проведённой продажи, CustomerReturn тип уже есть. Web: кнопка «Создать возврат».
  6. P1-7 Возврат поставщику (SupplierReturn) — по аналогии для Supply. Domain SupplierReturn+Line (referenceSupplyId). Контроллер. Web.
  7. P1-16 Hangfire dashboard + cleanup — Hangfire.Dashboard с авторизацией только для SuperAdmin. Scheduled: ежедневный cleanup StockMovement старше 2 лет, audit-log старше 90 дней.

Лог

  • Каждый пункт: build + тесты + коммит порцией + отметка [x] + коммит прогресса.
  • Все правки на ветке main (origin Forgejo), без коммита global.json.