food-market/docs/menu-links-progress.md

Menu links: достижимость новых страниц Sprint 31

Проблема (от координатора). Маршруты /purchases/invoices, /purchases/invoices/:id, /purchases/supplies/scan и /inventory/mobile объявлены в App.tsx, но пользователь к ним никак не доберётся: ни в sidebar (AppLayout.tsx), ни в CommandPalette, ни в QuickActionsPalette ссылок нет. На страницах /purchases/supplies и /inventory/inventories тоже нет кнопок, которые бы вели на новые UX-ветки.

Условия задачи.

• Админ + Кладовщик видят новые пункты; Кассир — нет.
• Пункты видны в простом режиме (isAdvancedMode === false) тоже — это базовые приёмка/инвентаризация, а не расширенные фичи.
• i18n: ru обязательно, en — потому что меню переводится.
• Playwright-проход «кликами с главной» на desktop (1280×800) + mobile (375×667) под demo-keeper и demo-admin; плюс негатив-проход для demo-cashier.
• Аудит сирот: диффим <Route path> из App.tsx против фактических точек входа.

Границы. Не трогаем прод, global.json, deploy/*/nginx.

Чек-лист

• 1. Главное меню AppLayout — пункты «Накладные (по фото)» (/purchases/invoices) в разделе «Закупки» и «Инвентаризация с телефона» (/inventory/mobile) в разделе «Остатки» для ролей Admin / Storekeeper; видны в простом режиме; i18n ru + en.
• 2. Dropdown-кнопки входа на /purchases/supplies и /inventory/inventories: «Новая приёмка ▾» → Вручную / По фото накладной / Сканированием; «Новая инвентаризация ▾» → Вручную / С телефона.
• 3. CommandPalette (Cmd+K) + QuickActionsPalette (Cmd+J): добавить invoices, supply-scan, inventory-mobile в соответствующие списки.
• 4. ПРОВЕРКА ГЛАЗАМИ — Playwright stage-ui-menu-links.spec.ts: 3 новых страницы кликами с главной под demo-keeper и demo-admin, desktop + mobile; скриншоты в tests/e2e/reports/. Негатив для demo-cashier.
• 5. Аудит «сирот» — скрипт tests/scripts/menu-orphans-audit.mjs, отчёт в docs/menu-orphans-report.md.
• 6. ~/deploy-stage.sh + ретест п.4 на свежем stage.

Протокол выполнения

1. Главное меню (AppLayout)

src/food-market.web/src/components/AppLayout.tsx:

• В секцию «Остатки» (section_inventory) добавлен пункт nav.inventoryMobile → /inventory/mobile (icon Smartphone), виден под условием isAdmin || isStorekeeper — т.е. без isCashier — и в простом режиме, не завязан на advanced.
• В секцию «Закупки» (section_purchases) — пункт nav.invoices → /purchases/invoices (icon Camera), те же роли, без advanced-гарда.
• Параллельно вскрылся сирота /admin/diagnostic (см. п.5) — добавлен в section_admin под Admin'ом (icon Stethoscope).
• i18n: обновили locales/ru.json + locales/en.json (nav.inventoryMobile, nav.invoices, nav.diagnostic).

2. Split-кнопки на list-страницах

Новый компонент src/food-market.web/src/components/SplitButtonMenu.tsx — dropdown-кнопка «Новая …» с клавиатурной навигацией (↑↓/Enter/Esc, click-outside). Использована:

• SuppliesPage.tsx: «Новая приёмка ▾» → Вручную (/purchases/supplies/new), По фото накладной (/purchases/invoices), Сканированием (/purchases/supplies/scan).
• InventoriesPage.tsx: «Новая инвентаризация ▾» → Вручную (/inventory/inventories/new), С телефона (/inventory/mobile). Селекторы data-testid=supplies-new-dropdown, inventories-new-dropdown, плюс каждый пункт меню — для e2e.

3. CommandPalette + QuickActions

components/CommandPalette.tsx: добавлены page:invoices, page:supply-scan, page:inventories (ранее отсутствовал), page:inventory-mobile в STATIC_PAGES. Иконки Camera, ScanLine, ClipboardCheck, Smartphone. components/QuickActionsPalette.tsx: действия invoice-new, supply-scan, inventory-mobile в ACTIONS.

4. Playwright-проверка глазами

tests/e2e/scenarios/stage-ui-menu-links.spec.ts — 5 тестов:

• demo-keeper / desktop — ✓ 10.5s
• demo-keeper / mobile — ✓ 24.1s (drawer открывается hamburger'ом)
• demo-admin / desktop — ✓ 10.5s
• demo-admin / mobile — ✓ 10.3s
• demo-cashier negative — ✓ 3.9s (нет пунктов «Накладные (по фото)», «Инвентаризация с телефона», и раздела «Приёмки»)

Итого 5/5 passed за 60 секунд против свежего stage (https://test.admin.food-market.kz). Логин через sentinel-пароль __QUICK_LOGIN_PWLESS__ (тот же механизм, что SPA использует при клике по карточке demo-аккаунта).

Скриншоты в tests/e2e/reports/: menu-links-{demo-admin|demo-keeper}-{desktop|mobile}-{invoices|supply-scan|inventory-mobile}.png (12 позитивных) + menu-links-demo-cashier-desktop-sidebar.png.

5. Orphan-audit

tests/scripts/menu-orphans-audit.mjs — парсит App.tsx, диффит все <Route path="…"> из tenant-ветки против всех строк, встречающихся в sidebar / CommandPalette / QuickActionsPalette / split-кнопках SuppliesPage.tsx + InventoriesPage.tsx.

Классификация: 57 tenant-маршрутов → 20 служебных (/login, /auth-bridge, /:id-формы, /new-формы, супер-админ), 37 проверяемых. После всех правок: 0 сирот. Отчёт — docs/menu-orphans-report.md.

Первый прогон обнаружил /admin/diagnostic — исправлено в п.1.

6. Deploy stage + retest

~/deploy-stage.sh → [stage] OK — https://test.admin.food-market.kz. После деплоя тот же stage-ui-menu-links.spec.ts — 5/5 passed.

Итог

Все 6 шагов выполнены. Новые экраны Sprint 31 полноценно встроены в навигацию: sidebar + Cmd+K + Cmd+J + split-кнопки на list-страницах. Автоматический orphan-audit в tests/scripts/menu-orphans-audit.mjs можно гонять в CI как регрессионную защиту от повторения проблемы.

Прод, global.json, deploy/nginx* — не трогались.