fix(moysklad): убираем выдумку Kind полностью — у MoySklad этого поля нет

Проверил через API под реальным токеном (entity/counterparty?expand=group,tags):
у MoySklad **нет** поля «Поставщик/Покупатель» у контрагентов вообще. Есть только:
- group (группа доступа сотрудников, у всех "Основной")
- tags (произвольные ярлыки, у большинства пусто)
- state (пользовательская цепочка статусов)
- companyType (legal/individual/entrepreneur — это наш Type)

Один и тот же контрагент может быть поставщиком в одной приёмке и покупателем
в другом чеке — классификация контекстная, не атрибут сущности.

Изменения:
- ImportCounterpartiesAsync.ResolveKind теперь ВСЕГДА возвращает Unspecified.
  Никаких эвристик по тегам — просто null для Kind.
- useSuppliers хук теперь useCounterparties — возвращает ВСЕХ контрагентов,
  не фильтрует по Kind. Селекторы поставщика в Supply/RetailSale показывают
  всех. Пользователь сам выбирает кто поставщик в этом конкретном документе.
- Создание контрагента в UI: дефолт Kind = Unspecified, не Supplier.

Поле Kind в нашей модели остаётся для пользователей которые сами хотят
классифицировать. Но импорт его не трогает.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.claude/scheduled_tasks.lock

@@ -1 +0,0 @@
-{"sessionId":"fae8ce63-bd1d-4246-9a44-09731c66e311","pid":2166378,"procStart":"133122020","acquiredAt":1779943840096}

.forgejo/workflows/auto-tag.yml

@@ -1,100 +0,0 @@
-name: Auto-tag
-
-# Sprint 21: создаёт тэг `v<YYYYMMDD>.<N>` на каждый push в main,
-# если HEAD-коммит ещё не помечен. N — порядковый счётчик в пределах дня.
-#
-# Цель: иметь чёткие точки отката. После 5 push'ей в main за день
-# получим v20260607.1 .. v20260607.5; перед каждым деплоем
-# `prod-deploy.sh v20260607.5` берёт стабильный snapshot.
-#
-# Тэги создаются с annotation'ом — `git tag -a` + сообщение со ссылкой
-# на коммит. Это в свою очередь триггерит docker-api/docker-web
-# workflow'ы по `tags: ['v*']` (см. ci.yml).
-
-on:
-  push:
-    branches: [main]
-
-concurrency:
-  group: auto-tag-${{ github.ref }}
-  cancel-in-progress: false  # не отменяем тэгирование если 2 push'а быстро подряд
-
-jobs:
-  tag:
-    name: Create date-tag
-    runs-on: [self-hosted, linux]
-    if: ${{ !startsWith(github.ref, 'refs/tags/') }}
-    steps:
-      - name: Checkout (full history)
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          fetch-tags: true
-
-      - name: Skip if HEAD already tagged
-        id: check
-        run: |
-          set -e
-          EXISTING=$(git tag --points-at HEAD)
-          if [[ -n "$EXISTING" ]]; then
-            echo "HEAD уже помечен: $EXISTING — выходим"
-            echo "skip=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "skip=false" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Build next tag
-        if: steps.check.outputs.skip != 'true'
-        id: build
-        run: |
-          set -e
-          DATE=$(date -u +%Y%m%d)
-          # Найти самый большой существующий тэг за этот день.
-          PREFIX="v${DATE}."
-          LAST=$(git tag --list "${PREFIX}*" --sort=-version:refname | head -1 || true)
-          if [[ -z "$LAST" ]]; then
-            N=1
-          else
-            # Извлечь число после точки.
-            LAST_N="${LAST#${PREFIX}}"
-            # Если LAST_N не число (вдруг ручной тэг типа v20260607.rc1) — берём 1.
-            if [[ "$LAST_N" =~ ^[0-9]+$ ]]; then
-              N=$((LAST_N + 1))
-            else
-              N=1
-            fi
-          fi
-          TAG="${PREFIX}${N}"
-          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
-          echo "Будет создан тэг: $TAG"
-
-      - name: Create + push annotated tag
-        if: steps.check.outputs.skip != 'true'
-        env:
-          TAG: ${{ steps.build.outputs.tag }}
-        run: |
-          set -e
-          git config user.email "auto-tag@food-market.kz"
-          git config user.name  "auto-tag bot"
-          MSG="Auto-tag $TAG for commit ${{ github.sha }} on ${{ github.ref_name }}"
-          git tag -a "$TAG" -m "$MSG"
-          # Push через workflow-token (Forgejo Actions автоматически
-          # выставляет GITHUB_TOKEN с правом push на refs/tags).
-          # Если права не хватает — fallback на SSH/HTTPS с deploy-key.
-          git push origin "$TAG"
-          echo "Тэг $TAG создан и запушен"
-
-      - name: Generate release notes
-        if: steps.check.outputs.skip != 'true'
-        env:
-          TAG: ${{ steps.build.outputs.tag }}
-        run: |
-          set -e
-          PREV=$(git tag --sort=-version:refname --list 'v*' | grep -v "^${TAG}$" | head -1 || true)
-          if [[ -n "$PREV" ]]; then
-            bash deploy/generate-release-notes.sh "$PREV" "$TAG" --dry-run > /tmp/release-notes.md
-            echo "## Release notes ($PREV → $TAG)"
-            head -60 /tmp/release-notes.md
-          else
-            echo "(нет предыдущего тэга — release notes пропущены)"
-          fi

.forgejo/workflows/ci.yml

@@ -1,127 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-    tags: ['v*']
-    paths-ignore:
-      - '**.md'
-      - 'docs/**'
-      - '.github/**'
-  pull_request:
-    branches: [main]
-    paths-ignore:
-      - '**.md'
-      - 'docs/**'
-      - '.github/**'
-  workflow_dispatch:
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  backend:
-    name: Backend (.NET 8)
-    runs-on: [self-hosted, linux]
-    services:
-      postgres:
-        image: 127.0.0.1:5001/mirror/postgres:16-alpine
-        env:
-          POSTGRES_DB: food_market_test
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-        options: >-
-          --health-cmd "pg_isready -U postgres"
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-        ports:
-          - 5441:5432
-    steps:
-      - uses: actions/checkout@v4
-
-      # dotnet 8 SDK is pre-installed on the self-hosted runner host.
-      - name: Dotnet version
-        run: dotnet --version
-
-      # Кэшируем NuGet-пакеты по hash *.csproj — restore становится мгновенным,
-      # если зависимости не менялись.
-      - name: Cache NuGet
-        uses: actions/cache@v4
-        with:
-          path: ~/.nuget/packages
-          key: nuget-${{ runner.os }}-${{ hashFiles('**/*.csproj', 'food-market.sln') }}
-          restore-keys: |
-            nuget-${{ runner.os }}-
-
-      - name: Restore
-        run: dotnet restore food-market.sln
-
-      - name: Build
-        run: dotnet build food-market.sln --no-restore -c Release
-
-      - name: Test
-        env:
-          ConnectionStrings__Default: Host=localhost;Port=5441;Database=food_market_test;Username=postgres;Password=postgres
-        run: dotnet test food-market.sln --no-build -c Release --verbosity normal --collect:"XPlat Code Coverage" --results-directory TestResults || echo "No tests yet"
-
-      # Sprint 16: пересчитываем coverage-badge и коммитим обновлённый
-      # SVG обратно в репо. Шаг no-op если ничего не изменилось.
-      - name: Update coverage badge
-        if: success() && github.ref == 'refs/heads/main'
-        run: |
-          bash scripts/generate-badges.sh
-          if ! git diff --quiet badges/coverage.svg 2>/dev/null; then
-            git config user.email "ci@food-market.local"
-            git config user.name "Forgejo CI"
-            git add badges/coverage.svg
-            git commit -m "chore(badges): update coverage [skip ci]" || true
-            git push || echo "push skipped (no token / detached HEAD)"
-          fi
-
-  web:
-    name: Web (React + Vite)
-    runs-on: [self-hosted, linux]
-    defaults:
-      run:
-        working-directory: src/food-market.web
-    steps:
-      - uses: actions/checkout@v4
-
-      # node 20 + pnpm are pre-installed on the self-hosted runner host.
-      - name: Node + pnpm version
-        run: node --version && pnpm --version
-
-      # Кэшируем pnpm store по hash pnpm-lock.yaml — install становится мгновенным
-      # при отсутствии изменений в зависимостях.
-      - name: Resolve pnpm store path
-        id: pnpm-store
-        run: echo "path=$(pnpm store path --silent)" >> "$GITHUB_OUTPUT"
-
-      - name: Cache pnpm store
-        uses: actions/cache@v4
-        with:
-          path: ${{ steps.pnpm-store.outputs.path }}
-          key: pnpm-${{ runner.os }}-${{ hashFiles('src/food-market.web/pnpm-lock.yaml') }}
-          restore-keys: |
-            pnpm-${{ runner.os }}-
-
-      - name: Install
-        run: pnpm install --frozen-lockfile
-
-      - name: Build (tsc + vite)
-        run: pnpm build
-
-  # POS build requires Windows — no Forgejo runner for it; skipped silently.
-  pos:
-    name: POS (WPF, Windows)
-    if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'
-    runs-on: windows-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Build POS
-        run: |
-          dotnet restore src/food-market.pos/food-market.pos.csproj
-          dotnet build src/food-market.pos/food-market.pos.csproj --no-restore -c Release
-          dotnet publish src/food-market.pos/food-market.pos.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -o publish

.forgejo/workflows/docker-api.yml

@@ -1,106 +0,0 @@
-name: Docker API
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - 'src/food-market.api/**'
-      - 'src/food-market.application/**'
-      - 'src/food-market.domain/**'
-      - 'src/food-market.infrastructure/**'
-      - 'src/food-market.shared/**'
-      - 'deploy/Dockerfile.api'
-      - 'deploy/docker-compose.yml'
-      - '.forgejo/workflows/docker-api.yml'
-      - 'food-market.sln'
-  workflow_dispatch:
-
-env:
-  LOCAL_REGISTRY: 127.0.0.1:5001
-
-jobs:
-  build:
-    name: Build + push API
-    runs-on: [self-hosted, linux]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Build + push (Docker daemon layer-cache)
-        env:
-          SHA: ${{ github.sha }}
-          DOCKER_BUILDKIT: '1'
-        run: |
-          # Используем обычный docker build — у host docker daemon в
-          # /etc/docker/daemon.json уже прописан 127.0.0.1:5001 как
-          # insecure-registry, и docker layer-cache между сборками
-          # дает быстрый dotnet restore/pnpm install при стабильных манифестах.
-          docker build \
-            -f deploy/Dockerfile.api \
-            -t $LOCAL_REGISTRY/food-market-api:$SHA \
-            -t $LOCAL_REGISTRY/food-market-api:latest \
-            .
-          docker push $LOCAL_REGISTRY/food-market-api:$SHA
-          docker push $LOCAL_REGISTRY/food-market-api:latest
-
-  deploy:
-    name: Deploy API on stage
-    needs: build
-    runs-on: [self-hosted, linux]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Update compose + .env
-        env:
-          PGPASS: ${{ secrets.STAGE_POSTGRES_PASSWORD }}
-        run: |
-          # Стенд использует :latest для обоих сервисов, .env переписываем
-          # идемпотентно — без затирания тэга соседнего сервиса.
-          cat > /home/nns/food-market-stage/deploy/.env <<ENV
-          REGISTRY=127.0.0.1:5001
-          API_TAG=latest
-          WEB_TAG=latest
-          POSTGRES_PASSWORD=$PGPASS
-          ENV
-          cp deploy/docker-compose.yml /home/nns/food-market-stage/deploy/docker-compose.yml
-
-      - name: Pull + recreate api only
-        working-directory: /home/nns/food-market-stage/deploy
-        run: |
-          docker compose pull api
-          docker compose up -d --no-deps api
-
-      - name: Smoke /health
-        run: |
-          for i in 1 2 3 4 5 6; do
-            sleep 5
-            if curl -fsS http://127.0.0.1:8080/health | grep -q '"status":"ok"'; then
-              echo "Health OK"
-              exit 0
-            fi
-          done
-          echo "Health failed"
-          exit 1
-
-      - name: Notify Telegram on success
-        if: success()
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.sha }}
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=✅ stage api deployed — ${SHA:0:7} → https://food-market.zat.kz" \
-            > /dev/null
-
-      - name: Notify Telegram on failure
-        if: failure()
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.sha }}
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=❌ stage api deploy FAILED — ${SHA:0:7}" \
-            > /dev/null

.forgejo/workflows/docker-public.yml

@@ -1,103 +0,0 @@
-name: Docker Public
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - 'src/food-market.public/**'
-      - 'deploy/docker-compose.yml'
-      - '.forgejo/workflows/docker-public.yml'
-  workflow_dispatch:
-
-env:
-  LOCAL_REGISTRY: 127.0.0.1:5001
-  # Текущие production-домены (миграция со stage zat.kz, см. коммит 79406e3).
-  # Публичный сайт = test.food-market.kz, админка/API = admin.food-market.kz.
-  # Без актуальных значений CI собирал бандл с zat.kz и каждый push
-  # перетирал латест-image, ломая prod (см. коммит 2a026c5).
-  PUBLIC_SITE_URL: https://test.food-market.kz
-  PUBLIC_APP_URL: https://admin.food-market.kz
-
-jobs:
-  build:
-    name: Build + push Public
-    runs-on: [self-hosted, linux]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Build + push
-        env:
-          SHA: ${{ github.sha }}
-          DOCKER_BUILDKIT: '1'
-        run: |
-          docker build \
-            --build-arg PUBLIC_SITE_URL=$PUBLIC_SITE_URL \
-            --build-arg PUBLIC_APP_URL=$PUBLIC_APP_URL \
-            -f src/food-market.public/Dockerfile \
-            -t $LOCAL_REGISTRY/food-market-public:$SHA \
-            -t $LOCAL_REGISTRY/food-market-public:latest \
-            src/food-market.public
-          docker push $LOCAL_REGISTRY/food-market-public:$SHA
-          docker push $LOCAL_REGISTRY/food-market-public:latest
-
-  deploy:
-    name: Deploy Public on stage
-    needs: build
-    runs-on: [self-hosted, linux]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Update compose + .env
-        env:
-          PGPASS: ${{ secrets.STAGE_POSTGRES_PASSWORD }}
-        run: |
-          cat > /home/nns/food-market-stage/deploy/.env <<ENV
-          REGISTRY=127.0.0.1:5001
-          API_TAG=latest
-          WEB_TAG=latest
-          PUBLIC_TAG=latest
-          POSTGRES_PASSWORD=$PGPASS
-          ENV
-          cp deploy/docker-compose.yml /home/nns/food-market-stage/deploy/docker-compose.yml
-
-      - name: Pull + recreate public only
-        working-directory: /home/nns/food-market-stage/deploy
-        run: |
-          docker compose pull public
-          docker compose up -d --no-deps public
-
-      - name: Smoke
-        run: |
-          for i in 1 2 3 4 5 6; do
-            sleep 4
-            if curl -fsS http://127.0.0.1:8082/ -o /dev/null; then
-              echo "Public OK"
-              exit 0
-            fi
-          done
-          echo "Public smoke failed"
-          exit 1
-
-      - name: Notify Telegram on success
-        if: success()
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.sha }}
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=✅ stage public deployed — ${SHA:0:7} → https://test.food-market.kz" \
-            > /dev/null
-
-      - name: Notify Telegram on failure
-        if: failure()
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.sha }}
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=❌ stage public deploy FAILED — ${SHA:0:7}" \
-            > /dev/null

.forgejo/workflows/docker-web.yml

@@ -1,96 +0,0 @@
-name: Docker Web
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - 'src/food-market.web/**'
-      - 'deploy/Dockerfile.web'
-      - 'deploy/nginx.conf'
-      - 'deploy/docker-compose.yml'
-      - '.forgejo/workflows/docker-web.yml'
-  workflow_dispatch:
-
-env:
-  LOCAL_REGISTRY: 127.0.0.1:5001
-
-jobs:
-  build:
-    name: Build + push Web
-    runs-on: [self-hosted, linux]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Build + push (Docker daemon layer-cache)
-        env:
-          SHA: ${{ github.sha }}
-          DOCKER_BUILDKIT: '1'
-        run: |
-          docker build \
-            -f deploy/Dockerfile.web \
-            -t $LOCAL_REGISTRY/food-market-web:$SHA \
-            -t $LOCAL_REGISTRY/food-market-web:latest \
-            .
-          docker push $LOCAL_REGISTRY/food-market-web:$SHA
-          docker push $LOCAL_REGISTRY/food-market-web:latest
-
-  deploy:
-    name: Deploy Web on stage
-    needs: build
-    runs-on: [self-hosted, linux]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Update compose + .env
-        env:
-          PGPASS: ${{ secrets.STAGE_POSTGRES_PASSWORD }}
-        run: |
-          cat > /home/nns/food-market-stage/deploy/.env <<ENV
-          REGISTRY=127.0.0.1:5001
-          API_TAG=latest
-          WEB_TAG=latest
-          POSTGRES_PASSWORD=$PGPASS
-          ENV
-          cp deploy/docker-compose.yml /home/nns/food-market-stage/deploy/docker-compose.yml
-
-      - name: Pull + recreate web only
-        working-directory: /home/nns/food-market-stage/deploy
-        run: |
-          docker compose pull web
-          docker compose up -d --no-deps web
-
-      - name: Smoke /health
-        run: |
-          for i in 1 2 3 4 5 6; do
-            sleep 5
-            if curl -fsS http://127.0.0.1:8081/ -o /dev/null; then
-              echo "Web OK"
-              exit 0
-            fi
-          done
-          echo "Web smoke failed"
-          exit 1
-
-      - name: Notify Telegram on success
-        if: success()
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.sha }}
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=✅ stage web deployed — ${SHA:0:7} → https://food-market.zat.kz" \
-            > /dev/null
-
-      - name: Notify Telegram on failure
-        if: failure()
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.sha }}
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=❌ stage web deploy FAILED — ${SHA:0:7}" \
-            > /dev/null

.forgejo/workflows/notify.yml

@@ -1,18 +0,0 @@
-name: Notify CI failures
-
-on:
-  workflow_run:
-    workflows: ["CI", "Docker Images"]
-    types: [completed]
-
-jobs:
-  telegram:
-    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
-    runs-on: [self-hosted, linux]
-    steps:
-      - name: Ping Telegram
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot${{ secrets.TELEGRAM_BOT_TOKEN }}/sendMessage" \
-            --data-urlencode "chat_id=${{ secrets.TELEGRAM_CHAT_ID }}" \
-            --data-urlencode "text=CI FAILED: ${{ github.event.workflow_run.name }} on ${{ github.event.workflow_run.head_branch }} (${GITHUB_SHA:0:7}). https://github.com/${{ github.repository }}/actions/runs/${{ github.event.workflow_run.id }}" \
-            > /dev/null

.forgejo/workflows/regression.yml

@@ -1,118 +0,0 @@
-name: Regression suite
-
-# Запускается ПОСЛЕ успешного docker-api/docker-web (stage-verify),
-# когда stage уже задеплоен новой ревизией. Гонит полную регрессию
-# (35 flow-тестов + 60 visual-snapshot'ов). Время прогона цель < 15 мин.
-#
-# Если падает — Telegram-уведомление со ссылкой на playwright-html отчёт.
-
-on:
-  workflow_run:
-    workflows: ["Docker API", "Docker Web"]
-    types: [completed]
-  workflow_dispatch:
-
-jobs:
-  regression:
-    name: Regression suite на stage
-    # Не запускаемся если триггерный workflow упал — нет смысла верифировать
-    # незадеплоенное.
-    if: ${{ github.event.workflow_run.conclusion == 'success' || github.event_name == 'workflow_dispatch' }}
-    runs-on: [self-hosted, linux]
-    timeout-minutes: 20
-    env:
-      E2E_ADMIN_URL: https://test.admin.food-market.kz
-      CI: '1'
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Wait for stage /health/ready
-        run: |
-          for i in 1 2 3 4 5 6 7 8 9 10; do
-            if curl -fsS "$E2E_ADMIN_URL/health/ready" | grep -q '"status":"Healthy"'; then
-              echo "stage ready"; exit 0
-            fi
-            sleep 3
-          done
-          echo "stage NOT ready" >&2
-          exit 1
-
-      - name: Setup pnpm cache for regression suite
-        uses: actions/cache@v4
-        with:
-          path: ~/.local/share/pnpm/store
-          key: pnpm-regression-${{ runner.os }}-${{ hashFiles('tests/regression/pnpm-lock.yaml') }}
-          restore-keys: |
-            pnpm-regression-${{ runner.os }}-
-
-      - name: Cache Playwright browsers
-        uses: actions/cache@v4
-        with:
-          path: ~/.cache/ms-playwright
-          key: pw-browsers-${{ hashFiles('tests/regression/package.json') }}
-          restore-keys: |
-            pw-browsers-
-
-      - name: Install regression deps
-        working-directory: tests/regression
-        run: pnpm install --frozen-lockfile
-
-      - name: Install Playwright Chromium
-        working-directory: tests/regression
-        run: pnpm exec playwright install chromium
-
-      - name: Run flows (35 tests)
-        id: flows
-        working-directory: tests/regression
-        run: pnpm exec playwright test flows/ --reporter=list,json
-
-      - name: Run visual (60 snapshots)
-        id: visual
-        working-directory: tests/regression
-        run: pnpm exec playwright test visual/ --reporter=list,json
-
-      # Sprint 27/28: cross-feature integration suite (отдельная папка
-      # tests/integration с собственным package.json). 7 specs, ~1.5 мин.
-      # Реюзает factories из regression/, отдельный pnpm install.
-      - name: Install integration deps
-        working-directory: tests/integration
-        run: pnpm install --frozen-lockfile
-
-      - name: Run integration cross-feature suite (Sprint 27/28)
-        id: integration
-        working-directory: tests/integration
-        run: pnpm exec playwright test --reporter=list,json
-
-      - name: Upload playwright artifacts on failure
-        if: failure()
-        uses: actions/upload-artifact@v4
-        with:
-          name: playwright-report-${{ github.run_id }}
-          path: |
-            tests/regression/reports/
-            tests/integration/reports/
-
-      - name: Notify Telegram on failure
-        if: failure()
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.event.workflow_run.head_sha || github.sha }}
-        run: |
-          RUN_URL="${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=❌ regression FAILED — ${SHA:0:7} — $RUN_URL" \
-            > /dev/null
-
-      - name: Notify Telegram on success
-        if: success() && github.event_name == 'workflow_run'
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.event.workflow_run.head_sha }}
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=✅ regression OK — ${SHA:0:7} (35 flows + 60 visual + 8 integration)" \
-            > /dev/null

.forgejo/workflows/stage-verify.yml

@@ -1,70 +0,0 @@
-name: Stage verify
-
-# Запускается ПОСЛЕ успешного docker-api или docker-web — они уже
-# собирают и деплоят на stage. Эта работа делает быстрый smoke
-# (~30с): auth, multi-tenant изоляция, один полный документ-цикл
-# (signup → seed → supply.post → retail-sale.post → проверка остатка).
-#
-# Если падает — пинг в Telegram. По дефолту в notify.yml уже есть
-# perfailure нотификация для CI/Docker — этот workflow добавляет к ним.
-
-on:
-  workflow_run:
-    workflows: ["Docker API", "Docker Web"]
-    types: [completed]
-  workflow_dispatch:
-
-# Не запускаемся, если триггерный workflow упал — нет смысла верифировать
-# то что не задеплоилось.
-jobs:
-  smoke:
-    name: Smoke против stage
-    if: ${{ github.event.workflow_run.conclusion == 'success' || github.event_name == 'workflow_dispatch' }}
-    runs-on: [self-hosted, linux]
-    env:
-      BASE_URL: https://test.admin.food-market.kz
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Wait for health/ready
-        run: |
-          for i in 1 2 3 4 5 6 7 8 9 10; do
-            if curl -fsS "$BASE_URL/health/ready" | grep -q '"status":"Healthy"'; then
-              echo "Stage ready"
-              exit 0
-            fi
-            echo "[$i/10] not ready yet, sleeping..."
-            sleep 3
-          done
-          echo "Stage NOT ready after 30s" >&2
-          exit 1
-
-      - name: Run smoke suite
-        env:
-          BASE_URL: ${{ env.BASE_URL }}
-        run: bash tests/stage-smoke.sh
-
-      - name: Notify Telegram on success
-        if: success() && github.event_name == 'workflow_run'
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.event.workflow_run.head_sha }}
-        run: |
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=✅ stage verify OK — ${SHA:0:7}" \
-            > /dev/null
-
-      - name: Notify Telegram on failure
-        if: failure()
-        env:
-          BOT: ${{ secrets.TELEGRAM_BOT_TOKEN }}
-          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
-          SHA: ${{ github.event.workflow_run.head_sha || github.sha }}
-        run: |
-          RUN_URL="${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"
-          curl -sS -X POST "https://api.telegram.org/bot$BOT/sendMessage" \
-            --data-urlencode "chat_id=$CHAT" \
-            --data-urlencode "text=❌ stage verify FAILED — ${SHA:0:7} — $RUN_URL" \
-            > /dev/null

.gitignore

@@ -90,6 +90,3 @@ postgres-data/
 
 ## Claude Code personal settings
 .claude/settings.local.json
-src/food-market.public/.astro/
-src/food-market.public/dist/
-src/food-market.public/node_modules/

CHANGELOG.md

@@ -1,307 +0,0 @@
-# CHANGELOG
-
-Auto-generated from git log feat:/fix: (last 90 days).
-
-## 2026-06-07
-
-- **feat**: security headers + rate-limits + sensitive-ops audit + session revoke + Grafana (s13)
-- **feat**: ОФД-scaffolding — IFiscalProvider + 4 провайдера + UI/тесты (s11)
-
-## 2026-06-06
-
-- **feat**: dark mode полировка + Cmd+K палитра + аудит-spec (s10-4)
-- **feat**: глобальная Cmd+K палитра + GET /api/search/global (s10-3)
-- **feat**: year-demo seeder + 4 dashboard виджета + week-stats (s10)
-
-## 2026-06-04
-
-- **fix**: IP-limit 60/min, locale ru-RU в playwright, исправлены payload'ы verify-spec'ов (stage-tests)
-- **fix**: per-username 5/мин + per-IP 30/мин — brute-force на конкретный аккаунт ловится, CI/NAT не страдают (rate-limit)
-- **fix**: rate-limit 5/min на /connect/token, nginx route /metrics+/swagger, Swagger в Production через IncludeSwagger (stage)
-
-## 2026-05-31
-
-- **fix**: bump cache version + filter SignalR-race errors in PWA test (pwa)
-- **fix**: SW не вмешивается в /hubs/* — SignalR negotiate сломался (pwa)
-- **feat**: PWA owner read-only + mobile tweaks + S9 stage specs (pwa+mobile+s9)
-- **fix**: убрать unused imports (TS6133) (loyalty)
-- **feat**: P2-12 + P2-13 — лояльность и промокоды (Sprint 9 п.1-2) (loyalty+promotions)
-- **feat**: IObjectStorage abstraction (Local + MinIO) — P2-15 (storage)
-- **feat**: react-i18next ru/en + language switcher (P2-6a — базовая) (i18n)
-- **feat**: OwnerDailySummaryJob + bot binding (P2-14) (telegram)
-- **feat**: SignalR hub /hubs/notifications per-org + dashboard live (realtime)
-
-## 2026-05-30
-
-- **fix**: после create — invalidate list query (не показывался сразу) (employees)
-- **fix**: error display через humanizeError, не «Request failed» (employees)
-- **fix**: уберём cache-touch после Delete — просто navigate (catalog)
-- **fix**: после Delete не refetch'аем удалённый товар (catalog)
-- **fix**: ProductEditPage — race на currencies.data + читаемая ошибка (catalog)
-- **fix**: Modal — role=dialog + aria-modal + aria-label на крестике (a11y)
-- **fix**: useShortcuts — бэр-клавиши не зависят от Shift (web)
-- **feat**: keyboard shortcuts на edit + list страницах + «?» overlay (web)
-- **feat**: Breadcrumbs на edit-страницах (Каталог / Товары / Молоко 3.2%) (web)
-- **feat**: Empty states с CTA на list-страницах (web)
-- **feat**: loading skeletons вместо «Загрузка…» в DataTable + edit-pages (web)
-- **feat**: toast-система — error на 4xx/5xx + success на мутации (через meta) (web)
-- **feat**: ConfirmDialog компонент + useConfirm hook вместо window.confirm() (web)
-- **feat**: demo-data seeder для test.admin.food-market.kz (stage)
-
-## 2026-05-29
-
-- **fix**: operationId + schemaId — генерация OpenAPI работает (swagger)
-- **fix**: 3 фикса по итогам stage-тестирования (reports)
-- **fix**: EF8 nav-collection bug в Enters/Losses/Transfers/SupplierReturns/Inventories.Update (docs)
-- **fix**: EF8 nav-collection bug в Products.Update + unique IX на Article (catalog)
-
-## 2026-05-28
-
-- **feat**: TOTP 2FA для админов через AuthenticatorTokenProvider (P2-4) (auth)
-- **feat**: MediatR partial — 3 handler-образца (TD-1) (cqrs)
-- **feat**: структурные log-fields в Serilog (TD-4) (logging)
-- **feat**: FluentValidation + ValidationFilter для DTO (TD-2) (validation)
-- **feat**: RowVersion на документах через Postgres xmin (TD-6) (concurrency)
-- **feat**: persisted ImportJobRegistry в БД (TD-5) (import-jobs)
-- **feat**: HTML-шаблоны MailKit + invite/weekly/low-stock джобы (P1-22) (email)
-- **feat**: per-tenant журнал мутаций OrgAuditLog (P1-18) (audit)
-- **feat**: оптовая отгрузка контрагенту-юрлицу (P1-5) (demands)
-- **feat**: Prometheus метрики /metrics + бизнес-счётчики (P1-17) (observability)
-- **feat**: GET /sync и POST /sales с двойной идемпотентностью (P1-12b) (pos-api)
-- **feat**: контракты POS v1 в food-market.shared (P1-12a) (pos-shared)
-- **feat**: улучшенный Swagger + TS-клиент через openapi-typescript (P1-19) (openapi)
-- **feat**: ABC-анализ по Парето (P1-11) (reports)
-- **feat**: отчёт «Прибыль» (выручка − COGS) (P1-10) (reports)
-- **feat**: отчёт «Остатки на дату» с реконструкцией (P1-9) (reports)
-- **feat**: отчёт «Продажи» с группировками и экспортом (P1-8) (reports)
-- **feat**: dashboard + scheduled cleanup джобы (P1-16) (hangfire)
-- **feat**: возврат поставщику (P1-7) (supplier-returns)
-- **feat**: возврат от покупателя (CustomerReturn) (P1-6) (returns)
-- **feat**: инвентаризация с CSV-импортом факта (P1-4) (inventories)
-- **feat**: атомарное перемещение между складами (P1-3) (transfers)
-- **feat**: списание со склада с указанием причины (P1-2) (losses)
-- **feat**: оприходование товара без поставщика (P1-1) (enters)
-
-## 2026-05-27
-
-- **feat**: авто-бэкап БД+uploads — systemd timer/service + скрипт (P0-6) (deploy)
-- **feat**: prod X509-ключи OpenIddict с persistent self-signed (P0-1) (auth)
-- **feat**: permission-based авторизация по флагам роли (P0-5) (authz)
-- **feat**: health-пробы /health/live и /health/ready (P0-4) (api)
-- **feat**: rate-limit /connect/token и /api/auth/signup (P0-3) (api)
-
-## 2026-05-26
-
-- **fix**: change-owner требует reason ≥ 10 символов (superadmin)
-- **fix**: увольнение/деактивация гасит логин связанного User (employees)
-- **fix**: сериализуемое проведение приёмки против lost update остатков (supplies)
-- **fix**: FK-guard удаления контрагента + валидация полей товара (catalog)
-- **fix**: refresh-token rotation немедленно инвалидирует старый токен (auth)
-
-## 2026-05-23
-
-- **fix**: защита денег и инварианта остатков на posting-операциях (documents)
-- **fix**: SuperAdmin edit-mode override обходит [Authorize(Roles=Admin)] (security)
-- **fix**: чиним P0-блокеры разворачивания на чистой БД (migrations)
-
-## 2026-05-18
-
-- **fix**: обновить node:20-alpine → 22-alpine (pnpm 11 требует Node ≥22) (docker)
-- **fix**: validatePassword проверяет заглавную и цифру (соответствует хинту) (validation)
-- **fix**: onBlur валидация через e.target.value, ре-валидация вместо сброса ошибки в onChange (signup)
-
-## 2026-05-17
-
-- **feat**: onBlur валидация полей во всех формах (ux)
-
-## 2026-05-08
-
-- **fix**: блок пустого Draft на UI + бэк уже отказывает (retail-sale)
-- **feat**: системная ProductGroup «Все товары» при создании org (bootstrap)
-- **fix**: обязательные FK-Guid проверяются на 400 + DbUpdateException → 400 (validation)
-- **fix**: блок overselling в Post — 409 если qty>остатка (retail-sale)
-- **fix**: добавить [Migration] атрибут для Phase5c — без него Migrate() не находит миграцию (migrations)
-- **fix**: серверная KZ-ФЛК на всех endpoint'ах принимающих phone (phone)
-- **fix**: Cashier/Storekeeper больше не видят /api/organization/employees + Identity-роль маппится из orgRole (auth)
-- **feat**: infrastructure + first full-cycle scenario + baseline report (e2e)
-
-## 2026-05-06
-
-- **feat**: forgot/reset password — endpoints + UI + IP rate-limit (auth)
-- **feat**: UI /super-admin/platform-settings + тестовая отправка (platform)
-- **feat**: IEmailSender + MailKit + PlatformSettingsController (platform)
-- **feat**: PlatformSettings entity + миграция (singleton SMTP-конфиг) (platform)
-- **feat**: фильтр sidebar и route-guard по ролям пользователя (roles)
-- **feat**: двухступенчатое удаление — «уволить» → «удалить» (employees)
-- **feat**: TextInput с type=email — авто-pattern для TLD-проверки (forms)
-- **feat**: MoneyInput для поля «Оклад» в карточке сотрудника (forms)
-- **feat**: убрать «ИНН» из UI — РК использует ИИН/БИН (localization)
-- **feat**: системная роль — read-only форма прав вместо alert (roles)
-- **feat**: три системные роли — Admin/Cashier/Storekeeper (roles)
-
-## 2026-05-03
-
-- **fix**: сохранять позицию курсора после нормализации (phone)
-- **fix**: нативное редактирование, фильтр не-цифр через onBeforeInput (phone)
-- **fix**: редактирование на месте курсора, как в обычном поле (phone)
-- **fix**: полностью переписать на простую модель — цифры как single source of truth (phone)
-- **fix**: блокировать ввод не-цифр на уровне keyDown (phone)
-- **fix**: не считать «7» из префикса как введённую цифру (phone)
-- **feat**: единый PhoneInput с зашитым «+7» и ФЛК Казахстана (phone)
-- **feat**: телефон обязателен + ФЛК Казахстана (77XXXXXXXXX) (signup)
-- **fix**: убрать «моргание» при клике на орг — переход теперь по double-click (super-admin)
-
-## 2026-05-02
-
-- **fix**: docker-public — актуализировать PUBLIC_*_URL под новые домены (ci)
-- **fix**: кнопка «Войти» вела на 410-Gone zat.kz (public)
-- **feat**: новый логотип food-market wordmark + apple mark (brand)
-
-## 2026-04-30
-
-- **feat**: миграция на food-market.kz / admin.food-market.kz (domains)
-
-## 2026-04-28
-
-- **feat**: полное управление сотрудниками любой орги (super-admin)
-- **feat**: AsyncSelect — серверный поиск в дропдаунах вместо pageSize=500 (ui)
-- **fix**: SuperAdmin платформы без OrganizationId + отдельный Admin для Demo Market (auth)
-
-## 2026-04-27
-
-- **feat**: главный администратор — терминология + защита роли/активности (employees)
-- **feat**: бейдж «Владелец» + блокировка удаления с объяснением (employees)
-- **fix**: пароль/orphan signup/tenant-guard toast/dashboard счётчик
-- **fix**: нейтральный placeholder в поле названия организации (public)
-- **fix**: закрыть критические дыры — orphan login, self-delete, owner-delete, override-баннер (auth)
-- **feat**: русская локализация и строгий email с TLD (validation)
-- **fix**: убрать русские имена/ИП из placeholder регистрации (public)
-
-## 2026-04-26
-
-- **feat**: Phase 6 — публичный сайт на food-market.zat.kz, админка на app. (deploy)
-- **feat**: Phase 6 — публичный маркетинговый сайт food-market.public на Astro (public)
-- **feat**: настраиваемый retention period для архивных орг (super-admin)
-- **fix**: убрать цикл редиректа, регресс override после пакета задач (super-admin)
-- **fix**: Phase4d таблица называется units_of_measure, не units (migration)
-- **feat**: двухуровневые справочники Группы и Ед.измерения (системные + tenant) (directories)
-- **feat**: системные роли read-only + русские имена + чистка дубликата у admin (roles)
-- **feat**: перенести справочник Стран в системную консоль (super-admin)
-- **fix**: SuperAdmin override должен применять tenant filter выбранной орги (tenancy)
-- **feat**: рабочий quick-switch + UI-блокировка мутаций в read-only (super-admin)
-- **feat**: Phase 2b — отдельный SuperAdminLayout и разделение от tenant-админки (super-admin)
-- **feat**: Phase 3 — edit-mode с reason + audit-trail (super-admin)
-- **feat**: Phase 2 — read-only «открыть как…» context switch (super-admin)
-- **feat**: /quiet и /loud команды для управления PreToolUse прогресс-лентой (bridge)
-- **fix**: новая org через UI получает полный bootstrap (как Demo) (super-admin)
-- **feat**: PreToolUse hook for Telegram progress feed + rate-limited batching (infra)
-- **fix**: grant SuperAdmin role to admin@food-market.local (seed)
-- **feat**: super-admin section + setup wizard + auto-redirect (web)
-- **feat**: super-admin endpoints (orgs CRUD + setup-status + audit-log + dashboard) (api)
-- **feat**: Organization.IsArchived/AccountOwner + SuperAdminAuditLog + migration (domain)
-- **feat**: add Salary, TaxNumber, Description, ImageUrl + radio role picker (employee)
-- **feat**: permissions matrix grouped by section + clone-from-template flow (roles)
-- **fix**: keep only Admin + Cashier as system, demote others to custom + migration (roles)
-- **feat**: event-driven Telegram bridge — webhook + Stop hook (infra)
-- **fix**: drop Employee.Navigation(RetailPointAssignments) to fix snapshot order (migrations)
-- **feat**: welcome dashboard with first-steps cards (onboarding)
-- **feat**: Employees + Roles pages with permissions matrix (web)
-- **feat**: EmployeesController + EmployeeRolesController + invite-with-temp-password (api)
-- **feat**: system roles per organization + map admin → Employee (seed)
-- **feat**: Employee, EmployeeRole, RolePermissions entities + migration (domain)
-- **fix**: dropdown opens as floating overlay (Portal + absolute) (searchable-select)
-- **fix**: theme styles + default to today for new docs (date-field)
-- **feat**: replace native input with react-datepicker — polished UX (date-field)
-- **fix**: polish calendar UX — dropdown nav, today/clear footer, ru weekdays (date-field)
-- **fix**: compact calendar popup — shadcn-style sizing (date-field)
-- **fix**: cap width + ru locale + DD.MM.YYYY format (date-fields)
-- **fix**: show both article and barcode in line subtitle (supply-lines)
-- **fix**: sticky input at viewport bottom + auto-scroll on add (supply-quick-add)
-- **fix**: dropdown opens upward + show only N results + create-new at bottom (supply-quick-add)
-- **feat**: drop supplier field, reorder sections, add cost column (product-card+list)
-- **fix**: keep input focused after scan / clear on add (supply-quick-add)
-- **fix**: dropdown not rendering — Portal + fixed position (supply-quick-add)
-- **feat**: inline line quick-add — scanner + autocomplete + create-on-fly (supply)
-- **feat**: products quick-search + by-barcode endpoints (api)
-- **fix**: колонка «Розничная» использует имя системного PriceType (supply)
-- **feat**: «Проведено» внутри формы + обязательная дата и ≥1 позиция (supply)
-- **fix**: catch-up Phase3b_AddShowDescriptionOnProduct (migrations)
-- **feat**: inline-create option in searchable Select (ui)
-- **feat**: searchable Select component (drop-in) (ui)
-- **feat**: drop ShelfLifeDays + recompose classification + auto-article + barcode trash hide (product-card)
-- **fix**: IsRequired применяется сразу, без перезагрузки страницы (price-types)
-
-## 2026-04-25
-
-- **fix**: человечная ошибка 400 + блок Save при незаполненных IsRequired ценах (product-edit)
-- **fix**: correct is-system seeder + require value > 0 + system-price filter/sort (price-types)
-- **feat**: inputs по справочнику PriceType — без dropdown'a (product-prices)
-- **feat**: компонент + inline-наценка в таблице групп (percent-input)
-- **feat**: срок годности (shelfLifeDays) + фильтр от/до (product+filters)
-- **feat**: чекбокс «Проведено» с confirm + системная розничная в списке (supply+products-list)
-- **feat**: drop IsActive, add ShelfLifeDays, restore PriceType IsSystem/IsRequired (phase3b)
-- **feat**: supply line retail override column (web)
-- **feat**: price types CRUD visibility + group markup table (web)
-- **feat**: product card pricing UI + settings toggles (web)
-- **feat**: recalc-retail endpoint + 30-day reference price refresh job (api)
-- **feat**: supply posting hook for cost & markup (api)
-- **feat**: pricing model rename and new fields (Phase3a) (domain)
-- **fix**: merge barcodes/prices по ключу + 409 на concurrency (products/update)
-- **fix**: toFixed(2) при allowFractional=true для правильного отображения (money-input)
-- **fix**: сохранять промежуточный ввод точки в draft (money-input)
-- **fix**: корректное обновление allowFractionalPrices без перелогина (money-input)
-- **fix**: уважать AllowFractionalPrices в формах редактирования (money-input)
-- **feat**: pre-check на Create/Update + warnings импорта + admin endpoint (barcode-uniqueness)
-- **feat**: AllowFractionalPrices — переключатель дробных цен (org-settings)
-- **feat**: группа обязательна, ≥1 штрихкод, умные дефолты на новом (product)
-- **feat**: MoneyInput/NumberInput + select-пагинация + Range на бэкенде (forms)
-
-## 2026-04-24
-
-- **feat**: авто-генерация числового артикула при создании (products)
-- **feat**: настройка ShowMinMaxStock для мин/макс остатков (org-settings)
-- **feat**: галки «Услуга»/«Маркируемый» скрываются по умолчанию (org-settings)
-- **feat**: авто-генерация EAN-13 при добавлении штрихкода (barcode)
-- **feat**: server-side sort by column header click (tables)
-- **feat**: валюта read-only, тянется из страны (как НДС) (org-settings)
-- **feat**: ставка в стране + опц. переопределение на товаре (vat)
-- **feat**: загрузка на диск сервера + галерея с лайтбоксом (product-images)
-- **feat**: enum Packaging (штучный/весовой/разливной) вместо IsWeighed (product)
-- **feat**: Country↔Currency, Organization.DefaultCurrency/MultiCurrency/DefaultVat + UI настроек (org-settings)
-- **fix**: сделать Token опциональным (other-system/test)
-
-## 2026-04-23
-
-- **feat**: async jobs с прогрессом + токен в настройках (other-system-import)
-- **fix**: per-page retry + чаще SaveChanges (other-system/import)
-- **feat**: tree-of-groups + фильтры как в OtherSystem (catalog/products)
-- **feat**: import archived entities too (as IsActive=false) (other-system)
-- **fix**: reconcile stage schema — drop TrackingType, add IsMarked (db)
-- **feat**: temp cleanup buttons + fix OtherSystem import duplicates (admin)
-- **feat**: strict OtherSystem schema — реплика потерянного f7087e9
-- **fix**: убираем выдумку Kind полностью — у OtherSystem этого поля нет (other-system)
-- **fix**: не выдумывать Kind=Both для импортированных контрагентов (other-system)
-- **feat**: Telegram <-> tmux bridge + local docker-registry unit (ops)
-- **feat**: sales chart + KPIs (как «Показатели» в сторонняя система) (dashboard)
-
-## 2026-04-22
-
-- **fix**: bootstrap admin + demo org on stage/prod too, not just Dev (seeder)
-- **fix**: always apply EF migrations on startup, not only in Development (api)
-- **fix**: widen Article + Barcode.Code to 500 chars for real-world catalogs (catalog)
-
-## 2026-04-21
-
-- **fix**: accept fractional prices (decimal, not long) in DTOs (other-system)
-- **fix**: add User-Agent header + enable HTTP auto-decompression (other-system)
-- **fix**: drop Accept-Encoding: gzip to avoid JSON parse failure (other-system)
-- **fix**: set Accept header as raw string to bypass .NET normalization (other-system)
-- **fix**: exact Accept header value per OtherSystem requirement (code 1062) (other-system)
-- **fix**: trailing slash on BaseUrl so HttpClient keeps /1.2/ in path (other-system)
-- **fix**: OtherSystem admin endpoint uses policy-based auth on role claim directly (auth)
-- **fix**: return 401 instead of 302 for API challenges; persist dev signing key across restarts (auth)
-- **fix**: drop FM square badge from Logo; better 404 diagnostics on OtherSystem page (web)
-- **feat**: rebrand to FOOD MARKET green (#00B207) per mobile app logo (web)
-- **fix**: remove TanStack devtools palm icon; restore user profile on dashboard (web)
-- **fix**: pin API dev port to 5081 (match Vite proxy config)
-

Directory.Packages.props

@@ -7,12 +7,8 @@
   <ItemGroup>
     <!-- ASP.NET Core 8 -->
     <PackageVersion Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="8.0.11" />
-    <PackageVersion Include="Microsoft.AspNetCore.Authentication.Google" Version="8.0.11" />
-    <PackageVersion Include="Microsoft.AspNetCore.Authentication.MicrosoftAccount" Version="8.0.11" />
-    <PackageVersion Include="Microsoft.AspNetCore.Authentication.Cookies" Version="2.3.0" />
     <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="8.0.11" />
     <PackageVersion Include="Microsoft.AspNetCore.SignalR" Version="1.2.0" />
-    <PackageVersion Include="Microsoft.AspNetCore.SignalR.Client" Version="8.0.11" />
     <PackageVersion Include="Swashbuckle.AspNetCore" Version="6.9.0" />
 
     <!-- EF Core 8 + PostgreSQL -->
@@ -31,11 +27,6 @@
     <PackageVersion Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="8.0.11" />
 
     <!-- App services -->
-    <PackageVersion Include="CsvHelper" Version="33.0.1" />
-    <PackageVersion Include="Minio" Version="6.0.5" />
-    <PackageVersion Include="ClosedXML" Version="0.104.2" />
-    <PackageVersion Include="MailKit" Version="4.10.0" />
-    <PackageVersion Include="Microsoft.AspNetCore.DataProtection" Version="8.0.11" />
     <PackageVersion Include="MediatR" Version="12.4.1" />
     <PackageVersion Include="FluentValidation" Version="11.11.0" />
     <PackageVersion Include="FluentValidation.DependencyInjectionExtensions" Version="11.11.0" />
@@ -45,16 +36,10 @@
     <PackageVersion Include="Serilog.Sinks.Console" Version="6.0.0" />
     <PackageVersion Include="Serilog.Sinks.File" Version="6.0.0" />
 
-    <!-- Image processing (Sprint 14: variants thumb/medium + WebP) -->
-    <PackageVersion Include="SixLabors.ImageSharp" Version="3.1.6" />
-
     <!-- Background jobs -->
     <PackageVersion Include="Hangfire.AspNetCore" Version="1.8.17" />
     <PackageVersion Include="Hangfire.PostgreSql" Version="1.20.10" />
 
-    <!-- Observability / Prometheus -->
-    <PackageVersion Include="prometheus-net.AspNetCore" Version="8.2.1" />
-
     <!-- POS: local storage + API client -->
     <PackageVersion Include="Microsoft.EntityFrameworkCore.Sqlite" Version="8.0.11" />
     <PackageVersion Include="Refit" Version="7.2.22" />
@@ -72,7 +57,6 @@
     <PackageVersion Include="NSubstitute" Version="5.3.0" />
     <PackageVersion Include="coverlet.collector" Version="6.0.3" />
     <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="8.0.11" />
-    <PackageVersion Include="Microsoft.EntityFrameworkCore.InMemory" Version="8.0.11" />
     <PackageVersion Include="Testcontainers.PostgreSql" Version="4.1.0" />
   </ItemGroup>
 </Project>

README.md

@@ -1,133 +1,85 @@
 # food-market
 
-<!-- quality-badge --> 🟢 **Quality:** [`docs/quality-status.md`](docs/quality-status.md) <!-- /quality-badge -->
+Аналог системы МойСклад для розничной торговли в Казахстане.
 
-[![CI](http://192.168.1.193:3000/nns/food-market/actions/workflows/ci.yml/badge.svg)](http://192.168.1.193:3000/nns/food-market/actions)
+## Состав системы
-[![Docker API](http://192.168.1.193:3000/nns/food-market/actions/workflows/docker-api.yml/badge.svg)](http://192.168.1.193:3000/nns/food-market/actions)
-[![Stage verify](http://192.168.1.193:3000/nns/food-market/actions/workflows/stage-verify.yml/badge.svg)](http://192.168.1.193:3000/nns/food-market/actions)
-[![Regression](http://192.168.1.193:3000/nns/food-market/actions/workflows/regression.yml/badge.svg)](http://192.168.1.193:3000/nns/food-market/actions)
-![coverage](./badges/coverage.svg)
 
-Аналог системы МойСклад для розничной торговли в Казахстане. Multi-tenant
+- **Сервер** (ASP.NET Core 8 + PostgreSQL) — мультитенантный API, web-админка на React
-SaaS + web-админка + Windows-касса. Поддерживает 8 типов документов учёта,
+- **Web-админка** (React 18 + Vite + shadcn/ui) — управление магазином, справочниками, документами, отчётами
-ОФД-интеграцию (scaffolding), кассу на POS WPF с offline-буфером, отчёты,
+- **Кассовая программа** (WPF на .NET 8) — офлайн-работоспособная касса для Windows 10+, синхронизируется с сервером, работает с весами (Масса-К в первую очередь)
-loyalty-programs, MoySklad-импорт, GDPR-export.
 
-## Состав
+## Структура репозитория
-
-| Часть | Технологии | Точка входа |
-|---|---|---|
-| **API** | .NET 8 LTS, ASP.NET Core, EF Core 8, PostgreSQL 16, OpenIddict 5 | `src/food-market.api` → http://localhost:5081 |
-| **Web-админка** | React 19, Vite, TypeScript, Tailwind v4, TanStack Query, AG Grid | `src/food-market.web` → http://localhost:5173 |
-| **Public marketing** | Astro 5, TypeScript, Tailwind | `src/food-market.public` → http://localhost:4321 |
-| **POS-касса** | WPF .NET 8 Windows, SQLite, Refit+Polly, COM-весы | `src/food-market.pos` (сборка кроссплатформенно, UI — Windows) |
-
-## 5-минутный quick start
-
-```bash
-git clone http://192.168.1.193:3000/nns/food-market.git
-cd food-market
-
-# БД (Postgres 14+ должен быть запущен, default user)
-createdb -U $USER food_market
-
-# Backend (миграции применятся на старте; Swagger на /swagger)
-ASPNETCORE_ENVIRONMENT=Development dotnet run --project src/food-market.api &
-
-# Web SPA
-cd src/food-market.web && pnpm install && pnpm dev &
-
-# Зарегистрироваться + получить токен
-curl -X POST http://localhost:5081/api/auth/signup \
-  -H "Content-Type: application/json" \
-  -d '{"organizationName":"Dev","email":"dev@local.test","password":"DevPass1!","phone":"+77001234567"}'
-
-curl -X POST http://localhost:5081/connect/token \
-  -d 'grant_type=password&username=dev@local.test&password=DevPass1!&client_id=food-market-web&scope=openid profile email roles api offline_access'
-
-# Открыть http://localhost:5173 → залогиниться dev@local.test / DevPass1!
-```
-
-Подробнее — [`docs/ONBOARDING.md`](docs/ONBOARDING.md).
-
-## Где что лежит
 
 ```
 food-market/
 ├── src/
-│   ├── food-market.domain/          # POCO + enum'ы + interfaces. Без EF / ASP.NET.
+│   ├── food-market.domain/          # доменные сущности, enum'ы, события
-│   ├── food-market.application/     # DTO, FluentValidation, MediatR-handler'ы, Mapster.
+│   ├── food-market.application/     # use cases (MediatR), DTO, интерфейсы
-│   ├── food-market.infrastructure/  # EF Core, миграции, Identity, OpenIddict storage.
+│   ├── food-market.infrastructure/  # EF Core, PostgreSQL, внешние сервисы
-│   ├── food-market.api/             # Controllers (58, 240 endpoints), middleware, Hangfire jobs (13 recurring), OpenIddict server.
+│   ├── food-market.api/             # ASP.NET Core + OpenIddict + SignalR
-│   ├── food-market.web/             # React 19 SPA админки.
+│   ├── food-market.web/             # React + Vite + shadcn/ui (SPA)
-│   ├── food-market.public/          # Astro marketing-сайт.
+│   ├── food-market.shared/          # DTO-контракты сервер ↔ POS
-│   ├── food-market.shared/          # DTO-контракты сервер↔POS.
+│   ├── food-market.pos.core/        # логика POS (независима от UI)
-│   ├── food-market.pos.core/        # POS-логика (UI-agnostic).
+│   └── food-market.pos/             # WPF + .NET 8 кассовая программа
-│   └── food-market.pos/             # WPF (.NET 8 Windows).
 ├── tests/
-│   ├── food-market.UnitTests/       # xUnit + InMemory EF.
+├── deploy/
-│   ├── food-market.IntegrationTests/# xUnit + Testcontainers Postgres.
+│   ├── docker-compose.yml           # PostgreSQL для локальной разработки
-│   ├── e2e/                         # Playwright + ad-hoc Python smoke.
+│   └── Dockerfile.api
-│   └── load/                        # k6 (нагрузочные).
+└── docs/
-├── deploy/                          # Dockerfile.{api,web,public}, compose, nginx, prod-toolchain.
-├── docs/                            # 50+ markdown файлов.
-└── food-market.sln
 ```
 
-## Ключевая документация
+## Именование
 
-- **[ARCHITECTURE.md](docs/ARCHITECTURE.md)** — общая картина: слои, deployment, что реализовано / scaffolding / не реализовано.
+- **Папки, проекты, csproj, docker-образы, URL** — lowercase: `food-market`, `food-market.api`
-- **[ONBOARDING.md](docs/ONBOARDING.md)** — first 3 days для нового разработчика.
+- **C# namespace** — `foodmarket.Api`, `foodmarket.Domain` (lowercase root; C# не допускает дефис в идентификаторах)
-- **[glossary.md](docs/glossary.md)** — все доменные термины с ссылками на код.
+- **Отображаемое имя в UI** — "Food Market"
-- **[MULTI-TENANCY.md](docs/MULTI-TENANCY.md)** — как изолируются org'и.
+
-- **[api-reference.md](docs/api-reference.md)** — auto-generated список всех 240 endpoint'ов (58 контроллеров).
+## Стек
-- **[error-codes.md](docs/error-codes.md)** — каталог HTTP-кодов для humanizeError на фронте.
+
-- **[secrets.md](docs/secrets.md)** — env-vars + где хранятся секреты.
+### Сервер
-- **[RUNBOOK.md](docs/RUNBOOK.md)** — операционные процедуры (что делать при инциденте).
+- .NET 8 LTS (до ноября 2026), ASP.NET Core Minimal APIs + Controllers
-- **[performance-baseline.md](docs/performance-baseline.md)** — k6 цифры + bottleneck'и.
+- EF Core 8 + Npgsql + PostgreSQL 16
+- OpenIddict 5 (OAuth2/OIDC — password + refresh tokens)
+- MediatR + FluentValidation (CQRS-lite)
+- SignalR (real-time синхронизация)
+- Hangfire (фоновые задачи)
+- Serilog (структурированное логирование)
+
+### Web
+- React 18 + Vite + TypeScript
+- shadcn/ui + Tailwind CSS
+- TanStack Query + TanStack Table
+- AG Grid Community (для тяжёлых grid'ов)
+- Recharts / Tremor (графики)
+- react-hook-form + Zod
+
+### POS
+- .NET 8 WPF, Windows 10+
+- CommunityToolkit.Mvvm (source-generated MVVM)
+- SQLite (локальная БД)
+- Refit + Polly (API-клиент с retry)
+- System.IO.Ports (драйверы весов: Масса-К и др.)
 
 ## Мультитенантность
 
-Один процесс API обслуживает много организаций. Каждая видит только свои
+Каждая сущность имеет `OrganizationId`. Пользователь scoped к организации. EF Core query filter автоматически изолирует данные между тенантами.
-данные через EF Core query-filter по `OrganizationId`. `SuperAdmin` роль
-видит всё. См. [MULTI-TENANCY.md](docs/MULTI-TENANCY.md).
 
-## Деплой
+## Локальная разработка
 
-- **Stage**: `https://test.admin.food-market.kz`. Деплой одной командой:
+```bash
-  ```bash
+# Поднять PostgreSQL
-  ~/deploy-stage.sh  # docker build api+web → push в local registry → ssh prod-vm → compose up -d
+cd deploy && docker compose up -d
-  ```
-- **Prod**: `https://admin.food-market.kz`. Toolchain готов (Sprint 21):
-  ```bash
-  deploy/check-prod-readiness.sh        # backup+disk+health+env
-  deploy/prod-deploy.sh <api-tag> <web-tag>  # blue-green
-  deploy/prod-rollback.sh <to-tag>       # быстрый откат
-  deploy/post-deploy-smoke.sh           # 10 шагов smoke + Telegram alert
-  ```
-  Реальный prod-сервер пока не настроен (DNS / certbot / nginx upstream).
 
-## Sprint-история (что было сделано)
+# Мигрировать БД
+cd src/food-market.api && dotnet ef database update
 
-Хронология в `docs/sprintNN-progress.md`. По состоянию на Sprint 28:
+# Запустить API
-- **1-7** — фундамент: auth (OpenIddict), multi-tenancy, каталог, документы, кассы.
+dotnet run --project src/food-market.api
-- **8-10** — отчёты, dashboard, dark mode + Cmd+K.
-- **11** — ОФД scaffolding (Webkassa / Kassa24 / ОФД-Соло).
-- **12-13** — документация / runbook / k6, security headers + rate-limits.
-- **14-15** — performance (bundle −51%, индексы, N+1 fix), a11y (WCAG-AA).
-- **16-17** — regression suite (44 Playwright specs), onboarding wizard + help.
-- **18** — TODO cleanup (P0 race, audit filters, notification center).
-- **19** — power UX (bulk-update, presets, Cmd+J, inline-edit, CSV import/export, keyboard nav).
-- **20** — Mapster + SSO scaffold + maintenance jobs (cleanup, VACUUM, disk-monitor, perf-regression).
-- **21** — stage→prod toolchain (7 deploy-скриптов + auto-tag).
-- **22** — data tooling: GDPR-export, 1C-CSV import, anonymize-prod, DB-schema docs, audit export streaming.
-- **23** — adversarial bug-hunt (4 bugs found + 4 fixed, includes CRITICAL 40001→500 fix).
-- **24** — docs cross-check + auto-generated API reference + ONBOARDING + integration-test gap-fill.
-- **25** — autonomous continuous quality monitoring: `~/quality-watchdog.sh` hourly + Telegram + auto-incident loop + Hangfire quality-org-cleanup.
-- **26** — flaky-test detection + observability stack: `find-flaky.sh`, Grafana quality-watchdog.json, Prometheus alerts.yml + RUNBOOK action-per-alert.
-- **27** — cross-feature integration: `tests/integration/` (6 specs) + 4h soak (k6) + crash recovery test.
-- **28** — overnight maintenance: api-reference auto-gen фикс (195→240), HSTS header on stage, integration spec gap-fill (1C-CSV, GDPR, security headers).
 
-## Лицензия
+# Запустить Web
+cd src/food-market.web && pnpm install && pnpm dev
+```
 
-Internal proprietary, не для публикации без разрешения владельца.
+## Статус
+
+🚧 Phase 0: фундамент (scaffolding, auth, multi-tenancy)

badges/ci-status-link.md

@@ -1,21 +0,0 @@
-# CI status badges
-
-Forgejo (primary, обновляется автоматически на каждый workflow run):
-
-```markdown
-![CI](http://127.0.0.1:3000/nns/food-market/actions/workflows/ci.yml/badge.svg)
-![Docker API](http://127.0.0.1:3000/nns/food-market/actions/workflows/docker-api.yml/badge.svg)
-![Regression](http://127.0.0.1:3000/nns/food-market/actions/workflows/regression.yml/badge.svg)
-```
-
-GitHub mirror (для external reader'ов):
-
-```markdown
-![CI](https://github.com/nurdotnet/food-market/actions/workflows/ci.yml/badge.svg)
-```
-
-Coverage (regenerated by `scripts/generate-badges.sh`):
-
-```markdown
-![coverage](./badges/coverage.svg)
-```

badges/coverage.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="180" height="20" role="img" aria-label="coverage (app+domain): 80%"><title>coverage (app+domain): 80%</title><g shape-rendering="crispEdges"><rect width="145" height="20" fill="#555"/><rect x="145" width="35" height="20" fill="#67ac09"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="735" y="140" transform="scale(.1)" fill="#fff" textLength="1350">coverage (app+domain)</text><text x="1615" y="140" transform="scale(.1)" fill="#fff" textLength="250">80%</text></g></svg>

deploy/.env.example

@@ -1,43 +0,0 @@
-# food-market — пример переменных окружения для деплоя.
-#
-# Скопировать в deploy/.env и заполнить значениями (.env в .gitignore — НЕ коммитить).
-#   cp deploy/.env.example deploy/.env && $EDITOR deploy/.env
-#
-# docker-compose читает deploy/.env автоматически. Описание секретов и ротация —
-# docs/secrets.md. Ключи OpenIddict — docs/openiddict-keys.md.
-
-# ─── Реестр образов и теги (docker-compose) ──────────────────────────────────
-# Откуда тянуть образы. Локальный registry на stage — 127.0.0.1:5001 (см. CLAUDE/memory).
-REGISTRY=127.0.0.1:5001
-API_TAG=latest
-WEB_TAG=latest
-PUBLIC_TAG=latest
-
-# ─── База данных (ОБЯЗАТЕЛЬНО) ───────────────────────────────────────────────
-# Пароль пользователя food_market в Postgres-контейнере. Подставляется и в
-# POSTGRES_PASSWORD контейнера БД, и в ConnectionStrings__Default API.
-# Сгенерировать: openssl rand -base64 24
-POSTGRES_PASSWORD=CHANGE_ME_strong_db_password
-
-# ─── OpenIddict / выдача токенов ─────────────────────────────────────────────
-# Публичный URL админки = issuer токенов (обязателен за nginx-прокси).
-OPENIDDICT_ISSUER=https://admin.food-market.kz/
-# Пароль PFX-сертификатов подписи/шифрования. Пусто = без пароля (self-signed
-# генерируется автоматически в App_Data, если файлов нет). Подробности — docs/openiddict-keys.md.
-OPENIDDICT_CERT_PASSWORD=
-
-# ─── Бэкап (systemd food-market-backup.*) ────────────────────────────────────
-# Переопределения для скрипта бэкапа. По умолчанию совпадают с compose — можно не задавать.
-# FM_BACKUP_DIR=/opt/food-market-data/backups
-# FM_UPLOADS_DIR=/opt/food-market-data/uploads
-# FM_BACKUP_RETENTION_DAYS=30
-
-# ─── Прочее (опционально, переопределяет appsettings.json) ───────────────────
-# CORS-origins фронта (если отличается от зашитых в appsettings). Индексируется с 0:
-# Cors__AllowedOrigins__0=https://admin.food-market.kz
-# Антибрутфорс на /connect/token и /api/auth/signup (дефолты 5/мин, 20/час):
-# RateLimiting__Enabled=true
-# RateLimiting__PerMinute=5
-# RateLimiting__PerHour=20
-# Интеграция МойСклад (по умолчанию боевой api.moysklad.ru):
-# MoySklad__BaseUrl=https://api.moysklad.ru/api/remap/1.2/

deploy/Dockerfile.api

@@ -1,5 +1,4 @@
-ARG LOCAL_REGISTRY=127.0.0.1:5001
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
-FROM ${LOCAL_REGISTRY}/mirror/dotnet-sdk:8.0 AS build
 WORKDIR /src
 
 COPY food-market.sln global.json Directory.Build.props Directory.Packages.props ./
@@ -11,28 +10,18 @@ COPY src/food-market.api/food-market.api.csproj src/food-market.api/
 COPY src/food-market.pos.core/food-market.pos.core.csproj src/food-market.pos.core/
 COPY src/food-market.pos/food-market.pos.csproj src/food-market.pos/
 
-COPY src/ src/
+RUN dotnet restore src/food-market.api/food-market.api.csproj
-# Single-step restore + publish — раздельные шаги в multi-stage cache
-# роняли publish с NETSDK1064 (Microsoft.CodeAnalysis.Analyzers 3.3.3 not
-# found) когда в csproj добавлялись новые transitive analyzer-зависимости,
-# а первый restore не покрывал их. Теперь restore выполняется внутри publish.
-RUN dotnet publish src/food-market.api/food-market.api.csproj -c Release -o /app
 
-FROM ${LOCAL_REGISTRY}/mirror/dotnet-aspnet:8.0 AS runtime
+COPY src/ src/
+RUN dotnet publish src/food-market.api/food-market.api.csproj -c Release -o /app --no-restore
+
+FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime
 WORKDIR /app
 
 RUN apt-get update && apt-get install -y --no-install-recommends curl \
     && rm -rf /var/lib/apt/lists/*
 
 COPY --from=build /app .
-# Sprint 17: CHANGELOG.md в content-root → WhatsNewController читает его на каждый /api/whats-new.
-COPY CHANGELOG.md ./CHANGELOG.md
-# VERSION файл создаётся deploy-скриптом (или CI) непосредственно перед docker
-# build'ом — содержит короткий SHA коммита. Если отсутствует — fallback на
-# AssemblyInformationalVersion. Поэтому COPY с || true (Dockerfile не имеет
-# опц-COPY, делаем через RUN с проверкой).
-ARG GIT_SHA=dev
-RUN echo "$GIT_SHA" > VERSION
 
 ENV ASPNETCORE_URLS=http://+:8080
 ENV ASPNETCORE_ENVIRONMENT=Production
@@ -40,7 +29,7 @@ ENV DOTNET_NOLOGO=1
 ENV DOTNET_CLI_TELEMETRY_OPTOUT=1
 
 EXPOSE 8080
-HEALTHCHECK --interval=30s --timeout=5s --start-period=30s \
+HEALTHCHECK --interval=30s --timeout=5s --start-period=20s \
-  CMD curl -fsS http://localhost:8080/health/ready || exit 1
+  CMD curl -fsS http://localhost:8080/health || exit 1
 
 ENTRYPOINT ["dotnet", "foodmarket.Api.dll"]

deploy/Dockerfile.web

@@ -1,5 +1,4 @@
-ARG LOCAL_REGISTRY=127.0.0.1:5001
+FROM node:20-alpine AS build
-FROM ${LOCAL_REGISTRY}/mirror/node:22-alpine AS build
 WORKDIR /src
 
 RUN corepack enable
@@ -10,7 +9,7 @@ RUN pnpm install --frozen-lockfile
 COPY src/food-market.web/ ./
 RUN pnpm build
 
-FROM ${LOCAL_REGISTRY}/mirror/nginx:1.27-alpine AS runtime
+FROM nginx:1.27-alpine AS runtime
 COPY deploy/nginx.conf /etc/nginx/conf.d/default.conf
 COPY --from=build /src/dist /usr/share/nginx/html
 

deploy/anonymize-prod.sh

@@ -1,185 +0,0 @@
-#!/usr/bin/env bash
-#
-# Sprint 22: создание anonymized stage-dump'a из прод-БД.
-#
-# Алгоритм:
-#   1. pg_dump прода в кастомном формате (-Fc)
-#   2. pg_restore во временную staging-БД (`food_market_anon`)
-#   3. UPDATE PII-полей в staging:
-#      - email → user{N}@example.kz
-#      - phone → +7700111{N:04}
-#      - passwordHash → один общий тестовый hash для пароля "Test12345!"
-#      - IIN / БИН → синтетические но валидные
-#      - имена/адреса → "Test Tester {N}" / "Тестовый адрес {N}"
-#   4. pg_dump anonymized → .sql.gz файл
-#   5. Удалить staging-БД
-#
-# Результат используется на dev-vm для воспроизведения багов на реальном
-# объёме данных без утечки persistent PII.
-#
-# Usage:
-#   deploy/anonymize-prod.sh [--source <conn-uri>] [--target <conn-uri>]
-#                            [--out <file>] [--dry-run]
-#
-# Default source: ssh prod docker exec food-market-postgres pg_dump
-# Default target: local postgres@14 with TEMP DB food_market_anon
-# Default out:    /home/nns/food-market-anon-YYYYMMDD.sql.gz
-
-set -uo pipefail
-
-SOURCE_HOST="${FM_PROD_HOST:-nns@admin.food-market.kz}"
-SOURCE_CONTAINER="${FM_PROD_CONT:-food-market-postgres}"
-SOURCE_DB="${FM_PG_DB:-food_market}"
-SOURCE_USER="${FM_PG_USER:-food_market}"
-LOCAL_USER="${PGUSER:-nns}"
-LOCAL_HOST="${PGHOST:-localhost}"
-LOCAL_PORT="${PGPORT:-5432}"
-TARGET_DB="food_market_anon_$$"
-OUT="${FM_ANON_OUT:-$HOME/food-market-anon-$(date +%Y%m%d-%H%M%S).sql.gz}"
-DRY_RUN=0
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --source-host) SOURCE_HOST="$2"; shift 2 ;;
-    --source-container) SOURCE_CONTAINER="$2"; shift 2 ;;
-    --out) OUT="$2"; shift 2 ;;
-    --dry-run) DRY_RUN=1; shift ;;
-    --help|-h) grep -E '^#( |$)' "$0" | sed 's/^# \?//'; exit 0 ;;
-    *) echo "Unknown: $1" >&2; exit 2 ;;
-  esac
-done
-
-log() { echo "[$(date -Iseconds)] $*"; }
-
-run() {
-  if [[ $DRY_RUN -eq 1 ]]; then echo "[dry-run] $*";
-  else echo "[exec] $*"; "$@"; fi
-}
-
-cleanup() {
-  log "cleanup: drop $TARGET_DB"
-  if [[ $DRY_RUN -eq 0 ]]; then
-    psql -h "$LOCAL_HOST" -p "$LOCAL_PORT" -U "$LOCAL_USER" -d postgres \
-      -c "DROP DATABASE IF EXISTS $TARGET_DB;" 2>/dev/null || true
-  fi
-}
-trap cleanup EXIT
-
-# ── 1. pg_dump из прода ──────────────────────────────────────────────
-DUMP="/tmp/food-market-prod-$$.dump"
-log "Step 1/5: pg_dump from $SOURCE_HOST → $DUMP (Fc format)"
-if [[ $DRY_RUN -eq 1 ]]; then
-  log "[dry-run] ssh $SOURCE_HOST docker exec $SOURCE_CONTAINER pg_dump -Fc -U $SOURCE_USER -d $SOURCE_DB > $DUMP"
-else
-  ssh -o ConnectTimeout=10 "$SOURCE_HOST" \
-    "docker exec $SOURCE_CONTAINER pg_dump -Fc --no-owner --no-privileges -U $SOURCE_USER -d $SOURCE_DB" \
-    > "$DUMP" || { log "FAIL pg_dump"; exit 1; }
-  log "dump size: $(du -h "$DUMP" | cut -f1)"
-fi
-
-# ── 2. Создать temp-БД и restore ─────────────────────────────────────
-log "Step 2/5: create $TARGET_DB + pg_restore"
-if [[ $DRY_RUN -eq 0 ]]; then
-  psql -h "$LOCAL_HOST" -p "$LOCAL_PORT" -U "$LOCAL_USER" -d postgres \
-    -c "CREATE DATABASE $TARGET_DB;" || { log "FAIL create db"; exit 1; }
-  pg_restore -h "$LOCAL_HOST" -p "$LOCAL_PORT" -U "$LOCAL_USER" -d "$TARGET_DB" \
-    --no-owner --no-privileges "$DUMP" 2>/dev/null || \
-    log "(некритично) pg_restore warnings — продолжаем"
-fi
-
-# ── 3. Anonymize PII ─────────────────────────────────────────────────
-# Hash для пароля "Test12345!" — генерируется через идентичный
-# алгоритм ASP.NET Identity (PBKDF2 SHA256, 10000 iter). Чтобы не
-# вводить криптографию в скрипт — берём заранее известный hash.
-# Сгенерировать новый можно через `dotnet run --project dev-tools/hash-pass.cs`.
-TEST_PASS_HASH='AQAAAAIAAYagAAAAEHJsxbHF3MoBGSe+1bktB4O9aERPI4j5Jt6w0iN4dCqU/5jL+i5xT8E+UEqcVf0Vqg=='
-
-log "Step 3/5: anonymize PII in $TARGET_DB"
-if [[ $DRY_RUN -eq 0 ]]; then
-  psql -h "$LOCAL_HOST" -p "$LOCAL_PORT" -U "$LOCAL_USER" -d "$TARGET_DB" -v ON_ERROR_STOP=1 <<SQL
--- 1. AspNetUsers (Identity): email + phone + password hash + security stamp
-WITH numbered AS (
-    SELECT "Id", row_number() OVER (ORDER BY "Id") AS rn FROM "AspNetUsers"
-)
-UPDATE "AspNetUsers" u
-SET
-    "Email" = 'user' || n.rn || '@example.kz',
-    "NormalizedEmail" = upper('user' || n.rn || '@example.kz'),
-    "UserName" = 'user' || n.rn || '@example.kz',
-    "NormalizedUserName" = upper('user' || n.rn || '@example.kz'),
-    "PhoneNumber" = '+7700111' || lpad(n.rn::text, 4, '0'),
-    "PasswordHash" = '$TEST_PASS_HASH',
-    "SecurityStamp" = encode(gen_random_bytes(16), 'hex'),
-    "ConcurrencyStamp" = gen_random_uuid()::text
-FROM numbered n
-WHERE u."Id" = n."Id";
-
--- 2. employees — рабочий email/телефон + полное имя
-WITH numbered AS (
-    SELECT "Id", row_number() OVER (ORDER BY "Id") AS rn FROM employees
-)
-UPDATE employees e
-SET
-    "Email" = CASE WHEN e."Email" IS NOT NULL THEN 'emp' || n.rn || '@example.kz' END,
-    "Phone" = CASE WHEN e."Phone" IS NOT NULL THEN '+7700222' || lpad(n.rn::text, 4, '0') END,
-    "FirstName" = 'Тест',
-    "LastName" = 'Тестов' || n.rn,
-    "MiddleName" = NULL,
-    "TaxNumber" = NULL
-FROM numbered n
-WHERE e."Id" = n."Id";
-
--- 3. counterparties — БИН/ИИН/имена/контакты
-WITH numbered AS (
-    SELECT "Id", row_number() OVER (ORDER BY "Id") AS rn FROM counterparties
-)
-UPDATE counterparties c
-SET
-    "Name" = 'Контрагент-' || n.rn,
-    "LegalName" = CASE WHEN c."LegalName" IS NOT NULL THEN 'ТОО Контрагент-' || n.rn END,
-    -- Синтетические BIN/IIN (12 цифр, не валидируем checksum здесь).
-    "Bin" = CASE WHEN c."Bin" IS NOT NULL THEN lpad(n.rn::text, 12, '9') END,
-    "Iin" = CASE WHEN c."Iin" IS NOT NULL THEN lpad(n.rn::text, 12, '8') END,
-    "Phone" = CASE WHEN c."Phone" IS NOT NULL THEN '+7700333' || lpad(n.rn::text, 4, '0') END,
-    "Email" = CASE WHEN c."Email" IS NOT NULL THEN 'cp' || n.rn || '@example.kz' END,
-    "Address" = CASE WHEN c."Address" IS NOT NULL THEN 'г. Тестовый, ул. Тестовая ' || n.rn END,
-    "BankAccount" = CASE WHEN c."BankAccount" IS NOT NULL THEN 'KZ000000' || lpad(n.rn::text, 14, '0') END,
-    "ContactPerson" = CASE WHEN c."ContactPerson" IS NOT NULL THEN 'Контакт ' || n.rn END,
-    "Notes" = NULL
-FROM numbered n
-WHERE c."Id" = n."Id";
-
--- 4. organizations: имя/БИН/телефон владельца/MoySkladToken
-UPDATE organizations
-SET
-    "MoySkladToken" = NULL,
-    "OwnerTelegramChatId" = NULL,
-    "Bin" = CASE WHEN "Bin" IS NOT NULL THEN '700700700700' END,
-    "Name" = 'TestOrg-' || substr("Id"::text, 1, 8);
-
--- 5. refresh tokens revoke all (чтобы старые stage-токены не работали)
-UPDATE "OpenIddictTokens" SET "Status" = 'revoked' WHERE "Status" = 'valid';
-
--- 6. чистим аудит-логи и feedback (могут содержать персональные тексты)
-TRUNCATE TABLE org_audit_log;
-TRUNCATE TABLE super_admin_audit_log;
-SQL
-  log "anonymize done"
-fi
-
-# ── 4. pg_dump anonymized → out ──────────────────────────────────────
-log "Step 4/5: pg_dump $TARGET_DB → $OUT"
-if [[ $DRY_RUN -eq 0 ]]; then
-  pg_dump -h "$LOCAL_HOST" -p "$LOCAL_PORT" -U "$LOCAL_USER" -d "$TARGET_DB" \
-    --no-owner --no-privileges --clean --if-exists \
-    | gzip > "$OUT"
-  log "anonymized dump: $(du -h "$OUT" | cut -f1) → $OUT"
-fi
-
-# ── 5. Cleanup (через trap) ──────────────────────────────────────────
-log "Step 5/5: cleanup"
-rm -f "$DUMP" 2>/dev/null || true
-
-log "✓ Готово: $OUT"
-log "Восстановить можно: gunzip -c $OUT | psql -d food_market_dev"
-exit 0

deploy/check-prod-readiness.sh

@@ -1,171 +0,0 @@
-#!/usr/bin/env bash
-#
-# Sprint 21: pre-deploy readiness check на prod-vm.
-#
-# Запускается ПЕРЕД prod-deploy.sh. Проверяет:
-#   1. Backup сделан < FM_BACKUP_MAX_AGE_MIN (60) минут назад
-#   2. Свободного места ≥ FM_MIN_FREE_GB (5) GB на каждом mount
-#   3. Текущий /health/ready возвращает 200
-#   4. (опц.) CI-проверки на этом коммите прошли (FM_CHECK_CI=1)
-#   5. .env содержит все required переменные (без placeholder'ов
-#      типа CHANGEME/REPLACE_ME)
-#
-# Exit 0 — всё хорошо, можно деплоить.
-# Exit 1+ — конкретная причина в stderr.
-#
-# Usage:
-#   deploy/check-prod-readiness.sh [--dry-run] [--ssh-host HOST]
-#
-# По умолчанию проверки локальные (предполагается что скрипт запущен НА
-# prod-vm). С --ssh-host выполняется через ssh: запускает себя
-# удалённо.
-
-set -uo pipefail
-# -e снят: хотим прогнать ВСЕ проверки и собрать суммарный отчёт,
-# не вылетая на первой.
-
-DRY_RUN=0
-SSH_HOST=""
-PROD_URL="${PROD_URL:-https://admin.food-market.kz}"
-BACKUP_DIR="${FM_BACKUP_DIR:-/opt/food-market-data/backups}"
-ENV_FILE="${FM_ENV_FILE:-/home/nns/food-market-prod/deploy/.env}"
-MAX_AGE_MIN="${FM_BACKUP_MAX_AGE_MIN:-60}"
-MIN_FREE_GB="${FM_MIN_FREE_GB:-5}"
-MOUNTS="${FM_MOUNTS:-/opt /var/lib/docker}"
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dry-run) DRY_RUN=1; shift ;;
-    --ssh-host) SSH_HOST="$2"; shift 2 ;;
-    --help|-h)
-      grep -E '^#( |$)' "$0" | sed 's/^# \?//'; exit 0 ;;
-    *) echo "Unknown arg: $1" >&2; exit 2 ;;
-  esac
-done
-
-if [[ -n "$SSH_HOST" ]]; then
-  # Re-run self on remote host.
-  echo "[check] proxying to $SSH_HOST"
-  exec ssh "$SSH_HOST" "FM_BACKUP_DIR='$BACKUP_DIR' FM_ENV_FILE='$ENV_FILE' \
-    FM_BACKUP_MAX_AGE_MIN='$MAX_AGE_MIN' FM_MIN_FREE_GB='$MIN_FREE_GB' \
-    FM_MOUNTS='$MOUNTS' PROD_URL='$PROD_URL' bash -s" < "$0" $([[ $DRY_RUN -eq 1 ]] && echo --dry-run)
-fi
-
-PASS=0
-FAIL=0
-ERRORS=()
-
-check() {
-  local name="$1" status="$2" detail="$3"
-  if [[ "$status" == "OK" ]]; then
-    echo "[✓] $name — $detail"
-    ((PASS+=1))
-  else
-    echo "[✗] $name — $detail" >&2
-    ERRORS+=("$name: $detail")
-    ((FAIL+=1))
-  fi
-}
-
-# ── 1. Backup age ────────────────────────────────────────────────────
-if [[ ! -d "$BACKUP_DIR" ]]; then
-  check "backup-age" "FAIL" "backup-dir $BACKUP_DIR не существует"
-else
-  # Самый свежий db-*.dump
-  LATEST=$(ls -t "$BACKUP_DIR"/db-*.dump 2>/dev/null | head -1)
-  if [[ -z "$LATEST" ]]; then
-    check "backup-age" "FAIL" "в $BACKUP_DIR нет db-*.dump файлов"
-  else
-    AGE_SEC=$(( $(date +%s) - $(stat -c %Y "$LATEST") ))
-    AGE_MIN=$(( AGE_SEC / 60 ))
-    if (( AGE_MIN > MAX_AGE_MIN )); then
-      check "backup-age" "FAIL" "последний backup $LATEST: $AGE_MIN мин назад (порог $MAX_AGE_MIN)"
-    else
-      check "backup-age" "OK" "$AGE_MIN мин назад ($LATEST)"
-    fi
-  fi
-fi
-
-# ── 2. Free disk space ───────────────────────────────────────────────
-for mnt in $MOUNTS; do
-  if [[ ! -d "$mnt" ]]; then
-    check "disk:$mnt" "FAIL" "mount не существует"
-    continue
-  fi
-  FREE_KB=$(df --output=avail "$mnt" 2>/dev/null | tail -1 | tr -d ' ')
-  if [[ -z "$FREE_KB" || "$FREE_KB" -le 0 ]]; then
-    check "disk:$mnt" "FAIL" "df не вернул avail"
-    continue
-  fi
-  FREE_GB=$(( FREE_KB / 1024 / 1024 ))
-  if (( FREE_GB < MIN_FREE_GB )); then
-    check "disk:$mnt" "FAIL" "$FREE_GB GB свободно (порог $MIN_FREE_GB)"
-  else
-    check "disk:$mnt" "OK" "$FREE_GB GB свободно"
-  fi
-done
-
-# ── 3. /health/ready ─────────────────────────────────────────────────
-HEALTH_BODY=$(curl -fsS --max-time 10 "$PROD_URL/health/ready" 2>/dev/null || echo "")
-if echo "$HEALTH_BODY" | grep -q '"status":"Healthy"'; then
-  check "health-ready" "OK" "$PROD_URL/health/ready=Healthy"
-else
-  check "health-ready" "FAIL" "ответ: ${HEALTH_BODY:-<empty>}"
-fi
-
-# ── 4. CI status (опц.) ──────────────────────────────────────────────
-if [[ "${FM_CHECK_CI:-0}" == "1" ]]; then
-  # Берём текущий commit и проверяем что CI workflow прошёл.
-  # Реализация зависит от наличия Forgejo CLI; пока — manual hint.
-  CURRENT_SHA=$(cd /home/nns/food-market 2>/dev/null && git rev-parse HEAD 2>/dev/null || echo "")
-  if [[ -n "$CURRENT_SHA" ]]; then
-    check "ci-status" "OK" "skipped (manual check: GET /api/v1/repos/nns/food-market/commits/$CURRENT_SHA/status)"
-  else
-    check "ci-status" "OK" "skipped (not a git repo)"
-  fi
-fi
-
-# ── 5. .env complete ─────────────────────────────────────────────────
-if [[ ! -f "$ENV_FILE" ]]; then
-  check ".env-file" "FAIL" "$ENV_FILE не существует"
-else
-  # Список обязательных переменных для прод-окружения.
-  REQUIRED=(
-    "POSTGRES_PASSWORD"
-    "OPENIDDICT_ISSUER"
-    "OPENIDDICT_CERT_PASSWORD"
-  )
-  MISSING=()
-  PLACEHOLDER=()
-  for key in "${REQUIRED[@]}"; do
-    VAL=$(grep -E "^${key}=" "$ENV_FILE" 2>/dev/null | head -1 | cut -d= -f2- || true)
-    if [[ -z "$VAL" ]]; then
-      MISSING+=("$key")
-    elif [[ "$VAL" =~ ^(CHANGEME|REPLACE_ME|TODO|dev|food_market_dev)$ ]]; then
-      PLACEHOLDER+=("$key=$VAL")
-    fi
-  done
-  if (( ${#MISSING[@]} > 0 )); then
-    check ".env-required" "FAIL" "отсутствуют: ${MISSING[*]}"
-  fi
-  if (( ${#PLACEHOLDER[@]} > 0 )); then
-    check ".env-placeholders" "FAIL" "плейсхолдеры: ${PLACEHOLDER[*]}"
-  fi
-  if (( ${#MISSING[@]} == 0 && ${#PLACEHOLDER[@]} == 0 )); then
-    check ".env-file" "OK" "${#REQUIRED[@]} required key(s) заполнены"
-  fi
-fi
-
-# ── Итог ─────────────────────────────────────────────────────────────
-echo
-echo "==> $PASS passed, $FAIL failed"
-if (( FAIL > 0 )); then
-  echo "Не готов к деплою:"
-  for e in "${ERRORS[@]}"; do echo "  - $e"; done
-  exit 1
-fi
-if [[ $DRY_RUN -eq 1 ]]; then
-  echo "(dry-run; никаких изменений)"
-fi
-echo "OK — можно запускать prod-deploy.sh"
-exit 0

deploy/db-schema-diff.sh

@@ -1,103 +0,0 @@
-#!/usr/bin/env bash
-#
-# Sprint 21: сравнение схемы БД stage vs prod.
-#
-# Делает `pg_dump --schema-only` с обеих БД, diff'ит. Если выводит
-# непустой diff — миграция не доехала или local-only изменения.
-#
-# Подразумевает что обе БД доступны (например через SSH-туннель или
-# pg_dump --host=<host>). Дефолтные подключения:
-#   stage = docker exec food-market-stage-postgres-1 pg_dump (через ssh dev-vm)
-#   prod  = docker exec food-market-postgres        pg_dump (через ssh prod-vm)
-#
-# Usage:
-#   deploy/db-schema-diff.sh [--stage-host HOST] [--prod-host HOST]
-#                            [--quick]    # без TOAST/sequence-details
-#                            [--dry-run]  # печать только команд
-#
-# Выход:
-#   0 — схемы идентичны
-#   1 — есть различия (печатает diff)
-#   2 — ошибка получения дампа
-
-set -uo pipefail
-
-STAGE_HOST="${FM_STAGE_HOST:-nns@192.168.1.190}"
-PROD_HOST="${FM_PROD_HOST:-nns@admin.food-market.kz}"
-STAGE_CONT="${FM_STAGE_CONT:-food-market-stage-postgres-1}"
-PROD_CONT="${FM_PROD_CONT:-food-market-postgres}"
-DB="${FM_PG_DB:-food_market}"
-DB_USER="${FM_PG_USER:-food_market}"
-QUICK=0
-DRY_RUN=0
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --stage-host) STAGE_HOST="$2"; shift 2 ;;
-    --prod-host)  PROD_HOST="$2"; shift 2 ;;
-    --quick) QUICK=1; shift ;;
-    --dry-run) DRY_RUN=1; shift ;;
-    --help|-h) grep -E '^#( |$)' "$0" | sed 's/^# \?//'; exit 0 ;;
-    *) echo "Unknown: $1" >&2; exit 2 ;;
-  esac
-done
-
-# Флаги pg_dump для schema-only сравнения. --schema-only + --no-owner +
-# --no-privileges чтобы дамп был стабильный без role-mismatch'ей между
-# инстансами. --no-comments — выключаем COMMENT'ы (они часто шумят).
-PGDUMP_FLAGS="--schema-only --no-owner --no-privileges --no-comments"
-if [[ $QUICK -eq 1 ]]; then
-  PGDUMP_FLAGS="$PGDUMP_FLAGS --exclude-table-data=pg_*"
-fi
-
-TMP_DIR=$(mktemp -d)
-trap "rm -rf $TMP_DIR" EXIT
-STAGE_SQL="$TMP_DIR/stage.sql"
-PROD_SQL="$TMP_DIR/prod.sql"
-
-log() { echo "[$(date -Iseconds)] $*" >&2; }
-
-dump_remote() {
-  local host="$1" container="$2" out="$3"
-  log "dump from $host (container $container) → $out"
-  if [[ $DRY_RUN -eq 1 ]]; then
-    echo "[dry-run] ssh $host docker exec $container pg_dump $PGDUMP_FLAGS -U $DB_USER -d $DB > $out"
-    touch "$out"
-    return
-  fi
-  ssh -o ConnectTimeout=10 "$host" "docker exec $container pg_dump $PGDUMP_FLAGS -U $DB_USER -d $DB" > "$out" 2>/dev/null \
-    || { log "FAIL: dump from $host"; return 2; }
-}
-
-dump_remote "$STAGE_HOST" "$STAGE_CONT" "$STAGE_SQL" || exit 2
-dump_remote "$PROD_HOST"  "$PROD_CONT"  "$PROD_SQL"  || exit 2
-
-# Нормализация: убираем строки которые всегда отличаются (комментарии,
-# даты, version-header'ы, OID'ы):
-normalize() {
-  sed -e '/^-- /d' \
-      -e '/^SET /d' \
-      -e '/^SELECT pg_catalog.set_config/d' \
-      -e '/^[[:space:]]*$/d' "$1"
-}
-
-# Применяем нормализацию ин-плейс и сравниваем.
-normalize "$STAGE_SQL" > "$TMP_DIR/stage.norm"
-normalize "$PROD_SQL"  > "$TMP_DIR/prod.norm"
-
-log "comparing…"
-if diff -u "$TMP_DIR/prod.norm" "$TMP_DIR/stage.norm" > "$TMP_DIR/diff" 2>&1; then
-  echo "✓ Схемы идентичны (stage == prod)"
-  exit 0
-fi
-
-LINES=$(wc -l < "$TMP_DIR/diff")
-echo "✗ Найдены различия: $LINES строк diff'a"
-echo
-echo "===== diff (prod → stage) ====="
-cat "$TMP_DIR/diff"
-echo "==============================="
-echo
-echo "Если разница — новые миграции stage → prod, применить их перед deploy."
-echo "Если разница — local-only изменения на prod, разобраться вручную."
-exit 1

deploy/docker-compose.yml

@@ -1,6 +1,6 @@
 services:
   postgres:
-    image: ${REGISTRY:-127.0.0.1:5001}/mirror/postgres:16-alpine
+    image: postgres:16-alpine
     container_name: food-market-postgres
     restart: unless-stopped
     environment:
@@ -29,51 +29,24 @@ services:
     environment:
       ASPNETCORE_ENVIRONMENT: Production
       ConnectionStrings__Default: Host=postgres;Port=5432;Database=food_market;Username=food_market;Password=${POSTGRES_PASSWORD:-food_market_dev}
-      # Публичный issuer токенов — обязателен за прокси, иначе берётся из запроса
-      # (или дефолт localhost из appsettings, что неверно для прод).
-      OpenIddict__Issuer: ${OPENIDDICT_ISSUER:-https://admin.food-market.kz/}
-      # Пароль PFX-сертификатов OpenIddict (пусто = сертификаты без пароля).
-      OpenIddict__CertPassword: ${OPENIDDICT_CERT_PASSWORD:-}
-      # Sprint 13: rate-limit на signup. На stage'е переопределяется в
-      # .env'е через RATE_SIGNUP_HOUR / RATE_SIGNUP_DAY для прохождения
-      # e2e/smoke; в prod'е оставляем дефолты 3/час, 10/сутки.
-      RateLimiting__SignupPerIpPerHour: ${RATE_SIGNUP_HOUR:-3}
-      RateLimiting__SignupPerIpPerDay: ${RATE_SIGNUP_DAY:-10}
     # Host port mapping: pick free ports on existing stage server (80/443 taken by
     # legacy nginx, 5000/5002/5005 taken by legacy .NET apps).
     ports:
       - "8080:8080"  # api
 
-    healthcheck:
-      # Готовность = БД отвечает + миграции применены (см. /health/ready).
-      test: ["CMD-SHELL", "curl -fsS http://localhost:8080/health/ready || exit 1"]
-      interval: 30s
-      timeout: 5s
-      retries: 5
-      start_period: 30s
-
     volumes:
       - api-data:/app/App_Data
       - api-logs:/app/logs
-      - /opt/food-market-data/uploads:/app/uploads
 
   web:
     image: ${REGISTRY:-127.0.0.1:5001}/food-market-web:${WEB_TAG:-latest}
     container_name: food-market-web
     restart: unless-stopped
     depends_on:
-      api:
+      - api
-        condition: service_healthy
     ports:
       - "8081:80"  # web SPA, not on 80 (legacy nginx holds it)
 
-  public:
-    image: ${REGISTRY:-127.0.0.1:5001}/food-market-public:${PUBLIC_TAG:-latest}
-    container_name: food-market-public
-    restart: unless-stopped
-    ports:
-      - "8082:80"  # marketing astro static
-
 volumes:
   postgres-data:
     name: food-market-postgres-data
@@ -81,4 +54,3 @@ volumes:
     name: food-market-api-data
   api-logs:
     name: food-market-api-logs
-

deploy/docker-registry.service

@@ -1,19 +0,0 @@
-[Unit]
-Description=Local Docker Registry for food-market
-Requires=docker.service
-After=docker.service network-online.target
-
-[Service]
-Type=simple
-ExecStartPre=-/usr/bin/docker rm -f food-market-registry
-ExecStart=/usr/bin/docker run --rm --name food-market-registry \
-  -p 127.0.0.1:5001:5000 \
-  -v /opt/food-market-data/docker-registry:/var/lib/registry \
-  -e REGISTRY_STORAGE_DELETE_ENABLED=true \
-  registry:2
-ExecStop=/usr/bin/docker stop food-market-registry
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=multi-user.target

deploy/food-market-backup.service

@@ -1,15 +0,0 @@
-[Unit]
-Description=food-market: бэкап БД и загруженных файлов
-Documentation=https://github.com/nurdotnet/food-market/blob/main/docs/backup-restore.md
-Wants=docker.service
-After=docker.service
-
-[Service]
-Type=oneshot
-# Опциональные переопределения FM_* (см. шапку скрипта). Знак "-" — файл не
-# обязателен. Путь скорректировать под фактический каталог деплоя.
-EnvironmentFile=-/opt/food-market/deploy/.env
-ExecStart=/opt/food-market/deploy/food-market-backup.sh
-# Бэкап не должен мешать основной нагрузке.
-Nice=10
-IOSchedulingClass=idle

deploy/food-market-backup.sh

@@ -1,67 +0,0 @@
-#!/usr/bin/env bash
-#
-# food-market: ежедневный бэкап БД + загруженных файлов с ротацией.
-#
-# Дампит Postgres (контейнер food-market-postgres) в custom-формат pg_dump
-# (-Fc, пригоден для pg_restore с параллелизмом/выборочным восстановлением) и
-# архивирует каталог uploads. Удаляет бэкапы старше RETENTION_DAYS дней.
-#
-# Запускается из systemd-таймера food-market-backup.timer (ежедневно), либо
-# вручную. Конфигурируется переменными окружения (значения по умолчанию
-# совпадают с deploy/docker-compose.yml):
-#
-#   FM_PG_CONTAINER         имя контейнера Postgres   (food-market-postgres)
-#   FM_PG_DB                имя БД                     (food_market)
-#   FM_PG_USER              пользователь БД            (food_market)
-#   FM_BACKUP_DIR           куда складывать бэкапы     (/opt/food-market-data/backups)
-#   FM_UPLOADS_DIR          каталог изображений        (/opt/food-market-data/uploads)
-#   FM_BACKUP_RETENTION_DAYS срок хранения, дней       (30)
-#
-set -euo pipefail
-
-CONTAINER="${FM_PG_CONTAINER:-food-market-postgres}"
-DB="${FM_PG_DB:-food_market}"
-DB_USER="${FM_PG_USER:-food_market}"
-BACKUP_DIR="${FM_BACKUP_DIR:-/opt/food-market-data/backups}"
-UPLOADS_DIR="${FM_UPLOADS_DIR:-/opt/food-market-data/uploads}"
-RETENTION_DAYS="${FM_BACKUP_RETENTION_DAYS:-30}"
-
-TS="$(date +%Y%m%d-%H%M%S)"
-DB_FILE="$BACKUP_DIR/db-$TS.dump"
-UPLOADS_FILE="$BACKUP_DIR/uploads-$TS.tgz"
-
-log() { echo "[$(date -Is)] $*"; }
-
-mkdir -p "$BACKUP_DIR"
-
-if ! docker ps --format '{{.Names}}' | grep -qx "$CONTAINER"; then
-  log "ОШИБКА: контейнер '$CONTAINER' не запущен — бэкап невозможен." >&2
-  exit 1
-fi
-
-log "Дамп БД '$DB' → $DB_FILE"
-# Дамп пишем во временный файл и переименовываем по успеху — частичный/битый
-# дамп при падении pg_dump не попадёт в ротацию как валидный.
-if docker exec "$CONTAINER" pg_dump -U "$DB_USER" -d "$DB" -Fc > "$DB_FILE.tmp"; then
-  mv "$DB_FILE.tmp" "$DB_FILE"
-  log "Готово: $(du -h "$DB_FILE" | cut -f1)"
-else
-  rm -f "$DB_FILE.tmp"
-  log "ОШИБКА: pg_dump завершился с ошибкой." >&2
-  exit 1
-fi
-
-if [ -d "$UPLOADS_DIR" ]; then
-  log "Архив uploads '$UPLOADS_DIR' → $UPLOADS_FILE"
-  tar czf "$UPLOADS_FILE.tmp" -C "$(dirname "$UPLOADS_DIR")" "$(basename "$UPLOADS_DIR")" \
-    && mv "$UPLOADS_FILE.tmp" "$UPLOADS_FILE"
-  log "Готово: $(du -h "$UPLOADS_FILE" | cut -f1)"
-else
-  log "Каталог uploads '$UPLOADS_DIR' отсутствует — пропуск."
-fi
-
-log "Ротация: удаляю бэкапы старше $RETENTION_DAYS дн."
-find "$BACKUP_DIR" -maxdepth 1 -type f -name 'db-*.dump'    -mtime +"$RETENTION_DAYS" -print -delete
-find "$BACKUP_DIR" -maxdepth 1 -type f -name 'uploads-*.tgz' -mtime +"$RETENTION_DAYS" -print -delete
-
-log "Бэкап завершён."

deploy/food-market-backup.timer

@@ -1,14 +0,0 @@
-[Unit]
-Description=food-market: ежедневный бэкап (03:00)
-Documentation=https://github.com/nurdotnet/food-market/blob/main/docs/backup-restore.md
-
-[Timer]
-# Каждый день в 03:00 локального времени сервера.
-OnCalendar=*-*-* 03:00:00
-# Догнать пропущенный запуск, если сервер был выключен в момент срабатывания.
-Persistent=true
-# Небольшой разброс — на случай нескольких таймеров одновременно.
-RandomizedDelaySec=300
-
-[Install]
-WantedBy=timers.target

deploy/food-market-mirror-base-images.service

@@ -1,11 +0,0 @@
-[Unit]
-Description=Mirror docker base images into local 127.0.0.1:5001 registry
-Requires=food-market-registry.service
-After=food-market-registry.service docker.service
-
-[Service]
-Type=oneshot
-User=nns
-ExecStart=/usr/local/bin/food-market-mirror-base-images.sh
-StandardOutput=append:/var/log/food-market-mirror-base-images.log
-StandardError=append:/var/log/food-market-mirror-base-images.log

deploy/food-market-mirror-base-images.timer

@@ -1,11 +0,0 @@
-[Unit]
-Description=Refresh docker base image mirrors daily
-
-[Timer]
-OnBootSec=10min
-OnUnitActiveSec=24h
-Unit=food-market-mirror-base-images.service
-Persistent=true
-
-[Install]
-WantedBy=timers.target

deploy/forgejo/docker-compose.yml

@@ -1,27 +0,0 @@
-services:
-  forgejo:
-    image: codeberg.org/forgejo/forgejo:7
-    container_name: food-market-forgejo
-    restart: unless-stopped
-    environment:
-      USER_UID: "1000"
-      USER_GID: "1000"
-      FORGEJO__server__DOMAIN: git.zat.kz
-      FORGEJO__server__ROOT_URL: https://git.zat.kz/
-      FORGEJO__server__SSH_DOMAIN: git.zat.kz
-      FORGEJO__server__SSH_PORT: "2222"
-      FORGEJO__server__SSH_LISTEN_PORT: "22"
-      FORGEJO__server__START_SSH_SERVER: "false"
-      FORGEJO__server__DISABLE_SSH: "false"
-      FORGEJO__service__DISABLE_REGISTRATION: "true"
-      FORGEJO__service__REQUIRE_SIGNIN_VIEW: "false"
-      FORGEJO__actions__ENABLED: "true"
-      FORGEJO__database__DB_TYPE: sqlite3
-      FORGEJO__log__LEVEL: Info
-    volumes:
-      - /opt/food-market-data/forgejo/data:/data
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    ports:
-      - "127.0.0.1:3000:3000"  # HTTP, fronted by nginx on git.zat.kz
-      - "2222:22"              # SSH for git clone/push via ssh://git@git.zat.kz:2222/...

deploy/forgejo/food-market-forgejo-mirror.service

@@ -1,7 +0,0 @@
-[Unit]
-Description=Push Forgejo food-market into GitHub (backup)
-
-[Service]
-Type=oneshot
-User=nns
-ExecStart=/usr/local/bin/food-market-forgejo-mirror.sh

deploy/forgejo/food-market-forgejo-mirror.timer

@@ -1,10 +0,0 @@
-[Unit]
-Description=Mirror Forgejo -> GitHub every 10 min
-
-[Timer]
-OnBootSec=3min
-OnUnitActiveSec=10min
-Unit=food-market-forgejo-mirror.service
-
-[Install]
-WantedBy=timers.target

deploy/forgejo/food-market-forgejo.service

@@ -1,15 +0,0 @@
-[Unit]
-Description=food-market Forgejo (primary git)
-Requires=docker.service
-After=docker.service network-online.target
-
-[Service]
-Type=oneshot
-RemainAfterExit=true
-WorkingDirectory=/home/nns/food-market/deploy/forgejo
-ExecStart=/usr/bin/docker compose up -d
-ExecStop=/usr/bin/docker compose stop
-User=nns
-
-[Install]
-WantedBy=multi-user.target

deploy/forgejo/mirror-to-github.sh

@@ -1,40 +0,0 @@
-#!/bin/bash
-# Mirrors our Forgejo repo into GitHub. Best-effort: if the push fails (flaky
-# KZ TCP to github.com), the next tick will retry.
-set -euo pipefail
-
-MIRROR_DIR="/opt/food-market-data/forgejo/mirror"
-FORGEJO_URL="http://127.0.0.1:3000/nns/food-market.git"
-GITHUB_URL="https://github.com/nurdotnet/food-market.git"
-GITHUB_TOKEN_FILE="/etc/food-market/github-mirror-token"  # 40-char PAT with repo scope
-LOG_FILE="/var/log/food-market-forgejo-mirror.log"
-
-log() { printf '%s %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$*" >> "$LOG_FILE"; }
-
-if [[ ! -f $GITHUB_TOKEN_FILE ]]; then
-  log "token file $GITHUB_TOKEN_FILE missing — skipping mirror push"
-  exit 0
-fi
-TOKEN=$(tr -d '\n' < "$GITHUB_TOKEN_FILE")
-
-if [[ ! -d $MIRROR_DIR/objects ]]; then
-  log "bootstrap: cloning $FORGEJO_URL → $MIRROR_DIR"
-  rm -rf "$MIRROR_DIR"
-  git clone --mirror "$FORGEJO_URL" "$MIRROR_DIR" >> "$LOG_FILE" 2>&1
-fi
-
-cd "$MIRROR_DIR"
-
-# Pull latest from Forgejo (source of truth).
-if ! git remote update --prune >> "$LOG_FILE" 2>&1; then
-  log "forgejo fetch failed — aborting this tick"
-  exit 0
-fi
-
-# Push everything to GitHub, timeout generously (big pushes on flaky link).
-GIT_HTTP_LOW_SPEED_LIMIT=1000 \
-GIT_HTTP_LOW_SPEED_TIME=60 \
-timeout 300 git push --prune "https://x-access-token:$TOKEN@github.com/nurdotnet/food-market.git" \
-  '+refs/heads/*:refs/heads/*' '+refs/tags/*:refs/tags/*' >> "$LOG_FILE" 2>&1 \
-  && log "pushed to github ok" \
-  || log "github push failed (exit=$?), will retry next tick"

deploy/forgejo/nginx.conf

@@ -1,22 +0,0 @@
-server {
-    listen 80;
-    server_name git.zat.kz;
-    location /.well-known/acme-challenge/ { root /var/www/html; }
-
-    # Forgejo can serve large pushes; allow big request bodies.
-    client_max_body_size 512M;
-
-    location / {
-        proxy_pass http://127.0.0.1:3000;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        proxy_buffering off;
-        proxy_request_buffering off;
-        proxy_read_timeout 300s;
-    }
-}
-# Note: run certbot --nginx -d git.zat.kz to issue a TLS cert — certbot will
-# add a TLS server block and rewrite this one to 301->https.

deploy/generate-release-notes.sh

@@ -1,129 +0,0 @@
-#!/usr/bin/env bash
-#
-# Sprint 21: генератор release-notes между двумя тэгами.
-#
-# Парсит `git log <from>..<to>`, группирует коммиты по prefix:
-#   feat: → ## Новые возможности
-#   fix:  → ## Исправления
-#   perf: → ## Производительность
-#   docs: → ## Документация
-#   test: → ## Тесты (свёрнуто)
-#   chore/refactor/build: → ## Внутренние изменения (свёрнуто)
-#
-# Вывод — markdown, дополнительно сохраняет в:
-#   docs/release-notes/<to-tag>.md
-# Используется при создании git-тега и в /whats-new.
-#
-# Usage:
-#   deploy/generate-release-notes.sh <from-tag> <to-tag> [--dry-run]
-#   deploy/generate-release-notes.sh v20260606.1 v20260607.3 > release.md
-
-set -uo pipefail
-
-FROM="${1:-}"
-TO="${2:-HEAD}"
-DRY_RUN=0
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dry-run) DRY_RUN=1; shift ;;
-    --help|-h) grep -E '^#( |$)' "$0" | sed 's/^# \?//'; exit 0 ;;
-    -*) echo "Unknown: $1" >&2; exit 2 ;;
-    *) shift ;;
-  esac
-done
-
-if [[ -z "$FROM" ]]; then
-  echo "Usage: $0 <from-tag> <to-tag> [--dry-run]" >&2
-  exit 2
-fi
-
-cd "$(dirname "$0")/.."
-REPO_ROOT="$(pwd)"
-
-# Валидация тэгов: должны существовать в git.
-git rev-parse --verify "$FROM" >/dev/null 2>&1 || { echo "FAIL: тэг $FROM не найден"; exit 1; }
-git rev-parse --verify "$TO"   >/dev/null 2>&1 || { echo "FAIL: тэг $TO не найден"; exit 1; }
-
-# Собираем коммиты в формате `prefix|subject|short-sha`.
-# `grep -v Merge` исключает merge-коммиты.
-COMMITS=$(git log "$FROM..$TO" --pretty=format:'%s|%h' --no-merges)
-
-if [[ -z "$COMMITS" ]]; then
-  echo "Нет коммитов между $FROM и $TO"
-  exit 0
-fi
-
-# Группируем через awk. Префикс: feat/fix/perf/docs/test/chore/refactor/build/style.
-RENDERED=$(echo "$COMMITS" | awk -F'|' '
-function head(label) {
-    if (!printed[label]) {
-        print ""
-        print label
-        print ""
-        printed[label] = 1
-    }
-}
-{
-    subject = $1
-    sha = $2
-    type = "other"
-    text = subject
-    if (match(subject, /^(feat|fix|perf|docs|test|chore|refactor|build|style)(\([^)]+\))?:[[:space:]]*/, m)) {
-        type = m[1]
-        scope = m[2]
-        text = substr(subject, RLENGTH + 1)
-    }
-    line = "- " text " (`" sha "`)"
-    bucket[type] = bucket[type] line "\n"
-}
-END {
-    if (bucket["feat"])     { head("## ✨ Новые возможности"); printf "%s", bucket["feat"] }
-    if (bucket["fix"])      { head("## 🐛 Исправления"); printf "%s", bucket["fix"] }
-    if (bucket["perf"])     { head("## ⚡ Производительность"); printf "%s", bucket["perf"] }
-    if (bucket["docs"])     { head("## 📚 Документация"); printf "%s", bucket["docs"] }
-    if (bucket["test"]) {
-        print ""
-        print "<details><summary>🧪 Тесты</summary>"
-        print ""
-        printf "%s", bucket["test"]
-        print ""
-        print "</details>"
-    }
-    if (bucket["refactor"] || bucket["chore"] || bucket["build"] || bucket["style"]) {
-        print ""
-        print "<details><summary>🔧 Внутренние изменения</summary>"
-        print ""
-        for (k in bucket) if (k == "refactor" || k == "chore" || k == "build" || k == "style") printf "%s", bucket[k]
-        print ""
-        print "</details>"
-    }
-    if (bucket["other"]) {
-        print ""
-        print "<details><summary>📦 Прочее</summary>"
-        print ""
-        printf "%s", bucket["other"]
-        print ""
-        print "</details>"
-    }
-}
-')
-
-DATE=$(date -u +%Y-%m-%d)
-COUNT=$(echo "$COMMITS" | wc -l)
-HEADER="# Release $TO
-
-Дата: $DATE · Коммитов: $COUNT · С: $FROM"
-
-OUTPUT="$HEADER
-$RENDERED"
-
-echo "$OUTPUT"
-
-if [[ $DRY_RUN -eq 0 ]]; then
-  TARGET="$REPO_ROOT/docs/release-notes/$TO.md"
-  mkdir -p "$(dirname "$TARGET")"
-  echo "$OUTPUT" > "$TARGET"
-  echo "" >&2
-  echo "[saved] $TARGET" >&2
-fi

deploy/grafana/dashboards/README.md

@@ -1,37 +0,0 @@
-# Grafana dashboards
-
-Дашборды для food-market — импортируются в Grafana через **Settings → Data
-sources → Add Prometheus** + **Dashboards → Import → Upload JSON**.
-
-## Список
-
-| Файл | UID | Назначение |
-|---|---|---|
-| `food-market.json` | `fm-baseline` | Sprint 13 baseline: HTTP, EF Core, бизнес-метрики |
-| `quality-watchdog.json` | `fm-quality-watchdog` | Sprint 26: smoke success / p95 latency / multi-tenant violations / incidents + базовые prom-метрики |
-
-## Зависимости
-
-1. **Prometheus** scrap'ит `/metrics` API'я (см. `deploy/prometheus/prometheus.yml`).
-2. **node_exporter** на машине, где живёт `~/quality-watchdog.sh`, с
-   флагом `--collector.textfile.directory=$HOME/.fm-watchdog/textfile`.
-   Watchdog туда пишет `quality_watchdog.prom` после каждого прогона.
-3. **Alertmanager** для alert'ов из `deploy/prometheus/alerts.yml` —
-   см. `docs/RUNBOOK.md` для action'ов.
-
-## Использование
-
-```bash
-# Local stack для теста дашбордов:
-cd deploy
-docker run -d -p 3000:3000 grafana/grafana
-docker run -d -p 9090:9090 \
-  -v $PWD/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml \
-  -v $PWD/prometheus/alerts.yml:/etc/prometheus/alerts.yml \
-  prom/prometheus
-# Grafana: admin/admin → Add Prometheus DS → http://host.docker.internal:9090
-# Import → upload grafana/dashboards/quality-watchdog.json
-```
-
-`${DS_PROMETHEUS}` template variable указывает на выбранный DS — Grafana
-подставит ваш Prometheus при импорте.

deploy/grafana/dashboards/food-market.json

@@ -1,399 +0,0 @@
-{
-  "annotations": {
-    "list": [
-      {
-        "builtIn": 1,
-        "datasource": {
-          "type": "grafana",
-          "uid": "-- Grafana --"
-        },
-        "enable": true,
-        "hide": true,
-        "iconColor": "rgba(0, 211, 255, 1)",
-        "name": "Annotations & Alerts",
-        "type": "dashboard"
-      }
-    ]
-  },
-  "description": "Sprint 13 baseline-dashboard для food-market.api. Объединяет prometheus-net (HTTP), EF Core (DB) и кастомные AppMetrics (бизнес).",
-  "editable": true,
-  "fiscalYearStartMonth": 0,
-  "graphTooltip": 1,
-  "id": null,
-  "links": [],
-  "liveNow": false,
-  "panels": [
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${DS_PROMETHEUS}"
-      },
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 10,
-            "gradientMode": "none",
-            "hideFrom": {"legend": false, "tooltip": false, "viz": false},
-            "lineInterpolation": "linear",
-            "lineWidth": 2,
-            "pointSize": 5,
-            "scaleDistribution": {"type": "linear"},
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {"group": "A", "mode": "none"},
-            "thresholdsStyle": {"mode": "off"}
-          },
-          "mappings": [],
-          "thresholds": {"mode": "absolute", "steps": [{"color": "green", "value": null}]},
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {"h": 8, "w": 12, "x": 0, "y": 0},
-      "id": 1,
-      "options": {
-        "legend": {"calcs": ["mean", "max"], "displayMode": "table", "placement": "right", "showLegend": true},
-        "tooltip": {"mode": "multi", "sort": "desc"}
-      },
-      "targets": [
-        {
-          "expr": "sum by (code) (rate(http_requests_received_total[1m]))",
-          "legendFormat": "{{code}}",
-          "refId": "A"
-        }
-      ],
-      "title": "HTTP — RPS по статус-коду",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${DS_PROMETHEUS}"
-      },
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "thresholds"},
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "green", "value": null},
-              {"color": "yellow", "value": 0.5},
-              {"color": "red", "value": 2}
-            ]
-          },
-          "unit": "s"
-        }
-      },
-      "gridPos": {"h": 8, "w": 12, "x": 12, "y": 0},
-      "id": 2,
-      "options": {
-        "legend": {"calcs": ["last", "max"], "displayMode": "table", "placement": "right", "showLegend": true},
-        "tooltip": {"mode": "multi", "sort": "desc"}
-      },
-      "targets": [
-        {
-          "expr": "histogram_quantile(0.50, sum by (le) (rate(http_request_duration_seconds_bucket[5m])))",
-          "legendFormat": "p50",
-          "refId": "A"
-        },
-        {
-          "expr": "histogram_quantile(0.95, sum by (le) (rate(http_request_duration_seconds_bucket[5m])))",
-          "legendFormat": "p95",
-          "refId": "B"
-        },
-        {
-          "expr": "histogram_quantile(0.99, sum by (le) (rate(http_request_duration_seconds_bucket[5m])))",
-          "legendFormat": "p99",
-          "refId": "C"
-        }
-      ],
-      "title": "HTTP — latency p50/p95/p99",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {
-            "drawStyle": "line",
-            "fillOpacity": 10,
-            "lineWidth": 2,
-            "pointSize": 5,
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {"group": "A", "mode": "normal"}
-          },
-          "mappings": [],
-          "thresholds": {"mode": "absolute", "steps": [{"color": "green", "value": null}]},
-          "unit": "ops"
-        }
-      },
-      "gridPos": {"h": 8, "w": 12, "x": 0, "y": 8},
-      "id": 3,
-      "options": {
-        "legend": {"calcs": ["sum"], "displayMode": "table", "placement": "right", "showLegend": true},
-        "tooltip": {"mode": "multi", "sort": "desc"}
-      },
-      "targets": [
-        {
-          "expr": "sum by (type) (rate(food_market_documents_posted_total[1m]))",
-          "legendFormat": "{{type}}",
-          "refId": "A"
-        }
-      ],
-      "title": "Бизнес — документы посчитаны (Post), per-type RPS",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "thresholds"},
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "green", "value": null},
-              {"color": "yellow", "value": 0.1},
-              {"color": "red", "value": 1}
-            ]
-          },
-          "unit": "ops"
-        }
-      },
-      "gridPos": {"h": 8, "w": 12, "x": 12, "y": 8},
-      "id": 4,
-      "options": {
-        "legend": {"calcs": ["sum"], "displayMode": "table", "placement": "right", "showLegend": true},
-        "tooltip": {"mode": "multi", "sort": "desc"}
-      },
-      "targets": [
-        {
-          "expr": "sum by (type, reason) (rate(food_market_documents_error_total[1m]))",
-          "legendFormat": "{{type}} / {{reason}}",
-          "refId": "A"
-        }
-      ],
-      "title": "Бизнес — ошибки проведения per-type / reason",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "spectrum", "scheme": "Blues"},
-          "custom": {
-            "hideFrom": {"legend": false, "tooltip": false, "viz": false},
-            "scaleDistribution": {"type": "linear"}
-          },
-          "mappings": [],
-          "unit": "s"
-        }
-      },
-      "gridPos": {"h": 9, "w": 12, "x": 0, "y": 16},
-      "id": 5,
-      "options": {
-        "calculate": false,
-        "cellGap": 1,
-        "color": {"exponent": 0.5, "fill": "dark-orange", "mode": "scheme", "reverse": false, "scale": "exponential", "scheme": "Spectral", "steps": 64},
-        "exemplars": {"color": "rgba(255,0,255,0.7)"},
-        "filterValues": {"le": 1e-9},
-        "legend": {"show": true},
-        "rowsFrame": {"layout": "auto"},
-        "tooltip": {"show": true, "yHistogram": false},
-        "yAxis": {"axisPlacement": "left", "reverse": false, "unit": "s"}
-      },
-      "pluginVersion": "10.0.0",
-      "targets": [
-        {
-          "expr": "sum by (le) (rate(food_market_db_query_duration_seconds_bucket[1m]))",
-          "format": "heatmap",
-          "legendFormat": "{{le}}",
-          "refId": "A"
-        }
-      ],
-      "title": "DB — длительность EF-запросов (heatmap)",
-      "type": "heatmap"
-    },
-    {
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "thresholds"},
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "green", "value": null},
-              {"color": "yellow", "value": 5},
-              {"color": "red", "value": 20}
-            ]
-          },
-          "unit": "percent"
-        }
-      },
-      "gridPos": {"h": 9, "w": 6, "x": 12, "y": 16},
-      "id": 6,
-      "options": {
-        "colorMode": "background",
-        "graphMode": "area",
-        "justifyMode": "center",
-        "orientation": "auto",
-        "reduceOptions": {"calcs": ["lastNotNull"], "fields": "", "values": false},
-        "textMode": "auto"
-      },
-      "pluginVersion": "10.0.0",
-      "targets": [
-        {
-          "expr": "100 * sum(rate(http_requests_received_total{code=~\"5..\"}[5m])) / sum(rate(http_requests_received_total[5m]))",
-          "refId": "A"
-        }
-      ],
-      "title": "HTTP — % 5xx за 5 мин",
-      "type": "stat"
-    },
-    {
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "thresholds"},
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "green", "value": null},
-              {"color": "yellow", "value": 10},
-              {"color": "red", "value": 30}
-            ]
-          },
-          "unit": "percent"
-        }
-      },
-      "gridPos": {"h": 9, "w": 6, "x": 18, "y": 16},
-      "id": 7,
-      "options": {
-        "colorMode": "background",
-        "graphMode": "area",
-        "justifyMode": "center",
-        "orientation": "auto",
-        "reduceOptions": {"calcs": ["lastNotNull"], "fields": "", "values": false},
-        "textMode": "auto"
-      },
-      "pluginVersion": "10.0.0",
-      "targets": [
-        {
-          "expr": "100 * sum(rate(http_requests_received_total{code=~\"4..\"}[5m])) / sum(rate(http_requests_received_total[5m]))",
-          "refId": "A"
-        }
-      ],
-      "title": "HTTP — % 4xx за 5 мин",
-      "type": "stat"
-    },
-    {
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {
-            "drawStyle": "line",
-            "fillOpacity": 10,
-            "lineWidth": 2,
-            "pointSize": 5,
-            "showPoints": "never"
-          },
-          "mappings": [],
-          "thresholds": {"mode": "absolute", "steps": [{"color": "green", "value": null}]},
-          "unit": "bytes"
-        }
-      },
-      "gridPos": {"h": 8, "w": 12, "x": 0, "y": 25},
-      "id": 8,
-      "options": {
-        "legend": {"calcs": ["last", "max"], "displayMode": "table", "placement": "right", "showLegend": true},
-        "tooltip": {"mode": "multi", "sort": "desc"}
-      },
-      "targets": [
-        {
-          "expr": "process_resident_memory_bytes",
-          "legendFormat": "RSS",
-          "refId": "A"
-        },
-        {
-          "expr": "dotnet_total_memory_bytes",
-          "legendFormat": "Managed heap",
-          "refId": "B"
-        }
-      ],
-      "title": "Процесс — память (RSS + managed)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {
-            "drawStyle": "line",
-            "fillOpacity": 10,
-            "lineWidth": 2,
-            "pointSize": 5,
-            "showPoints": "never"
-          },
-          "mappings": [],
-          "thresholds": {"mode": "absolute", "steps": [{"color": "green", "value": null}]},
-          "unit": "ops"
-        }
-      },
-      "gridPos": {"h": 8, "w": 12, "x": 12, "y": 25},
-      "id": 9,
-      "options": {
-        "legend": {"calcs": ["sum"], "displayMode": "table", "placement": "right", "showLegend": true},
-        "tooltip": {"mode": "multi", "sort": "desc"}
-      },
-      "targets": [
-        {
-          "expr": "rate(dotnet_collection_count_total[1m])",
-          "legendFormat": "Gen {{generation}}",
-          "refId": "A"
-        }
-      ],
-      "title": "GC — сборки в секунду (по поколениям)",
-      "type": "timeseries"
-    }
-  ],
-  "refresh": "30s",
-  "schemaVersion": 39,
-  "tags": ["food-market", "api"],
-  "templating": {
-    "list": [
-      {
-        "current": {"selected": false, "text": "Prometheus", "value": "Prometheus"},
-        "hide": 0,
-        "includeAll": false,
-        "label": "Datasource",
-        "multi": false,
-        "name": "DS_PROMETHEUS",
-        "options": [],
-        "query": "prometheus",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "type": "datasource"
-      }
-    ]
-  },
-  "time": {"from": "now-1h", "to": "now"},
-  "timepicker": {},
-  "timezone": "browser",
-  "title": "food-market — api / db / business",
-  "uid": "food-market-api-baseline",
-  "version": 1,
-  "weekStart": ""
-}

deploy/grafana/dashboards/quality-watchdog.json

@@ -1,350 +0,0 @@
-{
-  "annotations": {
-    "list": [
-      {
-        "builtIn": 1,
-        "datasource": {"type": "grafana", "uid": "-- Grafana --"},
-        "enable": true,
-        "hide": true,
-        "iconColor": "rgba(0, 211, 255, 1)",
-        "name": "Annotations & Alerts",
-        "type": "dashboard"
-      }
-    ]
-  },
-  "description": "Sprint 26: quality-watchdog dashboard. Метрики из ~/quality-watchdog.sh (textfile exporter, см. docs/observability.md) + базовые food-market.api метрики (/metrics).",
-  "editable": true,
-  "fiscalYearStartMonth": 0,
-  "graphTooltip": 1,
-  "id": null,
-  "links": [],
-  "liveNow": false,
-  "panels": [
-    {
-      "id": 1,
-      "type": "stat",
-      "title": "Smoke success ratio (7 дней)",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 5, "w": 6, "x": 0, "y": 0},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "thresholds"},
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "red", "value": null},
-              {"color": "orange", "value": 0.80},
-              {"color": "green", "value": 0.95}
-            ]
-          },
-          "unit": "percentunit",
-          "min": 0,
-          "max": 1
-        }
-      },
-      "options": {
-        "graphMode": "area",
-        "colorMode": "value",
-        "justifyMode": "center",
-        "reduceOptions": {"calcs": ["lastNotNull"]}
-      },
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "sum(increase(quality_watchdog_run_total{result=\"green\"}[7d])) / sum(increase(quality_watchdog_run_total[7d]))",
-          "legendFormat": "green ratio"
-        }
-      ]
-    },
-    {
-      "id": 2,
-      "type": "stat",
-      "title": "Incidents (7 дней)",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 5, "w": 6, "x": 6, "y": 0},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "thresholds"},
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "green", "value": null},
-              {"color": "orange", "value": 1},
-              {"color": "red", "value": 3}
-            ]
-          },
-          "unit": "short"
-        }
-      },
-      "options": {"colorMode": "value", "reduceOptions": {"calcs": ["lastNotNull"]}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "sum(increase(quality_watchdog_incidents_total[7d]))",
-          "legendFormat": "incidents"
-        }
-      ]
-    },
-    {
-      "id": 3,
-      "type": "stat",
-      "title": "Multi-tenant violations (24h) — должно быть 0",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 5, "w": 6, "x": 12, "y": 0},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "thresholds"},
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "green", "value": null},
-              {"color": "red", "value": 1}
-            ]
-          },
-          "unit": "short"
-        }
-      },
-      "options": {"colorMode": "value", "reduceOptions": {"calcs": ["lastNotNull"]}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "sum(increase(quality_watchdog_step_failure_total{step=\"multi_tenant\"}[24h]))",
-          "legendFormat": "leaks"
-        }
-      ]
-    },
-    {
-      "id": 4,
-      "type": "stat",
-      "title": "Текущий статус watchdog",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 5, "w": 6, "x": 18, "y": 0},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "thresholds"},
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "red", "value": null},
-              {"color": "orange", "value": 0.5},
-              {"color": "green", "value": 1}
-            ]
-          },
-          "unit": "short",
-          "mappings": [
-            {"options": {"0": {"text": "🔴 RED"}, "1": {"text": "🟢 GREEN"}}, "type": "value"}
-          ]
-        }
-      },
-      "options": {"colorMode": "background", "reduceOptions": {"calcs": ["lastNotNull"]}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "quality_watchdog_last_run_status",
-          "legendFormat": "status"
-        }
-      ]
-    },
-    {
-      "id": 5,
-      "type": "timeseries",
-      "title": "p95 latency по endpoint (мс)",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 9, "w": 12, "x": 0, "y": 5},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {
-            "drawStyle": "line",
-            "lineWidth": 2,
-            "fillOpacity": 10,
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {"mode": "none"}
-          },
-          "unit": "ms",
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "green", "value": null},
-              {"color": "orange", "value": 400},
-              {"color": "red", "value": 800}
-            ]
-          }
-        }
-      },
-      "options": {"legend": {"displayMode": "table", "placement": "bottom"}, "tooltip": {"mode": "multi"}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "quality_watchdog_endpoint_p95_ms",
-          "legendFormat": "{{endpoint}}"
-        }
-      ]
-    },
-    {
-      "id": 6,
-      "type": "timeseries",
-      "title": "Шаги watchdog — pass/fail во времени",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 9, "w": 12, "x": 12, "y": 5},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {
-            "drawStyle": "bars",
-            "lineWidth": 1,
-            "fillOpacity": 60,
-            "stacking": {"mode": "normal"}
-          },
-          "unit": "short"
-        }
-      },
-      "options": {"legend": {"displayMode": "list", "placement": "right"}, "tooltip": {"mode": "multi"}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "sum by (step) (increase(quality_watchdog_step_failure_total[1h]))",
-          "legendFormat": "{{step}}"
-        }
-      ]
-    },
-    {
-      "id": 7,
-      "type": "timeseries",
-      "title": "HTTP request rate (rps)",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 8, "w": 12, "x": 0, "y": 14},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {"drawStyle": "line", "lineWidth": 2, "fillOpacity": 10},
-          "unit": "reqps"
-        }
-      },
-      "options": {"legend": {"displayMode": "list"}, "tooltip": {"mode": "multi"}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "sum(rate(http_requests_received_total[5m])) by (code)",
-          "legendFormat": "code={{code}}"
-        }
-      ]
-    },
-    {
-      "id": 8,
-      "type": "timeseries",
-      "title": "DB query duration p95 (food_market_db_query_duration_seconds)",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 8, "w": 12, "x": 12, "y": 14},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {"drawStyle": "line", "lineWidth": 2, "fillOpacity": 10},
-          "unit": "s",
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "green", "value": null},
-              {"color": "orange", "value": 0.5},
-              {"color": "red", "value": 1.0}
-            ]
-          }
-        }
-      },
-      "options": {"legend": {"displayMode": "list"}, "tooltip": {"mode": "multi"}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "histogram_quantile(0.95, sum(rate(food_market_db_query_duration_seconds_bucket[5m])) by (le))",
-          "legendFormat": "p95 DB"
-        }
-      ]
-    },
-    {
-      "id": 9,
-      "type": "timeseries",
-      "title": "Документы проведены / ошибки",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 8, "w": 12, "x": 0, "y": 22},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {"drawStyle": "line", "lineWidth": 2, "fillOpacity": 10},
-          "unit": "ops"
-        }
-      },
-      "options": {"legend": {"displayMode": "table", "placement": "bottom"}, "tooltip": {"mode": "multi"}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "sum(rate(food_market_documents_posted_total[5m])) by (type)",
-          "legendFormat": "posted {{type}}"
-        },
-        {
-          "refId": "B",
-          "expr": "sum(rate(food_market_documents_error_total[5m])) by (type)",
-          "legendFormat": "error {{type}}"
-        }
-      ]
-    },
-    {
-      "id": 10,
-      "type": "timeseries",
-      "title": "Свободное место на диске",
-      "datasource": {"type": "prometheus", "uid": "${DS_PROMETHEUS}"},
-      "gridPos": {"h": 8, "w": 12, "x": 12, "y": 22},
-      "fieldConfig": {
-        "defaults": {
-          "color": {"mode": "palette-classic"},
-          "custom": {"drawStyle": "line", "lineWidth": 2, "fillOpacity": 10},
-          "unit": "bytes",
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {"color": "red", "value": null},
-              {"color": "orange", "value": 5368709120},
-              {"color": "green", "value": 10737418240}
-            ]
-          }
-        }
-      },
-      "options": {"legend": {"displayMode": "list"}, "tooltip": {"mode": "multi"}},
-      "targets": [
-        {
-          "refId": "A",
-          "expr": "food_market_disk_free_bytes",
-          "legendFormat": "{{mount}}"
-        }
-      ]
-    }
-  ],
-  "refresh": "1m",
-  "schemaVersion": 38,
-  "tags": ["food-market", "quality-watchdog", "sprint26"],
-  "templating": {
-    "list": [
-      {
-        "current": {"selected": false, "text": "Prometheus", "value": "Prometheus"},
-        "hide": 0,
-        "includeAll": false,
-        "label": "Datasource",
-        "multi": false,
-        "name": "DS_PROMETHEUS",
-        "options": [],
-        "query": "prometheus",
-        "queryValue": "",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "type": "datasource"
-      }
-    ]
-  },
-  "time": {"from": "now-7d", "to": "now"},
-  "timepicker": {},
-  "timezone": "browser",
-  "title": "food-market — quality-watchdog",
-  "uid": "fm-quality-watchdog",
-  "version": 1
-}

deploy/mirror-base-images.sh

@@ -1,48 +0,0 @@
-#!/bin/bash
-# Pulls all external base images the food-market builds depend on, then retags
-# them into the local registry at 127.0.0.1:5001 under the "mirror/" prefix.
-#
-# Why: outbound to docker.io / mcr.microsoft.com flaps on KZ network. Once
-# mirrored, Dockerfiles and docker-compose reference the local copy and builds
-# no longer need the internet at all.
-#
-# Idempotent — safe to run as often as you want. Scheduled daily via
-# food-market-mirror-base-images.timer.
-set -euo pipefail
-
-REGISTRY=127.0.0.1:5001
-LOG_PREFIX=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-
-# image_ref → local name under mirror/
-IMAGES=(
-  "node:20-alpine|mirror/node:20-alpine"
-  "nginx:1.27-alpine|mirror/nginx:1.27-alpine"
-  "postgres:16-alpine|mirror/postgres:16-alpine"
-  "mcr.microsoft.com/dotnet/sdk:8.0|mirror/dotnet-sdk:8.0"
-  "mcr.microsoft.com/dotnet/aspnet:8.0|mirror/dotnet-aspnet:8.0"
-)
-
-failures=0
-for pair in "${IMAGES[@]}"; do
-  src="${pair%|*}"
-  dst="${pair#*|}"
-  echo "$LOG_PREFIX pulling $src"
-  if ! docker pull "$src"; then
-    echo "$LOG_PREFIX FAILED: pull $src"
-    failures=$((failures + 1))
-    continue
-  fi
-  docker tag "$src" "$REGISTRY/$dst"
-  if ! docker push "$REGISTRY/$dst"; then
-    echo "$LOG_PREFIX FAILED: push $REGISTRY/$dst"
-    failures=$((failures + 1))
-    continue
-  fi
-  echo "$LOG_PREFIX ok $src -> $REGISTRY/$dst"
-done
-
-if [[ $failures -gt 0 ]]; then
-  echo "$LOG_PREFIX done, $failures failed — registry still has old mirrored copies"
-  exit 1
-fi
-echo "$LOG_PREFIX done, all mirrors fresh"

deploy/nginx.conf

@@ -3,40 +3,6 @@ server {
     root /usr/share/nginx/html;
     index index.html;
 
-    # Sprint 13 — security-заголовки (для SPA HTML; для API те же выставляются
-    # уже SecurityHeadersMiddleware'ом на api-side). add_header с always
-    # обеспечивает применение даже на 4xx/5xx (без always — только на 2xx/3xx).
-    # CSP синхронен с SecurityHeadersOptions.DefaultCsp.
-    add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; connect-src 'self' wss: ws:; img-src 'self' data: blob:; font-src 'self' data:; frame-ancestors 'none'; base-uri 'self'; form-action 'self'" always;
-    add_header X-Frame-Options "DENY" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-    add_header Permissions-Policy "camera=(), microphone=(), geolocation=(), payment=(), usb=()" always;
-    add_header X-Permitted-Cross-Domain-Policies "none" always;
-
-    # Sprint 28: HSTS. Brower honors HSTS only on HTTPS responses, поэтому
-    # безопасно добавлять unconditionally — если клиент пришёл по HTTP,
-    # header игнорируется. Без includeSubDomains и без preload — это
-    # pre-emptive consent: можно безопасно убрать. Когда production stack
-    # устаканится и admin.food-market.kz будет подан в hstspreload.org,
-    # увеличить max-age до 31536000 + добавить preload и includeSubDomains.
-    add_header Strict-Transport-Security "max-age=2592000" always;
-
-    # Long-running admin imports (MoySklad etc.) read from upstream for tens of
-    # minutes. Bump timeouts only on that path so normal API stays snappy.
-    location /api/admin/import/ {
-        proxy_pass http://api:8080;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        proxy_read_timeout 60m;
-        proxy_send_timeout 60m;
-        proxy_request_buffering off;
-        proxy_buffering off;
-    }
-
     # API reverse-proxy — upstream name "api" resolves in the compose network.
     location /api/ {
         proxy_pass http://api:8080;
@@ -55,92 +21,10 @@ server {
         proxy_set_header Host $host;
     }
 
-    # SignalR хаб для live-уведомлений (см. NotificationsHub).
-    # WebSocket требует upgrade-хедеры и большой read_timeout (иначе nginx
-    # будет рвать idle-коннекшен каждые 60 сек). access_token приходит как
-    # query (?access_token=...), Authorization-хедер middleware на API его
-    # перекладывает в нужный вид до UseAuthentication.
-    location /hubs/ {
-        proxy_pass http://api:8080;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection "upgrade";
-        proxy_read_timeout 86400;   # 24h — webSocket долгоживущий
-        proxy_send_timeout 86400;
-        proxy_buffering off;
-    }
-
     location /health {
         proxy_pass http://api:8080;
     }
 
-    # Prometheus метрики API. Без этого блока запрос ловится SPA fallback'ом и
-    # возвращает index.html (947 байт) вместо exposition format. На prod-домене
-    # имеет смысл закрыть IP-фильтром (allow 192.168.0.0/16; deny all;), на
-    # stage оставляем открытым — за gateway nginx уже есть auth/TLS-обвязка.
-    location = /metrics {
-        proxy_pass http://api:8080;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-
-    # Swagger UI + OpenAPI-doc. На контейнере api подключается только когда
-    # IncludeSwagger=true (env-флаг, см. Program.cs). На prod-домене флаг не
-    # выставляем, /swagger вернёт 404 от api — это ожидаемо.
-    location /swagger/ {
-        proxy_pass http://api:8080;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-    location = /swagger {
-        return 301 /swagger/;
-    }
-
-    # Sprint 13: Hangfire Dashboard — внутренний инструмент мониторинга
-    # фоновых джобов. Доступ только SuperAdmin'у (см. SuperAdminHangfireFilter
-    # в API). Без этой location'и /hangfire ловился бы SPA-fallback'ом и
-    # возвращал index.html — что выглядит как «всё ок», но дашборда нет.
-    location /hangfire {
-        proxy_pass http://api:8080;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-
-    # Статика изображений товаров — api раздаёт /uploads/... из volume.
-    location /uploads/ {
-        proxy_pass http://api:8080;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-    }
-
-    # PWA: SW и manifest должны отдаваться с правильным content-type и без
-    # кеша на самом ответе (внутри SW свой versioned cache). Иначе старый
-    # SW залипает на клиенте и не подхватывает обновления.
-    location = /sw.js {
-        add_header Cache-Control "no-cache, no-store, must-revalidate";
-        add_header Pragma "no-cache";
-        expires off;
-        try_files /sw.js =404;
-    }
-    location = /manifest.webmanifest {
-        types { } default_type application/manifest+json;
-        add_header Cache-Control "public, max-age=3600";
-        try_files /manifest.webmanifest =404;
-    }
-    location = /offline.html {
-        try_files /offline.html =404;
-    }
-
     # SPA fallback — all other routes return index.html
     location / {
         try_files $uri $uri/ /index.html;

deploy/nginx/food-market-public.conf.template

@@ -1,32 +0,0 @@
-# Шаблон nginx-конфига для публичного сайта food-market.public.
-# НЕ ПРИМЕНЯТЬ ПОКА ЮЗЕР НЕ ВЫБЕРЕТ ДОМЕН.
-#
-# Сборка контейнера: docker compose --build food-market-public (см.
-# deploy/docker-compose.yml; контейнер слушает на 127.0.0.1:8082).
-#
-# Использование (когда домен решится):
-#   1. Заменить SERVER_NAME ниже на финальный домен.
-#   2. Скопировать в /etc/nginx/conf.d/food-market-public.conf.
-#   3. sudo certbot --nginx -d <SERVER_NAME>.
-#   4. sudo nginx -t && sudo systemctl reload nginx.
-#
-# Архитектура после переезда (план):
-#   <PUBLIC_DOMAIN>     → этот блок (публичный Astro)
-#   app.<PUBLIC_DOMAIN> → существующий блок food-market-stage.conf (админка)
-#   API остаётся на app.* под /api/*.
-
-server {
-    server_name SERVER_NAME;
-    location /.well-known/acme-challenge/ { root /var/www/html; }
-
-    location / {
-        proxy_pass http://127.0.0.1:8082;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-
-    listen 80;
-}

deploy/post-deploy-smoke.sh

@@ -1,239 +0,0 @@
-#!/usr/bin/env bash
-#
-# Sprint 21: post-deploy smoke на проде.
-#
-# Запускается СРАЗУ после prod-deploy.sh. 10 ключевых сценариев на
-# https://admin.food-market.kz через временные тестовые credentials
-# (создаются через signup → удаляются в конце).
-#
-# Каждый шаг — отдельный pass/fail. Итог отправляется Telegram'ом
-# (если задан FM_TG_TOKEN+FM_TG_CHAT). Exit code = кол-во провалов.
-#
-# Защита от мусора: после прогона создаваемая org остаётся в БД (delete
-# через API ещё не реализовано) — но email содержит метку `smoke-` и
-# timestamp, поэтому видно по логам/audit что это.
-#
-# Usage:
-#   deploy/post-deploy-smoke.sh [--dry-run] [--url https://admin.food-market.kz]
-
-set -uo pipefail
-
-PROD_URL="${PROD_URL:-https://admin.food-market.kz}"
-DRY_RUN=0
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dry-run) DRY_RUN=1; shift ;;
-    --url) PROD_URL="$2"; shift 2 ;;
-    --help|-h) grep -E '^#( |$)' "$0" | sed 's/^# \?//'; exit 0 ;;
-    *) shift ;;
-  esac
-done
-
-log() { echo "[$(date -Iseconds)] $*"; }
-
-notify_telegram() {
-  local msg="$1"
-  local tok="${FM_TG_TOKEN:-}"; local chat="${FM_TG_CHAT:-}"
-  if [[ -z "$tok" || -z "$chat" ]]; then
-    log "(Telegram disabled — no FM_TG_TOKEN/CHAT)"; return
-  fi
-  curl -sS -X POST "https://api.telegram.org/bot$tok/sendMessage" \
-    --data-urlencode "chat_id=$chat" \
-    --data-urlencode "text=$msg" > /dev/null || true
-}
-
-if [[ $DRY_RUN -eq 1 ]]; then
-  log "DRY-RUN: показал бы сценарии без запуска API-вызовов"
-  for s in "signup" "login" "/api/me" "list-products" "create-product" \
-           "list-counterparties" "list-stores" "list-stock" "delete-product" "logout"; do
-    log "  → $s"
-  done
-  exit 0
-fi
-
-PASS=0
-FAIL=0
-FAILED_STEPS=()
-
-step() {
-  local name="$1" status="$2" detail="$3"
-  if [[ "$status" == "OK" ]]; then
-    log "[✓] $name — $detail"
-    ((PASS+=1))
-  else
-    log "[✗] $name — $detail"
-    FAILED_STEPS+=("$name: $detail")
-    ((FAIL+=1))
-  fi
-}
-
-TS=$(date +%s)
-EMAIL="smoke-${TS}@food-market.local"
-PASS_TEST='Smoke12345!'
-ORG_NAME="SmokeOrg-${TS}"
-
-# ── 1. signup ────────────────────────────────────────────────────────
-RESP=$(curl -fsS -X POST -H "Content-Type: application/json" \
-  -d "{\"organizationName\":\"$ORG_NAME\",\"email\":\"$EMAIL\",\"password\":\"$PASS_TEST\",\"phone\":\"+77001234567\"}" \
-  "$PROD_URL/api/auth/signup" 2>/dev/null || echo "")
-if echo "$RESP" | grep -q '"organizationId"\|"id"'; then
-  step "01-signup" "OK" "$EMAIL"
-else
-  step "01-signup" "FAIL" "resp: ${RESP:-<empty>}"
-fi
-
-# ── 2. login ─────────────────────────────────────────────────────────
-TOK=$(curl -fsS -X POST \
-  -H "Content-Type: application/x-www-form-urlencoded" \
-  --data-urlencode "grant_type=password" \
-  --data-urlencode "username=$EMAIL" \
-  --data-urlencode "password=$PASS_TEST" \
-  --data-urlencode "client_id=food-market-web" \
-  --data-urlencode "scope=openid profile email roles api offline_access" \
-  "$PROD_URL/connect/token" 2>/dev/null \
-  | python3 -c 'import sys,json; print(json.load(sys.stdin).get("access_token",""))' 2>/dev/null || echo "")
-if [[ -n "$TOK" ]]; then
-  step "02-login" "OK" "token=${TOK:0:24}…"
-else
-  step "02-login" "FAIL" "no access_token"
-  # Без токена остальное не запустить — сообщаем и выходим.
-  notify_telegram "🚨 post-deploy-smoke FAIL: login failed на $PROD_URL"
-  exit 1
-fi
-
-auth() { curl -fsS -H "Authorization: Bearer $TOK" "$@"; }
-
-# Извлечь поле .items[0].id из JSON через python (надёжнее grep'a — JSON
-# может содержать другие "id":"..." (organizationId, parentId etc.))
-first_item_id() { python3 -c 'import sys,json; d=json.load(sys.stdin); print((d.get("items") or [{}])[0].get("id",""))' 2>/dev/null || true; }
-# Поиск первого элемента items[] с условием key=value.
-find_item_id() {
-  python3 -c "
-import sys,json
-d=json.load(sys.stdin)
-key,val='$1','$2'
-for it in (d.get('items') or []):
-    if it.get(key) == True if val=='true' else it.get(key) == val:
-        print(it.get('id',''))
-        break
-" 2>/dev/null || true
-}
-
-# ── 3. /api/me ───────────────────────────────────────────────────────
-ME=$(auth "$PROD_URL/api/me" 2>/dev/null || echo "")
-if echo "$ME" | grep -q "\"email\":\"$EMAIL\""; then
-  step "03-me" "OK" "$EMAIL"
-else
-  step "03-me" "FAIL" "resp: ${ME:0:120}"
-fi
-
-# ── 4. list products ─────────────────────────────────────────────────
-PRODS=$(auth "$PROD_URL/api/catalog/products?pageSize=10" 2>/dev/null || echo "")
-if echo "$PRODS" | grep -q '"total"'; then
-  step "04-list-products" "OK" "$(echo "$PRODS" | grep -oE '"total":[0-9]+' | head -1)"
-else
-  step "04-list-products" "FAIL" "${PRODS:0:120}"
-fi
-
-# ── 5. create product ────────────────────────────────────────────────
-ROOT_ID=$(auth "$PROD_URL/api/catalog/product-groups" 2>/dev/null | first_item_id)
-UNIT_ID=$(auth "$PROD_URL/api/catalog/units-of-measure" 2>/dev/null | first_item_id)
-PT_ID=$(auth "$PROD_URL/api/catalog/price-types" 2>/dev/null | first_item_id)
-# Currencies endpoint иногда возвращает массив напрямую — python обработает оба.
-CURS_RAW=$(auth "$PROD_URL/api/catalog/currencies" 2>/dev/null)
-CUR_ID=$(echo "$CURS_RAW" | python3 -c 'import sys,json
-d=json.load(sys.stdin)
-items=d if isinstance(d,list) else (d.get("items") or [])
-print((items or [{}])[0].get("id",""))' 2>/dev/null || true)
-if [[ -z "$ROOT_ID" || -z "$UNIT_ID" || -z "$PT_ID" || -z "$CUR_ID" ]]; then
-  step "05-create-product" "FAIL" "missing refs: root=$ROOT_ID unit=$UNIT_ID pt=$PT_ID cur=$CUR_ID"
-else
-  BC="SMOKE-$TS"
-  PROD=$(auth -X POST -H "Content-Type: application/json" \
-    -d "{\"name\":\"smoke-product-$TS\",\"unitOfMeasureId\":\"$UNIT_ID\",\"productGroupId\":\"$ROOT_ID\",\"vat\":0,\"vatEnabled\":true,\"barcodes\":[{\"code\":\"$BC\",\"type\":0,\"isPrimary\":true}],\"prices\":[{\"priceTypeId\":\"$PT_ID\",\"amount\":100,\"currencyId\":\"$CUR_ID\"}]}" \
-    "$PROD_URL/api/catalog/products" 2>/dev/null || echo "")
-  PID=$(echo "$PROD" | grep -oE '"id":"[a-f0-9-]+"' | head -1 | cut -d'"' -f4)
-  if [[ -n "$PID" ]]; then
-    step "05-create-product" "OK" "$PID"
-  else
-    step "05-create-product" "FAIL" "${PROD:0:120}"
-  fi
-fi
-
-# ── 6. list counterparties ──────────────────────────────────────────
-CP=$(auth "$PROD_URL/api/catalog/counterparties?pageSize=10" 2>/dev/null || echo "")
-if echo "$CP" | grep -q '"total"'; then
-  step "06-list-counterparties" "OK" "$(echo "$CP" | grep -oE '"total":[0-9]+' | head -1)"
-else
-  step "06-list-counterparties" "FAIL" "${CP:0:120}"
-fi
-
-# ── 7. list stores ──────────────────────────────────────────────────
-STR=$(auth "$PROD_URL/api/catalog/stores" 2>/dev/null || echo "")
-if echo "$STR" | grep -q '"total"'; then
-  step "07-list-stores" "OK" "$(echo "$STR" | grep -oE '"total":[0-9]+' | head -1)"
-else
-  step "07-list-stores" "FAIL" "${STR:0:120}"
-fi
-
-# ── 8. list stock ───────────────────────────────────────────────────
-STK=$(auth "$PROD_URL/api/inventory/stock?pageSize=10" 2>/dev/null || echo "")
-if echo "$STK" | grep -q '"total"'; then
-  step "08-list-stock" "OK" "$(echo "$STK" | grep -oE '"total":[0-9]+' | head -1)"
-else
-  step "08-list-stock" "FAIL" "${STK:0:120}"
-fi
-
-# ── 9. delete product ───────────────────────────────────────────────
-if [[ -n "${PID:-}" ]]; then
-  DEL=$(auth -X DELETE -o /dev/null -w "%{http_code}" "$PROD_URL/api/catalog/products/$PID" 2>/dev/null || echo "")
-  if [[ "$DEL" == "204" ]]; then
-    step "09-delete-product" "OK" "204"
-  else
-    step "09-delete-product" "FAIL" "code=$DEL"
-  fi
-else
-  step "09-delete-product" "FAIL" "skipped (no PID)"
-fi
-
-# ── 10. session logout (через /api/me/sessions) ─────────────────────
-# OpenIddict /connect/revocation в этой конфигурации не включён, поэтому
-# logout = удаление активной сессии через /api/me/sessions/{id} либо
-# (если нет sessions API) — проверяем что /api/me ещё работает (sanity).
-# Берём первый sessionId юзера и пробуем DELETE; если 401/404 — fallback
-# на простую проверку valid-token.
-SESS=$(auth "$PROD_URL/api/me/sessions" 2>/dev/null || echo "")
-SID=$(echo "$SESS" | python3 -c 'import sys,json
-try:
-    d=json.load(sys.stdin)
-    arr=d if isinstance(d,list) else (d.get("items") or d.get("sessions") or [])
-    print((arr or [{}])[0].get("id",""))
-except: print("")' 2>/dev/null || true)
-if [[ -n "$SID" ]]; then
-  DEL=$(auth -X DELETE -o /dev/null -w "%{http_code}" "$PROD_URL/api/me/sessions/$SID" 2>/dev/null || echo "")
-  if [[ "$DEL" == "204" || "$DEL" == "200" ]]; then
-    step "10-logout-session" "OK" "session $SID revoked"
-  else
-    step "10-logout-session" "FAIL" "DELETE code=$DEL"
-  fi
-else
-  # Fallback: просто sanity-check что токен ещё действителен (full flow OK).
-  PING=$(auth -o /dev/null -w "%{http_code}" "$PROD_URL/api/me" 2>/dev/null || echo "")
-  if [[ "$PING" == "200" ]]; then
-    step "10-token-valid" "OK" "token still alive (no session API)"
-  else
-    step "10-token-valid" "FAIL" "code=$PING"
-  fi
-fi
-
-# ── Итог + notify ────────────────────────────────────────────────────
-log
-log "==> $PASS passed, $FAIL failed"
-if (( FAIL > 0 )); then
-  MSG="🚨 post-deploy-smoke FAIL ($FAIL/10) на $PROD_URL: $(IFS=,; echo "${FAILED_STEPS[*]}")"
-  notify_telegram "$MSG"
-  exit "$FAIL"
-fi
-notify_telegram "✅ post-deploy-smoke OK (10/10) на $PROD_URL"
-exit 0

deploy/prod-deploy.sh

@@ -1,220 +0,0 @@
-#!/usr/bin/env bash
-#
-# Sprint 21: blue-green deploy для prod-vm.
-#
-# Алгоритм:
-#   1. Pull новых images из registry (если их там нет → fail)
-#   2. Запуск ВТОРОГО api-контейнера (food-market-api-next) на :8088
-#   3. Выполнить миграции БД через временный one-shot контейнер
-#   4. Smoke-test на новом api: /health/ready + /api/me с тестовым токеном
-#   5. Если ок → переключить prod nginx upstream на :8088 → reload nginx
-#   6. Удалить старый api-контейнер; переименовать food-market-api-next → food-market-api
-#   7. То же самое для web (но без миграций)
-#
-# Если smoke не прошёл → откат: убиваем -next, оставляем старый запущенным.
-#
-# Usage:
-#   deploy/prod-deploy.sh <api-tag> <web-tag> [--dry-run] [--skip-web]
-#
-# Подразумевает что nginx стоит на хосте (не в compose) и его upstream
-# конфигурируется через include /etc/nginx/upstream.conf, который этот
-# скрипт переписывает atomic'ом. Если nginx внутри web-контейнера —
-# blue-green становится через docker-swap, а не nginx-reload (подробнее
-# в docs/prod-deploy.md).
-
-set -uo pipefail
-
-API_TAG="${1:-}"
-WEB_TAG="${2:-}"
-DRY_RUN=0
-SKIP_WEB=0
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dry-run) DRY_RUN=1; shift ;;
-    --skip-web) SKIP_WEB=1; shift ;;
-    -*) echo "Unknown: $1" >&2; exit 2 ;;
-    *) shift ;;
-  esac
-done
-
-if [[ -z "$API_TAG" || -z "$WEB_TAG" ]]; then
-  cat <<EOF
-Usage: $0 <api-tag> <web-tag> [--dry-run] [--skip-web]
-
-Example:
-  $0 v20260607.3 v20260607.3
-  $0 v20260607.3 v20260607.3 --dry-run
-
-Required env (defaults in [brackets]):
-  REGISTRY       [127.0.0.1:5001]
-  COMPOSE_PATH   [/home/nns/food-market-prod/deploy/docker-compose.yml]
-  NGINX_UPSTREAM_FILE [/etc/nginx/conf.d/food-market-upstream.conf]
-  API_PORT_BLUE  [8080]  — текущий
-  API_PORT_GREEN [8088]  — временный для нового контейнера
-EOF
-  exit 2
-fi
-
-REGISTRY="${REGISTRY:-127.0.0.1:5001}"
-COMPOSE_PATH="${COMPOSE_PATH:-/home/nns/food-market-prod/deploy/docker-compose.yml}"
-NGINX_UPSTREAM_FILE="${NGINX_UPSTREAM_FILE:-/etc/nginx/conf.d/food-market-upstream.conf}"
-API_PORT_BLUE="${API_PORT_BLUE:-8080}"
-API_PORT_GREEN="${API_PORT_GREEN:-8088}"
-TEST_TOKEN_FILE="${TEST_TOKEN_FILE:-/home/nns/.fm-prod-test-token}"
-
-run() {
-  if [[ $DRY_RUN -eq 1 ]]; then
-    echo "[dry-run] $*"
-  else
-    echo "[exec] $*"
-    "$@"
-  fi
-}
-
-log() { echo "[$(date -Iseconds)] $*"; }
-
-fail() {
-  log "FAIL: $*"
-  exit 1
-}
-
-# ── 1. Pull новых images ─────────────────────────────────────────────
-log "=== Step 1/7: pull images ==="
-API_IMG="$REGISTRY/food-market-api:$API_TAG"
-WEB_IMG="$REGISTRY/food-market-web:$WEB_TAG"
-run docker pull "$API_IMG" || fail "api image $API_IMG отсутствует в registry"
-[[ $SKIP_WEB -eq 0 ]] && (run docker pull "$WEB_IMG" || fail "web image $WEB_IMG отсутствует")
-
-# ── 2. Запуск green-api на :8088 ─────────────────────────────────────
-log "=== Step 2/7: start green api on :$API_PORT_GREEN ==="
-# Если -next уже есть (от прошлой неудачной попытки) — снести.
-run docker rm -f food-market-api-next 2>/dev/null || true
-
-# .env берём из compose dir чтобы получить те же переменные.
-ENV_FILE="$(dirname "$COMPOSE_PATH")/.env"
-[[ -f "$ENV_FILE" ]] || fail ".env не найден: $ENV_FILE"
-
-# Запускаем second api с теми же volume/env, но на host port 8088
-# и подключённый к той же compose-сети (food-market-prod_default).
-NETWORK="food-market-prod_default"
-run docker run -d \
-  --name food-market-api-next \
-  --network "$NETWORK" \
-  --env-file "$ENV_FILE" \
-  -e ASPNETCORE_ENVIRONMENT=Production \
-  -p "127.0.0.1:$API_PORT_GREEN:8080" \
-  --restart no \
-  "$API_IMG"
-
-# ── 3. Миграции БД ──────────────────────────────────────────────────
-# .NET API мигрирует автоматически на старте через AppDbContext.Database.Migrate()
-# (см. Program.cs). Поэтому ждём готовности green-контейнера — если он
-# поднялся healthy = миграции прошли.
-log "=== Step 3/7: wait for green api ready (migrations) ==="
-if [[ $DRY_RUN -eq 0 ]]; then
-  READY=0
-  for i in $(seq 1 60); do
-    sleep 2
-    if curl -fsS "http://127.0.0.1:$API_PORT_GREEN/health/ready" 2>/dev/null | grep -q '"status":"Healthy"'; then
-      READY=1
-      log "green api ready после $((i*2))s"
-      break
-    fi
-  done
-  if [[ $READY -eq 0 ]]; then
-    log "FAIL: green api не стал Healthy за 120с — сносим"
-    docker logs food-market-api-next --tail 50 || true
-    docker rm -f food-market-api-next || true
-    fail "green api не поднялся"
-  fi
-else
-  log "[dry-run] skip wait for ready"
-fi
-
-# ── 4. Smoke-test на green ──────────────────────────────────────────
-log "=== Step 4/7: smoke green api ==="
-if [[ $DRY_RUN -eq 0 ]]; then
-  # /health/ready уже проверили; ещё /api/me с тестовым токеном.
-  if [[ -f "$TEST_TOKEN_FILE" ]]; then
-    TEST_TOKEN=$(cat "$TEST_TOKEN_FILE")
-    ME=$(curl -fsS -H "Authorization: Bearer $TEST_TOKEN" \
-      "http://127.0.0.1:$API_PORT_GREEN/api/me" 2>/dev/null || echo "")
-    if [[ -z "$ME" ]] || ! echo "$ME" | grep -q '"email"'; then
-      log "FAIL: /api/me с тестовым токеном вернул: $ME"
-      docker rm -f food-market-api-next || true
-      fail "smoke-test провалился"
-    fi
-    log "smoke /api/me ✓"
-  else
-    log "(нет $TEST_TOKEN_FILE — пропускаем /api/me, только health-check)"
-  fi
-else
-  log "[dry-run] skip smoke"
-fi
-
-# ── 5. Switch nginx upstream ────────────────────────────────────────
-log "=== Step 5/7: nginx upstream switch :$API_PORT_BLUE → :$API_PORT_GREEN ==="
-if [[ $DRY_RUN -eq 0 ]]; then
-  if [[ ! -f "$NGINX_UPSTREAM_FILE" ]]; then
-    log "WARN: $NGINX_UPSTREAM_FILE не существует — создаём впервые"
-    sudo touch "$NGINX_UPSTREAM_FILE"
-  fi
-  # Atomic write: новый upstream указывает на green.
-  TMP="$(mktemp)"
-  cat > "$TMP" <<NGX
-# Generated by prod-deploy.sh $(date -Iseconds)
-upstream food_market_api {
-    server 127.0.0.1:$API_PORT_GREEN;
-}
-NGX
-  sudo install -m 644 "$TMP" "$NGINX_UPSTREAM_FILE"
-  rm "$TMP"
-  sudo nginx -t || { log "FAIL nginx -t"; fail "nginx config invalid"; }
-  sudo systemctl reload nginx
-  log "nginx reloaded"
-else
-  log "[dry-run] would write upstream → 127.0.0.1:$API_PORT_GREEN and reload nginx"
-fi
-
-# ── 6. Свернуть старый api, переименовать green → blue ──────────────
-log "=== Step 6/7: stop old api, rename green ==="
-run docker rm -f food-market-api 2>/dev/null || true
-run docker rename food-market-api-next food-market-api
-
-# Обновляем compose-yml tag → для будущих up-d
-# (используем docker compose с новой версией; перезапуск НЕ нужен,
-# контейнер уже работает).
-log "(compose-yml tag update — manual через .env API_TAG=$API_TAG)"
-
-# Переключить nginx обратно на blue-port чтобы соответствовать compose-mapping.
-# Контейнер уже на host port $API_PORT_BLUE? нет, мы запускали green на 8088.
-# Переключаем upstream обратно на 8080 чтобы dock-compose up в будущем работал.
-if [[ $DRY_RUN -eq 0 ]]; then
-  # Переcоздаём green-контейнер с blue-портом (быстрый stop/start).
-  docker stop food-market-api && docker rm food-market-api
-  cd "$(dirname "$COMPOSE_PATH")"
-  API_TAG="$API_TAG" docker compose up -d api
-  TMP="$(mktemp)"
-  cat > "$TMP" <<NGX
-upstream food_market_api {
-    server 127.0.0.1:$API_PORT_BLUE;
-}
-NGX
-  sudo install -m 644 "$TMP" "$NGINX_UPSTREAM_FILE"
-  rm "$TMP"
-  sudo nginx -t && sudo systemctl reload nginx
-fi
-
-# ── 7. Web (тот же flow без миграций) ───────────────────────────────
-log "=== Step 7/7: web ==="
-if [[ $SKIP_WEB -eq 1 ]]; then
-  log "skipped (--skip-web)"
-else
-  cd "$(dirname "$COMPOSE_PATH")"
-  run env WEB_TAG="$WEB_TAG" docker compose up -d web
-  log "web re-pulled to $WEB_IMG"
-fi
-
-log "✓ Deploy complete: api=$API_TAG web=$WEB_TAG"
-exit 0

deploy/prod-rollback.sh

@@ -1,112 +0,0 @@
-#!/usr/bin/env bash
-#
-# Sprint 21: быстрый rollback на предыдущий tag.
-#
-# Алгоритм:
-#   1. Проверить что image нужного tag'a есть в registry (docker pull)
-#   2. Перезапустить api/web с этим tag'ом через docker compose
-#      (через ENV API_TAG/WEB_TAG → compose pick'ает)
-#   3. Дождаться /health/ready на новом контейнере
-#   4. Если health OK → выйти 0; если не OK → fail (но контейнер уже
-#      поднят, ручное вмешательство нужно)
-#
-# Миграции БД rollback скрипт НЕ откатывает: down-migrations EF Core
-# поддерживает, но мы их не пишем (см. CLAUDE.md / Phase19a/b — обе
-# имеют Down() для DROP'a, но это для прода опасно — данные потеряются).
-# Если откат требует down-миграции — отдельный manual review.
-#
-# Usage:
-#   deploy/prod-rollback.sh <to-tag> [--dry-run] [--skip-web]
-#
-# Example:
-#   deploy/prod-rollback.sh v20260606.5
-#   deploy/prod-rollback.sh v20260606.5 --dry-run
-
-set -uo pipefail
-
-TO_TAG="${1:-}"
-DRY_RUN=0
-SKIP_WEB=0
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dry-run) DRY_RUN=1; shift ;;
-    --skip-web) SKIP_WEB=1; shift ;;
-    --help|-h) grep -E '^#( |$)' "$0" | sed 's/^# \?//'; exit 0 ;;
-    -*) echo "Unknown: $1" >&2; exit 2 ;;
-    *) shift ;;
-  esac
-done
-
-if [[ -z "$TO_TAG" ]]; then
-  echo "Usage: $0 <to-tag> [--dry-run] [--skip-web]" >&2
-  exit 2
-fi
-
-REGISTRY="${REGISTRY:-127.0.0.1:5001}"
-COMPOSE_PATH="${COMPOSE_PATH:-/home/nns/food-market-prod/deploy/docker-compose.yml}"
-PROD_URL="${PROD_URL:-https://admin.food-market.kz}"
-
-log() { echo "[$(date -Iseconds)] $*"; }
-fail() { log "FAIL: $*"; exit 1; }
-
-run() {
-  if [[ $DRY_RUN -eq 1 ]]; then echo "[dry-run] $*";
-  else echo "[exec] $*"; "$@"; fi
-}
-
-# ── 1. Validate image existence ──────────────────────────────────────
-log "=== Step 1/3: validate images ==="
-API_IMG="$REGISTRY/food-market-api:$TO_TAG"
-WEB_IMG="$REGISTRY/food-market-web:$TO_TAG"
-
-# Сначала пробуем docker image inspect — если уже скачан, не тянем.
-if [[ $DRY_RUN -eq 0 ]]; then
-  if ! docker image inspect "$API_IMG" >/dev/null 2>&1; then
-    log "api image $API_IMG не скачан, pull'им"
-    docker pull "$API_IMG" || fail "api image $TO_TAG отсутствует в $REGISTRY"
-  else
-    log "api image $TO_TAG уже скачан"
-  fi
-  if [[ $SKIP_WEB -eq 0 ]]; then
-    if ! docker image inspect "$WEB_IMG" >/dev/null 2>&1; then
-      docker pull "$WEB_IMG" || fail "web image $TO_TAG отсутствует"
-    fi
-  fi
-else
-  log "[dry-run] would pull $API_IMG (and $WEB_IMG)"
-fi
-
-# ── 2. docker compose up -d с новым tag ─────────────────────────────
-log "=== Step 2/3: docker compose up -d ==="
-if [[ ! -f "$COMPOSE_PATH" ]]; then
-  fail "compose не найден: $COMPOSE_PATH"
-fi
-cd "$(dirname "$COMPOSE_PATH")"
-
-if [[ $DRY_RUN -eq 0 ]]; then
-  if [[ $SKIP_WEB -eq 1 ]]; then
-    API_TAG="$TO_TAG" docker compose up -d --force-recreate api
-  else
-    API_TAG="$TO_TAG" WEB_TAG="$TO_TAG" docker compose up -d --force-recreate api web
-  fi
-else
-  log "[dry-run] would run: API_TAG=$TO_TAG WEB_TAG=$TO_TAG docker compose up -d --force-recreate api web"
-fi
-
-# ── 3. Wait /health/ready ────────────────────────────────────────────
-log "=== Step 3/3: wait /health/ready ==="
-if [[ $DRY_RUN -eq 0 ]]; then
-  for i in $(seq 1 60); do
-    sleep 2
-    if curl -fsS --max-time 5 "$PROD_URL/health/ready" 2>/dev/null | grep -q '"status":"Healthy"'; then
-      log "✓ Rollback complete: $PROD_URL Healthy после $((i*2))s"
-      exit 0
-    fi
-  done
-  fail "/health/ready не отвечает Healthy за 120с — ручное вмешательство"
-else
-  log "[dry-run] would poll $PROD_URL/health/ready up to 60×2s"
-fi
-
-exit 0

deploy/prometheus/alerts.yml

@@ -1,175 +0,0 @@
-# Sprint 26: Prometheus alert rules для food-market.
-#
-# Загружается через prometheus.yml:
-#   rule_files:
-#     - alerts.yml
-#
-# Каждое правило → Alertmanager → Telegram/email.
-# Все runbook-ссылки указывают на docs/RUNBOOK.md в репо.
-#
-# Группировка: 4 группы по доменам — uptime / errors / database / quality-watchdog.
-
-groups:
-  - name: food-market.uptime
-    interval: 30s
-    rules:
-      - alert: ApiDown
-        expr: up{job="food-market-api"} == 0
-        for: 1m
-        labels:
-          severity: critical
-          runbook: api-down
-        annotations:
-          summary: "food-market API не отвечает на /metrics уже 1 минуту"
-          description: |
-            Prometheus не может scrap'нуть {{ $labels.instance }} > 1 минуты.
-            Это означает либо процесс упал, либо порт недоступен.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#api-down"
-
-      - alert: RpsDropped50Percent
-        # RPS за 5 минут упал относительно среднего за час назад (5-минутка часовой давности).
-        # Защита от ложных в пиках/спадах: только когда фактическая загрузка была заметной (>0.5 rps).
-        expr: |
-          sum(rate(http_requests_received_total[5m]))
-            / clamp_min(sum(rate(http_requests_received_total[5m] offset 1h)), 0.001)
-            < 0.5
-          and
-          sum(rate(http_requests_received_total[5m] offset 1h)) > 0.5
-        for: 10m
-        labels:
-          severity: warning
-          runbook: rps-drop
-        annotations:
-          summary: "RPS упал >50% относительно того же окна час назад"
-          description: |
-            Сейчас RPS = {{ $value | humanize }}, что меньше половины часовой давности.
-            Возможно: упал процесс, нет трафика от клиентов, потерян DNS.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#rps-drop"
-
-  - name: food-market.errors
-    interval: 30s
-    rules:
-      - alert: HttpErrorsSpike
-        # Доля 5xx-ответов > 10% от общего трафика за 5 минут.
-        # 10% — порог, выше которого пользователи реально замечают.
-        expr: |
-          (sum(rate(http_requests_received_total{code=~"5.."}[5m]))
-            / clamp_min(sum(rate(http_requests_received_total[5m])), 0.001))
-            > 0.10
-        for: 5m
-        labels:
-          severity: critical
-          runbook: http-errors-spike
-        annotations:
-          summary: "Доля HTTP 5xx > 10% уже 5 минут"
-          description: |
-            Сейчас {{ $value | humanizePercentage }} от запросов возвращают 5xx.
-            Скорее всего сломан какой-то контроллер или зависимость.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#http-errors-spike"
-
-      - alert: HttpErrorRateGrowing
-        # Темп роста 5xx-ошибок > 10%/min.
-        expr: |
-          deriv(sum(rate(http_requests_received_total{code=~"5.."}[5m]))[5m:1m])
-            > 0.10 / 60
-        for: 10m
-        labels:
-          severity: warning
-          runbook: http-errors-growing
-        annotations:
-          summary: "Темп роста 5xx-ошибок > 10%/min на протяжении 10 минут"
-          description: |
-            Производная rate(5xx) положительная > 10%/min. Похоже на постепенную
-            деградацию (не explosion). Проверь логи: что начало падать.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#http-errors-growing"
-
-      - alert: DocumentPostingErrors
-        expr: |
-          sum(rate(food_market_documents_error_total[5m])) by (type)
-            > 0.05
-        for: 5m
-        labels:
-          severity: warning
-          runbook: doc-posting-errors
-        annotations:
-          summary: "Документы ({{ $labels.type }}) валятся чаще 1 раза в 20 секунд"
-          description: |
-            Тип={{ $labels.type }} даёт {{ $value }} ошибок/сек. Воркфлоу проведения
-            ломается — посмотри logs или Hangfire-failed-jobs.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#doc-posting-errors"
-
-  - name: food-market.database
-    interval: 30s
-    rules:
-      - alert: DbQueryP95High
-        # p95 DB-запросов > 500ms на протяжении 10 минут.
-        expr: |
-          histogram_quantile(0.95,
-            sum(rate(food_market_db_query_duration_seconds_bucket[5m])) by (le))
-            > 0.5
-        for: 10m
-        labels:
-          severity: warning
-          runbook: db-p95-high
-        annotations:
-          summary: "DB query p95 > 500ms 10 минут подряд"
-          description: |
-            p95 = {{ $value | humanizeDuration }}. Возможно: PG медленный, нет индекса,
-            ANALYZE устарел, или массовый insert. См. runbook.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#db-p95-high"
-
-      - alert: DiskFreeLow
-        expr: food_market_disk_free_bytes < 5 * 1024 * 1024 * 1024
-        for: 5m
-        labels:
-          severity: critical
-          runbook: disk-free-low
-        annotations:
-          summary: "Свободно < 5 ГБ на {{ $labels.mount }}"
-          description: |
-            Свободно: {{ $value | humanize1024 }}B. При достижении 0 БД встанет.
-            Очисти логи / запусти VACUUM FULL / расширь том.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#disk-free-low"
-
-  - name: food-market.quality-watchdog
-    interval: 1m
-    rules:
-      - alert: WatchdogLastRunRed
-        expr: quality_watchdog_last_run_status == 0
-        for: 5m
-        labels:
-          severity: warning
-          runbook: watchdog-red
-        annotations:
-          summary: "quality-watchdog последний прогон красный (>5 мин)"
-          description: |
-            Хотя бы один из 8 шагов упал. Посмотри docs/quality-status.md
-            или ~/.fm-watchdog/quality.log.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#watchdog-red"
-
-      - alert: MultiTenantViolation
-        # Multi-tenant leak — самый дорогой баг, alert немедленный.
-        expr: increase(quality_watchdog_step_failure_total{step="multi_tenant"}[1h]) > 0
-        for: 1m
-        labels:
-          severity: critical
-          runbook: multi-tenant-violation
-        annotations:
-          summary: "🚨 Multi-tenant LEAK обнаружен watchdog'ом"
-          description: |
-            Шаг multi_tenant failed в последнем прогоне. Org B видит данные A.
-            ЭТО P0. Немедленно разверни stage в read-only mode и проверь tenant-filter.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#multi-tenant-violation"
-
-      - alert: WatchdogIncidentCreated
-        expr: increase(quality_watchdog_incidents_total[1h]) > 0
-        for: 1m
-        labels:
-          severity: warning
-          runbook: watchdog-incident
-        annotations:
-          summary: "Watchdog создал incident — 2+ подряд красных прогона"
-          description: |
-            Один и тот же шаг упал 2 раза подряд. Server-Claude получит
-            incident-файл в очередь. Проверь ~/.fm-watchdog/incident-*.txt.
-          runbook_url: "https://forgejo.local/nns/food-market/src/branch/main/docs/RUNBOOK.md#watchdog-incident"

deploy/prometheus/prometheus.yml

@@ -1,47 +0,0 @@
-# Sprint 26: пример конфига Prometheus для food-market.
-#
-# НЕ деплоится автоматически — это reference для оператора. Под stage:
-#
-#   docker run -d --name prometheus \
-#     -p 9090:9090 \
-#     -v $PWD/prometheus.yml:/etc/prometheus/prometheus.yml \
-#     -v $PWD/alerts.yml:/etc/prometheus/alerts.yml \
-#     prom/prometheus:latest
-#
-# Затем Grafana datasource «Prometheus» = http://prometheus:9090.
-
-global:
-  scrape_interval: 30s
-  evaluation_interval: 30s
-  external_labels:
-    env: stage
-
-rule_files:
-  - alerts.yml
-
-scrape_configs:
-  # API exposed via /metrics endpoint
-  - job_name: food-market-api
-    metrics_path: /metrics
-    static_configs:
-      - targets:
-          - test.admin.food-market.kz:443   # stage
-          # - api.food-market.kz:443        # prod
-    scheme: https
-    relabel_configs:
-      - source_labels: [__address__]
-        target_label: instance
-
-  # quality-watchdog textfile exporter (через node_exporter).
-  # Запускается на машине, где живёт ~/quality-watchdog.sh:
-  #   node_exporter --collector.textfile.directory=$HOME/.fm-watchdog/textfile
-  - job_name: quality-watchdog
-    static_configs:
-      - targets:
-          - 192.168.1.193:9100   # dev-vm node_exporter
-
-alerting:
-  alertmanagers:
-    - static_configs:
-        - targets:
-            - alertmanager:9093

deploy/recovery-restore-orphan-owners.sql

@@ -1,72 +0,0 @@
--- Recovery: orphan AppUser cleanup.
---
--- Применяется один раз вручную на стейдже/проде после деплоя
--- AuthorizationController + SuperAdminOrganizationsController фиксов
--- (audit 2026-04-27 #1, #2, #7).
---
--- Что делает:
---   1. Находит users у которых OrganizationId указывает на отсутствующую
---      или архивированную организацию.
---   2. Деактивирует таких users (IsActive=false), сбрасывает OrganizationId.
---   3. Отзывает все OpenIddict refresh/access токены этих users
---      (Status='revoked') чтобы существующие сессии оборвались.
---
--- Идемпотентен: повторный запуск ничего не ломает.
--- Не удаляет данные — только статусы. Юзер при необходимости может
--- быть восстановлен ручным UPDATE users SET "IsActive"=true.
-
-BEGIN;
-
-WITH orphan_users AS (
-    SELECT u."Id"
-    FROM users u
-    LEFT JOIN organizations o ON o."Id" = u."OrganizationId"
-    WHERE u."IsActive" = true
-      AND (
-        u."OrganizationId" IS NULL
-        OR o."Id" IS NULL
-        OR o."IsArchived" = true
-      )
-      AND NOT EXISTS (
-        -- Не трогаем SuperAdmin'ов — у них org=null это норма.
-        SELECT 1
-        FROM "AspNetUserRoles" ur
-        JOIN roles r ON r."Id" = ur."RoleId"
-        WHERE ur."UserId" = u."Id" AND r."NormalizedName" = 'SUPERADMIN'
-      )
-)
-UPDATE users
-   SET "IsActive" = false,
-       "OrganizationId" = NULL
- WHERE "Id" IN (SELECT "Id" FROM orphan_users);
-
-UPDATE "OpenIddictTokens" t
-   SET "Status" = 'revoked'
- WHERE t."Status" = 'valid'
-   AND t."Subject" IN (
-        SELECT u."Id"::text FROM users u
-        WHERE u."IsActive" = false
-   );
-
--- Owner-Employee должен оставаться в роли «Администратор» и быть IsActive=true.
--- Если кто-то сменил роль владельца на Кладовщика/Менеджера/Кассира или
--- деактивировал — возвращаем «Администратор» и активируем.
-WITH admin_role_per_org AS (
-    SELECT r."OrganizationId", r."Id" AS role_id
-    FROM employee_roles r
-    WHERE r."IsSystem" = true AND r."Name" = 'Администратор'
-)
-UPDATE employees e
-   SET "RoleId"   = ar.role_id,
-       "IsActive" = true,
-       "FiredAt"  = NULL
-  FROM organizations o
-  JOIN admin_role_per_org ar ON ar."OrganizationId" = o."Id"
- WHERE e."OrganizationId" = o."Id"
-   AND e."UserId" = o."AccountOwnerUserId"
-   AND (
-        e."RoleId" <> ar.role_id
-        OR e."IsActive" = false
-   );
-
-COMMIT;

deploy/swagger-diff.sh

@@ -1,127 +0,0 @@
-#!/usr/bin/env bash
-#
-# Sprint 24: контракт-тест — diff /openapi.json между двумя
-# окружениями. Используется ПЕРЕД blue-green деплоем чтобы понять что
-# меняется в публичном API и не сломать клиентов (Web admin, POS WPF,
-# партнёрские интеграции).
-#
-# Usage:
-#   deploy/swagger-diff.sh [--from URL] [--to URL]
-#
-# Default:
-#   from = https://admin.food-market.kz      (prod)
-#   to   = https://test.admin.food-market.kz (stage)
-#
-# Что показывает:
-#   - removed endpoints (path+method) — BREAKING ⚠️
-#   - added endpoints                  — NEW (нормально)
-#   - changed request/response schemas — нужен ручной обзор
-#
-# Без зависимости от swagger-diff CLI: парсим JSON через python3.
-#
-# Exit codes:
-#   0 — изменений нет ИЛИ только additions
-#   1 — есть removed (BREAKING) или changed schemas
-#   2 — ошибка получения swagger.json
-
-set -uo pipefail
-
-FROM_URL="${FM_SWAGGER_FROM:-https://admin.food-market.kz}"
-TO_URL="${FM_SWAGGER_TO:-https://test.admin.food-market.kz}"
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --from) FROM_URL="$2"; shift 2 ;;
-    --to)   TO_URL="$2"; shift 2 ;;
-    --help|-h) grep -E '^#( |$)' "$0" | sed 's/^# \?//'; exit 0 ;;
-    *) echo "Unknown: $1" >&2; exit 2 ;;
-  esac
-done
-
-TMP=$(mktemp -d)
-trap "rm -rf $TMP" EXIT
-
-# Пытаемся несколько канонических путей: Swashbuckle default + alt-routes.
-fetch_swagger() {
-  local base="$1" out="$2"
-  for path in /swagger/v1/swagger.json /v1/swagger.json /api/v1/swagger.json; do
-    if curl -fsS --max-time 30 "$base$path" -o "$out" 2>/dev/null; then
-      # Должен быть JSON, не HTML (фронт SPA отдаёт index.html на unknown path).
-      if python3 -c 'import json,sys; json.load(open(sys.argv[1]))' "$out" 2>/dev/null; then
-        echo "  found at $path" >&2
-        return 0
-      fi
-    fi
-  done
-  return 1
-}
-
-echo "Fetching from $FROM_URL…" >&2
-fetch_swagger "$FROM_URL" "$TMP/from.json" \
-  || { echo "FAIL: $FROM_URL не отдаёт swagger.json. Проверьте IncludeSwagger=true в appsettings или ASPNETCORE_ENVIRONMENT=Development." >&2; exit 2; }
-echo "Fetching from $TO_URL…" >&2
-fetch_swagger "$TO_URL" "$TMP/to.json" \
-  || { echo "FAIL: $TO_URL не отдаёт swagger.json." >&2; exit 2; }
-
-python3 - <<PY
-import json, sys
-def endpoints(s):
-    out = set()
-    for path, methods in s.get('paths', {}).items():
-        for method, op in methods.items():
-            if method.lower() in {'get','post','put','patch','delete','head','options'}:
-                out.add(f"{method.upper()} {path}")
-    return out
-
-def schemas(s):
-    return set(s.get('components', {}).get('schemas', {}).keys())
-
-with open('$TMP/from.json') as f: src = json.load(f)
-with open('$TMP/to.json') as f: dst = json.load(f)
-e_src, e_dst = endpoints(src), endpoints(dst)
-s_src, s_dst = schemas(src), schemas(dst)
-
-added_ep  = sorted(e_dst - e_src)
-removed_ep = sorted(e_src - e_dst)
-added_sc  = sorted(s_dst - s_src)
-removed_sc = sorted(s_src - s_dst)
-
-print(f"=== Swagger diff: $FROM_URL → $TO_URL ===")
-print(f"endpoints: from={len(e_src)} to={len(e_dst)} added={len(added_ep)} removed={len(removed_ep)}")
-print(f"schemas:   from={len(s_src)} to={len(s_dst)} added={len(added_sc)} removed={len(removed_sc)}")
-print()
-
-if added_ep:
-    print("### Added endpoints (новые, нормально):")
-    for e in added_ep: print(f"  + {e}")
-    print()
-
-if removed_ep:
-    print("### ⚠️  REMOVED endpoints (BREAKING для клиентов!):")
-    for e in removed_ep: print(f"  - {e}")
-    print()
-
-if added_sc:
-    print(f"### Added schemas: {len(added_sc)} (показано первые 20)")
-    for s in added_sc[:20]: print(f"  + {s}")
-    print()
-
-if removed_sc:
-    print(f"### ⚠️  REMOVED schemas: {len(removed_sc)}")
-    for s in removed_sc[:20]: print(f"  - {s}")
-    print()
-
-# Изменения операций (опц.): сравнить parameters/responses для shared endpoint'ов.
-# Пока — высокоуровневое diff'a достаточно для blue-green safety check.
-
-# Exit code
-if removed_ep or removed_sc:
-    print("RESULT: BREAKING changes detected.")
-    sys.exit(1)
-elif not added_ep and not added_sc:
-    print("RESULT: schemas identical.")
-    sys.exit(0)
-else:
-    print("RESULT: только additions, безопасно деплоить.")
-    sys.exit(0)
-PY

deploy/telegram-bridge/bridge.py

@@ -1,180 +0,0 @@
-"""Telegram bridge: webhook receiver, paste-to-tmux only.
-
-Refactored from the original 2-second polling loop to a fully event-driven
-design: outgoing assistant messages are now pushed by the Claude Code Stop
-hook (/usr/local/bin/cc-tg-notify-stop). This bridge only handles the
-inbound side — Telegram → tmux paste.
-
-Config (/etc/food-market/telegram.env or env vars):
-  TELEGRAM_BOT_TOKEN    — bot token (required)
-  TELEGRAM_CHAT_ID      — single whitelisted chat id (required)
-  TELEGRAM_WEBHOOK_URL  — public URL Telegram should POST to
-                          (default: https://test.food-market.kz/tg-webhook)
-  TELEGRAM_WEBHOOK_SECRET — random secret; bridge validates the
-                          X-Telegram-Bot-Api-Secret-Token header on every
-                          incoming request and Telegram sends it back so
-                          third parties can't forge updates
-  TMUX_SESSION          — tmux session to paste into (default: claude)
-  WEBHOOK_LISTEN_HOST   — local bind host (default: 127.0.0.1)
-  WEBHOOK_LISTEN_PORT   — local bind port (default: 8765)
-"""
-
-from __future__ import annotations
-
-import asyncio
-import logging
-import os
-import subprocess
-import sys
-from pathlib import Path
-
-from telegram import Update
-from telegram.ext import (
-    ApplicationBuilder,
-    CommandHandler,
-    ContextTypes,
-    MessageHandler,
-    filters,
-)
-
-ENV_FILE = Path("/etc/food-market/telegram.env")
-TMUX_SESSION = os.environ.get("TMUX_SESSION", "claude")
-LISTEN_HOST = os.environ.get("WEBHOOK_LISTEN_HOST", "127.0.0.1")
-LISTEN_PORT = int(os.environ.get("WEBHOOK_LISTEN_PORT", "8765"))
-WEBHOOK_PATH = "/tg-webhook"
-
-logger = logging.getLogger("bridge")
-
-
-def load_env(path: Path) -> dict[str, str]:
-    out: dict[str, str] = {}
-    if not path.exists():
-        return out
-    for raw in path.read_text().splitlines():
-        line = raw.strip()
-        if not line or line.startswith("#") or "=" not in line:
-            continue
-        key, _, value = line.partition("=")
-        out[key.strip()] = value.strip().strip('"').strip("'")
-    return out
-
-
-async def tmux_send_text(session: str, text: str) -> None:
-    """Pastes one Telegram message verbatim into the tmux session, then Enter.
-
-    Uses `send-keys -l` for literal paste — no key-binding interpretation,
-    works for arbitrary text including unicode and special chars.
-    """
-    proc = await asyncio.create_subprocess_exec(
-        "tmux", "send-keys", "-t", session, "-l", text,
-        stdout=subprocess.DEVNULL, stderr=subprocess.PIPE,
-    )
-    _, stderr = await proc.communicate()
-    if proc.returncode != 0:
-        raise RuntimeError(f"tmux send-keys -l failed: {stderr.decode().strip()}")
-    proc = await asyncio.create_subprocess_exec(
-        "tmux", "send-keys", "-t", session, "Enter",
-        stdout=subprocess.DEVNULL, stderr=subprocess.PIPE,
-    )
-    _, stderr = await proc.communicate()
-    if proc.returncode != 0:
-        raise RuntimeError(f"tmux send-keys Enter failed: {stderr.decode().strip()}")
-
-
-def _allowed(update: Update, context: ContextTypes.DEFAULT_TYPE) -> bool:
-    chat_id = context.application.bot_data["chat_id"]
-    return update.effective_chat is not None and update.effective_chat.id == chat_id
-
-
-async def cmd_ping(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
-    if not _allowed(update, context):
-        return
-    await update.message.reply_text(f"pong — webhook mode, tmux session «{TMUX_SESSION}»")
-
-
-QUIET_FLAG = "/tmp/cc-tg-quiet"
-
-
-async def cmd_quiet(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
-    """Заткнуть PreToolUse прогресс-ленту (Stop hook продолжает работать)."""
-    if not _allowed(update, context):
-        return
-    try:
-        open(QUIET_FLAG, "w").close()
-        await update.message.reply_text("🔕 Прогресс-лента отключена. Включить — /loud")
-    except Exception as exc:  # noqa: BLE001
-        await update.message.reply_text(f"⚠️ {exc}")
-
-
-async def cmd_loud(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
-    """Включить обратно PreToolUse прогресс-ленту."""
-    if not _allowed(update, context):
-        return
-    try:
-        os.unlink(QUIET_FLAG)
-    except FileNotFoundError:
-        pass
-    except Exception as exc:  # noqa: BLE001
-        await update.message.reply_text(f"⚠️ {exc}")
-        return
-    await update.message.reply_text("🔔 Прогресс-лента включена.")
-
-
-async def handle_message(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
-    if not _allowed(update, context):
-        return
-    text = (update.message.text or "").strip() if update.message else ""
-    if not text:
-        return
-    logger.info("inbound message: %d chars", len(text))
-    try:
-        await tmux_send_text(TMUX_SESSION, text)
-    except Exception as exc:  # noqa: BLE001
-        logger.warning("paste to tmux failed: %s", exc)
-        await update.message.reply_text(f"⚠️ tmux error: {exc}")
-
-
-def main() -> int:
-    logging.basicConfig(
-        level=logging.INFO,
-        format="%(asctime)s %(levelname)s %(name)s: %(message)s",
-    )
-    env = {**os.environ, **load_env(ENV_FILE)}
-    token = env.get("TELEGRAM_BOT_TOKEN", "").strip()
-    chat_id_raw = env.get("TELEGRAM_CHAT_ID", "").strip()
-    secret = env.get("TELEGRAM_WEBHOOK_SECRET", "").strip()
-    webhook_url = env.get("TELEGRAM_WEBHOOK_URL", "https://test.food-market.kz/tg-webhook").strip()
-    if not token or not chat_id_raw:
-        print("ERROR: TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID required", file=sys.stderr)
-        return 78
-    try:
-        chat_id = int(chat_id_raw)
-    except ValueError:
-        print(f"ERROR: TELEGRAM_CHAT_ID must be int, got {chat_id_raw!r}", file=sys.stderr)
-        return 78
-    if not secret:
-        logger.warning("TELEGRAM_WEBHOOK_SECRET is empty — webhook is unauthenticated")
-
-    application = ApplicationBuilder().token(token).build()
-    application.bot_data["chat_id"] = chat_id
-    application.add_handler(CommandHandler("ping", cmd_ping))
-    application.add_handler(CommandHandler("quiet", cmd_quiet))
-    application.add_handler(CommandHandler("loud", cmd_loud))
-    application.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_message))
-
-    logger.info("starting webhook listener on %s:%d → %s", LISTEN_HOST, LISTEN_PORT, webhook_url)
-    application.run_webhook(
-        listen=LISTEN_HOST,
-        port=LISTEN_PORT,
-        url_path=WEBHOOK_PATH.lstrip("/"),
-        webhook_url=webhook_url,
-        secret_token=secret or None,
-        allowed_updates=Update.ALL_TYPES,
-        drop_pending_updates=False,
-        stop_signals=None,
-    )
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

deploy/telegram-bridge/cc-tg-notify-pretool

@@ -1,124 +0,0 @@
-#!/usr/bin/env bash
-# Claude Code PreToolUse hook: шлёт короткую строку в Telegram перед
-# каждым tool-call'ом для ощущения «активности». Дебаунс 1.5с — пока
-# tool-вызовы летят пачкой, копим в /tmp буфер и шлём одним сообщением
-# через 1.5 секунды тишины.
-#
-# Конфиг — /etc/food-market/telegram.env. Логи — /var/log/cc-tg-notify.log.
-# Off-switch: создать /tmp/cc-tg-quiet — все pretool-уведомления
-# скипаются (Stop hook продолжает работать).
-
-set -u
-ENV_FILE="/etc/food-market/telegram.env"
-LOG_FILE="${CC_TG_LOG:-/var/log/cc-tg-notify.log}"
-BUF="/tmp/cc-tg-pretool-buffer.txt"
-LAST="/tmp/cc-tg-pretool-last"
-LOCK="/tmp/cc-tg-pretool.lock"
-QUIET_FLAG="/tmp/cc-tg-quiet"
-DEBOUNCE_SEC="1.5"
-MAX_LINES=20
-
-log() { printf '%s [pretool] %s\n' "$(date -Is)" "$*" >>"$LOG_FILE" 2>/dev/null || true; }
-
-[[ -f "$QUIET_FLAG" ]] && exit 0
-
-if [[ -r "$ENV_FILE" ]]; then
-  # shellcheck disable=SC1090
-  set -a; source "$ENV_FILE"; set +a
-fi
-TOKEN="${TELEGRAM_BOT_TOKEN:-}"
-CHAT_ID="${TELEGRAM_CHAT_ID:-}"
-[[ -z "$TOKEN" || -z "$CHAT_ID" ]] && exit 0
-
-INPUT_JSON=""
-if [[ ! -t 0 ]]; then INPUT_JSON="$(cat)"; fi
-[[ -z "$INPUT_JSON" ]] && exit 0
-
-TOOL="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_name // empty' 2>/dev/null)"
-[[ -z "$TOOL" || "$TOOL" == "TodoWrite" ]] && exit 0
-
-# Извлекаем поле tool_input под нужный тип. cut -c обрезает многобайтные
-# UTF-8 неаккуратно, но для urlencode результат остаётся валидным.
-LINE=""
-case "$TOOL" in
-  Bash)
-    DESC="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.description // empty' 2>/dev/null | tr '\n' ' ' | head -c 100)"
-    CMD="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.command // empty' 2>/dev/null | tr '\n' ' ' | head -c 80)"
-    if [[ -n "$DESC" ]]; then LINE="🔨 $DESC"; else LINE="🔨 Bash: $CMD"; fi
-    ;;
-  Edit)
-    FP="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
-    LINE="✏️ Edit: $(basename "${FP:-?}")"
-    ;;
-  Write)
-    FP="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
-    LINE="📝 Write: $(basename "${FP:-?}")"
-    ;;
-  Read)
-    FP="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
-    LINE="📖 Read: $(basename "${FP:-?}")"
-    ;;
-  Grep)
-    P="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.pattern // empty' 2>/dev/null | head -c 30)"
-    LINE="🔍 Grep: \"$P\""
-    ;;
-  Glob)
-    P="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.pattern // empty' 2>/dev/null | head -c 50)"
-    LINE="🌐 Glob: $P"
-    ;;
-  WebFetch)
-    U="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.url // empty' 2>/dev/null | head -c 60)"
-    LINE="🌍 Fetch: $U"
-    ;;
-  WebSearch)
-    Q="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.query // empty' 2>/dev/null | head -c 60)"
-    LINE="🔎 Search: $Q"
-    ;;
-  Task)
-    D="$(printf '%s' "$INPUT_JSON" | jq -r '.tool_input.description // empty' 2>/dev/null | head -c 60)"
-    LINE="🎯 Task: $D"
-    ;;
-  *)
-    LINE="🔧 $TOOL"
-    ;;
-esac
-
-[[ -z "$LINE" ]] && exit 0
-
-NOW="$(date +%s%N | cut -c1-13)"
-
-# Append + bump LAST под flock'ом — конкурентные hook'и не теряют строки.
-(
-  flock 9
-  echo "$LINE" >> "$BUF"
-  echo "$NOW" > "$LAST"
-) 9>"$LOCK"
-
-# Дебаунс-flusher в фоне. Каждый hook спавнит свой sleep, но только
-# тот, чей NOW совпал с финальным LAST после задержки, реально шлёт —
-# остальные тихо выходят.
-(
-  sleep "$DEBOUNCE_SEC"
-  (
-    flock 9
-    LAST_TS="$(cat "$LAST" 2>/dev/null || echo 0)"
-    if [[ "$LAST_TS" != "$NOW" ]]; then
-      # Пришёл более свежий tool — он заfflushит сам.
-      exit 0
-    fi
-    [[ -s "$BUF" ]] || exit 0
-    # Если буфер длиннее MAX_LINES — режем хвост (свежие строки важнее).
-    BODY="$(tail -n "$MAX_LINES" "$BUF")"
-    : > "$BUF"
-    curl -fsS -m 10 -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
-      --data-urlencode "chat_id=${CHAT_ID}" \
-      --data-urlencode "text=${BODY}" \
-      --data-urlencode "disable_notification=true" \
-      --data-urlencode "disable_web_page_preview=true" \
-      >/dev/null 2>&1 || log "send failed"
-  ) 9>"$LOCK"
-) &
-
-# Не ждём фоновую задачу — Claude Code продолжает выполнение tool'а.
-disown 2>/dev/null || true
-exit 0

deploy/telegram-bridge/cc-tg-notify-stop

@@ -1,99 +0,0 @@
-#!/usr/bin/env bash
-# Claude Code Stop hook: вытаскивает финальный assistant-ответ из transcript'а
-# и пушит в Telegram. Устанавливается на /usr/local/bin/cc-tg-notify-stop.
-#
-# Hook runtime передаёт JSON на stdin с полем .transcript_path; раньше это
-# приходило как $CLAUDE_TRANSCRIPT_PATH env-var, но в новых версиях стрим
-# переехал в stdin. Поддерживаем оба варианта.
-#
-# Конфиг — /etc/food-market/telegram.env (TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID).
-# Логи — /var/log/cc-tg-notify.log (rotated externally).
-
-set -u
-ENV_FILE="/etc/food-market/telegram.env"
-LOG_FILE="${CC_TG_LOG:-/var/log/cc-tg-notify.log}"
-PROJECT_TAG="${CC_TG_TAG:-food-market}"
-MAX_CHUNK=4000
-
-log() { printf '%s [stop-hook] %s\n' "$(date -Is)" "$*" >>"$LOG_FILE" 2>/dev/null || true; }
-
-if [[ -r "$ENV_FILE" ]]; then
-  # shellcheck disable=SC1090
-  set -a; source "$ENV_FILE"; set +a
-fi
-TOKEN="${TELEGRAM_BOT_TOKEN:-}"
-CHAT_ID="${TELEGRAM_CHAT_ID:-}"
-if [[ -z "$TOKEN" || -z "$CHAT_ID" ]]; then
-  log "missing TELEGRAM_BOT_TOKEN or TELEGRAM_CHAT_ID"
-  exit 0
-fi
-
-# Читаем JSON со stdin (если пришёл) или берём env-vars (legacy).
-INPUT_JSON=""
-if [[ -t 0 ]]; then
-  INPUT_JSON=""
-else
-  INPUT_JSON="$(cat)"
-fi
-
-TRANSCRIPT="${CLAUDE_TRANSCRIPT_PATH:-}"
-if [[ -z "$TRANSCRIPT" && -n "$INPUT_JSON" ]]; then
-  TRANSCRIPT="$(printf '%s' "$INPUT_JSON" | jq -r '.transcript_path // empty' 2>/dev/null || true)"
-fi
-if [[ -z "$TRANSCRIPT" || ! -r "$TRANSCRIPT" ]]; then
-  log "no transcript path (stdin=${#INPUT_JSON} chars, env=${CLAUDE_TRANSCRIPT_PATH:-unset})"
-  exit 0
-fi
-
-# Последняя assistant-запись с непустым text-блоком. JSONL: одна запись на строку.
-TEXT="$(jq -r '
-  select(.type == "assistant")
-  | .message.content[]?
-  | select(.type == "text" and (.text // "" | length) > 0)
-  | .text
-' "$TRANSCRIPT" 2>/dev/null \
-  | awk 'BEGIN{RS=""}{a=$0} END{print a}')"
-
-# awk выше склеивает все записи в одну; нам нужна именно ПОСЛЕДНЯЯ assistant-запись,
-# поэтому делаем второй проход: берём индекс последней записи и достаём её text-блоки.
-LAST_TEXT="$(jq -s -r '
-  map(select(.type == "assistant")) | last as $m
-  | ($m.message.content // [])
-  | map(select(.type == "text" and (.text // "" | length) > 0) | .text)
-  | join("\n")
-' "$TRANSCRIPT" 2>/dev/null)"
-
-if [[ -n "$LAST_TEXT" ]]; then TEXT="$LAST_TEXT"; fi
-
-if [[ -z "$TEXT" ]]; then
-  log "no text in last assistant turn (only tool calls?)"
-  exit 0
-fi
-
-# Чанкуем по строкам с лимитом MAX_CHUNK; первый чанк — с префиксом.
-PREFIX="🤖 [${PROJECT_TAG}]"
-send_chunk() {
-  local body="$1"
-  curl -fsS -m 15 -X POST "https://api.telegram.org/bot${TOKEN}/sendMessage" \
-    --data-urlencode "chat_id=${CHAT_ID}" \
-    --data-urlencode "text=${body}" \
-    --data-urlencode "disable_web_page_preview=true" \
-    >/dev/null 2>&1 || log "send failed (curl rc=$?)"
-}
-
-CHUNK="$PREFIX"$'\n'
-EMITTED=0
-while IFS= read -r line; do
-  if (( ${#CHUNK} + ${#line} + 1 > MAX_CHUNK )); then
-    send_chunk "$CHUNK"
-    EMITTED=$((EMITTED+1))
-    CHUNK=""
-  fi
-  CHUNK+="$line"$'\n'
-done <<<"$TEXT"
-if [[ -n "$CHUNK" ]]; then
-  send_chunk "$CHUNK"
-  EMITTED=$((EMITTED+1))
-fi
-log "sent $EMITTED chunk(s), text=${#TEXT} chars"
-exit 0

deploy/telegram-bridge/requirements.txt

@@ -1 +0,0 @@
-python-telegram-bot[rate-limiter]==21.6

deploy/telegram-bridge/telegram-bridge.service

@@ -1,19 +0,0 @@
-[Unit]
-Description=food-market Telegram <-> tmux bridge
-After=network-online.target
-Wants=network-online.target
-
-[Service]
-Type=simple
-User=nns
-Group=nns
-WorkingDirectory=/opt/food-market-data/telegram-bridge
-EnvironmentFile=-/etc/food-market/telegram.env
-ExecStart=/opt/food-market-data/telegram-bridge/venv/bin/python /opt/food-market-data/telegram-bridge/bridge.py
-Restart=on-failure
-RestartSec=10
-# Access tmux sockets under /tmp/tmux-1000/
-Environment=TMUX_TMPDIR=/tmp
-
-[Install]
-WantedBy=multi-user.target

docs/ARCHITECTURE.md

@@ -1,486 +0,0 @@
-# food-market — архитектура
-
-Документ для разработчика, который пришёл в проект первый раз. Описывает
-слои, модули, ключевые потоки и почему некоторые вещи сделаны именно так.
-
-Старая короткая версия — `docs/architecture.md` (lowercase). Этот файл
-заменяет её и расширяет.
-
-## TL;DR
-
-- **Что**: multi-tenant SaaS-аналог МойСклад для розничных магазинов РК.
-- **Backend**: .NET 8 LTS, ASP.NET Core, EF Core 8, PostgreSQL 14+ (dev) / 16 (prod).
-- **Auth**: OpenIddict 5 (password + refresh) поверх ASP.NET Identity.
-- **Web**: React 19 + Vite + TS, Tailwind v4, shadcn/ui, TanStack Query, AG Grid.
-- **POS**: WPF на .NET 8 Windows, оффлайн-буфер в SQLite, синк через `/api/pos/v1`.
-
-## Топология deployment
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                  Internet / LAN магазина                         │
-└───────────┬───────────────────────┬─────────────────────────────┘
-            │ HTTPS                  │ HTTPS (Bearer) + офлайн-буфер
-            ▼                        ▼
-   ┌────────────────────┐    ┌──────────────────────────┐
-   │  food-market.web   │    │  food-market.pos (WPF)    │
-   │   React SPA        │    │   .NET 8, Windows 10+     │
-   │   admin.fm.kz      │    │   локальная SQLite        │
-   └─────────┬──────────┘    └──────────┬───────────────┘
-             │                          │
-             │ /api/*                   │ /api/pos/v1/*
-             │ /hubs/notifications      │
-             └─────────────┬────────────┘
-                           ▼
-          ┌───────────────────────────────────────────┐
-          │         food-market.api                    │
-          │   ASP.NET Core + OpenIddict + SignalR      │
-          │  - tenant query filters per request        │
-          │  - Hangfire scheduler + recurring jobs     │
-          │  - /metrics (Prometheus) /health/{live,ready}│
-          └────┬──────────┬───────────┬───────────┬───┘
-               ▼          ▼           ▼           ▼
-         ┌────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐
-         │Postgres│ │ Hangfire│ │ MinIO    │ │ Logs     │
-         │  16    │ │  (jobs) │ │ (S3, opt)│ │ Serilog  │
-         └────────┘ └─────────┘ └──────────┘ └──────────┘
-                                   │
-                                   ▼
-                        локальный FS (/uploads volume)
-                          — если MinIO не настроен
-```
-
-Stage и prod крутятся через `deploy/docker-compose.yml` на dev-vm
-(`192.168.1.190`). Локальный dev: API на `:5081`, Postgres из
-brew (`postgres@14` на `:5432`), web через `pnpm dev` на `:5173`.
-
-## Структура солюшна
-
-```
-food-market/
-├── src/
-│   ├── food-market.domain/          ← POCO, enum, доменные интерфейсы
-│   ├── food-market.application/     ← MediatR-handlers, DTO, абстракции
-│   ├── food-market.infrastructure/  ← EF Core, Identity, OpenIddict EF, внешние API
-│   ├── food-market.api/             ← ASP.NET Core host: controllers, middleware, DI
-│   ├── food-market.web/             ← React SPA
-│   ├── food-market.shared/          ← DTO-контракты api ↔ pos
-│   ├── food-market.public/          ← Astro static (маркетинг food-market.kz)
-│   ├── food-market.pos.core/        ← логика POS (без UI)
-│   └── food-market.pos/             ← WPF UI (net8.0-windows)
-├── tests/
-│   ├── food-market.UnitTests/       ← xUnit + InMemoryDB
-│   ├── food-market.IntegrationTests/← xUnit + Testcontainers Postgres
-│   ├── e2e/                         ← Playwright (TS), бьёт по test.admin.food-market.kz
-│   └── load/                        ← k6 (Sprint 12)
-├── deploy/                          ← docker-compose, Dockerfile.*, systemd-юниты
-└── docs/                            ← вы здесь
-```
-
-### Слои (Clean Architecture)
-
-| Слой              | Зависит от                | Что лежит                                                                              |
-|-------------------|---------------------------|----------------------------------------------------------------------------------------|
-| **domain**        | ничего                    | POCO-сущности, enum'ы, доменные интерфейсы (`ITenantEntity`, `IVersionedEntity`).      |
-| **application**   | domain + shared           | MediatR `IRequest`/`IRequestHandler`, DTO, абстракции (`IFiscalProvider`, `IEmailSender`, `IStockService`, `ITenantContext`), `FluentValidation` валидаторы. |
-| **infrastructure**| application + domain      | `AppDbContext`, Identity-таблицы, OpenIddict EF store, реализации абстракций, HTTP-клиенты к внешним API (Webkassa, MoySklad, MailKit, Telegram). |
-| **api**           | всё перечисленное выше    | ASP.NET Core host: контроллеры, middleware, DI-проводка, фоновые джобы (Hangfire), Realtime hub'ы (SignalR), сидеры. |
-
-Правило одностороннего направления зависимостей: домен не знает про EF и
-ASP.NET, application — про конкретные провайдеры. Это позволило прикрутить
-ОФД (Sprint 11) одним интерфейсом + четырьмя реализациями, без правок
-контроллеров кроме одной точки вызова.
-
-## Модули backend
-
-### Domain (`src/food-market.domain/`)
-
-- `Common/Entity.cs` — базовая `Entity` с `Id/CreatedAt/UpdatedAt`.
-- `Common/TenantEntity.cs` — `ITenantEntity` (обязательный `OrganizationId`),
-  `TenantEntity` (база), `IOptionalTenantEntity` (системные справочники с
-  `OrganizationId?`).
-- `Common/IVersionedEntity.cs` — оптимистичная блокировка через PG `xmin`
-  (`Xmin` поле).
-- Бизнес-сущности по поддоменам: `Catalog/` (Product, Counterparty,
-  ProductGroup, …), `Inventory/` (Stock, StockMovement, Loss, Transfer,
-  Inventory), `Purchases/` (Supply, Enter, SupplierReturn),
-  `Sales/` (RetailSale, RetailSaleLine, Demand, LoyaltyCard,
-  LoyaltyProgram, Promotion), `Organizations/` (Organization, Employee,
-  EmployeeRole, OrgAuditLog, SuperAdminAuditLog), `Platform/`
-  (PlatformSettings — singleton SMTP-конфиг).
-
-### Application (`src/food-market.application/`)
-
-- **CQRS на MediatR** — пока partial: образцы в `Purchases/Commands/CreateSupplyCommand.cs`,
-  `Sales/Commands/PostRetailSaleCommand.cs`, `Sales/Queries/GetSalesReportQuery.cs`.
-  Большинство контроллеров пока «толстые» (исторически до TD-1).
-- **Абстракции**:
-  - `Common/Tenancy/ITenantContext` — `OrganizationId`, `IsSuperAdmin`,
-    `IsTenantOverride`, `UserId`.
-  - `Common/Email/IEmailSender` — отправка через текущий SMTP-конфиг.
-  - `Common/Fiscal/IFiscalProvider` + `IFiscalProviderFactory` (Sprint 11).
-  - `Inventory/IStockService` — единая точка списания/начисления остатка
-    (любая операция, меняющая склад, идёт через `ApplyMovementAsync`).
-- **FluentValidation** валидаторы рядом с DTO; глобально подключаются
-  через `AddValidatorsFromAssemblyContaining<Program>()`.
-
-### Infrastructure (`src/food-market.infrastructure/`)
-
-- `Persistence/AppDbContext.cs` — единый DbContext (тенанта + Identity +
-  OpenIddict EF store). Query-filter применяется через reflection ко всем
-  `ITenantEntity` (см. [MULTI-TENANCY.md](MULTI-TENANCY.md)).
-- `Persistence/Configurations/*.cs` — EF Core fluent configs по поддоменам.
-- `Persistence/Migrations/` — миграции пишутся вручную (см. CLAUDE.md /
-  memory `feedback_ef_migrations`), снапшот не синхронизируется
-  с моделью (используется только `dotnet ef migrations add`, который
-  не вызывается в этом проекте).
-- `Persistence/OrgAuditInterceptor.cs` — EF `ISaveChangesInterceptor`,
-  пишет каждую `Add/Update/Delete` в `org_audit_log` (JSONB diff).
-- `Identity/` — кастомные `User`, `Role` для ASP.NET Identity.
-- `Email/MailKitEmailSender.cs` — SMTP через MailKit, конфиг из
-  `PlatformSettings` (читается на каждой отправке через scope).
-- `Fiscal/` — `IFiscalProvider` реализации: Mock + Webkassa (полный) +
-  Kassa24/OfdSolo (skeleton). См. [ofd-integration.md](ofd-integration.md).
-- `Inventory/StockService.cs` — единственное место, где двигаются остатки.
-  Бизнес-инвариант: stock = SUM(stock_movements) per (productId, storeId).
-- `Integrations/MoySklad/` — HTTP-клиент + конвертер для импорта каталога.
-
-### Api (`src/food-market.api/`)
-
-- `Program.cs` — composition root (~570 строк, поделён логическими
-  блоками; см. секцию «Composition root» ниже).
-- `Controllers/` — REST-API. Структура совпадает с маршрутами:
-  - `Auth/` — `/api/auth/*` (signup, forgot-password, 2FA).
-  - `Catalog/` — `/api/catalog/{products,counterparties,…}`.
-  - `Purchases/` — `/api/purchases/{supplies,supplier-returns}`.
-  - `Sales/` — `/api/sales/{retail,demands}`.
-  - `Inventory/` — `/api/inventory/{stock,enters,losses,transfers,inventories}`.
-  - `Reports/` — `/api/reports/{sales,stock,profit,abc}`.
-  - `Dashboard/` — `/api/dashboard/{top-products,low-stock,recent-sales,margin}`.
-  - `Loyalty/`, `Promotions/` — Sprint 9.
-  - `Organizations/` — настройки орги, сотрудники, роли, ОФД.
-  - `Pos/` — `/api/pos/v1/*` для WPF POS (sync, idempotency).
-  - `SuperAdmin/` — `/api/super-admin/*` (управление платформой).
-  - `Admin/` — `/api/admin/*` (per-org admin tools: cleanup, demo-seed,
-    moysklad-import, audit-log просмотр).
-  - `Search/` — глобальный `/api/search/global` (Cmd+K).
-  - `Telegram/` — bind owner-chat, статус.
-  - `Uploads/` — multipart upload изображений.
-- `Infrastructure/`:
-  - `Tenancy/HttpContextTenantContext.cs` — реализация `ITenantContext`
-    через `IHttpContextAccessor` + AsyncLocal-override для background tasks.
-  - `Tenancy/SuperAdminOverrideClaimsTransformer.cs` — добавляет
-    `Admin/Cashier/Storekeeper` роли SuperAdmin'у с активным
-    `X-Org-Override`, чтобы `[Authorize(Roles="Admin")]` не отшил его.
-  - `Tenancy/ReadonlyOverrideMiddleware.cs` — в режиме override без
-    `X-Org-Override-Reason` блочит любую мутацию (читать всё, писать
-    ничего; писать — только в edit-mode с reason).
-  - `Tenancy/SuperAdminEditAuditFilter.cs` — глобальный action-filter,
-    при mutate-в-override пишет в `super_admin_audit_log`.
-  - `Authorization/RequiresPermissionAttribute.cs` + `PermissionAuthorizationPolicyProvider`
-    + `PermissionAuthorizationHandler` — permission-based авторизация.
-    `[RequiresPermission("ProductsEdit")]` → policy `perm:ProductsEdit` →
-    `RolePermissions.ProductsEdit` булева на `EmployeeRole`.
-  - `Validation/ValidationFilter.cs` — FluentValidation → 400
-    ProblemDetails (RFC 7807).
-  - `RateLimiting/AuthRateLimiterExtensions.cs` — 5/мин + 20/час на
-    `/connect/token`, `/api/auth/signup` по IP+username.
-  - `Observability/LogEnrichmentMiddleware.cs` — кладёт
-    `CorrelationId/OrgId/UserId` в Serilog `LogContext`, каждая запись
-    в журнале получает эти лейблы.
-  - `Observability/DbMetricsInterceptor.cs` — EF интерсептор, Prometheus
-    `food_market_db_query_duration_seconds`.
-  - `Observability/AppMetrics.cs` — статические Counter'ы (Posted/Unposted
-    per docType, FiscalRegistered, …).
-  - `Health/DatabaseReadyHealthCheck.cs` — `SELECT 1` + проверка
-    `__EFMigrationsHistory`.
-  - `Security/OpenIddictKeyConfigurator.cs` — в dev — persistent RSA в
-    `App_Data/oidc-keys/*`; в stage/prod — X509 PFX из конфига
-    (см. [openiddict-keys.md](openiddict-keys.md)).
-- `Realtime/NotificationsHub.cs` + `NotificationsPublisher.cs` —
-  SignalR-хаб `/hubs/notifications`, группы per-org. События:
-  `SalePosted`, `LowStock`, `ImportProgress`.
-- `Background/`:
-  - `HangfireJobsConfigurator` — регистрирует recurring jobs при старте:
-    `prune-stock-movements` (03:30), `prune-audit-log` (03:45),
-    `weekly-summary` (пн 07:00), `low-stock-alert` (08:00),
-    `telegram-owner-daily-summary` (06:00).
-  - `HousekeepingJobs` — pg-cleanup'ы.
-  - `EmailNotificationJobs` — weekly-summary + low-stock email.
-  - `OwnerDailySummaryJob` — Telegram-сводка владельцу.
-  - `ReferencePriceRefreshJob` — пересчёт `Product.ReferencePrice`
-    каждые 30 дней без приёмок.
-- `Seed/`:
-  - `SystemReferenceSeeder` — справочники (страны, валюты, единицы).
-  - `OpenIddictClientSeeder` — регистрирует client `food-market-web`.
-  - `DevDataSeeder` — dev-only admin user (SuperAdmin).
-  - `DemoTenantSeeder` / `YearDemoSeeder` — заполняют tenant
-    демо-данными (Sprint 5 / Sprint 10).
-
-### Web (`src/food-market.web/`)
-
-- Vite + React 19 + TS 6, Tailwind v4. Маршрутизация — React Router 6.
-- `src/lib/api.ts` — axios instance с auto-refresh токена.
-- `src/lib/auth.ts` — login/logout, store токена в `localStorage`.
-- `src/components/` — общие виджеты (Field, Button, Skeleton,
-  CommandPalette, DashboardWidgets).
-- `src/pages/` — страницы (один файл per route).
-- TanStack Query — кеширование API-вызовов, инвалидация по SignalR.
-- AG Grid Community — большие списки (товары, контрагенты, отчёты).
-
-### POS (`src/food-market.pos*/`)
-
-- `pos.core/` — логика без UI: оффлайн-буфер, sync, расчёт чека.
-- `pos/` — WPF UI, CommunityToolkit.Mvvm, SQLite, Refit + Polly,
-  System.IO.Ports для весов CAS.
-- Sync: батчем по 50 чеков через `POST /api/pos/v1/batch` с
-  `Idempotency-Key`. Сервер дедупит через `pos_batch_acks` уникальный
-  индекс (`OrganizationId, IdempotencyKey`).
-
-## Composition root (`Program.cs`)
-
-Логические блоки в порядке регистрации:
-
-1. **Serilog** bootstrap (до builder).
-2. **CORS** (`Cors:AllowedOrigins` из конфига).
-3. **HttpContextAccessor** + `ITenantContext` + `IClaimsTransformation`
-   (SuperAdmin override роли).
-4. **EF Core**: `AppDbContext` (Npgsql, OpenIddict, два interceptor'а).
-5. **Identity** + **OpenIddict** server (password + refresh, rolling
-   refresh, leeway = 0).
-6. **Authentication/Authorization** policies (`AdminAccess`, `perm:*`).
-7. **Rate-limiter** (`/connect/token`, `/api/auth/signup`).
-8. **HealthChecks** (`database` тег `ready`).
-9. **IEmailSender** (Singleton + scope для DbContext).
-10. **IFiscalProvider** + 3 HttpClient + `IFiscalProviderFactory`.
-11. **MediatR** (assembly scan), **FluentValidation**.
-12. **MoySklad HttpClient** + import service.
-13. **Hangfire** server + storage (PG), `HangfireJobsConfigurator` хостед.
-14. **SignalR** + `INotificationsPublisher`.
-15. **Telegram-бот** HttpClient (если token задан).
-16. **Сидеры**: `OpenIddictClientSeeder`, `SystemReferenceSeeder`,
-    `DevDataSeeder` хостед; `DemoTenantSeeder`/`YearDemoSeeder` scoped.
-17. `Build()` → middleware pipeline (Serilog→CORS→HttpMetrics→
-    RateLimiter→hubs-token-fix→AuthN→AuthZ→LogEnrichment→
-    ReadonlyOverride→StaticFiles[/uploads]→Swagger→MapControllers→
-    MapHub→MapMetrics→HangfireDashboard→HealthChecks).
-18. На старте: `db.Database.Migrate()` (идемпотентно).
-19. `app.Run()`.
-
-## Поток: signup → bootstrap → первая продажа
-
-```
-1. POST /api/auth/signup { email, password, organizationName, phone }
-   ─→ создание Organization (Entity, не tenant-scoped)
-   ─→ создание AppUser + добавление в роль "Admin"
-   ─→ создание Employee с AdminRole и всеми permission'ами
-   ─→ создание главного Store (isMain=true) + RetailPoint
-   ─→ создание PriceType "Розничная" (isRetail=true, isSystem=true)
-   ─→ копирование системных UnitOfMeasure (OrganizationId=null) на org
-
-2. POST /connect/token { grant_type=password, username, password }
-   ─→ OpenIddict проверяет, выдаёт access_token + refresh_token
-   ─→ access_token содержит claim org_id и role
-
-3. GET /api/me  (web bootstrap)
-   ─→ возвращает { sub, email, roles, orgId, hasLiveOrg, hasActiveEmployee }
-   ─→ фронт роутит на /dashboard или /no-organization (orphan-fallback)
-
-4. POST /api/catalog/products  { name, prices, barcodes, ... }
-   ─→ ValidationFilter (FluentValidation)
-   ─→ controller → _db.Products.Add(...) (OrganizationId stamped в SaveChanges)
-   ─→ возвращает Product DTO
-
-5. POST /api/purchases/supplies + POST /{id}/post
-   ─→ post идёт под Serializable tx
-   ─→ для каждой строки StockService.ApplyMovementAsync(+qty, MovementType.Supply)
-   ─→ Stock row для (productId, storeId) либо создаётся, либо обновляется
-   ─→ commit, AppMetrics.IncrementPosted("supply")
-   ─→ SignalR: NotificationsHub → группа org → событие SupplyPosted
-
-6. POST /api/sales/retail + POST /{id}/post
-   ─→ Serializable tx, проверка остатка ≥ 0 для каждой строки
-   ─→ StockService.ApplyMovementAsync(-qty, MovementType.RetailSale)
-   ─→ commit, AppMetrics.IncrementPosted("retail-sale")
-   ─→ best-effort TryFiscalizeAsync (Sprint 11) — отдельно, после commit
-   ─→ SignalR: SalePosted (dashboard виджеты инвалидируют queries)
-```
-
-## База данных
-
-Postgres 14+ для dev (brew systemwide), Postgres 16 в Docker для
-stage/prod. Названия таблиц snake_case через явный `ToTable("…")`.
-
-### Ключевые таблицы
-
-| Таблица | Назначение |
-|---|---|
-| `organizations` | Корневой tenant. Не tenant-scoped. |
-| `users`, `roles`, `user_roles` | ASP.NET Identity. |
-| `employees`, `employee_roles`, `role_permissions` | Сотрудники tenant'а + кастомные роли с булевыми флагами прав. |
-| `products`, `product_prices`, `product_barcodes`, `product_images`, `product_groups` | Каталог товаров. |
-| `counterparties` | Поставщики + покупатели (тип=Supplier/Individual/Legal). |
-| `stores`, `retail_points`, `units_of_measure`, `currencies`, `price_types`, `countries` | Справочники. |
-| `stocks`, `stock_movements` | Остатки + история движений. `stocks` — кеш `SUM(stock_movements)`. |
-| `supplies`, `supply_lines`, `enters`, `enter_lines`, `supplier_returns`, `supplier_return_lines` | Приходные документы. |
-| `losses`, `loss_lines`, `transfers`, `transfer_lines`, `inventory_docs`, `inventory_lines` | Внутренний учёт. |
-| `retail_sales`, `retail_sale_lines` | Чеки розницы + строки чека. Sprint 11: ОФД-снапшоты на `retail_sales` (FiscalNumber, FiscalQrCode, …). |
-| `demands`, `demand_lines` | Опт-отгрузки. |
-| `loyalty_programs`, `loyalty_cards`, `promotions` | Sprint 9. |
-| `pos_batch_acks` | Идемпотентность POS-синка (UNIQUE OrganizationId, IdempotencyKey). |
-| `org_audit_log` | JSONB-diff каждой mutate-операции tenant'а. |
-| `super_admin_audit_log` | Действия SuperAdmin'а (особенно в режиме «открыто как…»). |
-| `platform_settings` | Singleton: SMTP-конфиг платформы. |
-| `system_settings` | Singleton: per-tenant фичи (не путать с platform). |
-| `import_jobs` | История импортов MoySklad. |
-
-OpenIddict хранит `openiddict_applications`/`authorizations`/`tokens`/`scopes`.
-Hangfire — `hangfire.*` (в своей схеме).
-
-### Concurrency
-
-`IVersionedEntity` сущности (Supply, RetailSale, Demand, Enter, Loss,
-Transfer, InventoryDoc, SupplierReturn) включают PG `xmin` через
-`UseXminAsConcurrencyToken()`. Параллельные апдейты одного документа
-получают `DbUpdateConcurrencyException`, контроллер возвращает 409.
-
-Post-операции, изменяющие остаток, идут под `IsolationLevel.Serializable`
-(см. `RetailSalesController.Post`, `SuppliesController.Post`, …) —
-это защищает от race в `SUM(stock_movements)`-инварианте.
-
-## Внешние интеграции
-
-| Сервис | Где | Состояние |
-|---|---|---|
-| **MoySklad** | `Infrastructure/Integrations/MoySklad/` | Импорт товаров, контрагентов, остатков. Per-org token в `Organization.MoySkladToken`. |
-| **SMTP** | `Infrastructure/Email/MailKitEmailSender.cs` | Платформенный SMTP в `PlatformSettings` (SuperAdmin настраивает). Используется для invite, forgot-password, weekly-summary. |
-| **Telegram Bot** | `Api/Integrations/Telegram/` | Owner-сводка. Per-org `OwnerTelegramChatId`. Bot token в env. |
-| **ОФД (Webkassa / Kassa24 / ОФД-Соло)** | `Infrastructure/Fiscal/` | Sprint 11 scaffolding. Per-org провайдер + креды. |
-| **MinIO (S3)** | `Api/Storage/StorageBootstrap.cs` | Опциональный сторадж изображений. Если не настроен — `/uploads` volume на FS. |
-
-## Тесты
-
-- **Unit** (`tests/food-market.UnitTests/`) — xUnit + InMemory EF + чистые
-  юниты на валидаторы, payload-builder'ы, MediatR-handler'ы.
-- **Integration** (`tests/food-market.IntegrationTests/`) — xUnit +
-  Testcontainers Postgres (`postgres:16-alpine`). Полный API через
-  `WebApplicationFactory<Program>`. Shared `ApiFactory` через
-  `ApiCollection` (один контейнер на сессию xunit). Memory note:
-  `test_suites_setup` — Ryuk выключен (TCN не тянет с docker-hub),
-  rate-limiter eager-config через env-переменную.
-- **E2E** (`tests/e2e/`) — Playwright (TS) против stage
-  `https://test.admin.food-market.kz`. Используется в verify-suite'ах
-  по спринтам.
-- **Load** (`tests/load/`) — k6 (Sprint 12). См. `docs/performance-baseline.md`.
-
-### Sprint 13-22 changes (быстрая сводка)
-
-| Sprint | Что добавлено / изменено |
-|---|---|
-| **13** (security) | `SecurityHeadersMiddleware` (CSP, X-Frame, HSTS); rate-limit на signup (3/h IP) и forgot-password (3/h email + 10/h IP); `SensitiveOpsAudit` сервис для logged-ops; `POST /api/me/sessions/revoke-all` через `IOpenIddictAuthorizationManager`; Hangfire-dashboard под `SuperAdminHangfireFilter` + nginx /hangfire location. Также: dedicated PG-роль `food_market_server_app` для legacy back.food-market.kz (без superuser). |
-| **14** (perf) | Phase14a индексы (composite + partial с INCLUDE на `retail_sales`); N+1 fix в `SalesReportController.FetchAsync`; React.lazy на 30 редких страниц + Recharts lazy → bundle 1456→706 KB (−51%); ImageSharp генерирует thumb/medium WebP при загрузке + `<ProductImage>` с `<picture>` srcset; Npgsql pool (Min=10/Max=100/AutoPrepare=20); `JobTimingFilter` для Hangfire-jobs. |
-| **15** (a11y + tests) | `useFocusTrap` (WCAG 2.4.3/2.1.2) на Modal + ConfirmDialog; axe-core spec-suite (10 страниц, 0 critical); aria-label на icon-only back-links + role="alert" на form errors; coverage Application 67%→83%, Domain 11%→79%; property-based tests на StockService (Σ movements ≡ Stock); verified backup-recovery drill RTO ~25s. |
-| **16** (regression) | Regression suite 35 Playwright flows + 60 visual snapshots; nightly stage-verify cron; Forgejo workflow regression; README badges; factories для test-data. |
-| **17** (onboarding) | `/onboarding-wizard` (4 шага + skip + `localStorage.fm.wizardCompleted`); `HelpTooltip` + 13 topics; `/help` knowledge base из 7 markdown'ов; `FeedbackWidget` (bug/suggestion/question + Telegram fallback); `/admin/diagnostic` (7 параллельных проверок); `/whats-new` из `CHANGELOG.md`; `EmptyStateWithDemo`. |
-| **18** (TODO cleanup) | P0 race в `GenerateNumberAsync` через PostgreSQL advisory lock (`pg_advisory_xact_lock(orgHash, docTypeHash)`); `WhatsNewBanner` в AppLayout; color contrast WCAG-AA (19 файлов); `useFormatCurrency()` hook; audit-log UI filters (Кто/Дата с/по); `NotificationCenter` (bell-icon SignalR-popover). |
-| **19** (power UX) | Phase19a: Product.IsArchived + IsAvailableForSale (partial-index). `POST /api/catalog/products/bulk-update {ids, op, params}` — 5 операций (price-adjust %/абсолют, change-group, archive/unarchive, toggle-sale) одной транзакцией. `SavedPresets` chips (UserPreset jsonb). `QuickActionsPalette` (Cmd+J отдельно от Cmd+K). `InlinePriceCell` dblclick → input optimistic + revert. CSV import 1000 строк транзакцией. `ExportButton` (CSV/XLSX) на 5 контроллерах. Keyboard nav в DataTable (↑↓/Enter/Space/Delete). |
-| **20** (Mapster + maintenance) | TD-3: `MapsterConfig.cs` + `.ProjectToType<TDto>(MapsterConfig.Config)` вместо ручных Select-expression'ов. SSO scaffold: `Microsoft.AspNetCore.Authentication.Google` + `.MicrosoftAccount` (conditional registration); `ExternalAuthController` (503 если не настроено, 501 callback с email для invite-flow). 3 новых cleanup-job'a (org-audit-log >90д, drafts >30д, refresh-tokens revoked >7д). `DatabaseMaintenanceJobs.VacuumTopTablesAsync` (топ-5 таблиц, weekly). `DiskMonitoringJob` ежечасно + Telegram-alert <1GB + Prom-gauge `food_market_disk_free_bytes{mount}`. `~/nightly-perf-check.sh` baseline-comparison через `/metrics`. Astro layout: gtag/Yandex.Metrika placeholders + `docs/analytics.md`. |
-| **21** (prod toolchain) | `deploy/check-prod-readiness.sh` (backup<60min, disk≥5GB, /health, .env), `prod-deploy.sh` (blue-green :8088 + nginx upstream switch), `prod-rollback.sh` (atomic), `post-deploy-smoke.sh` (10 шагов JSON через python3 — на stage 10/10 ✓), `db-schema-diff.sh` (pg_dump через ssh+docker exec, sed-нормализация, diff -u), `generate-release-notes.sh` (git log → markdown group by prefix), `.forgejo/workflows/auto-tag.yml` (v<YYYYMMDD>.<N>). Все скрипты — `--dry-run`. |
-| **22** (data tooling) | Phase22a: `org_exports` таблица (jsonb config-like, unique download token). `POST /api/org/export` → Hangfire `OrgExportJob` собирает ZIP с JSON-файлами по каждой сущности → IObjectStorage + DownloadToken 64-hex + 24h TTL + email-notify. `POST /api/catalog/products/import/1c-csv` (Windows-1251 + auto-detect разделитель + русские заголовки). `deploy/anonymize-prod.sh` (PII обфускация: email→user{N}@example.kz, phone→+7700111{N:04}, passwords→тестовый hash, BIN/IIN синтетические, MoySkladToken=NULL). `DbSchemaDocsJob` weekly → `db-schema-generated.md` с mermaid ER-диаграммой. `POST /api/admin/audit-log/export?format=csv|jsonl` streaming. `GET /api/moysklad/sync-status` агрегат last-success / last-7d errors / pending. **Итог: финальный ARCHITECTURE.md (этот).** |
-
-## Production readiness (после 22 спринтов)
-
-### Реализовано полностью
-
-- Backend: auth (OpenIddict password+refresh+revoke), multi-tenant (query-filter + advisory locks), все 8 типов документов (Supply/Enter/Loss/Transfer/Inventory/RetailSale/Demand/SupplierReturn+CustomerReturn) с проводкой через Serializable transactions и ОФД-snapshot полями.
-- Каталог: products + barcodes + prices + images (thumb/medium WebP), groups (иерархия с Path), counterparties, units, currencies, countries, stores, retail-points.
-- Reports: Sales / Stock / Profit / ABC с CSV+XLSX export'ом, all multi-tenant.
-- Background: Hangfire с 10 recurring jobs (housekeeping, email-notify, telegram-summary, vacuum, disk-monitor, db-schema-docs).
-- Observability: Prometheus `/metrics` (HTTP + DB query duration + business counters + disk gauge), Serilog structured logging, /health/{live,ready} с DB-проверкой.
-- A11y: WCAG 2 AA color contrast, focus-trap в modal, axe-core spec-suite 0 critical, keyboard-nav (Cmd+K, Cmd+J, table ↑↓/Enter/Space/Delete).
-- Tests: 80%+ coverage на Application, integration tests с Testcontainers, e2e Playwright 44 specs зелёные на stage, k6 load baseline.
-- Web: React 19 + Vite + TS, AG Grid Community, TanStack Query, 200 KB initial bundle (gzip), inline-edit, bulk-операции, CSV import/export, SavedPresets, Cmd+J QuickActions, NotificationCenter.
-- POS: WPF на .NET 8, оффлайн-буфер SQLite, синк через `/api/pos/v1/*` с идемпотентным batch-ack, ОФД-провайдеры (Mock работает, реальные — scaffolding).
-- DevOps: backup-таймер с retention 30d, stage→prod toolchain (7 скриптов из Sprint 21), auto-tag workflow, anonymize-prod для безопасных stage-дампов.
-
-### Scaffolding (готово к подключению, но не активно)
-
-| Что | Где | Что нужно от user'а |
-|---|---|---|
-| **SSO Google** | `Authentication:Google:ClientId/Secret` | OAuth credentials с Google Cloud Console |
-| **SSO Microsoft** | `Authentication:Microsoft:ClientId/Secret` | OAuth credentials с Azure App Registration |
-| **ОФД Webkassa** | `OrganizationFiscal.{Endpoint,Login,Password,CashboxId}` | Договор + кассовый аппарат + creds |
-| **ОФД Kassa24 / ОФД-Соло** | то же | Договоры с провайдерами |
-| **MoySklad sync** | `Organization.MoySkladToken` | Per-org OAuth token у клиента |
-| **Telegram alerts** | `Monitoring:SuperAdminTelegramChatIds` | Chat-id'ы суперадминов |
-| **Yandex.Metrika / GA4** | env `PUBLIC_YM_ID` / `PUBLIC_GA_ID` | Счётчики у клиента |
-| **SMTP** | `PlatformSettings.Smtp*` | SendGrid / Mailgun / Yandex300 креды |
-| **MinIO storage** | `Storage:Minio:Endpoint/AccessKey/SecretKey` | S3-совместимый bucket (опц.) |
-
-### Не реализовано (требует отдельного решения)
-
-- **Прод-деплой** — toolchain готов (`deploy/prod-deploy.sh`), но реальный сервер не настроен (DNS, certbot, /etc/nginx/conf.d/food-market-upstream.conf).
-- **SSO callback flow** — `/api/auth/external/callback` возвращает 501 с email; нужен invite-flow + tokens-issuance.
-- **Kazakh-перевод** — i18n keys на русском; для прод-релиза в РК нужен носитель языка.
-- **POS Windows-тест** — POS-проект собирается на macOS/Linux но требует Windows для UI-тестов.
-- **Down-миграции** — EF Migration.Down() есть в коде, но не валидированы для прод-данных (data loss risk).
-- **Public marketing site SEO** — `food-market.kz` (Astro) собирается, но не задеплоен.
-
-### Файловая структура (актуальная)
-
-```
-food-market/
-├── src/
-│   ├── food-market.domain/           # POCO + interfaces + enums
-│   ├── food-market.application/      # DTO + handlers + mapping (Sprint 20)
-│   ├── food-market.infrastructure/   # EF + Identity + OpenIddict + integrations
-│   ├── food-market.api/              # Controllers + middleware + Hangfire jobs + storage
-│   ├── food-market.web/              # React admin SPA
-│   ├── food-market.public/           # Astro marketing site
-│   ├── food-market.shared/           # POS↔API DTO-контракты
-│   ├── food-market.pos.core/         # POS-логика (UI-agnostic)
-│   └── food-market.pos/              # WPF (.NET 8 Windows)
-├── tests/
-│   ├── food-market.UnitTests/        # xUnit + InMemory EF
-│   ├── food-market.IntegrationTests/ # xUnit + Testcontainers Postgres
-│   ├── e2e/                          # Playwright + ad-hoc smoke scenarios
-│   └── load/                         # k6 (retail-sales-parallel, signup-burst, …)
-├── deploy/
-│   ├── docker-compose.yml            # Postgres + api + web + (registry)
-│   ├── Dockerfile.{api,web,public}
-│   ├── nginx.conf                    # SPA + reverse-proxy
-│   ├── backup.sh / food-market-backup.* # systemd-timer ежедневный бэкап
-│   ├── check-prod-readiness.sh       # Sprint 21
-│   ├── prod-deploy.sh                # Sprint 21
-│   ├── prod-rollback.sh              # Sprint 21
-│   ├── post-deploy-smoke.sh          # Sprint 21
-│   ├── db-schema-diff.sh             # Sprint 21
-│   ├── generate-release-notes.sh     # Sprint 21
-│   └── anonymize-prod.sh             # Sprint 22
-├── docs/                             # 30+ markdown файлов
-├── .forgejo/workflows/               # CI (ci.yml, regression.yml, auto-tag.yml, …)
-└── food-market.sln
-```
-
-## Релиз-цикл
-
-1. Локально: `dotnet build` + `dotnet test` + `pnpm build`.
-2. `git push origin main` (Forgejo на 127.0.0.1:3000 — primary remote,
-   GitHub — mirror, memory `feedback_forgejo_primary`).
-3. `~/deploy-stage.sh` — docker build api+web → push в локальный registry
-   `192.168.1.193:5001` → ssh на prod-vm → `docker compose pull && up -d`.
-4. Health check на `https://test.admin.food-market.kz/health/ready`.
-5. Verify на stage (Playwright или ручной чек).
-6. Prod-деплой — пока ручной (TBD, нужен план от user'а).
-
-## Что ещё прочитать
-
-- [MULTI-TENANCY.md](MULTI-TENANCY.md) — query filter, SuperAdmin override, подводные камни.
-- [RUNBOOK.md](RUNBOOK.md) — операционные процедуры.
-- [DEVELOPER-GUIDE.md](DEVELOPER-GUIDE.md) — как начать вкладываться в код.
-- [ofd-integration.md](ofd-integration.md) — ОФД-провайдеры.
-- [openapi.md](openapi.md) — генерация TS-клиента из Swagger.
-- [observability.md](observability.md) — Serilog + Prometheus.
-- [secrets.md](secrets.md) — управление секретами в stage/prod.
-- [stage-access.md](stage-access.md) — как попасть на stage-сервер.
-- [backup-restore.md](backup-restore.md) — бэкапы.

docs/DEVELOPER-GUIDE.md

@@ -1,480 +0,0 @@
-# Developer guide — food-market
-
-Как поднять проект, что куда добавлять, какие паттерны соблюдать.
-Предполагается, что вы прочитали [ARCHITECTURE.md](ARCHITECTURE.md) и
-понимаете слои.
-
-## Локальный setup
-
-### Что нужно
-
-- **.NET 8 SDK 8.0.4xx** (см. `global.json`, `rollForward: latestFeature`
-  — годится любой 8.0.4xx).
-- **Node 20+** и **pnpm 9+** (для web).
-- **PostgreSQL 14+** — на macOS обычно brew `postgresql@14`.
-  БД: `food_market`, owner `nns`, пароль пустой.
-- **Docker** + **Docker Compose** — только для integration-тестов
-  (Testcontainers) и stage-деплоя.
-
-### Поднять с нуля
-
-```bash
-git clone http://127.0.0.1:3000/nns/food-market.git
-cd food-market
-
-# 1) БД (если ещё нет)
-createdb -O nns food_market   # пользователь nns должен существовать
-
-# 2) Backend
-ASPNETCORE_ENVIRONMENT=Development \
-    dotnet run --project src/food-market.api
-# первый запуск: применит миграции, посеит справочники, создаст
-# SuperAdmin admin@food-market.local / Admin12345!.
-# API на http://localhost:5081, Swagger на /swagger.
-
-# 3) Web (в другом терминале)
-cd src/food-market.web
-pnpm install
-pnpm dev
-# http://localhost:5173
-
-# 4) Smoke
-curl http://localhost:5081/health
-# и зайти в браузере, залогиниться admin@food-market.local
-```
-
-### Получить токен из CLI
-
-```bash
-TOKEN=$(curl -sX POST http://localhost:5081/connect/token \
-  -H "Content-Type: application/x-www-form-urlencoded" \
-  -d 'grant_type=password&username=admin@food-market.local&password=Admin12345!&client_id=food-market-web&scope=openid profile email roles api offline_access' \
-  | jq -r .access_token)
-curl -sH "Authorization: Bearer $TOKEN" http://localhost:5081/api/me | jq
-```
-
-## Запуск тестов
-
-```bash
-# Unit-тесты (быстрые, ~7-10с)
-dotnet test tests/food-market.UnitTests/
-
-# Integration (тянут Postgres-контейнер, ~30-60с на холодную)
-dotnet test tests/food-market.IntegrationTests/
-
-# Фильтр по имени класса/метода
-dotnet test tests/... --filter "FullyQualifiedName~Fiscal"
-
-# Web — type-check + production build
-cd src/food-market.web && pnpm exec tsc --noEmit && pnpm build
-
-# E2E (Playwright против stage)
-cd tests/e2e && pnpm install
-pnpm playwright test stage-smoke.spec.ts
-```
-
-### Гочи integration-тестов
-
-- **Testcontainers Ryuk** выключен (env `TESTCONTAINERS_RYUK_DISABLED=true`).
-  Причина: контейнер reaper тянет образ с Docker Hub, на dev-vm сеть
-  туда нестабильна.
-- **Rate-limiter** выключен через `RateLimiting__Enabled=false`. Он
-  читает конфиг ЭАГЕРНО при регистрации сервисов — поэтому только через
-  переменную окружения (см. memory `test_suites_setup`).
-- **Hangfire-сервер** выключен (`Hangfire__Enabled=false`) — иначе
-  создаёт схему и держит коннект в одноразовом контейнере.
-- Один `ApiFactory` на всю xUnit-сессию через `[Collection(ApiCollection.Name)]`.
-  Делать второй `WebApplicationFactory<Program>` параллельно нельзя —
-  `HostFactoryResolver` сломается.
-
-## Конвенции репо
-
-- C# 12, `Nullable` enabled, `ImplicitUsings` enabled.
-- Названия неймспейсов — `foodmarket.Domain`, `foodmarket.Application`,
-  `foodmarket.Infrastructure`, `foodmarket.Api`. Папки в `src/` —
-  `food-market.api`, `food-market.application`, … (с дефисом). Это
-  расхождение исторически — менять не нужно.
-- Названия таблиц в БД — snake_case (явный `b.ToTable("retail_sales")`),
-  столбцы — PascalCase из C# (EF default), индексы по
-  `IX_<table>_<cols>` (EF default).
-- Комментарии в коде — рассказывающие *почему*, не *что*. Если из имени
-  переменной/метода не понятно — переименуй; если из логики не понятно,
-  *почему* — комментируй.
-- XML-doc на public API в Application/Infrastructure обязателен (даёт
-  IntelliSense для другой стороны и появляется в Swagger).
-- Локализация UI — `src/lib/i18n.ts` (русский по умолчанию, есть
-  заготовка под KZ — нужен переводчик).
-
-## Паттерны: добавить controller с permission
-
-Пример: `POST /api/loyalty/programs` (создание программы лояльности),
-доступно только Admin'у орги или SuperAdmin'у в edit-mode.
-
-```csharp
-// food-market.api/Controllers/Loyalty/LoyaltyProgramsController.cs
-[ApiController]
-[Authorize]
-[Route("api/loyalty/programs")]
-public class LoyaltyProgramsController : ControllerBase
-{
-    private readonly AppDbContext _db;
-    private readonly ITenantContext _tenant;
-    private readonly ILogger<LoyaltyProgramsController> _log;
-
-    public LoyaltyProgramsController(
-        AppDbContext db, ITenantContext tenant, ILogger<LoyaltyProgramsController> log)
-    {
-        _db = db; _tenant = tenant; _log = log;
-    }
-
-    public record ProgramInput(
-        [Required] string Name,
-        [Range(1, 4)] int Type,
-        [Range(0, 1000)] decimal Rate,
-        bool IsActive);
-
-    [HttpPost, RequiresPermission("LoyaltyEdit")]
-    public async Task<ActionResult<Guid>> Create(
-        [FromBody] ProgramInput input, CancellationToken ct)
-    {
-        var p = new LoyaltyProgram
-        {
-            Name = input.Name.Trim(),
-            Type = (LoyaltyProgramType)input.Type,
-            Rate = input.Rate,
-            IsActive = input.IsActive,
-            // OrganizationId stamping применит в SaveChanges
-        };
-        _db.LoyaltyPrograms.Add(p);
-        await _db.SaveChangesAsync(ct);
-        _log.LogInformation(
-            "Loyalty program created: {ProgramId} {Name} org={OrgId}",
-            p.Id, p.Name, _tenant.OrganizationId);
-        return Ok(p.Id);
-    }
-}
-```
-
-Что произошло:
-
-- `[Authorize]` — JWT-токен обязателен (валидируется OpenIddict).
-- `[Route("api/...")]` — обычный REST-маршрут. `api/` префикс
-  обязателен для всех контроллеров (web-фронт ходит через `/api/*`,
-  nginx это знает).
-- `[RequiresPermission("LoyaltyEdit")]` — резолвится в policy `perm:LoyaltyEdit`,
-  handler проверяет `RolePermissions.LoyaltyEdit` булеву у роли
-  текущего юзера. Добавь поле в `RolePermissions.cs` если ещё нет,
-  миграция-`AddColumn` для `bool LoyaltyEdit NOT NULL DEFAULT false`
-  + апдейт admin-роли в сидере.
-- `ProgramInput` — record с DataAnnotations. Для сложной валидации —
-  отдельный FluentValidation `AbstractValidator<ProgramInput>` в
-  `food-market.api/Infrastructure/Validation/Validators.cs` (см.
-  паттерны там).
-- `_db.LoyaltyPrograms.Add(p)` без явного `OrganizationId` —
-  `StampTenant` в `SaveChangesAsync` подставит.
-- Логирование структурированное: `{ProgramId}`, `{Name}`, `{OrgId}` —
-  Serilog кладёт их как property'и (search'абельны в Loki/ES, не строкой).
-
-### Если нужен Admin-only (грубее)
-
-```csharp
-[HttpPut, Authorize(Roles = "Admin")]
-```
-
-это эквивалентно «или Identity-role Admin, или SuperAdmin в режиме
-override (через `SuperAdminOverrideClaimsTransformer`)». Подходит для
-редких операций; для регулярных используй `RequiresPermission`.
-
-## Паттерны: добавить сущность с RowVersion и tenant
-
-Допустим, нужна новая сущность `PromoCode`.
-
-### 1. Domain
-
-```csharp
-// food-market.domain/Sales/PromoCode.cs
-public class PromoCode : TenantEntity, IVersionedEntity
-{
-    public uint Xmin { get; set; }
-
-    public string Code { get; set; } = "";
-    public decimal Discount { get; set; }
-    public DateTime? ExpiresAt { get; set; }
-    public bool IsActive { get; set; } = true;
-}
-```
-
-`TenantEntity` даёт `Id`, `CreatedAt`, `UpdatedAt`, `OrganizationId`.
-`IVersionedEntity` + `Xmin` — оптимистичная блокировка через PG xmin.
-
-### 2. EF Configuration
-
-```csharp
-// food-market.infrastructure/Persistence/Configurations/SalesConfigurations.cs
-b.Entity<PromoCode>(e =>
-{
-    e.ToTable("promo_codes");
-    e.UseXminAsConcurrencyToken();
-    e.Ignore(x => x.Xmin);
-    e.Property(x => x.Code).HasMaxLength(40).IsRequired();
-    e.Property(x => x.Discount).HasPrecision(18, 4);
-    e.HasIndex(x => new { x.OrganizationId, x.Code }).IsUnique();  // ← OrganizationId первым!
-    e.HasIndex(x => new { x.OrganizationId, x.IsActive });
-});
-```
-
-**Важно**: индексы — с `OrganizationId` первым полем. Все запросы пройдут
-через query filter и будут фильтроваться по этому полю; без правильного
-индекса PG будет full-scan тенант-таблицы.
-
-### 3. DbSet
-
-```csharp
-// food-market.infrastructure/Persistence/AppDbContext.cs
-public DbSet<PromoCode> PromoCodes => Set<PromoCode>();
-```
-
-### 4. Миграция руками
-
-```csharp
-// food-market.infrastructure/Persistence/Migrations/20260608100000_PromoCodes.cs
-[DbContext(typeof(AppDbContext))]
-[Migration("20260608100000_PromoCodes")]
-public partial class PromoCodes : Migration
-{
-    protected override void Up(MigrationBuilder b)
-    {
-        b.CreateTable(
-            name: "promo_codes",
-            schema: "public",
-            columns: t => new
-            {
-                Id = t.Column<Guid>(type: "uuid", nullable: false),
-                OrganizationId = t.Column<Guid>(type: "uuid", nullable: false),
-                Code = t.Column<string>(type: "character varying(40)", maxLength: 40, nullable: false),
-                Discount = t.Column<decimal>(type: "numeric(18,4)", precision: 18, scale: 4, nullable: false),
-                ExpiresAt = t.Column<DateTime>(type: "timestamp with time zone", nullable: true),
-                IsActive = t.Column<bool>(type: "boolean", nullable: false, defaultValue: true),
-                CreatedAt = t.Column<DateTime>(type: "timestamp with time zone", nullable: false),
-                UpdatedAt = t.Column<DateTime>(type: "timestamp with time zone", nullable: true),
-            },
-            constraints: t => t.PrimaryKey("PK_promo_codes", x => x.Id));
-        b.CreateIndex(
-            name: "IX_promo_codes_OrganizationId_Code",
-            schema: "public", table: "promo_codes",
-            columns: new[] { "OrganizationId", "Code" }, unique: true);
-        b.CreateIndex(
-            name: "IX_promo_codes_OrganizationId_IsActive",
-            schema: "public", table: "promo_codes",
-            columns: new[] { "OrganizationId", "IsActive" });
-    }
-    protected override void Down(MigrationBuilder b)
-        => b.DropTable("promo_codes", "public");
-}
-```
-
-**Обязательно**: `[DbContext]` + `[Migration("...")]` атрибуты — без них
-`db.Database.Migrate()` миграцию не подхватит (memory:
-`feedback_ef_migrations`).
-
-### 5. Тест на изоляцию
-
-Добавить case в `TenantIsolationTests`: org A создаёт PromoCode, org B
-делает GET, видит пустой список.
-
-## Валидация
-
-### Простые правила — DataAnnotations
-
-```csharp
-public record ProductInput(
-    [Required, MaxLength(200)] string Name,
-    [Range(0, 1e10)] decimal Price);
-```
-
-### Сложные — FluentValidation
-
-В `food-market.api/Infrastructure/Validation/Validators.cs`:
-
-```csharp
-public sealed class ProductInputValidator : AbstractValidator<ProductInput>
-{
-    public ProductInputValidator()
-    {
-        RuleFor(x => x.Name).NotEmpty().MaximumLength(200);
-        RuleFor(x => x.Price).GreaterThanOrEqualTo(0);
-
-        // Кросс-полевые правила, async, реализующие бизнес-инвариант
-        RuleFor(x => x.Lines).NotEmpty().WithMessage("Хотя бы одна позиция.");
-        RuleForEach(x => x.Lines).ChildRules(line =>
-        {
-            line.RuleFor(l => l.Quantity).GreaterThan(0);
-            line.RuleFor(l => l.UnitPrice).GreaterThanOrEqualTo(0);
-        });
-    }
-}
-```
-
-Валидаторы регистрируются автоматически через
-`AddValidatorsFromAssemblyContaining<Program>()`. `ValidationFilter`
-(глобальный action-filter в Program.cs) запускает их на каждом
-action и возвращает 400 ProblemDetails (RFC 7807).
-
-### Бизнес-валидация (требует БД)
-
-Если правило требует справиться с БД (например, «склад существует и
-не архивирован»), вынесите в первый шаг action-метода:
-
-```csharp
-[HttpPost]
-public async Task<ActionResult> Create(ProductInput input, CancellationToken ct)
-{
-    var groupOk = await _db.ProductGroups.AnyAsync(g => g.Id == input.ProductGroupId, ct);
-    if (!groupOk)
-        return BadRequest(new { error = "Группа не найдена.", field = "productGroupId" });
-    // ...
-}
-```
-
-Формат ошибки — `{ error: "...", field?: "..." }`. Фронт показывает
-`error` тостом, `field` подсвечивает в форме.
-
-## Логирование
-
-Используем Serilog со структурированными полями. `LogEnrichmentMiddleware`
-уже добавляет `CorrelationId/OrgId/UserId` в каждую запись.
-
-### Правила
-
-- **Не строкой**: `_log.LogInformation("Created product " + id)` — нет.
-  `_log.LogInformation("Product created: {ProductId} name={Name}", id, name)` — да.
-- **Уровень**:
-  - `Trace/Debug` — только для отладки конкретного бага.
-  - `Information` — успешные mutate-операции, важные events
-    (post/unpost документа, регистрация чека в ОФД).
-  - `Warning` — что-то пошло не как ожидалось, но обработали
-    (best-effort fail, retry-able ошибка).
-  - `Error` — обработать не удалось, нужен внимательный человек.
-  - `Critical` — приложение в плохом состоянии, может перестать работать.
-- **Не логировать** PII в открытом виде (пароли, токены, email — email
-  можно, но не светить лишний раз).
-- **Exception как первый аргумент**: `_log.LogError(ex, "...", ...)`,
-  не `_log.LogError("... " + ex.Message)` — теряется stack trace.
-
-### Пример из RetailSalesController
-
-```csharp
-_log.LogInformation(
-    "RetailSale posted: {SaleNumber} store={StoreId} payment={Payment} lines={LinesCount} total={Total}",
-    sale.Number, sale.StoreId, sale.Payment, sale.Lines.Count, sale.Total);
-
-// ...
-
-try
-{
-    await _notify.PublishAsync(...);
-}
-catch (Exception ex)
-{
-    // Notification — best-effort: не должна валить транзакцию (она уже закоммичена)
-    _log.LogWarning(ex, "SignalR notify failed for sale {SaleId}", sale.Id);
-}
-```
-
-## SignalR realtime
-
-Если нужно отправить уведомление на фронт (инвалидация query'я,
-показ тоста):
-
-```csharp
-// в Program.cs INotificationsPublisher уже зарегистрирован
-public class MyController : ControllerBase
-{
-    private readonly INotificationsPublisher _notify;
-
-    [HttpPost("...")]
-    public async Task<IActionResult> Action(...)
-    {
-        // ... business logic ...
-        await _notify.PublishAsync(
-            organizationId,
-            NotificationEvents.SalePosted,    // строковая константа
-            new SalePostedPayload(...));      // record DTO
-        return NoContent();
-    }
-}
-```
-
-На фронте — `useNotifications()` хук подписан на хаб и инвалидирует
-relevant query'и. Новые event'ы добавлять в `NotificationEvents`,
-payload — в соседнем record'е.
-
-## Что НЕ делать
-
-- НЕ инжектить `IServiceProvider` чтобы доставать сервисы лениво —
-  объяви явные зависимости в конструкторе. Исключение: фабрики (Fiscal,
-  Email) которые открывают scope для свежего DbContext'а.
-- НЕ писать raw SQL (`SqlQueryRaw`/`ExecuteSqlRaw`) без явного
-  `WHERE OrganizationId = @org` — query-filter не применится.
-- НЕ менять снапшот в `Persistence/Migrations/AppDbContextModelSnapshot.cs`
-  руками для добавления новых полей — он используется только инструментом
-  `dotnet ef migrations add`, который мы не запускаем. Trying to add
-  partial state ломает только инструмент, ничего не дав. Если хочется —
-  обновляй целиком, синхронно с моделью; иначе оставь как есть.
-- НЕ добавлять платные компоненты: Kendo, DevExpress, Syncfusion
-  commercial, Telerik (CLAUDE.md).
-- НЕ менять `global.json` без согласования (CLAUDE.md).
-- НЕ создавать миграции через `dotnet ef migrations add` — пиши руками
-  (memory: `feedback_ef_migrations`).
-- НЕ делать `git push --force` на main (Forgejo — primary).
-
-## Что добавилось после первого релиза этого guide'а
-
-| Sprint | Чем пользоваться |
-|---|---|
-| 13 | `SensitiveOpsAudit` (`food-market.api/Infrastructure/Audit/`) — централизованный логгер sensitive-операций. Вместо ручного `OrgAuditLogs.Add` — `_audit.LogAsync(action, entityType, entityId, payload)`. |
-| 13 | `[RequiresPermission("X")]` уже было; добавился `MeSessionsController.RevokeAll` — пример работы с `IOpenIddictAuthorizationManager`. |
-| 13 | Все ответы автоматически получают security-заголовки через `SecurityHeadersMiddleware`. Если новый endpoint требует ослабленную CSP (например, embeds другой домен) — добавь его path в `ShouldSkip` middleware'a. |
-| 14 | Композитный индекс `(OrganizationId, …)` на новых таблицах — must. Для отчётных запросов с фильтром по статусу — добавляй partial index `WHERE Status = X` с `INCLUDE` (covering). |
-| 14 | `ImageVariantService` — при upload картинок автоматически генерирует thumb/medium WebP. Через frontend `<ProductImage src={url} size="thumb" />` — `<picture>` + srcset. |
-| 14 | Hangfire-jobs: `JobTimingFilter` глобально логирует длительность; >30с — Warning. Для своих jobs ничего настраивать не надо. |
-| 15 | `useFocusTrap` (`src/lib/useFocusTrap.ts`) — focus trap + return-focus для модалок. Уже подключён в `Modal` и `ConfirmDialog`. Для своего модала: `const ref = useFocusTrap<HTMLDivElement>(open)`. |
-| 15 | a11y: каждая icon-only `<button>`/`<a>` нуждается в `aria-label="..."` и `aria-hidden="true"` на иконке внутри. Поля формы с ошибкой — `aria-invalid={true}` + `aria-describedby="err-id"` + `<span id="err-id" role="alert">...</span>`. Цвет текста для маленького font'а — `text-slate-500` минимум (4.61 contrast), не `text-slate-400` (2.63, fails WCAG AA). |
-| 15 | Unit-coverage цель — 70% по строкам в Application+Domain. Добавляешь новую POCO → один touch-test в `DomainPocoSmokeTests`/`DomainFullPropertyTouchTests`. Property-based тест на бизнес-инвариант — `StockServicePropertyTests`-pattern (рандомные seed'ы, проверка инварианта). |
-
-## Что НЕ делать
-
-- НЕ инжектить `IServiceProvider` чтобы доставать сервисы лениво —
-  объяви явные зависимости в конструкторе. Исключение: фабрики (Fiscal,
-  Email) которые открывают scope для свежего DbContext'а.
-- НЕ писать raw SQL (`SqlQueryRaw`/`ExecuteSqlRaw`) без явного
-  `WHERE OrganizationId = @org` — query-filter не применится.
-- НЕ менять снапшот в `Persistence/Migrations/AppDbContextModelSnapshot.cs`
-  руками для добавления новых полей — он используется только инструментом
-  `dotnet ef migrations add`, который мы не запускаем. Trying to add
-  partial state ломает только инструмент, ничего не дав. Если хочется —
-  обновляй целиком, синхронно с моделью; иначе оставь как есть.
-- НЕ добавлять платные компоненты: Kendo, DevExpress, Syncfusion
-  commercial, Telerik (CLAUDE.md).
-- НЕ менять `global.json` без согласования (CLAUDE.md).
-- НЕ создавать миграции через `dotnet ef migrations add` — пиши руками
-  (memory: `feedback_ef_migrations`).
-- НЕ делать `git push --force` на main (Forgejo — primary).
-- НЕ использовать `text-slate-400` для маленьких подписей на белом
-  фоне — fails WCAG AA color contrast (Sprint 15). Минимум `text-slate-500`.
-- НЕ делать icon-only `<button>`/`<a>` без `aria-label` — Screen readers
-  пропустят его (Sprint 15 axe-core finding).
-
-## Полезные ссылки
-
-- [ARCHITECTURE.md](ARCHITECTURE.md) — слои и модули.
-- [MULTI-TENANCY.md](MULTI-TENANCY.md) — query-filter, override-режим,
-  расширенный чеклист «как добавить tenant-сущность».
-- [RUNBOOK.md](RUNBOOK.md) — операционные процедуры, recovery drill
-  (RTO ~25с подтверждённый).
-- [openapi.md](openapi.md) — генерация TS-клиента из Swagger.
-- [observability.md](observability.md) — Serilog + Prometheus + Grafana
-  dashboard JSON (Sprint 13).
-- [ofd-integration.md](ofd-integration.md) — ОФД-провайдеры (Sprint 11).
-- [performance-baseline.md](performance-baseline.md) — k6-замеры (Sprint 12, 14).
-- [secrets.md](secrets.md) — где живут секреты.

docs/MULTI-TENANCY.md

@@ -1,416 +0,0 @@
-# Multi-tenancy в food-market
-
-Один процесс API, одна БД, много организаций (тенантов). Каждый запрос
-видит только данные своей организации. Изоляция держится на двух вещах:
-
-1. **EF Core query filter** на каждой `ITenantEntity` (auto-инжектится
-   в `WHERE` каждого SQL-запроса).
-2. **Stamping в SaveChanges** — добавляемые сущности получают
-   `OrganizationId` из текущего `ITenantContext`.
-
-`SuperAdmin` — отдельная роль с правом обходить фильтр (видеть/менять
-всё). Чтобы не получить «случайные изменения по всем оргам сразу»,
-есть строгий режим «открыть как…» с двумя ступенями (read-only +
-edit-mode с reason).
-
-## Модель
-
-### Базовые интерфейсы
-
-```csharp
-// food-market.domain/Common/TenantEntity.cs
-
-public interface ITenantEntity        // обязательный orgId
-{
-    Guid OrganizationId { get; set; }
-}
-
-public abstract class TenantEntity : Entity, ITenantEntity
-{
-    public Guid OrganizationId { get; set; }
-}
-
-public interface IOptionalTenantEntity  // системный справочник
-{
-    Guid? OrganizationId { get; set; }
-}
-```
-
-### Когда использовать что
-
-| Случай | База |
-|---|---|
-| Бизнес-данные тенанта: продукты, чеки, контрагенты, отчёты | `TenantEntity` (обязательный orgId) |
-| Системные справочники с возможностью per-tenant расширения: `UnitOfMeasure`, `ProductGroup`, `Country` | `IOptionalTenantEntity` (null = системная, оrgId = tenant'овская) |
-| Корневая сущность тенанта: `Organization` | `Entity` (сама не tenant-scoped) |
-| Платформенные настройки: `PlatformSettings` (SMTP), OpenIddict-клиенты | `Entity` (singletons / cross-tenant) |
-| Audit-логи SuperAdmin'а: `SuperAdminAuditLog` | `Entity` (есть optional `OrganizationId` для фильтра, но сама не tenant-scoped) |
-
-## Tenant-контекст
-
-`ITenantContext` (Application слой) — единственный источник правды о
-том, кто сейчас делает запрос:
-
-```csharp
-// food-market.application/Common/Tenancy/ITenantContext.cs
-public interface ITenantContext
-{
-    Guid? OrganizationId { get; }     // null = SuperAdmin вне override, или нет JWT
-    bool IsAuthenticated { get; }
-    bool IsSuperAdmin { get; }
-    bool IsTenantOverride { get; }    // SuperAdmin в режиме «открыть как…»
-    Guid? UserId { get; }
-}
-```
-
-Реализация — `HttpContextTenantContext` (`food-market.api/Infrastructure/Tenancy/`).
-Источники данных в порядке приоритета:
-
-1. **AsyncLocal-override** (`UseOverride(orgId, isSuper)`) — для
-   background-tasks (Hangfire, импорт MoySklad, фоновые сидеры).
-   Когда нет HttpContext, нужно явно задать tenant перед `DbContext`-вызовом.
-2. **HTTP-заголовок `X-Org-Override`** — режим «открыть как…»
-   (только если у юзера роль SuperAdmin).
-3. **JWT claim `org_id`** — обычный tenant-юзер.
-
-```csharp
-// background-job пример
-using (HttpContextTenantContext.UseOverride(orgId, isSuperAdmin: false))
-{
-    // здесь _db применит фильтр на orgId
-    var products = await _db.Products.ToListAsync();
-}
-```
-
-## Query filter
-
-`AppDbContext.OnModelCreating` после регистрации всех сущностей
-рефлексией обходит модель и вешает фильтр на каждую `ITenantEntity`:
-
-```csharp
-// food-market.infrastructure/Persistence/AppDbContext.cs
-
-private void ApplyTenantFilter<T>(ModelBuilder builder) where T : class, ITenantEntity
-{
-    // SuperAdmin обходит фильтр ТОЛЬКО когда не в режиме «открыть как…».
-    // В override-режиме (X-Org-Override header активен) он работает в
-    // контексте конкретной орги — фильтр обязан применяться.
-    builder.Entity<T>().HasQueryFilter(e =>
-        (_tenant.IsSuperAdmin && !_tenant.IsTenantOverride)
-        || e.OrganizationId == _tenant.OrganizationId);
-}
-
-private void ApplyOptionalTenantFilter<T>(ModelBuilder builder) where T : class, IOptionalTenantEntity
-{
-    builder.Entity<T>().HasQueryFilter(e =>
-        (_tenant.IsSuperAdmin && !_tenant.IsTenantOverride)
-        || e.OrganizationId == null
-        || e.OrganizationId == _tenant.OrganizationId);
-}
-```
-
-Результат:
-
-- Tenant-юзер: `WHERE OrganizationId = '<его orgId>'`.
-- SuperAdmin без override: фильтр не применяется (видит всё).
-- SuperAdmin с `X-Org-Override`: `WHERE OrganizationId = '<выбранная orgId>'`.
-- `IOptionalTenantEntity`: видит свои + системные (`IS NULL`).
-
-## Stamping в SaveChanges
-
-`AppDbContext.SaveChanges/Async` зовут `StampTenant()`, который
-проходит по `Added`-entries:
-
-```csharp
-private void StampTenant()
-{
-    foreach (var entry in ChangeTracker.Entries())
-    {
-        if (entry.State != EntityState.Added) continue;
-        if (entry.Entity is ITenantEntity tenant && tenant.OrganizationId == Guid.Empty)
-        {
-            if (_tenant.OrganizationId.HasValue)
-                tenant.OrganizationId = _tenant.OrganizationId.Value;
-        }
-        else if (entry.Entity is IOptionalTenantEntity opt && opt.OrganizationId is null)
-        {
-            // SuperAdmin без override: оставляем null (системная запись)
-            // SuperAdmin с override / tenant-юзер: стампим текущий orgId
-            if (_tenant.IsSuperAdmin && !_tenant.IsTenantOverride) { /* null */ }
-            else if (_tenant.OrganizationId.HasValue)
-                opt.OrganizationId = _tenant.OrganizationId.Value;
-        }
-    }
-}
-```
-
-Это значит: контроллер может писать `_db.Products.Add(product)` без
-явного `product.OrganizationId = ...` — stamping подставит сам.
-**НО**: если код явно выставил `OrganizationId` (например, чтобы создать
-запись для другой орги в Hangfire-job), stamping её не перетрёт.
-
-## SuperAdmin override: режим «открыть как…»
-
-Конкретный поток с фронта:
-
-1. SuperAdmin заходит в «Системная консоль → Организации».
-2. Кликает «Открыть как…» на какой-то orgRow.
-3. Фронт начинает слать каждый запрос с заголовком
-   `X-Org-Override: <orgId>`. Без этого хедера SuperAdmin видит «своё»
-   (а у SuperAdmin'а часто нет своей орги, поэтому все списки пусты —
-   у супер-админа в админке тренировочный режим).
-4. По умолчанию режим **read-only** (`ReadonlyOverrideMiddleware`):
-   GET/HEAD/OPTIONS — пропускаются; PUT/POST/DELETE/PATCH — `403`.
-   Исключение: `/api/super-admin/*` и `/connect/*` (refresh-token).
-5. Чтобы что-то поменять, фронт показывает «Войти в edit-mode»,
-   запрашивает причину (≥ 10 символов), отправляет её в каждом запросе
-   как `X-Org-Override-Reason: <текст>`. Тогда middleware пропускает
-   мутации, а action-filter (`SuperAdminEditAuditFilter`) после успешного
-   ответа пишет строку в `super_admin_audit_log` с reason'ом и
-   запросом/ответом.
-6. Фронт ограничивает edit-mode 30 минутами (UI таймер).
-   Сервер не следит за временем — это UX-конвенция, а аудит уже есть.
-
-### ClaimsTransformer для tenant-ролей
-
-Тонкость: SuperAdmin сам по себе не имеет ролей `Admin/Storekeeper/Cashier`
-(они — атрибуты `Employee` тенанта). Контроллер
-`[Authorize(Roles="Admin")]` отшил бы его 403 даже в edit-mode.
-
-Решение: `SuperAdminOverrideClaimsTransformer` (`IClaimsTransformation`,
-вызывается на каждый authenticated request) — если есть `X-Org-Override`,
-динамически добавляет SuperAdmin'у `Admin/Storekeeper/Cashier` claim-роли
-**только на текущий запрос**. Записи в БД не трогает.
-
-## RequiresPermission: тонкая авторизация
-
-Для мутаций используется `[RequiresPermission("...")]` вместо
-`[Authorize(Roles="Admin,Storekeeper")]`. Атрибут резолвится через
-policy-механизм:
-
-```
-[RequiresPermission("ProductsEdit")]
-   → Policy "perm:ProductsEdit"
-   → PermissionAuthorizationPolicyProvider создаёт PermissionRequirement
-   → PermissionAuthorizationHandler проверяет
-     EmployeeRole.RolePermissions.ProductsEdit == true для текущего юзера
-```
-
-`RolePermissions` — это POCO с булевыми полями (`ProductsView`,
-`ProductsEdit`, `RetailSalesOperate`, `RetailSalesRefund`, …).
-`Employee.EmployeeRoleId` указывает на конкретную роль, у каждой —
-свой набор флагов. SuperAdmin (с override) проходит всегда.
-
-См. `food-market.api/Infrastructure/Authorization/`.
-
-## Audit-trail
-
-### `org_audit_log`
-
-Каждая `Add/Update/Delete` в `AppDbContext` (через
-`OrgAuditInterceptor`) пишет JSONB-diff в `org_audit_log`:
-
-```json
-{
-  "id": "...",
-  "organizationId": "...",
-  "userId": "...",
-  "entityType": "Product",
-  "entityId": "...",
-  "action": "Update",
-  "changesJson": { "before": {...}, "after": {...} },
-  "createdAt": "..."
-}
-```
-
-Фоновый Hangfire-job `prune-audit-log` (03:45) чистит записи старше
-180 дней.
-
-Сидеры/миграции выставляют `_db.SkipAudit = true` чтобы не плодить
-бессмысленные строки.
-
-### `super_admin_audit_log`
-
-Только мутации SuperAdmin'а в edit-mode, плюс изменения платформенных
-настроек. Без TTL — храним всё.
-
-## Известные подводные камни
-
-### 1. `IgnoreQueryFilters()` — когда нужно знать
-
-Тенант-фильтр применяется ко ВСЕМУ — в том числе там, где это «не надо».
-
-- При логине: ищем `Organization` по `OrgId` из credentials → нужен
-  `IgnoreQueryFilters()`, потому что фильтр требует OrganizationId,
-  которого ещё нет в контексте.
-- При проверке «есть ли у юзера эта орг»: `_db.Organizations.IgnoreQueryFilters().AnyAsync(...)`.
-- При cross-tenant отчётах SuperAdmin'а без override-режима фильтр и так
-  не применится, но при override — применится; чтобы получить
-  cross-tenant данные в этом режиме (редко нужно), вызвать
-  `IgnoreQueryFilters()` явно.
-
-### 2. Stamping не работает, если orgId уже задан
-
-Бэкенд-код в нескольких местах принимает `Guid OrganizationId` из payload
-(например, при импорте). Stamping проверяет `OrganizationId == Guid.Empty`
-и НЕ перетирает уже выставленное значение. Если кто-то по ошибке прислал
-чужой orgId в payload — он сохранится. Защита: явно валидировать
-`OrganizationId == _tenant.OrganizationId` в контроллере (или вообще не
-принимать поле из payload).
-
-### 3. Background-jobs без HttpContext
-
-`HangfireJobsConfigurator` регистрирует методы, исполняющиеся в фоне.
-`HttpContextAccessor.HttpContext` там null → `OrganizationId` тоже null →
-query filter возвращает только записи с `OrganizationId == null` (т.е.
-системные справочники), а tenant-запросы — пустоту.
-
-Решение: внутри job, перед `DbContext`-вызовом, обернуть в
-`HttpContextTenantContext.UseOverride(orgId, isSuperAdmin: false)`.
-См. `OwnerDailySummaryJob`, `EmailNotificationJobs` — там есть пример.
-
-### 4. SignalR за query-фильтром
-
-`NotificationsHub` использует `IServiceProvider.GetRequiredService<AppDbContext>()`
-внутри `OnConnectedAsync` для добавления соединения в group. Если в
-connection нет JWT — нет org_id — нет группы → клиент не получит
-событий. Web-фронт прокидывает `?access_token=...` query (см. middleware
-в Program.cs), POS — `Authorization` header.
-
-### 5. EF migrations и наследование от TenantEntity
-
-При добавлении новой `TenantEntity` миграция должна включать
-`OrganizationId` колонку (uuid, NOT NULL) и индекс
-`(OrganizationId, …)` для фильтрации. **Эта колонка не появляется
-автоматически в snapshot-выводе `dotnet ef migrations add`** в этом
-проекте, потому что снапшот не синхронизируется с моделью (миграции
-пишутся руками, см. memory `feedback_ef_migrations`).
-
-Проверка: после `Migrate()` тестовый запрос
-`SELECT column_name FROM information_schema.columns WHERE table_name='...'`
-должен показать `OrganizationId`.
-
-### 6. `xmin` concurrency и параллельные посты
-
-`UseXminAsConcurrencyToken()` на документах. Если два кассира одновременно
-постят один и тот же чек (что не должно случаться, но всё же) — второй
-получает `DbUpdateConcurrencyException`. Контроллер ловит и возвращает
-`409 Conflict` с сообщением «документ изменён в другой сессии, обновите
-страницу».
-
-Stock-операции — отдельная история: `Serializable` транзакция блокирует
-параллельный пост на тех же товарах в том же storе. Серверу `PG40001`
-(serialization_failure) — контроллер не ретраит автоматически, кассир
-видит 409 «недостаточно остатка» (после ретрая по факту достаточно или
-нет).
-
-### 7. Тестирование изоляции
-
-`TenantIsolationTests` (integration) — обязательный смок: создаём 2
-организации, в одной — продукт; в другой делаем `GET /api/catalog/products`
-→ список пустой. На любую новую `ITenantEntity` добавлять такой тест.
-
-### 8. Read-models / ad-hoc raw SQL
-
-Если контроллер напишет raw SQL через `_db.Database.SqlQueryRaw(...)`,
-EF-фильтр НЕ применится. Это используется только для отчётов с тяжёлой
-агрегацией (`ProfitReportController`); там OrganizationId явно
-включается в `WHERE` и приходит из `_tenant.OrganizationId`.
-Правило: никаких raw SQL без явного `WHERE OrganizationId = @org` в
-середине запроса.
-
-## Чеклист «как добавить новую tenant-сущность»
-
-Расширенная версия с RowVersion + permission + validation паттернами
-(Sprint 15). Минимальный «список из 6 пунктов» оставлен ниже как краткая
-форма.
-
-### Domain
-
-1. Унаследовать от `TenantEntity` (или реализовать `ITenantEntity`).
-2. Для **документов** (Supply, RetailSale, Loss…) — добавить
-   `IVersionedEntity` + `uint Xmin { get; set; }` для оптимистической
-   блокировки через PG xmin. EF переведёт concurrency-конфликт в
-   `DbUpdateConcurrencyException`, контроллер вернёт 409.
-
-### Infrastructure (EF Config + миграция)
-
-3. Добавить EF Configuration в
-   `food-market.infrastructure/Persistence/Configurations/`:
-   - `b.ToTable("snake_case");`
-   - Для документа: `b.UseXminAsConcurrencyToken(); b.Ignore(x => x.Xmin);`
-   - `b.Property(x => x.Number).HasMaxLength(50).IsRequired();` —
-     явные ограничения вместо EF-defaults.
-   - `b.Property(x => x.SomeDecimal).HasPrecision(18, 4);` — иначе EF
-     warning'и про missing precision.
-   - **Индекс с `OrganizationId` первым полем**:
-     `b.HasIndex(x => new { x.OrganizationId, x.SomeField });`.
-   - Уникальность в рамках org: `.IsUnique()` на том же composite-индексе.
-   - Sprint 14: для статусов-документов, по которым строятся отчёты —
-     ещё один composite `(OrganizationId, Status, Date)` или partial
-     индекс `WHERE Status = X AND NOT Y` с `INCLUDE` для covering.
-
-4. Создать миграцию руками в `Persistence/Migrations/`:
-   - Атрибуты `[DbContext(typeof(AppDbContext))]` + `[Migration("YYYYMMDDHHMMSS_NameHere")]`.
-     **Без них `Migrate()` миграцию не подхватит** (см. memory
-     `feedback_ef_migrations`).
-   - В `Up()` — `CreateTable` с колонкой `OrganizationId uuid NOT NULL`.
-   - Индексы (минимум один на OrganizationId).
-   - Не использовать `dotnet ef migrations add` — снапшот в репо
-     не синхронизируется с моделью.
-
-5. Добавить `DbSet<TEntity>` в `AppDbContext`.
-
-### Permission (RolePermissions)
-
-6. Добавить булевый флаг в `RolePermissions.cs`:
-   `public bool MyEntityEdit { get; set; }` + соответствующая запись в
-   `All()` фабрике (для системной роли Admin).
-7. Миграции для `role_permissions` не нужно — это JSONB-колонка
-   на `EmployeeRole`.
-8. Все Admin-роли уже получат новый permission через `RolePermissions.All()`.
-
-### Validation
-
-9. Для простой валидации — DataAnnotations на input-record'е:
-   `public record Input([Required, MaxLength(200)] string Name, …);`
-10. Для сложной — `FluentValidation` в
-   `food-market.api/Infrastructure/Validation/Validators.cs`:
-   - `public sealed class MyInputValidator : AbstractValidator<MyInput>`
-     с `RuleFor`/`RuleForEach`.
-   - Регистрируется автоматически (assembly-scan на старте).
-   - `ValidationFilter` в pipeline'е вызовет валидатор и вернёт 400
-     ProblemDetails (RFC 7807) до Action'а.
-11. Бизнес-валидация (требует БД — «существует ли поставщик»): в начале
-    action-метода вернуть `BadRequest(new { error, field })`.
-
-### Controller
-
-12. Контроллер использует `_db.MyEntities.Where(...)` — query filter
-    подключится автоматически. `StampTenant` в `SaveChangesAsync`
-    выставит `OrganizationId` в `Add()`.
-13. Защитить mutating endpoint'ы атрибутом
-    `[RequiresPermission("MyEntityEdit")]` (резолвится в policy
-    `perm:MyEntityEdit` → проверяет флаг на `RolePermissions`).
-14. Для concurrency-чувствительных мутаций (Post документа):
-    `await using var tx = await _db.Database.BeginTransactionAsync(
-        IsolationLevel.Serializable, ct)` — защита от race на остатке.
-
-### Audit (Sprint 13)
-
-15. CRUD автоматически логируется `OrgAuditInterceptor`'ом в
-    `org_audit_log` (JSON diff).
-16. Для sensitive-операций (смена пароля, выдача роли, изменение
-    permissions) — дополнительно через
-    `SensitiveOpsAudit.LogAsync()` — она пишет в `org_audit_log` +
-    Serilog с типизированным action-name.
-
-### Tests
-
-17. **Интеграционный тест на изоляцию** (`TenantIsolationTests`):
-    org A создаёт, org B делает GET — список пустой, GET-by-id → 404.
-18. Если есть concurrency-критика (Post под Serializable):
-    `RetailOversellingTests`-pattern — два параллельных VU гарантированно
-    дают 409 на одном из них.
-19. Для бизнес-инварианта (типа «Sum(movements) ≡ Stock»):
-    property-based test (см. `StockServicePropertyTests`, Sprint 15).

docs/ONBOARDING.md

@@ -1,275 +0,0 @@
-# Onboarding для нового разработчика food-market
-
-Этот документ — путь от «клонировал репо» до «открыл первый PR» за 3 дня.
-Если что-то не сходится с реальностью — это **баг документации**,
-отредактируй и оставь PR.
-
-## День 1 — установка и первый запуск
-
-### Что нужно
-
-- macOS / Linux. Windows только для POS WPF (см. отдельно ниже).
-- .NET 8 SDK (точная версия из `global.json` — `dotnet --list-sdks`
-  должен показывать её; если нет — `winget install Microsoft.DotNet.SDK.8`
-  / `brew install dotnet@8`).
-- Node.js 20+ (`nvm install 20 && nvm use 20`).
-- pnpm 9+ (`npm i -g pnpm`).
-- PostgreSQL 14+ (на macOS: `brew install postgresql@14 && brew services start postgresql@14`).
-- git, curl, python3 (для скриптов в `tests/e2e/`).
-- Docker для интеграционных тестов (Testcontainers) и stage-deploy.
-
-### Установка проекта
-
-```bash
-git clone http://192.168.1.193:3000/nns/food-market.git
-cd food-market
-
-# БД для dev — пустая, инициируется миграциями автоматически.
-createdb -U $USER food_market
-
-# Backend
-dotnet restore
-dotnet build food-market.sln -c Debug --nologo
-
-# Web frontend
-cd src/food-market.web && pnpm install && cd ../..
-```
-
-### Запуск
-
-```bash
-# Терминал 1: API
-ASPNETCORE_ENVIRONMENT=Development dotnet run --project src/food-market.api
-# → http://localhost:5081, Swagger на /swagger
-
-# Терминал 2: Web SPA
-cd src/food-market.web && pnpm dev
-# → http://localhost:5173
-```
-
-### Проверка что работает
-
-```bash
-# Health
-curl http://localhost:5081/health/ready
-
-# Зарегистрируйся
-curl -X POST http://localhost:5081/api/auth/signup \
-  -H "Content-Type: application/json" \
-  -d '{"organizationName":"DevOrg","email":"dev@local.test","password":"DevPass123!","phone":"+77001234567"}'
-
-# Логин и получи токен
-TOKEN=$(curl -sX POST http://localhost:5081/connect/token \
-  -d 'grant_type=password&username=dev@local.test&password=DevPass123!&client_id=food-market-web&scope=openid profile email roles api offline_access' \
-  | python3 -c 'import sys,json;print(json.load(sys.stdin)["access_token"])')
-
-# Что я могу
-curl -sH "Authorization: Bearer $TOKEN" http://localhost:5081/api/me | python3 -m json.tool
-```
-
-### Тесты
-
-```bash
-# Unit
-dotnet test tests/food-market.UnitTests --nologo
-
-# Integration (нужен Docker — Testcontainers поднимает Postgres-контейнер)
-dotnet test tests/food-market.IntegrationTests --nologo
-
-# E2E (Playwright против локального API)
-cd tests/e2e
-E2E_ADMIN_URL=http://localhost:5081 ./run.sh stage-smoke
-```
-
-## День 2 — где что лежит
-
-### Структура (укрупнённо)
-
-```
-food-market/
-├── src/
-│   ├── food-market.domain/          — POCO + enum'ы + интерфейсы. Без EF, без ASP.NET.
-│   ├── food-market.application/     — DTO, FluentValidation, MediatR-handler'ы, Mapster config.
-│   ├── food-market.infrastructure/  — EF Core, миграции, Identity, OpenIddict storage.
-│   ├── food-market.api/             — Controllers, middleware, Hangfire jobs, OpenIddict server.
-│   ├── food-market.web/             — React 19 + Vite SPA админки (admin.food-market.kz).
-│   ├── food-market.public/          — Astro marketing-сайт (food-market.kz).
-│   ├── food-market.shared/          — DTO-контракты сервер↔POS.
-│   ├── food-market.pos.core/        — POS-логика (UI-agnostic).
-│   └── food-market.pos/             — WPF (net8.0-windows; собирается на любой OS).
-├── tests/
-│   ├── food-market.UnitTests/       — xUnit + InMemory EF (быстрые юниты).
-│   ├── food-market.IntegrationTests/— xUnit + Testcontainers Postgres (через WebApplicationFactory).
-│   ├── e2e/                         — Playwright (TS) + ad-hoc Python smoke-скрипты.
-│   └── load/                        — k6 (нагрузочные).
-├── deploy/                          — Dockerfile.{api,web,public}, compose, nginx, скрипты (prod-deploy/rollback/smoke/anonymize/swagger-diff).
-├── docs/                            — markdown (этот файл — `ONBOARDING.md`, плюс ARCHITECTURE/RUNBOOK/etc).
-└── food-market.sln
-```
-
-### Что почитать в первую очередь
-
-Порядок имеет значение — от general к specific:
-
-1. **[ARCHITECTURE.md](ARCHITECTURE.md)** — общая картина: слои, deployment-топология, ключевые потоки, что реализовано / scaffolding / не реализовано (после 22 спринтов).
-2. **[glossary.md](glossary.md)** — все доменные термины (Tenant / Organization / Stock / RetailSale / …) с ссылками на классы.
-3. **[MULTI-TENANCY.md](MULTI-TENANCY.md)** — query-filter, SuperAdmin override, как не утечь cross-org.
-4. **[DEVELOPER-GUIDE.md](DEVELOPER-GUIDE.md)** — паттерны (CQRS-like, MediatR, валидаторы, Mapster), стиль кода, как добавлять новые endpoint'ы.
-5. **[api-reference.md](api-reference.md)** — auto-generated список всех 190+ endpoint'ов (обновляется weekly через Hangfire).
-6. **[error-codes.md](error-codes.md)** — каталог HTTP-кодов для humanizeError на фронте.
-7. **[secrets.md](secrets.md)** — env-vars + где хранятся секреты.
-8. **[observability.md](observability.md)** — Prometheus метрики, Serilog, /health.
-9. **[RUNBOOK.md](RUNBOOK.md)** — как разруливать инциденты («api не стартует», «остатки разъехались», и т.п.).
-10. **[performance-baseline.md](performance-baseline.md)** — k6 baseline + что НЕ масштабируется.
-
-### Sprint-history
-
-Хронология фич: `docs/sprint1-progress.md` … `docs/sprint28-progress.md`.
-Каждый — что было сделано + цифры. Полезно когда видишь странное имя
-файла и хочешь понять «когда и зачем».
-
-После Sprint 24 — серия "quality marathon":
-- **25** — hourly quality-watchdog (`~/quality-watchdog.sh`) с
-  auto-incident loop в Server-Claude очередь.
-- **26** — flaky-test detection (`tests/regression/find-flaky.sh`) +
-  observability stack (Grafana JSON + Prometheus alerts + RUNBOOK
-  action-per-alert).
-- **27** — cross-feature integration tests (`tests/integration/`) +
-  4-часовой soak (k6) + crash recovery (11.7s ≤ 30s SLA).
-- **28** — overnight maintenance: api-reference auto-gen fix
-  (195→240 endpoints), HSTS header на stage, integration spec
-  gap-fill (1C-CSV import, GDPR export, security headers).
-
-### Тестовый стенд
-
-- **Stage**: `https://test.admin.food-market.kz` — `~/deploy-stage.sh` собирает образ и катит. Подробности в [stage-access.md](stage-access.md).
-- **Prod**: `https://admin.food-market.kz` — НЕ деплоится автоматически (Sprint 21 toolchain готов, см. `deploy/prod-deploy.sh`, но реальный сервер не настроен).
-
-### Git workflow
-
-- Origin — Forgejo на `http://192.168.1.193:3000/nns/food-market.git`.
-  GitHub — mirror.
-- Никаких force-push'ей в main (после первого тэга).
-- Branch для серьёзных фич: `feat/<sprint>-<short-name>`, в Pull Request →
-  Squash & Merge.
-- Каждый коммит на собственной фиче — `feat(scope): subject` (см.
-  `git log --oneline` для примеров).
-
-## День 3 — первый PR
-
-### Найти первую задачу
-
-- `grep -rn "TODO\|FIXME" src/` — около 30 живых TODO. Самые маленькие
-  обычно UX-полировка (i18n, copy, validation message).
-- `docs/sprintNN-progress.md` последнего спринта → раздел «Открытые TODO».
-- В Forgejo Issues (если есть): bug-001..004 в `tests/e2e/reports/bugs/`
-  — некоторые фиксы уже сделаны, остаются follow-up'ы.
-- Слабый шаг: посмотри `docs/performance-baseline.md` раздел «Сводка:
-  что нужно поправить» — там список задач со статусом ✅/⚠️/❌.
-
-### Что сделать перед PR
-
-1. `git fetch origin && git rebase origin/main` (memory: `feedback_serialize_edits` —
-   мы один-коммитящий-за-раз; не делай параллельных правок).
-2. `dotnet build` + `dotnet test` (unit + integration) — должны быть зелёные.
-3. `pnpm -C src/food-market.web exec tsc --noEmit` — TS clean.
-4. Локальный smoke если правил controller'ы: запусти API + `curl` на затронутый
-   endpoint.
-5. Для UI: открой `/login` локально, проверь что страница работает.
-
-### Шаблон PR-сообщения
-
-```
-<тип>(scope): краткое описание
-
-Что: …
-Зачем: …
-Как тестировал: …
-Связанные issue/sprint: …
-
-Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>  (если работал в паре с Claude)
-```
-
-### Кодстайл
-
-- **C#**: дефолтный .NET-стиль. Один файл — один класс. Async/await везде
-  где I/O. EF-проекции через `.ProjectToType<TDto>(MapsterConfig.Config)`
-  для новых endpoint'ов (Sprint 20+).
-- **TS**: prettier+eslint конфиг в `src/food-market.web`. Hooks naming
-  `useFoo`. Server-state — TanStack Query, не useState.
-- **CSS**: только Tailwind utility-classes. Никаких inline styles.
-- **Комментарии**: только если объясняют **почему**, не **что**. Если
-  переписал паттерн — оставь reference на `[memory:feedback_serialize_edits]`
-  или sprint-doc.
-
-## FAQ
-
-### Q: API не стартует, ругается на global.json
-
-`dotnet --list-sdks` должен содержать ровно ту версию что в `global.json`
-(8.0.417). Если нет — установи SDK. **НЕ редактируй global.json** — это
-сломает CI и другие dev-машины.
-
-### Q: Integration-тесты падают с "Cannot find docker daemon"
-
-Включи Docker Desktop / `sudo systemctl start docker`. Testcontainers
-тащит `postgres:16-alpine` (один раз, потом из кеша).
-
-### Q: Web стартует но не видит API
-
-Проверь что `src/food-market.web/vite.config.ts` proxy указывает на
-`http://localhost:5081`. Если порт API изменился — обнови.
-
-### Q: Сертификат OpenIddict не создаётся
-
-Dev-режим: `App_Data/` должен быть writable. Прод: см.
-[openiddict-keys.md](openiddict-keys.md).
-
-### Q: Как добавить новую сущность
-
-Шаги (псевдо-flow):
-1. POCO в `src/food-market.domain/<Area>/MyEntity.cs` (от `TenantEntity` если связана с org'ой).
-2. DbSet + EntityTypeConfiguration в `src/food-market.infrastructure/Persistence/AppDbContext.cs` + `Configurations/`.
-3. Migration в `Migrations/<timestamp>_<name>.cs` — **ВРУЧНУЮ**, не через `dotnet ef migrations add`. Обязательны `[Migration("id")]` + `[DbContext(typeof(AppDbContext))]` (memory: `feedback_ef_migrations`).
-4. DTO + Validator в `src/food-market.application/<Area>/`.
-5. Mapster TypeAdapterConfig в `MapsterConfig.Build()` если есть нетривиальное проецирование.
-6. Controller в `src/food-market.api/Controllers/<Area>/`. Atomic per endpoint, multi-tenant через query-filter (автоматически).
-7. Integration-тест в `tests/food-market.IntegrationTests/<Area>Tests.cs` — минимум один happy-path.
-8. Если возвращаешь в Web — обновить `src/food-market.web/src/lib/types.ts`.
-
-### Q: Как запустить нагрузочный тест
-
-```bash
-cd tests/load
-BASE_URL=http://localhost:5081 k6 run retail-sales-parallel.js
-# или против stage:
-BASE_URL=https://test.admin.food-market.kz k6 run signup-burst.js
-```
-
-См. [performance-baseline.md](performance-baseline.md) для интерпретации цифр.
-
-### Q: Где POS WPF тестировать
-
-Нужен Windows. На macOS/Linux можно собрать (`dotnet build src/food-market.pos`)
-но не запустить UI. Тесты POS-логики в `src/food-market.pos.core` —
-кроссплатформенные.
-
-### Q: Хочу понять как работает …
-
-- **Tenant isolation** → `MULTI-TENANCY.md` + `AppDbContext.ApplyTenantFilter`.
-- **OpenIddict** → `openiddict-keys.md` + Program.cs `AddOpenIddict()`.
-- **POS sync с idempotency** → `food-market.pos.core` + `PosBatchAckController`.
-- **ОФД** → `ofd-integration.md` + `Infrastructure/Fiscal/`.
-- **CSV import** → `imports.md` + `ProductsController.ImportCsv`.
-- **GDPR org export** → `OrgExportJob` (Sprint 22).
-
-## Где спрашивать
-
-- Forgejo issues — для багов и feature requests.
-- В коде — поиск по docstring (комментарии часто отвечают «почему сделано
-  именно так»).
-- Sprint-progress файлы — там цифры и trade-off'ы зафиксированы.
-- Memory-файлы Claude Code в `~/.claude/projects/-home-nns-food-market/memory/`
-  — что-то типа CHANGELOG развития, более информально.
-
-Welcome! 🚀

docs/RUNBOOK.md

@@ -1,575 +0,0 @@
-# Runbook — операционные процедуры food-market
-
-Что делать, когда что-то идёт не так, или когда нужно сделать
-неавтоматическую операцию.
-
-## Контактные точки
-
-| Что | Где |
-|---|---|
-| Stage URL | https://test.admin.food-market.kz |
-| Prod URL | https://admin.food-market.kz (план, ещё не задеплоен) |
-| Stage VM | `nns@192.168.1.190` (через ssh, prod-vm в локалке) |
-| Dev VM (этот хост) | `nns@<this>` — здесь крутится локальный API/Postgres + локальный Forgejo + локальный Docker registry |
-| Forgejo (primary git) | http://127.0.0.1:3000/nns/food-market.git |
-| GitHub (mirror) | https://github.com/nurdotnet/food-market (только зеркало) |
-| Local Docker registry | `192.168.1.193:5001` (memory: `local_docker_registry`) |
-| Hangfire Dashboard (stage) | https://test.admin.food-market.kz/hangfire — только SuperAdmin |
-| Swagger (stage) | https://test.admin.food-market.kz/swagger |
-
-## Health-чеки
-
-| Endpoint | Что значит | Что делать при 503 |
-|---|---|---|
-| `GET /health` | Процесс отвечает | Контейнер живёт, проблема в обвязке (nginx/cert/DNS). |
-| `GET /health/live` | Процесс жив (без проверок) | То же. |
-| `GET /health/ready` | БД отвечает + миграции применены | См. ниже «Health/ready упал». |
-| `GET /metrics` | Prometheus exposition | Если 404 — приложение не стартануло. |
-
-### `/health/ready` упал
-
-1. `ssh nns@192.168.1.190 'docker logs --tail 100 food-market-stage-api'` —
-   стек ошибки на старте.
-2. Типичные причины:
-   - **Миграция упала**: ищем `Failed executing DbCommand` / `relation
-     "..." already exists`. Решение: миграция конфликтует со снапшотом
-     БД. Возможно её надо переписать с `IF NOT EXISTS` (см.
-     `Phase6e_RetailSaleReturns.cs` как пример «defensive migration»).
-   - **OpenIddict cert pass mismatch**: переменная
-     `OpenIddict__CertPassword` в docker-compose env'е не совпадает с
-     паролем PFX-файла → `CryptographicException: PKCS12 password incorrect`.
-   - **Connection refused**: Postgres контейнер не успел подняться.
-     `depends_on.condition: service_healthy` должно это покрывать,
-     но если healthcheck не успел — `docker compose restart api`.
-3. Если фикс требует кода — `~/deploy-stage.sh` после правки.
-
-## Деплой на stage
-
-```bash
-~/deploy-stage.sh
-```
-
-Скрипт делает:
-1. `docker build` api и web с локальным registry в качестве кеша.
-2. `docker push` обоих образов в `192.168.1.193:5001`.
-3. `ssh nns@192.168.1.190` → `docker compose -p food-market-stage pull api web` → `up -d --force-recreate`.
-4. Ждёт `https://test.admin.food-market.kz/health/ready` до 30с.
-
-**Важно**: проект `docker compose` называется `food-market-stage`
-(флаг `-p food-market-stage`). См. инцидент ниже про project name.
-
-## Бэкап и восстановление
-
-### Расписание
-
-systemd-таймер `food-market-backup.timer` (см. `deploy/`) запускается
-**каждый день в 03:00 локального времени** prod-vm. Запускается через
-`OnCalendar=*-*-* 03:00:00` + `Persistent=true` (догоняет пропущенные
-если сервер был выключен).
-
-Скрипт `food-market-backup.sh`:
-- `pg_dump -Fc` из контейнера `food-market-postgres` → `db-<TS>.dump`.
-- `tar czf` каталога `/opt/food-market-data/uploads` → `uploads-<TS>.tgz`.
-- Удаляет файлы старше 30 дней (`FM_BACKUP_RETENTION_DAYS`).
-
-Папка: `/opt/food-market-data/backups/`.
-
-### Ручной бэкап
-
-```bash
-ssh nns@192.168.1.190 'sudo /opt/food-market/deploy/food-market-backup.sh'
-```
-
-Или из репо разработчика:
-```bash
-deploy/backup.sh --remote 192.168.1.190:5434   # PG в Docker exposed на 5434
-```
-
-### Recovery drill (RTO ≈ 25 секунд на сегодняшних данных)
-
-Sprint 15 — verified восстановление stage'а в свежий PG-контейнер на dev-vm:
-
-| Шаг | Время |
-|---|---|
-| `pg_dump -Fc` из stage-postgres | **~2 секунды** (на 1.5k чеков / 200 продуктов) |
-| Создать чистый Docker-контейнер `postgres:16-alpine` | ~1 сек |
-| `pg_restore --clean --if-exists --no-owner --no-privileges` | **~4 секунды** |
-| Поднять API против восстановленной БД | ~19 сек (cold-start dotnet + migrations) |
-| `/health/ready` → `{"status":"Healthy"}` | подтверждено |
-| **Всего RTO (single-instance)** | **~25 секунд** |
-
-Команды, выполненные в drill'е:
-
-```bash
-# 1. Снять бэкап со stage'а
-ssh nns@192.168.1.190 'docker exec food-market-stage-postgres-1 \
-  pg_dump -U food_market -d food_market -Fc -f /tmp/drill.dump'
-ssh nns@192.168.1.190 'docker cp food-market-stage-postgres-1:/tmp/drill.dump /tmp/drill.dump'
-scp nns@192.168.1.190:/tmp/drill.dump /tmp/drill.dump
-
-# 2. Чистый PG
-docker run -d --name drill-pg \
-  -e POSTGRES_DB=food_market \
-  -e POSTGRES_USER=food_market \
-  -e POSTGRES_PASSWORD=drill_pass \
-  -p 127.0.0.1:5499:5432 postgres:16-alpine
-
-# 3. Восстановление
-docker cp /tmp/drill.dump drill-pg:/tmp/drill.dump
-docker exec drill-pg pg_restore -U food_market -d food_market \
-  --clean --if-exists --no-owner --no-privileges /tmp/drill.dump
-
-# 4. Проверка: API на восстановленной БД
-ASPNETCORE_ENVIRONMENT=Production \
-  ConnectionStrings__Default="Host=localhost;Port=5499;Database=food_market;Username=food_market;Password=drill_pass" \
-  Hangfire__Enabled=false \
-  ASPNETCORE_URLS="http://127.0.0.1:5099" \
-  RateLimiting__Enabled=false \
-  dotnet run --project src/food-market.api
-
-curl http://127.0.0.1:5099/health/ready
-# → {"status":"Healthy", checks:[{"name":"database","status":"Healthy",
-#    "description":"БД доступна, миграции применены."}]}
-
-# Очистка
-docker rm -f drill-pg
-```
-
-Для прод-данных большего объёма (50k+ чеков) RTO будет ~2-5 минут — но
-порядок остаётся: pg_restore линейно по данным + API startup константный.
-
-### Восстановление БД из дампа
-
-> ⚠️ Перезаписывает данные. Сначала остановить API.
-
-```bash
-ssh nns@192.168.1.190
-cd /opt/food-market
-
-# 1. Остановить API/Web, оставить Postgres
-docker compose -p food-market-stage stop api web
-
-# 2. Применить дамп
-DUMP=/opt/food-market-data/backups/db-YYYYMMDD-HHMMSS.dump
-docker exec -i food-market-stage-postgres \
-    pg_restore -U food_market -d food_market \
-    --clean --if-exists --no-owner --no-privileges \
-    < "$DUMP"
-
-# 3. Поднять API обратно — миграции применятся автоматически (idempotent)
-docker compose -p food-market-stage up -d api web
-
-# 4. Проверить
-curl https://test.admin.food-market.kz/health/ready
-```
-
-### Восстановление uploads
-
-```bash
-ssh nns@192.168.1.190
-cd /opt/food-market-data
-sudo tar xzf backups/uploads-YYYYMMDD-HHMMSS.tgz
-# Содержимое восстанавливается в текущий каталог (uploads/...)
-```
-
-### Полный disaster-recovery (новый сервер)
-
-1. Поднять Docker, склонировать репо в `/opt/food-market`.
-2. Скопировать бэкапы в `/opt/food-market-data/backups/`.
-3. Запустить пустой стек:
-   ```bash
-   cd /opt/food-market/deploy
-   docker compose -p food-market-stage up -d postgres
-   docker compose -p food-market-stage exec postgres pg_isready
-   ```
-4. Применить дамп (см. выше).
-5. Восстановить uploads.
-6. Запустить остальное: `docker compose -p food-market-stage up -d`.
-7. Поднять nginx + сертификат (см. `docs/stage-access.md`).
-8. Включить таймер бэкапов:
-   ```bash
-   sudo cp deploy/food-market-backup.{service,timer} /etc/systemd/system/
-   sudo systemctl daemon-reload
-   sudo systemctl enable --now food-market-backup.timer
-   ```
-
-## Перенос на другой сервер
-
-1. На старом — снять свежий бэкап вручную.
-2. На новом — поднять Docker, склонировать репо, восстановить (см. выше).
-3. Обновить DNS A-запись `admin.food-market.kz` на новый IP.
-4. Дождаться распространения DNS (TTL).
-5. Старый сервер — выключить через 24 часа (для гарантии).
-
-## Смена SDK-версии
-
-> ⚠️ `global.json` фиксирует `8.0.417` с `rollForward: latestFeature`.
-> Менять только когда вышел новый patch и Microsoft анонсировал
-> EOL текущего. memory: НЕ переключать systemwide postgres версию.
-
-1. На dev-машине: `dotnet --list-sdks` — проверить что новая версия
-   установлена.
-2. Обновить `global.json` → новый patch.
-3. `dotnet build` + `dotnet test`.
-4. `deploy/Dockerfile.api` — обновить `FROM mirror/dotnet-sdk:X.Y`
-   (если тэг изменился).
-5. `~/deploy-stage.sh` — задеплоить, проверить `/health/ready`.
-6. Verify-suite (Playwright или вручную smoke).
-7. Только после этого — менять на prod-машине.
-
-## Логи
-
-| Где | Что |
-|---|---|
-| `docker logs food-market-stage-api` (по контейнеру) | Console JSON Serilog. |
-| `/opt/food-market-data/api-logs/` (Docker volume) | Файлы Serilog rolling. |
-| `journalctl -u food-market-backup.service --no-pager` | Логи бэкапа. |
-| Hangfire Dashboard `/hangfire` | Состояние фоновых джобов, истории, ошибки. |
-
-Формат JSON-логов — структурированный, каждая запись содержит
-`CorrelationId`, `OrgId`, `UserId` (через `LogEnrichmentMiddleware`).
-Поиск по `CorrelationId` восстанавливает полный trace запроса.
-
-## Метрики
-
-Prometheus scrape: `GET /metrics` (без auth). Локально в проекте нет
-prometheus-сервера — на stage его тоже пока нет; план — поднять
-prometheus + grafana отдельным compose'ом и proxy через nginx.
-
-Ключевые метрики (`food-market.api/Infrastructure/Observability/AppMetrics.cs`):
-
-- `food_market_posted_total{document_type="..."}` — счётчик post'ов.
-- `food_market_unposted_total{document_type="..."}` — счётчик unpost'ов.
-- `food_market_db_query_duration_seconds_*` — гистограмма EF-запросов
-  (interceptor).
-- Стандартные prometheus-net: `http_requests_received_total`,
-  `http_request_duration_seconds`, `dotnet_collection_count_total`,
-  etc.
-
-## Известные инциденты
-
-### Инцидент 1: docker-compose project name
-
-**Симптом** (наблюдался при первой миграции на новый stage):
-- `docker compose pull && up -d` создавали контейнеры с именами
-  `deploy-api-1` вместо ожидаемых `food-market-stage-api`.
-- Healthcheck'и `depends_on` отрабатывали по новым именам, но nginx
-  configurated на старые — 502 Bad Gateway.
-
-**Причина**: `docker compose` берёт project name из имени каталога,
-если не указан `-p`. Каталог `deploy/` → project=`deploy` → контейнеры
-с префиксом `deploy-`. Старые контейнеры с префиксом `food-market-stage-`
-оставались стопнутыми, новые поднялись параллельно (Docker не считает
-их дубликатами потому что имена разные).
-
-**Решение**: всегда передавать `-p food-market-stage`. Сделано в
-`~/deploy-stage.sh`. На prod ставить аналогичный wrapper-скрипт,
-не запускать `docker compose` голым из `/opt/food-market/deploy`.
-
-**Превенция**: в будущем — `COMPOSE_PROJECT_NAME=food-market-stage`
-в `/etc/environment` на серверах, чтобы голый `docker compose` тоже
-не промахивался.
-
-### Инцидент 2: GHCR network flakiness
-
-**Симптом**: docker push/pull в `ghcr.io` периодически зависает на
-2-5 минут или падает по TCP-таймауту.
-
-**Причина**: исходящая сеть с dev-vm к github.com нестабильна
-(memory: `network_github_flaky`).
-
-**Решение**: используем **локальный Docker registry** на
-`192.168.1.193:5001` как primary, ghcr только как mirror (для
-external CI/CD когда понадобится). Stage compose тянет с локального
-(`REGISTRY=192.168.1.193:5001`). См. memory `local_docker_registry`.
-
-### Инцидент 3: OpenIddict cert rotation
-
-**Симптом**: после `docker compose down -v` (с удалением volume
-`api-data`) OpenIddict не может расшифровать существующие refresh-токены
-→ все пользователи разлогинены.
-
-**Причина**: keys из `App_Data/oidc-keys/` пропали вместе с volume.
-
-**Решение / превенция**:
-- НИКОГДА не делать `down -v` на stage/prod без явного намерения.
-- Хранить `App_Data` volume отдельно: `volumes: api-data:` с
-  `external: true` (план).
-- Бэкап `App_Data` вместе с БД (TODO: добавить в `food-market-backup.sh`).
-
-### Инцидент 4: rate-limiter eager-config
-
-**Симптом** (в integration-тестах): тесты падают с `429 Too Many Requests`
-после ~5 signup'ов.
-
-**Причина**: `RateLimiting:Enabled=true` (default) читается ЭАГЕРНО при
-регистрации сервисов; `ConfigureAppConfiguration` в `WebApplicationFactory`
-применяется позже и не успевает override'нуть.
-
-**Решение**: в integration-тестах ставим `RateLimiting__Enabled=false`
-через переменную окружения **до** создания factory. Сделано в
-`ApiFactory` static-конструкторе. Memory: `test_suites_setup`.
-
-### Инцидент 5: Telegram chat-id привязка
-
-**Симптом**: владелец org вводит chat_id, сервер тестирует отправку →
-`403 Forbidden` от Telegram API.
-
-**Причина**: пользователь не отправил `/start` боту перед привязкой,
-бот не может писать первым.
-
-**Решение / превенция**: UI показывает инструкцию «1. Откройте бота → `/start`.
-2. Получите chat_id у `@userinfobot`. 3. Введите.» Это идёт сверху на
-странице привязки. Бэкенд возвращает ошибку с понятным текстом.
-
-### Инцидент 6: Identity password policy 
-
-**Симптом**: signup-форма принимает пароль `12345`, потом
-`/connect/token` отшивает «Invalid credentials» — потому что Identity
-сам не разрешил создать пользователя с таким паролем, но контроллер
-проглотил ошибку.
-
-**Превенция**: контроллер `AuthController.Signup` теперь возвращает
-`IdentityResult.Errors` массивом → фронт показывает причину.
-
-## Troubleshooting на стороне БД
-
-### Большой `org_audit_log`
-
-`prune-audit-log` каждый день чистит >180 дней; если каталог-tenant
-делал массовый импорт (10к товаров за раз), таблица может вырасти на
-порядок. Проверка:
-```sql
-SELECT pg_size_pretty(pg_total_relation_size('org_audit_log'));
-SELECT count(*) FROM org_audit_log WHERE created_at < now() - interval '30 days';
-```
-
-Ручная чистка:
-```sql
-DELETE FROM org_audit_log WHERE created_at < now() - interval '90 days';
-VACUUM ANALYZE org_audit_log;
-```
-
-### Stock-агрегат расходится с движениями
-
-Инвариант: `stocks.quantity = SUM(stock_movements.quantity)` per
-`(product_id, store_id)`. Если разошёлся (баг где-то не вызвали
-`IStockService.ApplyMovementAsync`):
-
-```sql
--- найти расхождения
-SELECT s.product_id, s.store_id, s.quantity AS cached,
-       COALESCE(SUM(m.quantity), 0) AS actual
-FROM stocks s
-LEFT JOIN stock_movements m
-    ON m.product_id = s.product_id AND m.store_id = s.store_id
-GROUP BY s.product_id, s.store_id, s.quantity
-HAVING s.quantity <> COALESCE(SUM(m.quantity), 0);
-
--- пересчитать всё (под maintenance window!)
-UPDATE stocks s SET quantity = COALESCE((
-    SELECT SUM(quantity) FROM stock_movements m
-    WHERE m.product_id = s.product_id AND m.store_id = s.store_id
-), 0);
-```
-
-### `__EFMigrationsHistory` рассинхрон
-
-Бывает после ручной правки миграции после её применения.
-```sql
-SELECT * FROM "__EFMigrationsHistory" ORDER BY 1 DESC LIMIT 5;
-```
-Если в коде есть миграция, которой нет в таблице — `db.Database.Migrate()`
-попытается её применить (что обычно и нужно). Если в таблице есть запись,
-а файла нет — обратное направление (миграция была удалена) — `Migrate()`
-не упадёт, но фокус с EF Tools перестанет работать, см. memory
-`feedback_ef_migrations`.
-
-## Sprint 26 — Alert response (`deploy/prometheus/alerts.yml`)
-
-Каждый alert в `alerts.yml` имеет `runbook` label — anchor сюда.
-Junior-разработчик находит alert в Telegram, кликает runbook_url, попадает
-на соответствующий раздел.
-
-### api-down
-
-**Alert:** `ApiDown` — `up{job="food-market-api"} == 0` 1 минуту.
-
-**Что значит:** Prometheus не может scrap'нуть `/metrics`. API либо упал,
-либо порт недоступен.
-
-**Действия:**
-1. `curl -fsS https://test.admin.food-market.kz/health/ready` —
-   подтверди что API недоступен (или вернулся).
-2. `ssh nns@192.168.1.190 'docker ps | grep food-market-stage-api'` —
-   контейнер живой?
-3. Если контейнер в `Restarting`: `docker logs --tail 200 food-market-stage-api-1`
-   — стек ошибки старта (часто миграция / OpenIddict cert mismatch).
-4. Если контейнер OK, но не отвечает: `docker exec food-market-stage-api-1 curl
-   -s http://localhost:8080/health` (внутренний порт). Если внутри отвечает,
-   проблема в nginx/proxy цепочке.
-5. Recovery: `cd ~/food-market-stage/deploy && docker compose -p
-   food-market-stage up -d --force-recreate api`.
-6. Если не помогло: `~/deploy-stage.sh` с локального dev-vm (полный
-   build+push+restart).
-
-### rps-drop
-
-**Alert:** `RpsDropped50Percent` — RPS за 5 мин <50% от того же окна час
-назад, при условии что было >0.5 rps.
-
-**Действия:**
-1. `curl https://test.admin.food-market.kz/health/ready` — API живой?
-2. `ssh nns@192.168.1.190 'docker logs --tail 50 food-market-stage-api-1'`
-   — внезапные ошибки на старте/в логе.
-3. Проверь DNS из дома/мобильной сети: `dig admin.food-market.kz` —
-   возможно сломалась запись.
-4. Откати последний deploy: `cd ~/food-market-stage/deploy && git log -1
-   --format=%H && docker compose pull && docker compose up -d`. Если
-   откат на предыдущий image помог — баг в новом коде, см. логи.
-
-### http-errors-spike
-
-**Alert:** `HttpErrorsSpike` — доля 5xx >10% уже 5 минут.
-
-**Действия:**
-1. Logs: `ssh nns@192.168.1.190 'docker logs --tail 200 food-market-stage-api-1 | grep -iE "(error|exception)"'`.
-2. Какая ручка валится: `curl https://test.admin.food-market.kz/metrics |
-   grep 'http_requests_received_total.*code="5'` — топ-3 контроллеров.
-3. Hangfire-failed: `curl -u admin /hangfire/jobs/failed` (нужен
-   SuperAdmin login).
-4. Часто — БД упала. См. `db-p95-high` раздел ниже.
-5. Если баг локален (только одна ручка валится): найди фикс, deploy.
-
-### http-errors-growing
-
-**Alert:** `HttpErrorRateGrowing` — производная 5xx растёт >10%/min 10 мин.
-
-**Действия:** Постепенная деградация, не emergency. Часто — память течёт
-или коннекшен-пул исчерпывается.
-1. Memory: `docker stats food-market-stage-api-1` (ratio %).
-2. PG connections: `psql ... -c "SELECT count(*), state FROM pg_stat_activity GROUP BY state"`
-   — если `idle in transaction` много, есть leak.
-3. Restart api: `docker compose -p food-market-stage restart api` —
-   куплено время.
-4. Найди корень в логах — кто часто получает Exception.
-
-### doc-posting-errors
-
-**Alert:** `DocumentPostingErrors` — типа документов > 0.05 ошибки/сек 5 мин.
-
-**Действия:**
-1. `docker logs food-market-stage-api-1 | grep "Posting failed"` —
-   ищи название документа в логе.
-2. Hangfire failed: документы постятся через Hangfire-job — посмотри
-   `/hangfire/jobs/failed`.
-3. Stock-инвариант: `Posting failed: stock would be negative` означает
-   попытку списать больше чем есть. Это бизнес-уровневая ошибка, не баг.
-   Сообщи владельцу org. Если ошибок много — возможно баг в pre-validate.
-4. Concurrent posting: `Posting failed: serialization conflict` — это
-   Sprint 23 `SerializationConflictMiddleware` ловит и возвращает 409.
-   Если не возвращает 409 а 500 — middleware сломался, проверь deploy.
-
-### db-p95-high
-
-**Alert:** `DbQueryP95High` — p95 DB-запросов >500ms 10 минут подряд.
-
-**Действия:**
-1. Самые медленные запросы:
-   ```sql
-   SELECT calls, mean_exec_time, total_exec_time, query
-   FROM pg_stat_statements ORDER BY mean_exec_time DESC LIMIT 10;
-   ```
-2. Если статистика устарела: `ANALYZE` всей БД (`vacuum-top-tables`
-   Hangfire-job делает это раз в неделю, см. `DatabaseMaintenanceJobs`).
-3. Lock'и: `SELECT * FROM pg_locks WHERE NOT granted;` — заблокирована ли
-   какая-то таблица.
-4. Disk: см. `disk-free-low` ниже — если IO упирается в диск.
-5. Если новый медленный запрос в логе после deploy — откати relevant
-   контроллер.
-
-### disk-free-low
-
-**Alert:** `DiskFreeLow` — < 5 ГБ свободно на mount.
-
-**Действия:**
-1. `df -h` — какой mount упал.
-2. Logs: `du -sh /var/lib/docker/containers/*/`. Логи Docker'a иногда
-   разрастаются. Truncate: `truncate -s 0 /var/lib/docker/containers/*/.log`.
-3. БД growth: `psql -c "SELECT pg_size_pretty(pg_database_size('food_market'))"`.
-   Если >50 ГБ — запусти PruneStockMovements + VACUUM FULL под maintenance
-   (см. ниже).
-4. Quality-watchdog test orgs: `PruneQualityTestOrgs` Hangfire-job (cron
-   02:30 UTC) удаляет старые `quality-{epoch}-*` org'и (см.
-   `[[sprint25_done]]`). Если не отработал: trigger вручную через
-   `/hangfire`.
-5. Очисти `~/.fm-watchdog/quality.log.*` старее 14 дней (auto-ротация уже есть).
-
-### watchdog-red
-
-**Alert:** `WatchdogLastRunRed` — quality-watchdog последний прогон красный
->5 мин.
-
-**Действия:**
-1. Открой `docs/quality-status.md` в репо — сразу видно какой шаг упал.
-2. Тот же шаг сам и воспроизведёшь:
-   ```bash
-   /home/nns/quality-watchdog.sh   # сразу прогоняет всё
-   tail -50 ~/.fm-watchdog/quality.log   # детали последнего шага
-   ```
-3. Дальше зависит от шага:
-   - `health` — см. `api-down`.
-   - `auth_me` / `products` / `signalr` — см. `http-errors-spike`.
-   - `multi_tenant` — см. `multi-tenant-violation` (КРИТИЧНО).
-   - `perf` — см. `db-p95-high`.
-   - `ui_flow` — Playwright-тест. Прогон вручную: `cd tests/regression &&
-     pnpm exec playwright test flows/03-catalog.spec.ts --grep "3.1" --headed`.
-
-### multi-tenant-violation 🚨
-
-**Alert:** `MultiTenantViolation` — шаг multi_tenant упал в последнем часу.
-
-**ЭТО P0.** Org B видит данные A — это утечка между арендаторами.
-
-**Действия (немедленные):**
-1. Останови stage'е приём новых signup'ов (косвенно — поставь
-   `RateLimiting__SignupPerIpPerHour=0`, redeploy api).
-2. `tail -100 ~/.fm-watchdog/quality.log` — детали leak'а (`get_code`,
-   `list_total`).
-3. В коде проверь `AppDbContext.ApplyTenantQueryFilter` (см. `[[sprint22_done]]`):
-   ```bash
-   grep -n "ApplyTenantQueryFilter\|IgnoreQueryFilters" src/food-market.infrastructure/Persistence/
-   ```
-   Кто-то добавил `IgnoreQueryFilters()` где не надо? Это самая частая
-   причина leak'ов.
-4. Воспроизведи руками: создай 2 org'и (`curl POST /api/auth/signup` × 2),
-   токен для каждого, попробуй cross-access. Если воспроизводится —
-   фикс ASAP.
-5. После фикса — `~/deploy-stage.sh`, дождись зелёного watchdog'a.
-6. Если на prod уже катилось: notify владельцев (через Telegram-summary
-   job), audit-log за последние 48ч (`/api/admin/audit?since=...`) на
-   подозрительные cross-org операции.
-
-### watchdog-incident
-
-**Alert:** `WatchdogIncidentCreated` — 2+ подряд красных прогона ⇒ incident-файл.
-
-**Действия:**
-1. `ls -lt ~/.fm-watchdog/incident-*.txt | head -3` — последние инциденты.
-2. `cat ~/.fm-watchdog/incident-{...}.txt` — описание + действия.
-3. Server-Claude автоматически получит этот файл в очередь (через
-   `~/fm-watchdog.sh` → ротацию queue). Не дублируй — он начнёт фикс сам.
-4. Если хочешь форсировать вмешательство: тот же файл sent'нул в
-   `~/.fm-watchdog/queue/0000-incident-XXX.txt` (uname-prefix `0000` →
-   первый в очереди).
-
-## Что НЕ делать
-
-- НЕ менять `global.json` без явного решения (CLAUDE.md).
-- НЕ переключать systemwide postgres версию через brew (поломает
-  смежные проекты в `~/Documents/devprojects/`).
-- НЕ запускать `docker compose down -v` на stage/prod (потеря volume).
-- НЕ делать миграции через `dotnet ef migrations add` — снапшот в репо
-  не синхронный с моделью, генератор выдаст ерунду. Пишем руками.
-- НЕ редактировать тот же файл одновременно с Mac-Claude (memory:
-  `feedback_serialize_edits`).

docs/TZ-доработка.md

@@ -1,221 +0,0 @@
-# ТЗ на доработку Food Market
-
-> Дата составления: 2026-05-22
-> Автор анализа: Claude Opus 4.7
-> Базируется на полном обходе кодовой базы `~/food-market` (backend + web + public + tests + deploy).
-
----
-
-## 1. Текущее состояние системы
-
-### 1.1. Сводная таблица готовности по модулям
-
-| Модуль / слой | Статус | Готовность | Ключевой комментарий |
-|---|---|---:|---|
-| **food-market.domain** | ✅ готово | 95% | 26 сущностей, мультитенантность через `ITenantEntity`/`IOptionalTenantEntity`, чисто (нет TODO/HACK). |
-| **food-market.infrastructure** | ✅ готово | 90% | EF Core 8, query filters, MailKit SMTP, StockService, MoySkladClient, 34 миграции. |
-| **food-market.api (контроллеры)** | ✅ готово | 85% | 27 контроллеров, ~120 endpoint'ов, OpenIddict (password + refresh), CRUD полный. |
-| **food-market.application** | 🟡 частично | 60% | Только DTO + интерфейсы, нет MediatR handlers — вся логика в контроллерах. |
-| **food-market.web (админка)** | ✅ готово | 95% | 35 страниц, темная тема, адаптив, RU-локаль, onBlur-валидация. |
-| **food-market.public (сайт)** | ✅ готово | 90% | Astro 4: landing, тарифы, блог, KB, legal; SignupForm → API. |
-| **food-market.shared (POS контракты)** | ❌ нет | 0% | Только .csproj, ни одного CS-файла. |
-| **food-market.pos.core + food-market.pos** | ❌ скелет | 5% | Пустой WPF-проект, только зависимости в .csproj. |
-| **POS Sync API** | ❌ нет | 0% | Нет `/api/pos/sync`, нет `/api/pos/sales bulk`, нет WebSocket. |
-| **Documents: Supply / RetailSale** | ✅ готово | 100% | Полный цикл (Draft → Post → Unpost), Stock + Movement, Cost (скользящее среднее). |
-| **Documents: Inventory / Loss / Enter / Transfer** | ❌ нет | 0% | Нет контроллеров и страниц. Domain-сущности тоже не определены. |
-| **Documents: Demand (оптовая отгрузка)** | ❌ нет | 0% | Только enum `MovementType.WholesaleSale`, контроллера/сущности нет. |
-| **Reports** | ❌ нет | 5% | Есть `/api/sales/retail/stats` для дашборда, отдельных отчётов нет. |
-| **MoySklad интеграция** | 🟡 частично | 50% | Импорт товаров и контрагентов ✅; нет Demand/Payment sync, нет webhook'ов. |
-| **OpenIddict auth** | ✅ готово | 100% | Password + refresh_token; org_id, role, sub claims; persistent dev-ключи. |
-| **Multi-tenancy** | ✅ готово | 95% | Query filters + `HttpContextTenantContext`; SuperAdmin override read-only/edit. |
-| **Permission-based authz (RolePermissions)** | 🟡 частично | 30% | 30+ флагов в БД, но контроллеры проверяют только Roles (Admin/Cashier и т.д.). |
-| **SuperAdmin Console** | ✅ готово | 95% | Organizations CRUD, audit log, archive/restore, platform settings (SMTP); биллинг-KPI заглушка. |
-| **Hangfire** | 🟡 частично | 40% | `ReferencePriceRefreshJob` ✅; нет dashboard, нет scheduled cleanup, нет retry. |
-| **Email (SMTP)** | ✅ готово | 100% | MailKit, DataProtection-шифрование пароля, forgot-password flow. |
-| **Платёжные интеграции (Kaspi/Halyk/Jusan)** | ❌ нет | 0% | Упомянуты только в маркетинге; есть `PaymentMethod` enum, реальных шлюзов нет. |
-| **ОФД (фискализация чеков РК)** | ❌ нет | 0% | Поля `FiscalSerial`/`FiscalRegNumber` есть в RetailPoint, отправки чеков нет. |
-| **Маркетплейсы (Ozon, Wildberries, Kaspi Magazin)** | ❌ нет | 0% | Только маркетинговые баннеры. |
-| **CI/CD (Forgejo Actions)** | ✅ готово | 90% | docker-api/web/public + smoke-тест /health после деплоя; self-hosted runner. |
-| **Docker / docker-compose (stage)** | ✅ готово | 95% | postgres:16 + api + web + public + persistent volumes + local registry. |
-| **E2E тесты** | 🟡 частично | 40% | Один сценарий `full-cycle` (12 шагов), отчёт в md; нет регрессии и параллелизма. |
-| **Backend unit/integration тесты** | ❌ нет | 0% | Совсем. В CI стоит `\|\| echo "No tests yet"`. |
-| **Logging / Serilog** | ✅ готово | 90% | Console + File с ротацией 14 дней; нет structured fields для бизнес-событий. |
-| **Health checks (детальные)** | 🟡 частично | 20% | Только `/health` → {status:ok}; нет проверки БД, SMTP, диска. |
-| **Метрики / observability** | ❌ нет | 0% | Нет Prometheus/AppInsights/OpenTelemetry. |
-| **Rate limiting** | 🟡 частично | 15% | Только в `forgot-password` (3/час/IP, in-memory). |
-| **Backup БД** | 🟡 частично | 60% | `deploy/backup.sh` есть, но не привязан к cron/timer, restore-скрипта нет. |
-
-### 1.2. Что точно работает (готово к продакшен-использованию)
-
-- **Регистрация → онбординг → ежедневная работа магазина** (товары, цены, приёмки, розничные продажи, остатки).
-- **Управление пользователями и ролями**, soft-delete, передача владельца, восстановление пароля по email.
-- **SuperAdmin-консоль платформы** (создание/архивирование организаций, SMTP, аудит).
-- **Импорт каталога из МойСклад** (товары + контрагенты, асинхронный job с прогрессом).
-- **Полный stage-стенд** на docker-compose с локальным registry и автодеплоем через Forgejo Actions.
-
-### 1.3. Где точно не получится запуститься без доработки
-
-- **Невозможно работать с физическим магазином без ККМ-фискализации** (РК требует чеки в ОФД).
-- **Невозможно вести полноценный складской учёт** — нет инвентаризации, оприходования, списания, перемещения.
-- **Нет аналитики/отчётов** — только сводка на дашборде, ABC-анализа, отчёта по поставщикам/прибыли нет.
-- **Нет POS-приложения** — главная ценность проекта (offline-касса на Windows) — пустой проект.
-- **Нет защиты от перебора паролей** в основных endpoint'ах (login/signup), только в forgot-password.
-
----
-
-## 2. ТЗ на доработку по приоритетам
-
-### Приоритет P0 — блокеры запуска в продакшен
-
-| # | Задача | Что сделать | Зачем |
-|---:|---|---|---|
-| P0-1 | **Production-сертификаты OpenIddict** | Заменить `App_Data/openiddict-dev-key.xml` на реальные RSA/X.509 сертификаты, читать из KeyVault или secrets. | Сейчас токены подписываются dev-ключом без шифрования access-token. В проде это утечка claims. |
-| P0-2 | **HTTPS на nginx** | Настроить TLS-termination на reverse-proxy (Let's Encrypt через certbot), форсировать HTTPS-only, добавить HSTS. | OAuth/refresh_token нельзя гонять по HTTP. |
-| P0-3 | **Rate limiting на login/signup** | Добавить `Microsoft.AspNetCore.RateLimiting` (sliding window) на `/connect/token`, `/api/auth/signup`. 5 попыток/минута/IP, 20/час/IP. | Перебор паролей и DOS публичного signup. |
-| P0-4 | **Health check БД** | Расширить `/health` на `/health/live` (alive) + `/health/ready` (DB ping, миграции применены). Использовать `Microsoft.Extensions.Diagnostics.HealthChecks`. | Сейчас docker-compose `healthcheck` возвращает 200 даже когда БД упала — стейдж не падает корректно. |
-| P0-5 | **Permission-based authorization** | В `RolePermissions` (Domain) уже 30+ флагов. Реализовать `PermissionHandler` (IAuthorizationHandler) + атрибут `[RequiresPermission("ProductsEdit")]`, проверять в контроллерах вместо `[Authorize(Roles=...)]`. | Без этого все Admin'ы организации имеют полные права, кастомные роли (Менеджер/Кладовщик/Кассир) — фикция. |
-| P0-6 | **Автоматический backup БД** | Создать systemd-timer (`food-market-backup.timer`) на ежедневный запуск `deploy/backup.sh`, добавить restore-инструкцию в `docs/`. Хранить 30 дней локально + копия в S3/MinIO. | Сейчас бэкап делается вручную, восстановления не отрепетировали. |
-| P0-7 | **ОФД фискализация РК** | Интегрировать одного оператора (например, Webkassa или ОФД-Соло, КГД РК), отправлять `RetailSale.Post` чек, сохранять QR-код и фискальный номер в `RetailSale.FiscalQrCode`/`FiscalNumber`. | В РК продажа без чека ОФД — административное правонарушение. Без этого нельзя продавать. |
-| P0-8 | **.env.example + документация secrets** | Описать все required env-переменные (`ConnectionStrings__DefaultConnection`, `Cors__AllowedOrigins`, `Smtp__*`, `OpenIddict__Issuer`, `OFD__Token`). Обновить `docs/stage-setup.md`. | Сейчас новый деплой не задокументирован. Передача знаний из головы — узкое место. |
-| P0-9 | **Чек-листы перед релизом** | Документ `docs/release-checklist.md`: миграции применены, бэкап свежий, smoke-тесты прошли, E2E full-cycle зелёный, мониторинг здоров. | Снижает риск выкатки в проде сломанной версии. |
-
-### Приоритет P1 — важные функциональные пробелы
-
-| # | Задача | Что сделать | Зачем |
-|---:|---|---|---|
-| P1-1 | **Документ «Оприходование» (Enter)** | Domain-сущность `Enter` + `EnterLine` (как Supply, но без поставщика). Контроллер CRUD + Post/Unpost. UI-страницы `/inventory/enters`. Создаёт `StockMovement` с типом `Enter`. | Нужно вводить начальные остатки и излишки инвентаризации без поставщика. |
-| P1-2 | **Документ «Списание» (Loss)** | Domain-сущность `Loss` + `LossLine` (причина: брак, истечение срока, бой, недостача). Контроллер + UI. `StockMovement` тип `WriteOff`. | Списание брака — обязательная функция магазина. |
-| P1-3 | **Документ «Перемещение» (Transfer)** | Domain `Transfer` + `TransferLine` (FromStore → ToStore). Контроллер с атомарной транзакцией (списание + поступление). UI-форма. | В сети магазинов товар постоянно перемещается между складами. |
-| P1-4 | **Документ «Инвентаризация» (Inventory)** | Domain `Inventory` + `InventoryLine` (book qty, actual qty, diff). Контроллер с импортом текущих остатков + Post создаёт корректирующее движение `InventoryAdjustment`. UI-форма с CSV-импортом фактического количества. | Регулярная сверка остатков — обязательно для розницы. |
-| P1-5 | **Документ «Оптовая отгрузка» (Demand)** | Domain `Demand` + `DemandLine` (покупатель, способ оплаты — наличные/безнал, цена опт.). Контроллер. UI-страницы. `StockMovement` тип `WholesaleSale`. | Часть клиентов работает с юрлицами, отгрузка по накладной с НДС. |
-| P1-6 | **Возврат от покупателя (CustomerReturn)** | Расширить `RetailSale` опцией «Возврат» (по чеку или без). Domain enum `MovementType.CustomerReturn` уже есть. UI: кнопка «Создать возврат» из посту-проведённой продажи. | Закон о защите прав потребителей в РК требует приёма возвратов. |
-| P1-7 | **Возврат поставщику (SupplierReturn)** | По аналогии с CustomerReturn для Supply. UI: «Возврат поставщику» из проведённой приёмки. | Брак, неликвид, отказ от партии. |
-| P1-8 | **Отчёт «Продажи»** | `/api/reports/sales` с группировкой по периодам (день/неделя/месяц), товарам, кассирам, кассам, способам оплаты. UI: страница `/reports/sales` с фильтром периода и экспортом в CSV/XLSX. | Без отчёта по продажам управлять бизнесом невозможно. |
-| P1-9 | **Отчёт «Остатки на дату»** | `/api/reports/stock` с восстановлением остатков на любую дату через `StockMovement` журнал. UI с экспортом. | Налоговый учёт, инвентаризация. |
-| P1-10 | **Отчёт «Прибыль»** | `/api/reports/profit` — выручка - себестоимость по периодам/группам/товарам. Используем `Cost` snapshot из `RetailSaleLine`. | Главный показатель магазина. |
-| P1-11 | **Отчёт «ABC-анализ»** | Топ товаров по выручке/прибыли/маржинальности за период. Группа A/B/C по правилу Парето. | Управление ассортиментом. |
-| P1-12 | **POS Sync API** | Endpoints: `GET /api/pos/sync?since={ts}` (товары, цены, остатки, контрагенты с изменениями после ts); `POST /api/pos/sales` (батч продаж с idempotency-key). Контракты в `food-market.shared`. | Без этого POS-приложение не может синхронизироваться с сервером. |
-| P1-13 | **POS WPF MVP** | Минимальный UI: логин кассира (привязка к RetailPoint), список товаров/поиск по штрихкоду, корзина, оплата (нал/карта), печать чека (с ОФД), оффлайн-буфер на SQLite, фоновая синхронизация. | Главная фича проекта по позиционированию. |
-| P1-14 | **MoySklad — Demand sync** | Импорт оптовых отгрузок (демандов) из МойСклад. Расширить `MoySkladImportService`. | Текущая интеграция только односторонняя для каталога; продажи не синхронизируются. |
-| P1-15 | **MoySklad — webhook на изменения** | Получать webhook'и от МойСклад при изменении товаров, автоматически обновлять каталог (вместо ручного «Импортировать сейчас»). | Двусторонняя живая синхронизация. |
-| P1-16 | **Hangfire dashboard** | Подключить `Hangfire.Dashboard` с авторизацией только для SuperAdmin. Добавить scheduled jobs: ежедневный cleanup `StockMovement` (старше 2 лет), audit-log (старше 90 дней), eтиничные jobs (e.g. рассылка email). | Сейчас jobs запускаются только вручную через AdminCleanupController; нет видимости. |
-| P1-17 | **Метрики Prometheus** | Подключить `prometheus-net.AspNetCore` (`/metrics` endpoint). Базовый набор: http_requests_total, http_request_duration, db_query_duration, business: sales_count, supply_posted_count, errors_total. | Без observability нельзя гнать прод. |
-| P1-18 | **Аудит мутаций tenant'а** | Расширить `SuperAdminAuditLog` на обычные org-мутации (`OrgAuditLog`): кто, когда, что изменил в Supply/Sale/Product/Counterparty. Хранить diff JSON. | Розница часто судится с сотрудниками по поводу пропавших товаров — нужны доказательства. |
-| P1-19 | **OpenAPI спецификация** | Включить `Swashbuckle.AspNetCore`. Опубликовать `/swagger/v1/swagger.json` (только в Dev) и сгенерировать TypeScript-клиент для food-market.web. | Удалит ручной труд по типизации API в фронте и POS. |
-| P1-20 | **Unit-тесты критичной логики** | Покрыть xUnit'ом: `StockService.ApplyMovement`, расчёт Cost при `SuppliesController.Post`, расчёт автонаценки по `ProductGroup.MarkupPercent`, валидация платежа `RetailSalesController.Post`, multi-tenant query filter. | Без этих тестов любое изменение логики Supply/Sale = потенциально баг с минусовыми остатками или потерями денег. |
-| P1-21 | **Integration-тесты на тестовой БД** | `Testcontainers.PostgreSql` + `WebApplicationFactory`. Покрыть: signup-flow, supply post→unpost, retail sale post с overselling, tenant isolation (org A vs org B), permission проверки. | Регрессия на каждый коммит в CI. |
-| P1-22 | **Email-нотификации** | Готовый MailKit-сервис расширить шаблонами: приглашение сотрудника (с временным паролем), еженедельный отчёт владельцу, low-stock alert. Хранить шаблоны в `Resources/EmailTemplates/*.html`. | Сейчас email отправляется только при forgot-password. |
-
-### Приоритет P2 — желательные улучшения
-
-| # | Задача | Что сделать | Зачем |
-|---:|---|---|---|
-| P2-1 | **Платёжный шлюз Kaspi Pay** | Интеграция Kaspi Pay QR (касса показывает QR, покупатель оплачивает с приложения, callback фиксирует оплату в RetailSale). | Самый популярный способ безнала в РК. |
-| P2-2 | **Платёжные шлюзы банков** | Halyk Epay, Jusan Pay, Forte Pay (POS-терминал API или e-commerce). | Альтернативы Kaspi. |
-| P2-3 | **Интеграция с маркетплейсами** | Ozon Seller API, Wildberries, Kaspi Magazin — синхронизация остатков и цен (исходящая), импорт заказов (входящая). | Расширение каналов продаж. |
-| P2-4 | **2FA для админов** | TOTP (Google Authenticator) для роли Admin и SuperAdmin. Использовать `Identity.AddDefaultTokenProviders` + `AuthenticatorTokenProvider`. | Защита платёжного функционала. |
-| P2-5 | **SSO (Google/Microsoft)** | Расширить OpenIddict внешними провайдерами для логина персонала. | UX для офисных сотрудников. |
-| P2-6 | **Многоязычность (en/kz)** | Подключить `react-i18next` в web, выделить русские строки в `locales/ru.json`. Перевести интерфейс на казахский (государственное требование). | Государство РК требует госязык в публичных интерфейсах. |
-| P2-7 | **WebSocket / SignalR для real-time** | Push-уведомления на дашборд (новая продажа), кассе (изменение цены), импортах (вместо polling). | UX + снижение нагрузки от polling. |
-| P2-8 | **Аналитика на public-сайте** | Google Analytics или Yandex.Metrika, A/B тесты pricing'а, события signup-конверсии. | Маркетинг. |
-| P2-9 | **Mobile-приложение (PWA или React Native)** | Просмотр остатков, продаж, KPI для владельца. | UX для владельцев. |
-| P2-10 | **Распознавание чеков (OCR)** | Загрузка фото чека от поставщика → распознавание → автозаполнение Supply. | Уменьшение ручного ввода. |
-| P2-11 | **Электронные счёт-фактуры (ЭСФ)** | Интеграция с ИС ЭСФ КГД РК (выпуск счетов-фактур для юрлиц). | Часть оптовых клиентов требует ЭСФ. |
-| P2-12 | **Бонусные программы / скидочные карты** | Domain: `LoyaltyProgram`, `LoyaltyCard`. Списание/начисление в RetailSale. | Удержание клиентов. |
-| P2-13 | **Промокоды / акции** | Domain: `Promotion`, правила (категория, период, % скидки). UI-настройка из админки. | Маркетинг для магазина. |
-| P2-14 | **Telegram-бот для владельца** | Ежедневная сводка выручки, low-stock alerts. | UX для владельцев. |
-| P2-15 | **Multi-storage для изображений** | Сейчас файлы лежат в `/app/uploads` (volume). Перевести на S3-совместимое хранилище (MinIO/Yandex.Cloud). | Масштабируемость, отказоустойчивость. |
-
----
-
-## 3. Дорожная карта (рекомендованная последовательность)
-
-### Спринт 1 — Стабилизация (2-3 недели)
-
-Цель: безопасно выкатить текущий функционал в прод.
-
-- P0-1 → P0-9 (все блокеры запуска)
-- P1-20, P1-21 (юнит/интеграционные тесты на текущую логику)
-- P1-18 (аудит мутаций tenant'а)
-
-**Критерий готовности:** прод-стенд работает с HTTPS, rate-limit'ы установлены, бэкап автоматический, фискализация ОФД работает, права RolePermissions проверяются.
-
-### Спринт 2 — Складской учёт (3-4 недели)
-
-Цель: полноценное складское ядро ERP.
-
-- P1-1 (Enter), P1-2 (Loss), P1-3 (Transfer), P1-4 (Inventory)
-- P1-6 (CustomerReturn), P1-7 (SupplierReturn)
-- P1-16 (Hangfire dashboard + scheduled cleanup)
-
-**Критерий готовности:** магазин может вести полный складской учёт без обходных путей.
-
-### Спринт 3 — Отчёты и аналитика (2 недели)
-
-- P1-8 (Sales report), P1-9 (Stock on date), P1-10 (Profit), P1-11 (ABC)
-- P1-19 (OpenAPI / Swagger)
-
-**Критерий готовности:** владелец видит, как идёт бизнес, без выгрузки в Excel.
-
-### Спринт 4 — POS (4-6 недель)
-
-- P1-12 (POS Sync API), `food-market.shared` контракты
-- P1-13 (POS WPF MVP)
-- P1-17 (метрики Prometheus + Grafana dashboard)
-
-**Критерий готовности:** касса работает оффлайн, синхронизируется с сервером, печатает фискальные чеки.
-
-### Спринт 5 — Оптовые продажи + MoySklad full sync (2-3 недели)
-
-- P1-5 (Demand)
-- P1-14 (MoySklad Demand sync), P1-15 (webhook'и)
-- P1-22 (email-шаблоны)
-
-**Критерий готовности:** клиент, работающий с юрлицами через МойСклад, может полностью перейти на Food Market.
-
-### Спринт 6+ — Интеграции и фичи (P2)
-
-P2-1 Kaspi Pay → P2-3 маркетплейсы → P2-6 локализация → P2-11 ЭСФ → P2-12/13 лояльность/акции.
-
----
-
-## 4. Технический долг (для рефакторинга)
-
-Не блокирует функциональность, но затрудняет развитие.
-
-| # | Что | Почему важно |
-|---:|---|---|
-| TD-1 | **CQRS через MediatR** — перенести бизнес-логику из контроллеров в Command/Query handlers. | Сейчас невозможно переиспользовать логику между API/POS/Hangfire. Контроллеры по 500 строк. |
-| TD-2 | **FluentValidation** — заменить inline-валидацию в контроллерах на отдельные `Validator<T>`. | Сейчас валидация перемешана с бизнес-логикой, тестировать сложно. |
-| TD-3 | **Mapster** — выделить mapping в отдельные `MapperConfig`. | Сейчас projection'ы инлайнятся в LINQ-запросы, переиспользования нет. |
-| TD-4 | **Структурные log-fields в Serilog** — добавить `org_id`, `user_id`, `correlation_id` в log scope. | Сейчас в логах сложно найти конкретного пользователя/организацию. |
-| TD-5 | **ImportJobRegistry в БД** — сейчас in-memory `ConcurrentDictionary`. При рестарте API теряется. Перевести на таблицу `ImportJobs`. | Жизненный цикл job'а >5 минут — рестарт обычное дело. |
-| TD-6 | **Concurrency-токены на документах** — `RowVersion` (xmin/timestamp) на Supply/RetailSale, чтобы исключить race condition при параллельной правке. | Сейчас два кассира могут испортить один чек. |
-
----
-
-## 5. Сводка по оценке готовности
-
-```
-┌──────────────────────────────────┬──────────────┬─────────────┐
-│ Категория                        │ Готовность   │ Состояние   │
-├──────────────────────────────────┼──────────────┼─────────────┤
-│ Авторизация и multi-tenancy      │ 95%          │ ✅ готово   │
-│ Каталог товаров                  │ 95%          │ ✅ готово   │
-│ Документы (Supply, RetailSale)   │ 100%         │ ✅ готово   │
-│ Документы (Inventory/Loss/...)   │ 0%           │ ❌ нет      │
-│ Отчёты                           │ 5%           │ ❌ нет      │
-│ POS                              │ 5%           │ ❌ нет      │
-│ MoySklad                         │ 50%          │ 🟡 частично │
-│ Платежи и фискализация           │ 0%           │ ❌ нет      │
-│ Инфраструктура (CI/CD, Docker)   │ 90%          │ ✅ готово   │
-│ Безопасность (HTTPS, rate-limit) │ 30%          │ 🟡 частично │
-│ Observability (метрики, аудит)   │ 20%          │ 🟡 частично │
-│ Тестирование                     │ 40%          │ 🟡 частично │
-└──────────────────────────────────┴──────────────┴─────────────┘
-
-  Общая готовность к продакшен-запуску:  60-65%
-  - Для MVP "магазин на одном POS-терминале": требуется ОФД + базовые складские документы.
-  - Для полноценного ERP: требуется выполнение P0+P1.
-  - Для конкуренции с МойСклад: требуется ещё и P2.
-```

docs/TZ-тестирование.md

@@ -1,630 +0,0 @@
-# ТЗ на тестирование Food Market
-
-> Дата составления: 2026-05-22
-> Автор: Claude Opus 4.7
-> Документ парный к [TZ-доработка.md](./TZ-доработка.md). Описывает что и как проверять до и после релизов.
-
----
-
-## 0. Принципы тестирования
-
-### 0.1. Пирамида тестов
-
-```
-        ▲   E2E (Playwright, full-cycle)             ~ 5%
-       ▲▲▲  API integration (axios + Testcontainers) ~ 25%
-      ▲▲▲▲▲ Unit-тесты бизнес-логики (xUnit)         ~ 70%
-```
-
-Сейчас реальное соотношение **5% / 0% / 0%** — это нужно перевернуть.
-
-### 0.2. Уровни тестирования
-
-| Уровень | Когда запускается | Что проверяет |
-|---|---|---|
-| **Smoke** | Каждый push, ≤2 мин | Сервис стартует, /health отвечает 200, миграции применены, главные страницы открываются. |
-| **Регрессия** | Каждый PR, ≤10 мин | Основные сценарии не сломаны: signup→login, создание продукта/приёмки/продажи, multi-tenant isolation. |
-| **E2E full-cycle** | Каждый merge в main, ≤30 мин | Полный путь от создания организации до отчёта о продажах. |
-| **Нагрузочные** | Перед мажорными релизами | 1000 одновременных пользователей, 10000 товаров, 50000 движений. |
-| **Безопасность** | Перед релизом + регулярно | OWASP Top-10, рейт-лимит, multi-tenant утечки. |
-
-### 0.3. Когда считать «работает корректно»
-
-- **Бэкенд:** код возвращает ожидаемый HTTP-код, тело ответа валидно по схеме, побочные эффекты в БД соответствуют ожиданиям (StockMovement, Stock.Quantity).
-- **Фронтенд:** интерфейс отображает корректные данные, формы валидируются (HTML5 + onBlur + submit), ошибки сервера показываются человекочитаемо.
-- **Безопасность:** запрещённые операции возвращают 401/403/404 без утечки информации (не «такого пользователя нет», а «неверный логин/пароль»).
-- **Мультитенант:** пользователь org A никогда не видит и не изменяет данные org B (ни через UI, ни через прямой API).
-
-### 0.4. Что считать багом
-
-- Любой 500 без log-entry с причиной.
-- Отрицательный остаток после провёденной продажи (overselling без контроля).
-- Несоответствие `Stock.Quantity` сумме `StockMovement.Quantity` по тому же (Product, Store).
-- Возможность увидеть/изменить данные другой организации.
-- Возможность залогиниться как заархивированный/удалённый сотрудник.
-- Email-flow signup/reset не работает (письма не доходят).
-
----
-
-## 1. Приоритезация по критичности модулей
-
-| Приоритет | Модули | Что попадает |
-|---|---|---|
-| **P0 (smoke + регрессия в каждом PR)** | Auth, Supply, RetailSale, Stock, Multi-tenancy | Без этого не работает ничего. |
-| **P1 (регрессия перед релизом)** | Catalog (Products, Groups, Counterparties), SuperAdmin Console, MoySklad import, Permissions | Без этого магазин не функционален. |
-| **P2 (один раз перед мажорным релизом + после изменений)** | Reports, Email, Health checks, UI-валидация, локализация чисел/дат | Не блокирует, но влияет на UX. |
-| **P3 (точечно по требованию)** | Public site (Astro), CI/CD-сценарии | Меняется реже. |
-
----
-
-## 2. Сценарии тестирования по модулям
-
-### 2.1. Аутентификация (P0)
-
-#### 2.1.1. Регистрация новой организации (`POST /api/auth/signup`)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Happy: новая орга** | POST с уникальным email, паролем 8+, org name, валидным KZ-телефоном (+7 7XX...). | 201, в БД: новый Organization, User с ролью Admin, Employee, bootstrap-данные (Stores=1, Roles=4, Units, PriceTypes). |
-| **Email уже занят** | Повторный POST с тем же email. | 400 «email уже занят» (без раскрытия деталей о существующей орге). |
-| **Слабый пароль (<8 симв.)** | POST с password="abc". | 400, поле password в ошибках. |
-| **Невалидный телефон** | POST с phone="+79161234567" (РФ). | 400 «введите корректный номер Казахстана». |
-| **Без согласия с офертой** | UI: не отметить чекбокс. | Submit заблокирован, поле agree красное. |
-| **Email с лишними пробелами** | "  user@example.kz  ". | Нормализация: trim, lowercase. 201. |
-| **Bootstrap полнота** | После регистрации: GET `/api/catalog/stores` → 1 основной склад; GET `/api/organization/employee-roles` → 4 системных роли (Admin/Manager/Storekeeper/Cashier). | Соответствие. |
-
-#### 2.1.2. Логин (`POST /connect/token`)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Happy: правильный пароль** | grant_type=password, valid creds. | 200, access_token (jwt), refresh_token, claims.org_id, claims.role. |
-| **Неверный пароль** | Wrong password. | 400 OAuth error="invalid_grant", без раскрытия «такой email есть» vs «нет». |
-| **Заблокированный пользователь** | User.IsActive=false. | 400, токен не выдан. |
-| **Архивированная организация** | Organization.IsArchived=true. | 400, токен не выдан, claim org_id отсутствует или вход запрещён. |
-| **SuperAdmin без org** | User с ролью SuperAdmin, OrganizationId=null. | 200, токен выдан, claim role="SuperAdmin". |
-| **Refresh token flow** | grant_type=refresh_token с действующим refresh. | 200, новый access + refresh (sliding). |
-| **Истёкший access токен** | Запрос с истёкшим токеном. | 401, фронт делает refresh автоматически. |
-| **Истёкший refresh** | Подождать >30 дней. | 400 на refresh, форс-логаут на фронте. |
-| **Rate limit (после P0-3)** | 6+ login-попыток за минуту с одного IP. | 429 Too Many Requests. |
-
-#### 2.1.3. Forgot/Reset password
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Happy: запрос восстановления** | POST `/api/auth/forgot-password` с email существующего. | 200 (всегда), на email приходит ссылка с токеном (1 час). |
-| **Несуществующий email** | POST с unknown@example. | 200 (anti-enumeration), без email. |
-| **Сброс по токену** | POST `/api/auth/reset-password` с email+token+newPassword. | 200, все refresh_token'ы revoke'нуты. |
-| **Просроченный токен (>1 ч)** | POST с истёкшим токеном. | 400 «ссылка устарела». |
-| **Rate limit forgot** | 4+ запроса за час с одного IP. | 429 «слишком много попыток». |
-
----
-
-### 2.2. Multi-tenancy и изоляция данных (P0, КРИТИЧНО)
-
-#### 2.2.1. Изоляция через UI
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Видимость списков** | Залогиниться в org A, создать товар «Хлеб». Залогиниться в org B. | `/catalog/products` org B не содержит «Хлеб». |
-| **Переключение организаций** | Один email в двух организациях (если возможно — сейчас нет). | (Не поддерживается — каждый User принадлежит одной org). |
-
-#### 2.2.2. Изоляция через прямой API
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **GET по GUID чужой орги** | Залогиниться в org A, узнать `productId` org B (например, через БД). GET `/api/catalog/products/{productIdOrgB}`. | 404 (не 200). Query filter скрывает. |
-| **PUT по GUID чужой орги** | PUT `/api/catalog/products/{productIdOrgB}` с теми же данными. | 404 (не 200, не 200 с записью в чужую). |
-| **DELETE по GUID чужой орги** | DELETE того же. | 404. |
-| **POST с FK на чужую сущность** | POST Supply в org A с supplierId, принадлежащим org B. | 400 «contact not found» (FK проверка через query filter). |
-| **Подделка org_id в JWT** | Сгенерировать токен с org_id чужой орги (без подписи). | 401 (подпись не валидна). |
-
-#### 2.2.3. SuperAdmin override
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **SuperAdmin без override** | GET `/api/super-admin/organizations`. | Видит все организации. |
-| **SuperAdmin с override (read)** | GET `/api/catalog/products` с заголовком `X-Org-Override: <orgId>`. | Видит товары org X. |
-| **SuperAdmin с override (write)** | PUT `/api/catalog/products/{id}` с `X-Org-Override: <orgId>` без `X-Org-Override-Reason`. | 403 «Read-only mode...». |
-| **SuperAdmin с override + reason** | PUT с обоими заголовками (`X-Org-Override-Reason: "Customer support ticket #123, исправляем дубль штрихкода"`). | 200, запись в SuperAdminAuditLog. |
-| **Reason слишком короткий** | reason="ok". | 403. |
-| **Обычный Admin с X-Org-Override** | Admin org A пытается подделать заголовок и выйти в org B. | 403 «only SuperAdmin can override». |
-
-#### 2.2.4. Глобальные справочники
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Country / Currency видны всем** | Login org A: GET /api/catalog/countries → видит. Login org B: GET → тот же список. | Идентичные списки. |
-| **System ProductGroup видна всем** | SuperAdmin создаёт ProductGroup OrganizationId=null. Login любая org: видит. | Видна, но не редактируется обычным Admin. |
-| **System UnitOfMeasure (ОКЕИ)** | SuperAdmin: GET /api/super-admin/units-of-measure → видит все global. Admin org A: GET /api/catalog/units-of-measure → видит только enabled через junction. | Корректная фильтрация. |
-
----
-
-### 2.3. Каталог (P1)
-
-#### 2.3.1. Товары (Products)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Создание минимального** | POST `/api/catalog/products` с name + unit. | 201, автогенерация артикула (числовой), штрихкода нет. |
-| **Создание с штрихкодом EAN13** | POST с barcode value="4607034630092", type=Ean13. | 201, валидация контрольной цифры. |
-| **EAN13 с невалидной контрольной цифрой** | barcode="4607034630099". | 400 «невалидный EAN13». |
-| **Дубль штрихкода в одной орге** | POST два товара с одинаковым штрихкодом. | 409 на втором. |
-| **Дубль штрихкода в разных оргах** | Org A: barcode X. Org B: тот же barcode. | 201 для обеих (per-tenant unique). |
-| **Цена по типам** | POST с prices: розничная=1000 KZT, оптовая=800 KZT. | Записи в ProductPrice. |
-| **Обязательная розничная цена** | POST без розничной. | 400 «требуется розничная цена» (если PriceType.IsRequired=true). |
-| **Артикул вручную** | POST с article="ABC-001". | 201, без автогенерации. |
-| **Дубль артикула** | Два товара с article="ABC-001". | 409. |
-| **Поиск по barcode** | GET `/api/catalog/products/by-barcode/4607034630092`. | Возвращает товар. |
-| **Quick search** | GET `/api/catalog/products/quick-search?q=хле`. | Ранжирование: exact barcode → article → name prefix → name contains. |
-| **Фильтр по группе** | GET `?groupId=X`. | Только товары группы X. |
-| **Фильтр по упаковке** | `?packaging=Weight`. | Только весовые. |
-| **Удаление товара с приёмками** | DELETE товара, на который есть SupplyLine. | 409 «нельзя удалить, есть документы». |
-| **Удаление без документов** | DELETE свежесозданного. | 204. |
-| **Изображения товара** | POST `/api/catalog/products/{id}/images` с jpg <10MB. | 201, файл в /uploads, ImageUrl обновлён. |
-| **Загрузка > 10MB** | POST с 15MB файлом. | 400. |
-| **Установка main image** | POST `/images/{imageId}/main`. | Product.ImageUrl ← путь, IsMain переброшен. |
-
-#### 2.3.2. Группы товаров (ProductGroups)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Создание корневой** | POST с name="Хлебобулочные", parentId=null. | 201, Path="Хлебобулочные". |
-| **Создание дочерней** | POST с parentId="<root>", name="Хлеб". | 201, Path="Хлебобулочные/Хлеб". |
-| **Циклическая ссылка** | PUT группы с parentId=своим id или потомка. | 400 «цикл». |
-| **Удаление с подгруппами** | DELETE родителя у которого есть дети. | 409. |
-| **Удаление с товарами** | DELETE группы с привязанными товарами. | 409. |
-| **Системная группа SuperAdmin** | SuperAdmin POST с OrganizationId=null. Login org → видна, но Edit/Delete недоступны. | Корректное поведение. |
-| **Markup percent** | Группа с MarkupPercent=20%. Cost=1000 → RecalcRetail = 1200. | Round up до целых (по AllowFractionalPrices). |
-
-#### 2.3.3. PriceTypes
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Только один IsRetail** | Создать два PriceType с IsRetail=true. | 409 на втором. |
-| **IsSystem нельзя удалить** | DELETE PriceType с IsSystem=true. | 409. |
-| **Переименование системного** | PUT name. | 200 (можно). |
-| **Toggle IsRequired системного** | PUT IsRequired=false для системного. | 409 (зафиксирован). |
-
-#### 2.3.4. UnitsOfMeasure
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Enable global unit** | POST `/api/catalog/units-of-measure/{id}/enable`. | 204, junction record создан. |
-| **Disable enabled unit с ссылками** | DELETE enable у unit'а, который используется товаром. | 409 «нельзя — товары используют». |
-| **SuperAdmin: создать global unit** | POST `/api/super-admin/units-of-measure` с code="МЛ". | 201. |
-| **SuperAdmin: удалить global unit с ссылками** | DELETE того же если ссылается товар. | 409 со списком орг. |
-
-#### 2.3.5. Counterparties
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Юрлицо с БИН** | POST с type=LegalEntity, bin="123456789012". | 201. |
-| **БИН не 12 цифр** | bin="1234". | 400. |
-| **Физлицо с ИИН** | type=Individual, iin="850101300123". | 201. |
-| **Невалидный KZ телефон** | phone="+79161234567". | 400. |
-
----
-
-### 2.4. Документы: Приёмки (P0)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Создание Draft** | POST Supply с supplier, store, currency, 2 lines. | 201, status=Draft, Total=sum(qty*price), Stock не изменился. |
-| **Posting** | POST `/posts/{id}/post`. | Stock.Quantity += sum(qty). StockMovement +N записей с type=Supply. Cost пересчитан (weighted avg). |
-| **Cost weighted average** | До: Stock.Cost=100, qty=10. Приёмка: qty=10, price=120. После: Cost = (10*100+10*120)/20 = 110. | Соответствие. |
-| **ReferencePrice при первой приёмке** | Product без приёмок. После Supply.Post: Product.ReferencePrice = UnitPrice. | Соответствие. |
-| **Автонаценка розничной** | ProductGroup.MarkupPercent=30, товар без override розницы, Cost=100. После Post: ProductPrice (IsRetail) = 130. | Соответствие. |
-| **Unpost** | POST `/{id}/unpost` на провёденной. | StockMovement удалены/инвертированы, Stock.Quantity вернулся, status=Draft. |
-| **Edit проведённой** | PUT провёденной (status=Posted). | 409 «нельзя редактировать проведённую». |
-| **Delete Draft** | DELETE Draft без посту. | 204. |
-| **Delete проведённой** | DELETE Posted. | 409. |
-| **Posting → отрицательный остаток после unpost** | Post Supply (+10), затем Sale (-15), затем Unpost Supply. | 409 «нельзя расковать, остаток уйдёт в минус» (по дизайну). |
-| **FK на удалённого поставщика** | Supplier удалён (если бы это было возможно), Supply ссылается. | Корректная обработка (запрет удаления поставщика или nullable). |
-| **Пустые lines** | POST с lines=[]. | 400. |
-| **Quantity ≤ 0** | line.qty=0 или -5. | 400. |
-| **Параллельный Post одного Supply** | Два запроса /post одновременно. | Один 200, второй 409 (concurrency-конфликт после P1 RowVersion). |
-
----
-
-### 2.5. Документы: Розничные продажи (P0)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Создание Draft** | POST RetailSale с retailPoint, lines, payments. | 201, status=Draft. |
-| **Posting с достаточным остатком** | Stock=10. POST с qty=5, /post. | Stock=5, StockMovement type=RetailSale qty=-5. |
-| **Posting с overselling** | Stock=3. POST с qty=5, /post. | 409 «недостаточно товара» (по фиксу из git history). |
-| **PaidCash + PaidCard ≠ Total** | Total=1000, paidCash=300, paidCard=500. | 400 «суммы не сходятся». |
-| **Расчёт суммы со скидкой** | Line qty=2, price=500, discount=100. Subtotal=1000, DiscountTotal=100, Total=900. | Соответствие. |
-| **VAT snapshot в строке** | На момент продажи Product.VatPercent=12, после Sale.Post страну поменяли → VAT=0. Старая RetailSaleLine.VatPercent = 12. | Снимок цены/НДС сохраняется. |
-| **Cashier из другого RetailPoint** | Cashier привязан к RP1. POST RetailSale с retailPointId=RP2. | 403 (после реализации Permission). |
-| **Unpost продажи** | POST /unpost. | Stock возвращается, StockMovement инвертирован. |
-| **Stats эндпоинт** | GET /stats?days=30. | Daily series 30 дней, revenueToday, transactionsToday, avgTicketThisMonth корректны. |
-| **Возврат по чеку (после P1-6)** | POST CustomerReturn ссылается на RetailSale. | Stock возвращается, новый StockMovement type=CustomerReturn. |
-
----
-
-### 2.6. Остатки и движения (P0)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Целостность Stock vs Movement** | После N операций: для любых (ProductId, StoreId) `Stock.Quantity == SUM(StockMovement.Quantity)`. | Соответствие (инвариант). |
-| **Reserved** | (Если реализуется в P1) Сейчас Reserved=0 везде. | После резервирования через Demand: Reserved += qty. |
-| **Доступно (Available)** | Available = Quantity - Reserved. | Корректно. |
-| **Фильтр includeZero=false** | Stock.Quantity=0. GET /stock?includeZero=false. | Не включается. |
-| **Movements: пагинация** | 1000 движений. GET ?page=1&pageSize=50. | total=1000, items=50. |
-| **Сортировка по occurredAt desc** | GET ?sort=-occurredAt. | Свежие сверху. |
-| **Фильтр по storeId** | Два склада, по 10 movements в каждом. GET ?storeId=X. | Только 10 из X. |
-
----
-
-### 2.7. Сотрудники и роли (P1)
-
-#### 2.7.1. CRUD сотрудников
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Создание без учётки** | POST с createAccount=false. | 201, Employee.UserId=null. |
-| **Создание с учёткой** | POST с createAccount=true, email. | 201, User создан с temp password, password возвращён в response (один раз). |
-| **Email обязателен при createAccount=true** | POST с email="" и createAccount=true. | 400. |
-| **Дубль email** | Два сотрудника, одинаковый email при createAccount. | 409. |
-| **Soft-delete (увольнение)** | DELETE employeeId. | IsActive=false, FiredAt=now, IsDeleted=false. User блокируется. |
-| **Полное удаление (после увольнения)** | DELETE дважды (после Fired). | IsDeleted=true, DeletedAt=now. |
-| **Архивный сотрудник в документах** | После soft-delete: старые Supply показывают «Иванов И. (удалён)». | Подпись сохраняется. |
-| **Защита OwnerUser** | DELETE главного администратора (Organization.AccountOwnerUserId == Employee.UserId). | 409 «только SuperAdmin». |
-| **Защита самого себя** | Залогинен Иванов, пытается DELETE сам себя. | 409 «нельзя удалить себя». |
-
-#### 2.7.2. Роли и Permission-based authz (после P0-5)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Системные роли созданы** | После signup: 4-6 системных ролей (Admin, Manager, Storekeeper, Cashier, ...). | IsSystem=true, не удаляются. |
-| **Кастомная роль** | POST роль "Менеджер по продажам" с permissions {productsView:true, suppliesView:true, all_else:false}. | 201. |
-| **Permission DENY** | Employee с ролью "Менеджер по продажам" → POST Product. | 403 «нет права ProductsEdit». |
-| **Permission ALLOW** | Тот же → GET /api/catalog/products. | 200. |
-| **Изменение прав роли** | PUT permissions роли. | Применяется ко всем сотрудникам этой роли (без revoke токенов). |
-| **Удаление роли с сотрудниками** | DELETE используемой роли. | 409. |
-| **Cashier → RetailPoint** | Cashier с EmployeeRetailPointAssignment (RP1). POST RetailSale (RP1). | 200. С RP2: 403. |
-
----
-
-### 2.8. SuperAdmin Console (P1)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Создание организации** | POST /api/super-admin/organizations с org+admin данными. | 201, temp password возвращён, organization в БД. |
-| **Аудит создания** | SELECT FROM super_admin_audit_log WHERE action_type='OrganizationCreated'. | Запись с reason, before/after JSON. |
-| **Архивирование** | POST /{id}/archive с confirmationName=правильное имя org. | IsArchived=true, ArchivedAt=now. Логины этой org перестают работать. |
-| **Архивирование с неверным confirmationName** | confirmationName="wrong". | 400. |
-| **Восстановление** | POST /{id}/restore. | IsArchived=false. |
-| **Hard delete после retention period** | Через SystemSettings.ArchiveRetentionDays=0, DELETE архивной. | 204, организация физически удалена (CASCADE). |
-| **Hard delete до retention** | DELETE архивной до истечения. | 409 «до удаления ещё N дней». |
-| **Смена владельца** | POST /change-owner с newOwnerUserId, reason. | Organization.AccountOwnerUserId обновлён, запись в audit log. |
-| **Reason требуется** | POST /change-owner без reason. | 400. |
-| **Reason < 10 символов** | POST с reason="ok". | 400. |
-| **Audit log фильтр** | GET /audit-log?orgId=X&actionType=Y. | Корректная фильтрация. |
-| **Audit log CSV экспорт** | Через UI кнопка «Экспорт». | CSV-файл скачивается. |
-
----
-
-### 2.9. SuperAdmin Platform Settings — SMTP (P1)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Сохранение SMTP** | PUT с host, port, ssl, username, newSmtpPassword="pass123". | 200, hasSmtpPassword=true. Пароль в БД зашифрован. |
-| **Получение настроек** | GET. | Все поля кроме password. password не возвращается. |
-| **Очистка пароля** | PUT с newSmtpPassword="__clear__". | hasSmtpPassword=false. |
-| **Test send** | POST /test-send. | Письмо приходит на адрес супер-админа. |
-| **Test send без настроек** | POST /test-send когда SMTP не настроен. | 400 «SMTP не настроен». |
-| **Forgot password после настройки** | Юзер делает forgot-password → письмо со ссылкой приходит. | Соответствие. |
-
----
-
-### 2.10. MoySklad интеграция (P1)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Сохранение токена** | PUT /api/admin/moysklad/settings с token. | Token сохранён в Organization, masked при GET. |
-| **Test connection** | POST /test с валидным токеном. | 200, возвращает {organization, inn}. |
-| **Test с невалидным токеном** | POST /test с "abc". | 400 или 401 с понятным сообщением. |
-| **Import counterparties** | POST /import/counterparties. | 202, jobId возвращён. |
-| **Job progress polling** | GET /api/admin/jobs/{id} раз в 1.5 сек. | Status: InProgress → Succeeded. Stage обновляется. |
-| **Импортированные контрагенты** | GET /api/catalog/counterparties после import. | N новых контрагентов с правильными BIN, телефонами. |
-| **OverwriteExisting=true** | Повторный import с overwrite. | Обновляются по name (case-insensitive), не дубли. |
-| **Импорт товаров** | POST /import/products. | Товары + группы + штрихкоды + остатки импортированы. |
-| **Архивные товары** | МойСклад имеет archived товары. | Импортируются в Product.IsArchived=true. |
-| **Прерывание job (после P1)** | Рестарт API во время импорта. | Job маркируется как Failed, можно перезапустить. |
-
----
-
-### 2.11. Складские документы (P1, после реализации)
-
-#### 2.11.1. Оприходование (Enter)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Создание/Post** | POST Enter с lines, /post. | Stock += qty, StockMovement type=Enter. |
-| **Без поставщика** | POST без supplierId. | 201 (Enter не требует supplier). |
-
-#### 2.11.2. Списание (Loss)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Списание брака** | POST Loss с reason="брак", lines с qty. | Stock -= qty, StockMovement type=WriteOff. |
-| **Списание сверх остатка** | Stock=3, Loss qty=5. | 409 «недостаточно». |
-
-#### 2.11.3. Перемещение (Transfer)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Между складами** | POST Transfer (FromStore=A, ToStore=B), lines. /post. | Stock[A] -= qty, Stock[B] += qty. Два StockMovement (TransferOut + TransferIn). |
-| **Атомарность** | Если ToStore Stock записать не удалось (например, БД упала между). | Транзакция откатывается, Stock[A] не изменён. |
-
-#### 2.11.4. Инвентаризация (Inventory)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Создание с импортом текущих** | POST Inventory storeId=X. | InventoryLine на каждый товар склада X с bookQty=Stock.Quantity, actualQty=null. |
-| **Заполнение фактических** | PUT с actualQty по каждой строке. | Diff = actual - book. |
-| **Post** | POST /post. | StockMovement type=InventoryAdjustment с qty=diff. Stock актуализирован. |
-| **CSV-импорт фактических** | UI: загрузка CSV (sku, qty). | Заполнение строк. |
-
----
-
-### 2.12. Отчёты (P1, после реализации)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Отчёт по продажам** | GET /api/reports/sales?from=...&to=...&groupBy=day. | Series выручки по дням. |
-| **Отчёт по продажам с фильтром по кассиру** | ?cashierId=X. | Только продажи этого кассира. |
-| **Отчёт «остатки на дату»** | GET /stock?date=2026-04-01. | Stock восстановлен через `SUM(Movement WHERE occurredAt <= date)`. |
-| **Отчёт «прибыль»** | GET /profit?from=...&to=... | Выручка - себестоимость (использует Cost snapshot из RetailSaleLine). |
-| **ABC-анализ** | GET /abc?metric=revenue&period=last_quarter. | Топ-20% товаров (группа A), следующие 30% (B), остаток (C). |
-| **Экспорт CSV/XLSX** | UI: кнопка «Экспорт». | Скачивается файл с теми же данными. |
-| **Большой объём** | 100k продаж в периоде. | <5 секунд ответ (с агрегацией на стороне БД). |
-
----
-
-### 2.13. POS Sync API (P1, после реализации)
-
-| Сценарий | Шаги | Ожидание |
-|---|---|---|
-| **Initial sync** | POS первый раз: GET /api/pos/sync?since=0. | Все товары, цены, остатки, контрагенты. |
-| **Incremental sync** | GET /api/pos/sync?since=<lastSyncTimestamp>. | Только изменения после timestamp. |
-| **Batch upload sales** | POST /api/pos/sales [{idempotencyKey, ...}, ...]. | Все продажи провёдены, idempotency повторных вызовов. |
-| **Idempotency** | POST с тем же idempotencyKey дважды. | Второй вызов возвращает оригинальный результат, без дубля. |
-| **Offline → online** | POS работает offline 1 час, накопил 20 продаж. После online: upload. | Все 20 синхронизированы корректно. |
-| **Conflict: товар удалён** | POS отправил продажу товара, который SuperAdmin удалил. | 409, POS откатывает локально или маркирует как ошибку. |
-
----
-
-### 2.14. Web-админка UI/UX (P2)
-
-| Сценарий | Что проверить |
-|---|---|
-| **Темная тема** | Все 35 страниц — переключение dark mode через кнопку. Без артефактов, контраст AAA. |
-| **Адаптив** | Каждая страница на мобильном (375px), планшете (768px), десктопе (1280px). |
-| **onBlur валидация форм** | После только что внедрённого ФЛК (см. git ff44afc): SignupForm, LoginPage, ResetPasswordPage, ForgotPasswordPage, EmployeesPage, CounterpartiesPage, StoresPage, PriceTypesPage, EmployeeRolesPage, RetailPointsPage, OrganizationSettingsPage, SuperAdminOrgCreatePage. Каждое поле показывает ошибку при потере фокуса. |
-| **onChange сбрасывает ошибку** | После показа ошибки, начать вводить — ошибка должна убираться. |
-| **Обработка 401 в axios** | Истёкший токен → автоматический refresh → повторный запрос. |
-| **Обработка 403** | Понятная страница «нет прав». |
-| **Обработка 500** | Не белый экран, а toast/alert. |
-| **Loading states** | Спиннеры/skeleton'ы на всех таблицах при загрузке. |
-| **Empty state** | Пустые списки показывают «Нет данных», а не пустую таблицу. |
-| **Pagination** | Корректные счётчики, переходы. На последней странице нет «next». |
-| **Sticky header** | Заголовок таблицы остаётся при скролле длинных списков. |
-| **Локализация** | Все строки на русском. Числа в `toLocaleString('ru-KZ')` (1 234,56). Даты в `dd.MM.yyyy`. |
-
----
-
-### 2.15. Public site (Astro) (P3)
-
-| Сценарий | Что проверить |
-|---|---|
-| **Маршруты** | /, /pricing, /features, /pos, /import, /integrations, /about, /contacts, /signup, /blog/[slug], /kb/[slug], /legal/[slug] — все открываются. |
-| **SignupForm на /signup** | Заполнить корректно → редирект на admin.food-market.kz с токенами. |
-| **Tariff builder на /pricing** | Изменение количества касс/складов → перерасчёт стоимости. |
-| **SEO** | Каждая страница имеет title, description, canonical, og-image. |
-| **sitemap.xml** | GET /sitemap.xml → валидный XML со всеми статичными страницами. |
-| **robots.txt** | GET /robots.txt → ожидаемое содержимое. |
-| **Lighthouse** | Performance 90+, Accessibility 95+, Best Practices 95+, SEO 100. |
-
----
-
-### 2.16. Infrastructure / DevOps (P2)
-
-| Сценарий | Что проверить |
-|---|---|
-| **/health** | 200 OK, JSON {status, time}. |
-| **/health/ready (после P0-4)** | 200 если БД и миграции OK. 503 если БД упала. |
-| **CI: build на push** | Зелёный pipeline на каждый push в main. |
-| **CI: deploy on push api** | После push в `src/food-market.api/*` → docker-api workflow → деплой на stage → smoke /health → 200. |
-| **Backup script** | Запуск `deploy/backup.sh local`. Файл *.sql.gz создан, размер > 0. |
-| **Backup restore** | Восстановить из бэкапа в чистую БД, поднять API, проверить логин. |
-| **Postgres healthcheck в compose** | docker-compose ps → postgres healthy. |
-| **Persistent volumes** | После `docker compose down && up` данные сохраняются. |
-| **Persistent OpenIddict ключ** | После рестарта API: refresh_token продолжает работать. |
-| **Логи Serilog** | tail -f /app/logs/food-market-*.log — структурированные строки. |
-| **Ротация логов** | После 14 дней старые логи удаляются. |
-| **Локальный docker registry** | curl 127.0.0.1:5001/v2/_catalog → список образов. |
-
----
-
-### 2.17. Безопасность (P0+P1)
-
-| Сценарий | Что проверить |
-|---|---|
-| **HTTPS-only (после P0-2)** | HTTP → 301 redirect на HTTPS. HSTS-header установлен. |
-| **JWT signature tampering** | Изменить body токена, не подписать. | 401. |
-| **JWT expired** | Использовать токен старше 1 часа. | 401, фронт делает refresh. |
-| **SQL injection** | Поиск со значением `'; DROP TABLE products;--`. | Безопасно (EF параметризует). |
-| **XSS в формах** | Создать товар с name=`<script>alert(1)</script>`. | На UI выводится как текст, не как HTML. |
-| **CSRF на /connect/token** | Cookie-based auth не используется, CSRF неактуален. | OK. |
-| **CORS** | Запрос из http://evil.com → блокирован. |
-| **Path traversal в /uploads** | GET /uploads/../../etc/passwd. | 404. |
-| **Unauthenticated endpoints** | Список AllowAnonymous: /health, /api/auth/signup, /api/auth/forgot-password, /connect/token, /uploads/*. | Других — нет. |
-| **Rate limit login (после P0-3)** | 10 попыток за минуту → 429. |
-| **Перебор email на signup** | 100 signup-запросов с разными email — должен 429 после 20. |
-| **Утечка через 404 vs 403** | GET /api/catalog/products/<существующий-чужого-tenant> возвращает 404, не 403 (чтобы не подтверждать существование). |
-
----
-
-### 2.18. Производительность (P2)
-
-| Сценарий | Цель |
-|---|---|
-| **GET /api/catalog/products при 10k товаров** | < 500 мс с пагинацией pageSize=50. |
-| **POST Supply.Post с 100 lines** | < 2 сек. |
-| **GET /api/inventory/movements при 100k записей** | < 1 сек с пагинацией. |
-| **Quick search в каталоге** | < 200 мс при 10k товаров. |
-| **Dashboard `/stats`** | < 500 мс при 100k продаж. |
-| **N+1 запросы** | EF Profiler / Serilog log: на GET /products нет N+1 для prices/barcodes. |
-| **Concurrent signup** | 50 параллельных signup → все 201, БД консистентна. |
-
----
-
-## 3. Регрессионный чек-лист (перед каждым релизом)
-
-```
-[ ] Все миграции применяются на чистую БД
-[ ] Smoke: GET /health → 200
-[ ] Smoke: signup → новая org → login → /api/me → roles[admin]
-[ ] Регрессия: создать товар → создать приёмку → /post → Stock обновился
-[ ] Регрессия: создать продажу → /post → Stock уменьшился, чек создан
-[ ] Регрессия: запрос с другого org_id → 404
-[ ] Регрессия: SuperAdmin без override видит все организации
-[ ] Регрессия: SuperAdmin с override read-only — мутация 403
-[ ] Регрессия: SuperAdmin с reason — мутация 200, audit log запись
-[ ] MoySklad: test connection → 200
-[ ] Email: forgot password → письмо приходит
-[ ] UI: все 35 страниц открываются, onBlur валидация работает
-[ ] CI: docker-api workflow зелёный, smoke на /health → 200
-[ ] Backup за последние сутки существует, размер > предыдущего > 50%
-[ ] Логи за последний час: нет 5xx без log-entry
-[ ] Метрики (после P1-17): error_rate < 1%, p95 latency < 1s
-```
-
----
-
-## 4. Стратегия покрытия тестами
-
-### 4.1. Unit-тесты (xUnit, цель 70% coverage критичной логики)
-
-```
-food-market.tests.unit/
-├── Domain/
-│   ├── ProductTests.cs               — валидация конструктора, computed properties
-│   ├── StockMovementTests.cs         — invariants
-│   └── RolePermissionsTests.cs       — расчёт прав
-├── Application/                       — после миграции на MediatR
-│   ├── SuppliesPostHandlerTests.cs   — Cost weighted average, авто-наценка
-│   ├── RetailSalePostHandlerTests.cs — Stock update, overselling check
-│   └── ImportJobsTests.cs            — состояния job'а
-└── Infrastructure/
-    ├── TenantFilterTests.cs           — query filter включается/исключается правильно
-    ├── StockServiceTests.cs           — атомарность ApplyMovement
-    └── MoySkladClientTests.cs        — pagination, error handling (с mock HttpMessageHandler)
-```
-
-### 4.2. Integration-тесты (Testcontainers.PostgreSql + WebApplicationFactory)
-
-```
-food-market.tests.integration/
-├── Auth/
-│   ├── SignupFlowTests.cs            — POST /signup → bootstrap data
-│   └── LoginFlowTests.cs             — token + refresh + revoke
-├── Catalog/
-│   ├── ProductsCrudTests.cs
-│   └── ProductGroupsHierarchyTests.cs
-├── Documents/
-│   ├── SupplyPostUnpostTests.cs      — Stock consistency
-│   └── RetailSalePostTests.cs        — overselling 409
-├── Tenancy/
-│   ├── MultiTenantIsolationTests.cs  — org A не видит org B
-│   └── SuperAdminOverrideTests.cs    — read-only / edit mode
-└── Authorization/
-    └── PermissionBasedAuthzTests.cs   — после P0-5
-```
-
-### 4.3. E2E (расширить существующий full-cycle)
-
-```
-tests/e2e/scenarios/
-├── full-cycle.yml                    — текущий: signup → import → supply → sale → report
-├── multi-tenant-isolation.yml         — два юзера, два org, попытки кросс-доступа
-├── superadmin-flow.yml               — создание org, архив, реcтор, edit-mode
-├── permission-checks.yml              — кастомные роли, разрешения/отказы
-└── moysklad-sync.yml                  — конец-в-конец импорт + проверки в БД
-```
-
----
-
-## 5. Инструменты тестирования
-
-| Инструмент | Назначение | Готовность |
-|---|---|---|
-| **xUnit + FluentAssertions** | Backend unit-тесты | ❌ нет (нужно завести проект) |
-| **Testcontainers.PostgreSql** | Integration-тесты с реальной БД в Docker | ❌ нет |
-| **WebApplicationFactory<Program>** | In-memory test server | ❌ нет |
-| **Playwright** | E2E браузерные тесты | ✅ есть (через `tests/e2e/run.sh full-cycle`) |
-| **axios + pg (TS)** | E2E API + DB-проверки | ✅ есть (`tests/e2e/lib/`) |
-| **Bombardier / k6** | Нагрузочное тестирование | ❌ нет |
-| **OWASP ZAP** | Сканер уязвимостей | ❌ нет (рекомендуется использовать перед prod) |
-| **Lighthouse CI** | Public site performance | ❌ нет |
-| **Codecov / Coverlet** | Coverage report | ❌ нет |
-
----
-
-## 6. Метрики качества тестирования
-
-```
-Цели после внедрения P1-20, P1-21:
-
-  Unit-тесты бизнес-логики:    ≥ 70%  (сейчас 0%)
-  Integration-тесты API:        ≥ 60%  (сейчас 0%)
-  E2E сценариев:                ≥ 5    (сейчас 1)
-  Время прогона полного CI:    ≤ 15 мин
-  Время smoke в PR:             ≤ 2 мин
-
-Регрессионный SLA после релиза:
-  Severity 1 (блокирующие): обнаружение → фикс ≤ 2 часа
-  Severity 2 (важные):       обнаружение → фикс ≤ 1 рабочий день
-  Severity 3 (косметика):    в плановый спринт
-```
-
----
-
-## 7. Финальный чек-лист «готовности к продакшен»
-
-Прежде чем сказать «можно запускать прод»:
-
-```
-БЕЗОПАСНОСТЬ
-[ ] HTTPS forced, HSTS установлен
-[ ] OpenIddict prod-сертификаты
-[ ] Rate limiting на login/signup
-[ ] Permission-based authorization работает
-[ ] Multi-tenant изоляция проверена (см. п. 2.2)
-[ ] OWASP Top-10 сканер пройден
-
-ФУНКЦИОНАЛ
-[ ] Складские документы (Enter/Loss/Transfer/Inventory) реализованы
-[ ] Отчёты (Sales/Stock/Profit/ABC) реализованы
-[ ] ОФД фискализация чеков работает
-[ ] Email-нотификации настроены и тестированы
-
-ИНФРАСТРУКТУРА
-[ ] Backup автоматический (cron/timer)
-[ ] Restore-сценарий отрепетирован
-[ ] Health checks детальные (ready/live)
-[ ] Метрики Prometheus + Grafana dashboard
-[ ] Алерты на error_rate, latency p95
-
-ПРОЦЕССЫ
-[ ] CI зелёный на main
-[ ] Coverage > 70% unit, > 60% integration
-[ ] E2E full-cycle зелёный
-[ ] Regression checklist пройден
-[ ] Release notes написаны
-[ ] Документация .env.example актуальна
-[ ] Rollback plan описан
-```

docs/analytics.md

@@ -1,54 +0,0 @@
-# Web-analytics на public-сайте
-
-Sprint 20: в `food-market.public` (Astro marketing-сайт) подключены
-placeholder'ы для Google Analytics 4 и Яндекс.Метрики. По умолчанию
-оба не активны — в HTML рендерятся `<script data-id="REPLACE_ME">`
-маркеры. Аналитика включается через env-vars при сборке Astro.
-
-**Зачем placeholder, а не сразу скрипты:**
-- Аналитика на marketing-сайте — это PII (IP-адреса посетителей),
-  по GDPR / 152-ФЗ / казахскому ЗоЗПД требует согласия пользователя
-  или специальной конфигурации (`anonymize_ip: true` + cookies notice).
-- Прод-аккаунт в Google/Yandex заводится отдельно владельцем; коммитить
-  его в репо неправильно.
-
-## Google Analytics 4
-
-1. Завести **GA4 property** на https://analytics.google.com.
-2. **Admin → Data Streams → Web → Add stream** → ввести URL public-сайта.
-3. Скопировать **Measurement ID** вида `G-XXXXXXXXXX`.
-4. В `deploy/Dockerfile.public` или в env переменной добавить:
-   ```bash
-   PUBLIC_GA_ID=G-XXXXXXXXXX
-   ```
-5. Пересобрать public-image: `cd src/food-market.public && pnpm build`.
-6. Открыть https://food-market.kz, проверить в DevTools → Network тегом
-   `gtag/js?id=G-XXX`.
-
-## Яндекс.Метрика
-
-1. https://metrika.yandex.com → **Создать счётчик**.
-2. Скопировать **ID счётчика** (8-значное число).
-3. Env: `PUBLIC_YM_ID=12345678`.
-4. Аналогично — пересобрать.
-
-## Проверка что НЕ настроено
-
-Открыть https://food-market.kz, View Source, найти:
-
-```html
-<script data-analytics="google" data-id="REPLACE_ME" data-doc="docs/analytics.md" />
-<script data-analytics="yandex-metrika" data-id="REPLACE_ME" data-doc="docs/analytics.md" />
-```
-
-Если эти строки есть — аналитика **не подключена**. Если вместо них
-видны `gtag` или `ym(...)` скрипты — настроено.
-
-## Что НЕ собираем
-
-- Никаких событий на админ-сайте `admin.food-market.kz` — это закрытая
-  система для авторизованных пользователей, тут аналитика будет
-  собирать persistent activity, что нарушает privacy expectations.
-  Если потребуется product-analytics в админке — отдельный обсуждение
-  (можем self-host Plausible / PostHog).
-- Никаких user-id в Metrika events — только anonymous traffic.

docs/api-reference.md

@@ -1,598 +0,0 @@
-# API endpoint reference
-
-Сгенерировано Python-сканером (`scripts/gen-api-reference.py`) из `src/food-market.api/Controllers/`.
-Sprint 28 версия: ловит endpoint'ы с nested generic return-типами.
-Идентичный логике runtime-job `ApiReferenceDocsJob` (Sprint 24); тот пересоздаёт файл
-еженедельно при cron `Hangfire:Cron:ApiReferenceDocs`.
-
-Всего endpoint'ов: **240**.  
-Контроллеров: **58**.
-
-Полная OpenAPI-спека: `/swagger/v1/swagger.json`. Этот reference — human-readable summary.
-
-## `AbcReportController`
-Base route: `/api/reports/abc`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/reports/abc` | — |  |
-| GET | `/api/reports/abc/export` | — |  |
-
-## `AdminCleanupController`
-Base route: `/api/admin/cleanup`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/admin/cleanup/all` | — | Полная очистка данных текущей организации — всё кроме настроек: остаются Organization, пользователи,… |
-| DELETE | `/api/admin/cleanup/counterparties` | — | Удалить всех контрагентов текущей организации. Чтобы не нарваться на FK, сначала обнуляем ссылки (Pr… |
-| GET | `/api/admin/cleanup/stats` | — |  |
-| POST | `/api/admin/cleanup/all/async` | — |  |
-
-## `AdminJobsController`
-Base route: `/api/admin/jobs`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/admin/jobs/recent` | — |  |
-| GET | `/api/admin/jobs/{id:guid}` | — |  |
-
-## `AuthForgotPasswordController`
-Base route: `/api/auth`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| POST | `/api/auth/forgot-password` | — |  |
-| POST | `/api/auth/reset-password` | — |  |
-
-## `AuthSignupController`
-Base route: `/api/auth`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| POST | `/api/auth/signup` | — |  |
-
-## `AuthorizationController`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| POST | `/connect/token` | — |  |
-
-## `CounterpartiesController`
-Base route: `/api/catalog/counterparties`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/counterparties/{id:guid}` | — |  |
-| GET | `/api/catalog/counterparties` | — |  |
-| GET | `/api/catalog/counterparties/export` | — | Sprint 19: экспорт списка контрагентов. |
-| GET | `/api/catalog/counterparties/{id:guid}` | — |  |
-| POST | `/api/catalog/counterparties` | — |  |
-| PUT | `/api/catalog/counterparties/{id:guid}` | — |  |
-
-## `CountriesController`
-Base route: `/api/catalog/countries`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/countries/{id:guid}` | — |  |
-| GET | `/api/catalog/countries` | — |  |
-| GET | `/api/catalog/countries/{id:guid}` | — |  |
-| POST | `/api/catalog/countries` | — |  |
-| PUT | `/api/catalog/countries/{id:guid}` | — |  |
-
-## `CurrenciesController`
-Base route: `/api/catalog/currencies`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/catalog/currencies` | — |  |
-| GET | `/api/catalog/currencies/{id:guid}` | — |  |
-| POST | `/api/catalog/currencies` | — |  |
-| PUT | `/api/catalog/currencies/{id:guid}` | — |  |
-
-## `DashboardController`
-Base route: `/api/dashboard`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/dashboard/low-stock` | — | Список товаров с остатком ≤ MinStock (Product.MinStock задан). Сортировка: меньший «запас в днях» → … |
-| GET | `/api/dashboard/margin` | — | Маржа за окно N дней: выручка минус COGS (Sum(qty * UnitCost) по строкам проданных товаров). Использ… |
-| GET | `/api/dashboard/recent-sales` | — | Последние N проведённых чеков (включая возвраты). Дашборд рендерит их как live-feed: SignalR SalePos… |
-| GET | `/api/dashboard/top-products` | — | Top-N товаров по выручке за окно последних N дней. Default: 7 дней, top-5. Только проведённые чеки (… |
-
-## `DemandsController`
-Base route: `/api/sales/demands`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/sales/demands/{id:guid}` | — |  |
-| GET | `/api/sales/demands` | — |  |
-| GET | `/api/sales/demands/{id:guid}` | — |  |
-| POST | `/api/sales/demands` | — |  |
-| POST | `/api/sales/demands/{id:guid}/post` | — |  |
-| POST | `/api/sales/demands/{id:guid}/unpost` | — |  |
-| PUT | `/api/sales/demands/{id:guid}` | — |  |
-
-## `DemoSeedController`
-Base route: `/api/admin/seed-demo`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/admin/seed-demo/status` | — | Сводка: какие демо-сущности уже наполнены. Дешёвый — только count'ы, не вызывает seed. UI использует… |
-| POST | `/api/admin/seed-demo` | — | Запустить seed демо-данных. Идемпотентен — если уже наполнено, возвращает existing summary без встав… |
-
-## `DiagnosticController`
-Base route: `/api/admin/diagnostic`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/admin/diagnostic/run` | — |  |
-
-## `EmployeeRolesController`
-Base route: `/api/organization/employee-roles`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/organization/employee-roles/{id:guid}` | — |  |
-| GET | `/api/organization/employee-roles` | — |  |
-| GET | `/api/organization/employee-roles/{id:guid}` | — |  |
-| POST | `/api/organization/employee-roles` | — |  |
-| PUT | `/api/organization/employee-roles/{id:guid}` | — |  |
-
-## `EmployeesController`
-Base route: `/api/organization/employees`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/organization/employees/{id:guid}` | — |  |
-| GET | `/api/organization/employees` | — |  |
-| GET | `/api/organization/employees/{id:guid}` | — |  |
-| POST | `/api/organization/employees` | — |  |
-| PUT | `/api/organization/employees/{id:guid}` | — |  |
-
-## `EntersController`
-Base route: `/api/inventory/enters`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/inventory/enters/{id:guid}` | — |  |
-| GET | `/api/inventory/enters` | — |  |
-| GET | `/api/inventory/enters/{id:guid}` | — |  |
-| POST | `/api/inventory/enters` | — |  |
-| POST | `/api/inventory/enters/{id:guid}/post` | — |  |
-| POST | `/api/inventory/enters/{id:guid}/unpost` | — |  |
-| PUT | `/api/inventory/enters/{id:guid}` | — |  |
-
-## `ExternalAuthController`
-Base route: `/api/auth/external`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/auth/external/callback` | — | Callback после успешного OAuth у провайдера. Читает claims и решает, что делать: связать с существую… |
-| GET | `/api/auth/external/providers` | — | Список доступных SSO-провайдеров. Web-фронт по этому списку решает, какие кнопки рисовать на /login. |
-| GET | `/api/auth/external/{provider}` | — | Инициирует OAuth challenge на провайдере. Если провайдер не сконфигурирован — 503 с подсказкой. |
-
-## `FeedbackController`
-Base route: `/api/feedback`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| POST | `/api/feedback` | — |  |
-
-## `GlobalSearchController`
-Base route: `/api/search`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/search/global` | — |  |
-
-## `InventoriesController`
-Base route: `/api/inventory/inventories`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/inventory/inventories/{id:guid}` | — |  |
-| GET | `/api/inventory/inventories` | — |  |
-| GET | `/api/inventory/inventories/{id:guid}` | — |  |
-| POST | `/api/inventory/inventories` | — |  |
-| POST | `/api/inventory/inventories/{id:guid}/post` | — |  |
-| POST | `/api/inventory/inventories/{id:guid}/unpost` | — |  |
-| PUT | `/api/inventory/inventories/{id:guid}` | — |  |
-
-## `LossesController`
-Base route: `/api/inventory/losses`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/inventory/losses/{id:guid}` | — |  |
-| GET | `/api/inventory/losses` | — |  |
-| GET | `/api/inventory/losses/{id:guid}` | — |  |
-| POST | `/api/inventory/losses` | — |  |
-| POST | `/api/inventory/losses/{id:guid}/post` | — |  |
-| POST | `/api/inventory/losses/{id:guid}/unpost` | — |  |
-| PUT | `/api/inventory/losses/{id:guid}` | — |  |
-
-## `LoyaltyCardsController`
-Base route: `/api/loyalty/cards`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/loyalty/cards/{id:guid}` | — |  |
-| GET | `/api/loyalty/cards` | — |  |
-| GET | `/api/loyalty/cards/lookup` | — | Lookup по CardNumber — используется кассой при оплате. Возвращает 404 если карты нет, 409 если карта… |
-| POST | `/api/loyalty/cards/issue` | — |  |
-| POST | `/api/loyalty/cards/{id:guid}/block` | — |  |
-| POST | `/api/loyalty/cards/{id:guid}/unblock` | — |  |
-
-## `LoyaltyProgramsController`
-Base route: `/api/loyalty/programs`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/loyalty/programs/{id:guid}` | — |  |
-| GET | `/api/loyalty/programs` | — |  |
-| GET | `/api/loyalty/programs/{id:guid}` | — |  |
-| POST | `/api/loyalty/programs` | — |  |
-| PUT | `/api/loyalty/programs/{id:guid}` | — |  |
-
-## `MeAccountController`
-Base route: `/api/me`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| POST | `/api/me/change-password` | — | Сменить пароль текущему юзеру. Требует текущий пароль для защиты от случайного/злонамеренного измене… |
-
-## `MeSessionsController`
-Base route: `/api/me/sessions`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| POST | `/api/me/sessions/revoke-all` | — | Гасит все refresh-токены текущего юзера. Использовать когда есть подозрение на угон cookies/пароля. |
-
-## `MoySkladImportController`
-Base route: `/api/admin/moysklad`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/admin/moysklad/settings` | — |  |
-| POST | `/api/admin/moysklad/import-counterparties` | — |  |
-| POST | `/api/admin/moysklad/import-products` | — |  |
-| POST | `/api/admin/moysklad/test` | — |  |
-| PUT | `/api/admin/moysklad/settings` | — |  |
-
-## `MoySkladSyncStatusController`
-Base route: `/api/moysklad`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/moysklad/sync-status` | — |  |
-
-## `OrgAuditLogController`
-Base route: `/api/admin/audit-log`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/admin/audit-log` | — |  |
-| POST | `/api/admin/audit-log/export` | — | Sprint 22: streaming-export audit-log для compliance / расследований. Multi-tenant — query-filter пр… |
-
-## `OrgExportController`
-Base route: `/api/org/export`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/org/export` | — |  |
-| GET | `/api/org/export/download/{token}` | — | Anonymous download по токену. Не требует авторизации — security через 256-битный random token + TTL … |
-| GET | `/api/org/export/{id:guid}` | — |  |
-| POST | `/api/org/export` | — | Создать новый экспорт. Возвращает 202 + Id; полезно сразу polled'ить GET /api/org/export/{id} до Sta… |
-
-## `OrgFiscalSettingsController`
-Base route: `/api/organization/fiscal`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/organization/fiscal` | — |  |
-| GET | `/api/organization/fiscal/providers` | — | Доступные значения провайдера для select'а в UI. Возвращаем массив, потому что enum-значения мы НЕ х… |
-| POST | `/api/organization/fiscal/test-send` | — | Тестовая отправка: создаёт «фейк-чек» (in-memory, не в БД) и отправляет через выбранного провайдера.… |
-| PUT | `/api/organization/fiscal` | — |  |
-
-## `OrganizationSettingsController`
-Base route: `/api/organization`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/organization/settings` | — |  |
-| PUT | `/api/organization/settings` | — |  |
-
-## `PlatformSettingsController`
-Base route: `/api/super-admin/platform-settings`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/super-admin/platform-settings` | — |  |
-| POST | `/api/super-admin/platform-settings/test-send` | — |  |
-| PUT | `/api/super-admin/platform-settings` | — |  |
-
-## `PosController`
-Base route: `/api/pos/v1`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/pos/v1/sync` | — |  |
-| POST | `/api/pos/v1/sales` | — |  |
-
-## `PriceTypesController`
-Base route: `/api/catalog/price-types`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/price-types/{id:guid}` | — |  |
-| GET | `/api/catalog/price-types` | — |  |
-| GET | `/api/catalog/price-types/{id:guid}` | — |  |
-| POST | `/api/catalog/price-types` | — |  |
-| PUT | `/api/catalog/price-types/{id:guid}` | — |  |
-
-## `ProductGroupsController`
-Base route: `/api/catalog/product-groups`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/product-groups/{id:guid}` | — |  |
-| GET | `/api/catalog/product-groups` | — |  |
-| GET | `/api/catalog/product-groups/{id:guid}` | — |  |
-| POST | `/api/catalog/product-groups` | — |  |
-| PUT | `/api/catalog/product-groups/{id:guid}` | — |  |
-
-## `ProductImagesController`
-Base route: `/api/catalog/products/{productId:guid}/images`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/products/{productId:guid}/images/{imageId:guid}` | — |  |
-| GET | `/api/catalog/products/{productId:guid}/images` | — |  |
-| POST | `/api/catalog/products/{productId:guid}/images` | — |  |
-| POST | `/api/catalog/products/{productId:guid}/images/{imageId:guid}/main` | — |  |
-
-## `ProductsController`
-Base route: `/api/catalog/products`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/products/{id:guid}` | — |  |
-| GET | `/api/catalog/products` | — |  |
-| GET | `/api/catalog/products/barcode-duplicates` | — | Находит штрихкоды, привязанные к более чем одному товару в текущей организации. Уникальный индекс эт… |
-| GET | `/api/catalog/products/by-barcode/{value}` | — | Точный поиск по штрихкоду (для сканера). 0 → 404, 1 → объект, несколько → { items: [...] } чтобы UI … |
-| GET | `/api/catalog/products/export` | — | Sprint 19: экспорт списка товаров с теми же фильтрами что и /api/catalog/products. Сервер-side генер… |
-| GET | `/api/catalog/products/quick-search` | — | Лёгкий поиск для inline-добавления строк в документы (приёмка, продажа). Ранжирует точное совпадение… |
-| GET | `/api/catalog/products/{id:guid}` | — |  |
-| PATCH | `/api/catalog/products/{id:guid}/price` | — |  |
-| POST | `/api/catalog/products` | — |  |
-| POST | `/api/catalog/products/bulk-update` | — |  |
-| POST | `/api/catalog/products/import-csv` | — |  |
-| POST | `/api/catalog/products/import/1c-csv` | — |  |
-| POST | `/api/catalog/products/{id:guid}/recalc-retail` | — | «Привести розничную к себестоимости»: ставит дефолтную розничную цену = ceil(Cost * (1 + Group.Marku… |
-| PUT | `/api/catalog/products/{id:guid}` | — |  |
-
-## `ProfitReportController`
-Base route: `/api/reports/profit`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/reports/profit` | — |  |
-| GET | `/api/reports/profit/export` | — |  |
-
-## `PromotionsController`
-Base route: `/api/promotions`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/promotions/{id:guid}` | — |  |
-| GET | `/api/promotions` | — |  |
-| GET | `/api/promotions/{id:guid}` | — |  |
-| POST | `/api/promotions` | — |  |
-| PUT | `/api/promotions/{id:guid}` | — |  |
-
-## `RetailPointsController`
-Base route: `/api/catalog/retail-points`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/retail-points/{id:guid}` | — |  |
-| GET | `/api/catalog/retail-points` | — |  |
-| GET | `/api/catalog/retail-points/{id:guid}` | — |  |
-| POST | `/api/catalog/retail-points` | — |  |
-| PUT | `/api/catalog/retail-points/{id:guid}` | — |  |
-
-## `RetailSalesController`
-Base route: `/api/sales/retail`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/sales/retail/{id:guid}` | — |  |
-| GET | `/api/sales/retail` | — |  |
-| GET | `/api/sales/retail/export` | — | Sprint 19: экспорт списка чеков с фильтрами status/storeId/from/to. |
-| GET | `/api/sales/retail/stats` | — | Aggregated sales metrics + daily series for the dashboard. Series buckets are days; defaults to last… |
-| GET | `/api/sales/retail/{id:guid}` | — |  |
-| POST | `/api/sales/retail` | — |  |
-| POST | `/api/sales/retail/{id:guid}/create-return` | — | POST /create-return — копирует строки проведённого чека в новый Draft с IsReturn=true и ReferenceSal… |
-| POST | `/api/sales/retail/{id:guid}/post` | — |  |
-| POST | `/api/sales/retail/{id:guid}/unpost` | — |  |
-| PUT | `/api/sales/retail/{id:guid}` | — |  |
-
-## `SalesReportController`
-Base route: `/api/reports/sales`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/reports/sales` | — |  |
-| GET | `/api/reports/sales/export` | — |  |
-
-## `StockController`
-Base route: `/api/inventory`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/inventory/movements` | — |  |
-| GET | `/api/inventory/stock` | — |  |
-| GET | `/api/inventory/stock/export` | — | Sprint 19: экспорт остатков. |
-
-## `StockReportController`
-Base route: `/api/reports/stock`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/reports/stock` | — |  |
-| GET | `/api/reports/stock/export` | — |  |
-
-## `StoresController`
-Base route: `/api/catalog/stores`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/stores/{id:guid}` | — |  |
-| GET | `/api/catalog/stores` | — |  |
-| GET | `/api/catalog/stores/{id:guid}` | — |  |
-| POST | `/api/catalog/stores` | — |  |
-| PUT | `/api/catalog/stores/{id:guid}` | — |  |
-
-## `SuperAdminController`
-Base route: `/api/super-admin`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/super-admin/audit-log` | — |  |
-| GET | `/api/super-admin/dashboard` | — |  |
-| GET | `/api/super-admin/settings` | — |  |
-| GET | `/api/super-admin/setup-status` | — |  |
-| PUT | `/api/super-admin/settings` | — |  |
-
-## `SuperAdminEmployeesController`
-Base route: `/api/super-admin/organizations/{orgId:guid}/employees`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/super-admin/organizations/{orgId:guid}/employees/{id:guid}` | — |  |
-| GET | `/api/super-admin/organizations/{orgId:guid}/employees` | — |  |
-| GET | `/api/super-admin/organizations/{orgId:guid}/employees/{id:guid}` | — |  |
-| POST | `/api/super-admin/organizations/{orgId:guid}/employees` | — |  |
-| POST | `/api/super-admin/organizations/{orgId:guid}/employees/{id:guid}/account/toggle-active` | — |  |
-| POST | `/api/super-admin/organizations/{orgId:guid}/employees/{id:guid}/reset-password` | — |  |
-| POST | `/api/super-admin/organizations/{orgId:guid}/employees/{id:guid}/toggle-active` | — |  |
-| PUT | `/api/super-admin/organizations/{orgId:guid}/employees/{id:guid}` | — |  |
-
-## `SuperAdminOrganizationsController`
-Base route: `/api/super-admin/organizations`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/super-admin/organizations/{id:guid}` | — |  |
-| GET | `/api/super-admin/organizations` | — |  |
-| GET | `/api/super-admin/organizations/{id:guid}` | — |  |
-| POST | `/api/super-admin/organizations` | — |  |
-| POST | `/api/super-admin/organizations/{id:guid}/archive` | — |  |
-| POST | `/api/super-admin/organizations/{id:guid}/change-owner` | — |  |
-| POST | `/api/super-admin/organizations/{id:guid}/restore` | — |  |
-| PUT | `/api/super-admin/organizations/{id:guid}` | — |  |
-
-## `SuperAdminUnitsOfMeasureController`
-Base route: `/api/super-admin/units-of-measure`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/super-admin/units-of-measure/{id:guid}` | — | Soft-delete: IsActive=false. Если на единицу ссылаются продукты или активные org-junction'ы — 409 со… |
-| GET | `/api/super-admin/units-of-measure` | — |  |
-| GET | `/api/super-admin/units-of-measure/{id:guid}` | — |  |
-| POST | `/api/super-admin/units-of-measure` | — |  |
-| PUT | `/api/super-admin/units-of-measure/{id:guid}` | — |  |
-
-## `SupplierReturnsController`
-Base route: `/api/purchases/supplier-returns`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/purchases/supplier-returns/{id:guid}` | — |  |
-| GET | `/api/purchases/supplier-returns` | — |  |
-| GET | `/api/purchases/supplier-returns/{id:guid}` | — |  |
-| POST | `/api/purchases/supplier-returns` | — |  |
-| POST | `/api/purchases/supplier-returns/{id:guid}/post` | — |  |
-| POST | `/api/purchases/supplier-returns/{id:guid}/unpost` | — |  |
-| PUT | `/api/purchases/supplier-returns/{id:guid}` | — |  |
-
-## `SuppliesController`
-Base route: `/api/purchases/supplies`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/purchases/supplies/{id:guid}` | — |  |
-| GET | `/api/purchases/supplies` | — |  |
-| GET | `/api/purchases/supplies/export` | — | Sprint 19: экспорт списка приёмок с теми же фильтрами. |
-| GET | `/api/purchases/supplies/{id:guid}` | — |  |
-| POST | `/api/purchases/supplies` | — |  |
-| POST | `/api/purchases/supplies/{id:guid}/post` | — |  |
-| POST | `/api/purchases/supplies/{id:guid}/unpost` | — |  |
-| PUT | `/api/purchases/supplies/{id:guid}` | — |  |
-
-## `TelegramBindingController`
-Base route: `/api/organization/telegram`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/organization/telegram` | — |  |
-| GET | `/api/organization/telegram/status` | — |  |
-| PUT | `/api/organization/telegram/bind` | — |  |
-
-## `TransfersController`
-Base route: `/api/inventory/transfers`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/inventory/transfers/{id:guid}` | — |  |
-| GET | `/api/inventory/transfers` | — |  |
-| GET | `/api/inventory/transfers/{id:guid}` | — |  |
-| POST | `/api/inventory/transfers` | — |  |
-| POST | `/api/inventory/transfers/{id:guid}/post` | — |  |
-| POST | `/api/inventory/transfers/{id:guid}/unpost` | — |  |
-| PUT | `/api/inventory/transfers/{id:guid}` | — |  |
-
-## `TwoFactorController`
-Base route: `/api/me/2fa`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/me/2fa/status` | — |  |
-| POST | `/api/me/2fa/disable` | — |  |
-| POST | `/api/me/2fa/enroll` | — |  |
-| POST | `/api/me/2fa/verify` | — |  |
-
-## `UnitsOfMeasureController`
-Base route: `/api/catalog/units-of-measure`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/catalog/units-of-measure/{id:guid}/enable` | — | Отключить global для текущей орги. Если на эту единицу ссылаются продукты орги — 409 со списком назв… |
-| GET | `/api/catalog/units-of-measure` | — | Список единиц для текущей орги: только включённые active globals. Для SuperAdmin без override — все … |
-| GET | `/api/catalog/units-of-measure/{id:guid}` | — |  |
-| POST | `/api/catalog/units-of-measure/{id:guid}/enable` | — | Включить global для текущей орги. Идемпотентно: повторный вызов отдаёт 204 и не плодит дубликатов ju… |
-
-## `UploadsController`
-Base route: `/uploads`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/uploads/{*path}` | — |  |
-
-## `UserPresetsController`
-Base route: `/api/user/presets`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| DELETE | `/api/user/presets/{id:guid}` | — |  |
-| GET | `/api/user/presets` | — |  |
-| POST | `/api/user/presets` | — |  |
-| PUT | `/api/user/presets/{id:guid}` | — |  |
-
-## `WhatsNewController`
-Base route: `/api/whats-new`
-
-| Method | Route | Permission | Summary |
-|---|---|---|---|
-| GET | `/api/whats-new` | — |  |

docs/audit-2026-04-27.md

@@ -1,134 +0,0 @@
-# Системный аудит — 2026-04-27
-
-Полный обход auth, tenant isolation, удаления сущностей, override-режима, локализации, валидации форм. Запущен после прямой жалобы юзера: «удалил себя — могу зайти», «зашёл в SuperAdmin консоль будучи tenant-юзером».
-
-## Корневая диагностика nurnetps@gmail.com
-
-Состояние БД на момент аудита (см. SQL-скрипты в этом отчёте):
-
-```
-users.Id             = fbe4255a-c1ad-4355-88c1-ef21dfcd6db2
-users.IsActive       = true
-users.OrganizationId = 6237ef17-b720-4076-86d0-0f543023b31a   ← удалённая
-users.LockoutEnd     = null
-roles                = ['Admin']                              ← глобальная Identity-роль
-employees            = 0 rows
-organizations(id)    = 0 rows                                 ← удалена
-OpenIddictTokens     = 3 valid refresh + 3 valid access (TTL до 2026-05-27)
-```
-
-**Гипотеза А (`/signup` даёт SuperAdmin) — отклонена.** В `AuthSignupController.cs:79` назначается роль `Admin`, не `SuperAdmin`.
-
-**Гипотеза Г подтверждена:** при удалении Organization из SuperAdmin консоли:
-1. Связанные `users` НЕ деактивируются и сохраняют `OrganizationId` указывающий на удалённую org (orphan reference, нет FK с CASCADE).
-2. OpenIddict refresh/access tokens НЕ отзываются.
-3. `Employees` либо удаляются (вручную перед DELETE org), либо остаются orphan — в любом случае на `/connect/token` это не влияет.
-
-Login повторно проходит, потому что:
-- `users.IsActive=true` (поле есть, но никто не сбрасывает на DELETE org).
-- Пароль валиден.
-- Identity-роль `Admin` глобальная.
-- На бэке нет проверки «AppUser.OrganizationId должен указывать на живую Organization».
-- На фронте после login нет проверки «активный Employee в орге».
-
-Override-баннер видит обычный tenant-юзер потому что (см. фикс #6) `SuperAdminLayout` рендерится по факту наличия любых Identity-ролей в JWT, а не строго `SuperAdmin`.
-
-## Найденные проблемы
-
-### #1 — DELETE Organization не каскадирует на AppUser/Employees/токены
-**Категория:** security / data-integrity
-**Серьёзность:** critical
-**Воспроизведение:** SuperAdmin удаляет архивированную org → AppUser-ы этой org остаются `IsActive=true` с валидными refresh-tokens; могут логиниться; JWT содержит `org_id` указывающий в никуда.
-**Корневая причина:** `SuperAdminOrganizationsController.Delete` (api/Controllers/SuperAdmin) делает `_db.Organizations.Remove(o)` без побочных эффектов; FK от `users.OrganizationId` к `organizations.Id` отсутствует на уровне БД.
-**Фикс:** перед `Remove(org)` — `users.IsActive=false` + `Employees.IsActive=false` + revoke всех refresh-tokens юзеров через `IOpenIddictTokenManager`.
-
-### #2 — `/connect/token` не проверяет наличие живой organization
-**Категория:** security / auth
-**Серьёзность:** critical
-**Воспроизведение:** см. nurnetps — login проходит при удалённой org.
-**Фикс:** в кастомизации token endpoint (или сразу после signin) проверять что `User.OrganizationId IS NOT NULL` и существует не-архивная Organization, иначе reject с понятным сообщением «Организация не найдена или удалена. Обратитесь к владельцу».
-
-### #3 — `EmployeesController.Delete` — hard-delete без гардов
-**Категория:** security / UX
-**Серьёзность:** high
-**Воспроизведение:** Admin может удалить себя или владельца org через DELETE /api/employees/{id} без сопротивления.
-**Фикс:** проверки `e.UserId == currentUserId` → 403, `e.UserId == org.AccountOwnerUserId` → 403, soft-delete (`IsActive=false`) вместо `Remove`.
-
-### #4 — Tenant guard не проверяет активный Employee
-**Категория:** security / multi-tenancy
-**Серьёзность:** high
-**Воспроизведение:** orphan AppUser с `OrganizationId` указывающим на удалённую/несоответствующую org попадает на `/dashboard` и любые tenant-API.
-**Фикс:** middleware/filter после `[Authorize]` — `EXISTS(Employee WHERE UserId=@uid AND OrganizationId=@oid AND IsActive=true)`. SuperAdmin override обходит проверку (ему так и надо). Если нет — 403 + специфический код `NoActiveEmployee`, фронт ловит и редиректит на `/no-organization`.
-
-### #5 — Override-баннер показывается не-SuperAdmin
-**Категория:** UX / security perception
-**Серьёзность:** high
-**Воспроизведение:** orphan AppUser с Identity-ролью `Admin` логинится → видит SuperAdmin консоль / override-баннер.
-**Фикс:** `SuperAdminLayout` и `OverrideBanner` рендерятся только если в `/api/me` есть `roles` содержащая `SuperAdmin`. Все остальные — на `/dashboard` или `/no-organization`.
-
-### #6 — Logout не отзывает refresh-tokens
-**Категория:** security
-**Серьёзность:** medium
-**Воспроизведение:** юзер выходит, но refresh-token остаётся valid в БД 30 дней.
-**Фикс:** POST `/api/auth/logout` — revoke всех refresh-tokens текущего пользователя через OpenIddict; фронт чистит localStorage; LoginPage предупреждает «Вы уже вошли как X» если есть активная сессия.
-
-### #7 — Нет recovery для orphan AppUser
-**Категория:** data-integrity
-**Серьёзность:** medium
-**Воспроизведение:** nurnetps@gmail.com висит в БД с указателем на удалённую org.
-**Фикс:** SQL-скрипт `deploy/recovery-restore-orphan-owners.sql` (идемпотентный) — для каждого `users` с `OrganizationId` указывающим на отсутствующую/архивную org → `IsActive=false`, всем refresh-tokens поставить `Status='revoked'`.
-
-### #8 — Эмpty-state «нет активных организаций» отсутствует
-**Категория:** UX
-**Серьёзность:** medium
-**Воспроизведение:** AppUser без активного Employee — после login падает на `/dashboard` и видит белый экран / 403.
-**Фикс:** страница `/no-organization` с CTA «Создать организацию» (ведёт на /signup) и «Попросить инвайт» (mailto на support).
-
-## Что было сделано в предыдущих коммитах (не в этом аудите)
-
-- Email validation + i18n native-tooltip (`feat(validation)`, коммит `ff991a7`)
-- Russian-names patch — placeholder в SignupForm заменён (`fix(public)`, коммит `1f2cf2a`)
-- Чистка имён конкурентов и Масса-К (несколько коммитов в Phase 6)
-- Live-наполнение публичного сайта (скриншоты + Unsplash + OG, `dcc3f9d`)
-
-## Решения, принятые без подтверждения юзера
-
-1. **Soft-delete vs hard-delete для Employee:** soft (`IsActive=false`). История операций сохраняется.
-2. **Хранение Owner-маркера:** уже есть `Organization.AccountOwnerUserId` — использую его, новой колонки `Employee.IsOwner` не нужно.
-3. **Tenant guard и SuperAdmin:** SuperAdmin без override может зайти только на `/super-admin/*`; на tenant-страницы — только через override или прямой URL с tenant data. SuperAdmin override обходит guard «активный Employee».
-4. **Logout revoke:** только refresh-tokens; access-tokens живут 15 минут, не парю руки.
-5. **Recovery скрипт:** идемпотентный, безопасный к повторному запуску. Не рушит данные — только деактивирует orphan AppUser.
-6. **Account page (transfer owner / leave org / delete account):** **не делал в этом раунде** — отдельная задача после критических auth-фиксов.
-7. **Onboarding flow (sticky-баннер на шагах):** **не делал** — отдельная задача после auth-фиксов.
-
-## Открытые вопросы (требуют решения юзера)
-
-1. **Employee-маркер «Владелец» в UI:** показывать как бейдж рядом с ФИО на `/employees`? Сейчас Owner определяется через `org.AccountOwnerUserId == employee.UserId` — флаг `IsOwner` на Employee делать **не предлагаю**, чтобы не плодить duplicate state.
-2. **Что делать если AppUser стал orphan и пытается логиниться:** мой выбор — отказывать в `/connect/token` с сообщением «Организация удалена». Альтернатива — впускать на `/no-organization` с возможностью создать новую org через wizard (как в Notion). Если нужен второй вариант — потребует UX-проектирования.
-3. **Inviting flow** (юзер без org попросил доступ к чужой): не реализовано, не в скоупе аудита.
-
-## Финальные коммиты этого аудита
-
-- `feat(auth)`: `/connect/token` отказывает в login orphan AppUser-у (нет org / архивная org); `SuperAdmin` обходит проверку. Файлы: `AuthorizationController.cs`.
-- `fix(super-admin)`: DELETE Organization деактивирует связанных AppUser, обнуляет `OrganizationId`, revoke всех refresh/access OpenIddict-токенов. Файлы: `SuperAdminOrganizationsController.cs`.
-- `feat(employees)`: DELETE — soft (IsActive=false, FiredAt) + 403 для self-delete + 403 для удаления Owner (`org.AccountOwnerUserId == employee.UserId`). Файлы: `EmployeesController.cs`.
-- `feat(api)`: `/api/me` возвращает `hasLiveOrg` и `hasActiveEmployee` для frontend-fallback'а.
-- `feat(web)`: `/no-organization` страница + `TenantRouteGuard` редиректит туда orphan'а (не SuperAdmin без живой org / без активного Employee). Файлы: `App.tsx`, `pages/NoOrganizationPage.tsx`, `components/TenantRouteGuard.tsx`.
-- `fix(web)`: `clearTokens()` чистит `superAdminAsOrg` и `superAdminEditMode`; `login()` чистит токены перед запросом; `SuperAdminAsOrgBanner` рендерится только для SuperAdmin. Файлы: `lib/auth.ts`, `lib/api.ts`, `components/SuperAdminAsOrgBanner.tsx`.
-- `chore(recovery)`: `deploy/recovery-restore-orphan-owners.sql` — деактивирует orphan AppUser, revoke токены. Применён на стейдже.
-
-### Smoke после фикса
-- `nurnetps@gmail.com` → POST /connect/token → `invalid_grant` «Неверный логин или пароль».
-- `admin@food-market.local` (SuperAdmin) → login проходит.
-- Публичный сайт + админка отдают 200.
-- В БД: `users.IsActive=false`, 9 OpenIddict tokens у nurnetps теперь `revoked`.
-
-## Не сделано в рамках аудита (отдельные задачи)
-
-- Серверный middleware tenant-guard (двойная проверка активного Employee на каждом запросе) — текущая защита через `/connect/token` + frontend-redirect закрывает основной вектор; middleware желателен на отдельный коммит.
-- Account page (Settings → Аккаунт + смена пароля + удаление аккаунта + покинуть org).
-- Transfer-owner UI с модалом передачи прав.
-- Onboarding sticky-баннер на шагах.
-- Убран `Employee.IsOwner` поле — используем существующий `Organization.AccountOwnerUserId`.
-
-Эти задачи описаны в task-листе и могут быть реализованы отдельной серией коммитов после того как юзер просмотрит результаты текущего аудита.

docs/audit-2026-05-06.md

@@ -1,107 +0,0 @@
-# Системный аудит авторизации — 2026-05-06
-
-Финальный пункт пакета фиксов по системе ролей. Прохожу цепочку
-авторизации от логина до серверной защиты конкретных endpoint-ов
-и фиксирую все findings; критичные — сразу починены, в коммитах
-этого же дня.
-
-## 1. Логин: OpenIddict /connect/token
-
-`AuthorizationController.cs`:
-- Password grant: `_userManager.FindByNameAsync` + `CheckPasswordSignInAsync` + проверка `User.IsActive`.
-- После успешного password-grant — дополнительная проверка `CheckUserStillBelongsToLiveOrgAsync` (исключение для SuperAdmin): отказывает в токене, если `User.OrganizationId` указывает на удалённую/архивированную org. Это закрывает orphan-AppUser сценарий из аудита 2026-04-27.
-- Refresh grant: повторно проверяет `IsActive` и `BelongsToLiveOrg`.
-- Поле `org_id` пишется в JWT-claims как `HttpContextTenantContext.OrganizationClaim`.
-
-**Status: OK.** Проверки покрывают: deactivated user, orphan org, SuperAdmin override.
-
-## 2. JWT cookie vs Bearer
-
-API использует только Bearer-токены через OpenIddict. Cookie-схему AspNetCore Identity подавляет `AddAuthentication` (см. `Program.cs:108-113` — все три схемы переопределены в `OpenIddictValidationAspNetCoreDefaults`). Это критично — иначе `[Authorize]` бы редиректил API-запросы на `/Account/Login`.
-
-**Status: OK.**
-
-## 3. X-Org-Override (impersonation)
-
-`HttpContextTenantContext.cs`:
-- `OrgOverrideHeader = "X-Org-Override"`.
-- `TryGetHttpOverrideOrg`: возвращает `true` ТОЛЬКО если `User.IsInRole("SuperAdmin")` И header присутствует. Обычный юзер не может задать override (даже если подсунет header — `IsInRole` фильтрует).
-- В режиме override `IsTenantOverride=true`. Tenant-фильтр в `AppDbContext.ApplyTenantFilter` строится так:
-  ```
-  (IsSuperAdmin && !IsTenantOverride) || OrganizationId == _tenant.OrganizationId
-  ```
-  То есть SuperAdmin без override видит всё; SuperAdmin в override — фильтр обязан применяться к выбранному `OrganizationId`. Ровно так, как нужно.
-
-**Status: OK.** Проверка роли защищает от подделки header'а.
-
-## 4. Tenant query filters
-
-`AppDbContext.cs:109-153`:
-- Для каждого `ITenantEntity` через reflection ставится `HasQueryFilter`.
-- Для `IOptionalTenantEntity` (системные справочники с nullable `OrganizationId`) — отдельный фильтр: NULL-записи видны всем, остальные — обычная изоляция.
-- Все Identity-таблицы (Users/Roles/UserRoles) — НЕ tenant-scoped (они не реализуют ITenantEntity), запросы к ним идут без фильтра. Это by design — Identity управляется через UserManager/RoleManager.
-
-**Status: OK.**
-
-## 5. Smoke (UI) ожидаемое поведение по ролям
-
-Согласно `AppLayout.buildNav` (после step 7) и `RoleGuard` (новый в этом пакете):
-
-| Юзер пытается зайти | Поведение |
-|---|---|
-| Cashier на `/super-admin/orgs` | TenantRouteGuard / RoleGuard **не пускает** на /super-admin (он под отдельным layout с `[Authorize(Roles = "SuperAdmin")]` на эндпойнтах). Юзер увидит «Нет доступа» из RoleGuard и/или 403 от API. |
-| Storekeeper на `/settings/employees` | RoleGuard `roles=['Admin']` → «Нет доступа». |
-| Cashier на `/catalog/counterparties` | RoleGuard `roles=['Admin']` → «Нет доступа». |
-| Tenant-Admin на `/super-admin/...` | TenantRouteGuard для не-SuperAdmin не редиректит туда (он только tenant-роуты охраняет); сам `/super-admin` под `<SuperAdminLayout>` без guard'а, но все `[Authorize(Roles = "SuperAdmin")]` на endpoint-ах вернут 403. UI покажет 403-страницы пустые таблицы / ошибки. **Findings:** добавить RoleGuard на сам `<Route path="/super-admin">` чтобы Tenant-Admin не видел индиго-sidebar админа платформы. → Не сделано в этом пакете, описано как future. |
-| 401 на любом запросе | `api.ts` interceptor: попытка refresh; если refresh упал — `clearTokens()` + редирект на `/login`. |
-
-## 6. Reset пароля и инвалидация токенов
-
-`SuperAdminEmployeesController.ResetPassword`:
-- `_userMgr.RemovePasswordAsync` + `AddPasswordAsync(temp)`.
-- `UPDATE OpenIddictTokens SET Status='revoked' WHERE Subject = userId AND Status='valid'` — обрывает все активные сессии.
-
-`SuperAdminEmployeesController.ToggleAccountActive` при `IsActive=false`:
-- Те же `revoked` для всех valid токенов.
-
-**Status: OK.**
-
-## 7. Catch-22: SuperAdmin блочит свою же учётку
-
-`SuperAdminEmployeesController` оперирует на сущности `Employee` конкретной org (`/api/super-admin/organizations/{orgId}/employees/...`). SuperAdmin платформы — это `User` БЕЗ `OrganizationId` и БЕЗ `Employee`. Через этот контроллер до его учётки не дойти.
-
-Других endpoint-ов, через которые можно `User.IsActive=false` для произвольного user-id — НЕТ. `SuperAdminOrganizationsController.Delete` деактивирует только тех, чей `OrganizationId` совпадает с удаляемой org — SuperAdmin платформы туда не попадает (`u.OrganizationId == null`).
-
-**Status: OK сейчас.** Future risk: если добавится `/api/super-admin/users/...` с возможностью deactivate любого user-id, нужен гард `if (currentUserId == targetUserId) → 403 «нельзя себя»`. Запишу как TODO.
-
-## 8. Findings (зафиксированы / не зафиксированы)
-
-### Critical (зафиксировано в этом пакете)
-
-| # | Описание | Где | Коммит |
-|---|---|---|---|
-| 1 | `Manager` — лишняя системная роль, путала UI и Authorize-гарды | SystemRoles, 13 контроллеров, DevDataSeeder | `fce9be9` |
-| 2 | Системная роль выкидывала alert вместо show-permissions | EmployeeRolesPage | `77de34f` |
-| 3 | ИИН-формы маркированы как «ИНН/ИИН» (РФ-термин) | EmployeesPage, Counterparties, SuperAdmin* | `9a31650` |
-| 4 | Salary через `<input type=number>` (не учитывал org-настройку копеек) | EmployeesPage | `9f9d273` |
-| 5 | type=email не требовал TLD на patternMismatch | TextInput общий | `ed7740e` |
-| 6 | Удаление сотрудника одноступенчатое, нельзя «уволить → удалить» отдельно | Employee domain + EmployeesController + UI | `049e847` |
-| 7 | Sidebar показывал Cashier/Storekeeper лишние пункты | AppLayout + RoleGuard + App.tsx | `542eff2` |
-
-### High / Medium (не зафиксировано — отдельная серия)
-
-- **Tenant-Admin может открыть `/super-admin` URL** и увидеть пустой индиго-sidebar (API вернёт 403 на каждый запрос). Нет RoleGuard на сам Route `/super-admin/*`. Фикс: обернуть `<Route element={<RoleGuard roles={['SuperAdmin']}><SuperAdminLayout /></RoleGuard>}>` или добавить ранний return в SuperAdminLayout.
-- **`Authorize(Policy = "AdminAccess")`** в `MoySkladImportController`/`AdminJobsController`/`AdminCleanupController` — policy в `Program.cs:118-119` пропускает Admin **или** SuperAdmin. SuperAdmin без override проходит — нужен ли он там? Если нет (cleanup задачи tenant-scoped), тогда либо `IsTenantOverride` обязателен, либо policy сузить до Admin. Это не critical, но архитектурно хочется единообразия.
-- **Catch-22 защита для будущего `/api/super-admin/users/...`** — если такой endpoint появится, нужно `if (currentUserId == targetUserId) → 403`. Сейчас такого endpoint-а нет, риска тоже нет.
-- **Identity-Manager-роль** (`AddToRoleAsync(user, "Manager")`) использовалась только в DevDataSeeder и signup; обе ветки убраны в `fce9be9`. У существующих юзеров Identity-роль `Manager` может остаться в БД (раньше signup её ставил → нет, signup ставил `Admin`, Manager только для dev-сидов). Нужно ли `RoleManager.DeleteAsync(Manager)`? Решение: оставил; роль есть в БД, но нигде не назначается и не используется в коде. Безопасно.
-- **DevDataSeeder продолжает создавать Demo Market и admin@food-market.local** на каждом старте API. Для production это лишнее — Demo Market и dev-admin засоряют prod-БД. Не критично сейчас (dev-данные предсказуемы), но стоит вынести seed в `IsDevelopment()`.
-- **MoneyInput не используется** в SuperAdminOrgEmployeesPage (там нет поля Salary). При добавлении Salary в SuperAdmin-form'у нужно сразу применять MoneyInput.
-
-### Low (косметика / документация)
-
-- `EmployeesPage.useEffect` имеет логику дефолтной роли «Менеджер ?? roles[0]» — после удаления Manager-сидера всегда упадёт на roles[0]. Не баг, но стоит переписать на `Кассир` или `Кладовщик` как дефолт.
-- `EmployeeRole.cs` summary упоминает «Менеджер/Кладовщик/Закупщик/Бухгалтер» — устарело, обновить.
-
-## Итог
-
-Все 8 пунктов задачи закрыты или зафиксированы в этом отчёте. 7 атомарных коммитов между `fce9be9..542eff2`. Билд и API, и web проходят чисто (0 errors). Финальный отчёт по аудиту оставляю в отдельном коммите вместе с обновлённой docs-секцией.

docs/audit-moysklad.md

@@ -1,464 +0,0 @@
-# Аудит наших доменных сущностей vs. MoySklad API
-
-Источник правды — живой MoySklad API `/api/remap/1.2/`. Проверялись ключи на реальных ответах (`?limit=2` на нашем аккаунте). Цель: каждая наша сущность должна либо повторять MoySklad, либо иметь явно оправданное отличие. Никаких «выдуманных» полей.
-
-Условные обозначения:
-- **⛔** — у нас есть поле, которого нет у MoySklad → либо оправдать комментарием, либо удалить.
-- **➕** — у MoySklad есть поле, которого нет у нас → потенциально добавить.
-- **⚠️** — важный нюанс (тип, семантика, обязательность).
-
----
-
-## Counterparty → `entity/counterparty`
-
-Ключи MoySklad (из ответа API, верхний уровень): `accountId, accounts, archived, bonusPoints, bonusProgram, companyType, created, externalCode, files, group, id, meta, name, notes, owner, salesAmount, shared, state, tags, updated` + расширяемые: `legalTitle, legalAddress, inn, kpp, ogrn, ogrnip, certificateNumber, certificateDate, phone, email, actualAddress, description, discountCardNumber, priceType, sex, salesChannel`.
-
-| Наше поле | MoySklad | Комментарий |
-|---|---|---|
-| `Name` | `name` | ОК |
-| `LegalName` | `legalTitle` | rename? или доп. комментарий-алиас |
-| `Kind` (CounterpartyKind) | **нет** | ⛔ уже исправили enum (`Unspecified/Supplier/Customer/Both`), но MoySklad не имеет этого поля вообще — он различает контрагентов через `tags` или через `state` (статус в пайплайне продаж/закупок). **TODO:** либо оставить Kind только как UI-фильтр (не импортировать из MoySklad), либо перейти на теги |
-| `Type` (LegalEntity/Individual) | `companyType` | ⚠️ у MoySklad 3 значения: `legal`, `individual`, `entrepreneur` (ИП!). У нас ИП отсутствует — **добавить `IndividualEntrepreneur` в enum** (для РК актуально) |
-| `Bin` (БИН, РК) | `inn` (12-значный БИН пишется туда) | ⚠️ MoySklad для всех рынков использует `inn` — 12 цифр это ИИН РФ, 12 цифр РК — БИН. Мы вынесли `Bin` отдельно, при импорте MoySklad кладёт в `inn`. **TODO:** документировать маппинг Bin ↔ inn |
-| `Iin` (ИИН, РК) | `inn` (тот же) | ⚠️ same — MoySklad не различает |
-| `TaxNumber` | `inn` | дубль |
-| `CountryId` | `country` (extended, по `meta`) | ⚠️ MoySklad не на верхнем уровне — тянется при `?expand=country` |
-| `Address` | `actualAddress` | ОК |
-| `Phone` | `phone` | ОК |
-| `Email` | `email` | ОК |
-| `BankName, BankAccount, Bik` | `accounts` (массив объектов) | ⚠️ у MoySklad это **коллекция счетов** (до нескольких банков). У нас одиночные поля — **либо сделать коллекцию Accounts, либо документировать "берём первый"** |
-| `ContactPerson` | `contactpersons` (sub-endpoint) | ⚠️ у MoySklad это отдельный endpoint `counterparty/{id}/contactpersons` — массив. У нас скалярное поле |
-| `Notes` | `description` (или `notes` разные в разных версиях API?) | ⚠️ в ответе API было `notes` — ОК |
-| `IsActive` | `archived` (inverse) | ОК |
-| — | `tags` (массив) | ➕ **добавить** — удобно для классификации (в том числе заменой Kind) |
-| — | `state` (ссылка на состояние в пайплайне) | ➕ отложить до Phase N (CRM) |
-| — | `bonusPoints, bonusProgram, discountCardNumber` | ➕ отложить до дисконтных карт |
-| — | `salesAmount` (вычисляемое) | не храним |
-| — | `priceType` (персональный тип цены) | ➕ полезно для опта; добавить `Guid? DefaultPriceTypeId` |
-
-**TODO:**
-1. Enum `CounterpartyType`: добавить `IndividualEntrepreneur = 3`.
-2. Коллекция `CounterpartyAccount` (BankName/BankAccount/Bik/IsDefault) — или явный комментарий «храним только основной».
-3. Коллекция `CounterpartyTag` (string) — для классификации при импорте из MoySklad.
-4. Поле `DefaultPriceTypeId` → `PriceType` (для опта/персональной цены).
-5. Комментарий на `Bin/Iin/TaxNumber`: при импорте из MoySklad все три могут прилететь из одного поля `inn` — логика различения по длине (12 цифр РК-формат) / по companyType.
-
----
-
-## Organization → `entity/organization`
-
-Ключи MS: `accountId, accounts, archived, bonusPoints, bonusProgram, companyType, companyVat__ru, created, email, externalCode, group, id, isEgaisEnable, meta, name, owner, payerVat, shared, updated` + extended: `legalTitle, legalAddress, actualAddress, inn, kpp, ogrn, ogrnip, okpo, director, chiefAccountant, phone, fax, utmUrl`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Name` | `name` | ОК |
-| `CountryCode` | **нет** | ⛔ у MoySklad нет — у них multi-tenant через account. У нас — multi-tenant через Organization, но CountryCode неочевиден. Оставить как есть, документировать почему (нам нужно для налоговых/локальных настроек) |
-| `Bin` | `inn` | то же что и Counterparty |
-| `Address` | `actualAddress` | ОК |
-| `Phone` | `phone` | ОК |
-| `Email` | `email` | ОК |
-| `IsActive` | `archived` inverse | ОК |
-| — | `legalTitle, legalAddress` | ➕ для офиц. документов |
-| — | `kpp, ogrn, ogrnip, okpo` | РФ-специфично, пропускаем для РК |
-| — | `payerVat` (bool, плательщик НДС) | ➕ полезно — есть ли НДС у нашей организации |
-| — | `director, chiefAccountant` | ➕ для подписей на накладных |
-| — | `accounts` (банковские) | ➕ аналогично Counterparty |
-| — | `isEgaisEnable` | РФ, пропускаем |
-
-**TODO:**
-1. `LegalName`, `LegalAddress`, `PayerVat` (bool), `DirectorName`, `ChiefAccountantName` — для накладных/счетов.
-2. `CountryCode` оставить + `<see langword="…"/>` комментарий почему у нас есть, а у MS нет.
-
----
-
-## Product → `entity/product`
-
-Ключи MS: `accountId, archived, barcodes, buyPrice, code, discountProhibited, externalCode, files, group, id, images, isSerialTrackable, meta, minPrice, name, owner, pathName, paymentItemType, productFolder, salePrices, shared, supplier, trackingType, uom, updated, useParentVat, variantsCount, volume, weight` + optional: `article, country, description, effectiveVat, minPrice.currency, taxSystem, vat, tnved, syncId, modifications`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Name` | `name` | ОК |
-| `Article` | `article` | ОК |
-| `Description` | `description` | ОК |
-| `UnitOfMeasureId` | `uom.meta` | ОК |
-| `VatRateId` | `vat` (число) + `useParentVat` | ⚠️ у MS НДС хранится как число (20, 10, 12, 0) прямо на товаре. **Мы отдельная сущность VatRate**. Обоснование: нам нужно хранить локализованные названия ("НДС 12%", "Без НДС"), is-default, и позволять разным организациям иметь разные ставки. НО — при импорте надо резолвить число в VatRate по organization_id |
-| `ProductGroupId` | `productFolder.meta` | ОК |
-| `DefaultSupplierId` | `supplier.meta` | ОК (у MS тоже одиночная ссылка) |
-| `CountryOfOriginId` | `country.meta` | ОК |
-| `IsService` | `paymentItemType` (одно из значений = "SERVICE") | ⚠️ у MS это enum с ~10 значений; у нас bool. **TODO:** либо enum, либо документировать что мы учитываем только IsService |
-| `IsWeighed` | **нет** | ⛔ у MS этого нет; характеристика ритейла, нам нужно для касс с весами. **Оставить, документировать.** |
-| `IsAlcohol` | `tnved` (класс товара) или через group | ⚠️ у MS через tnved-код или through type классификаторы. Наше bool — упрощение. **Оставить с комментарием.** |
-| `IsMarked` | `trackingType` (enum: NOT_TRACKED, BEER_ALCOHOL, …) | ⚠️ У MS это enum из 10+ вариантов маркировки. Наш `IsMarked: bool` — потеря информации. **TODO:** заменить на enum `TrackingType` (NOT_TRACKED/TOBACCO/ALCOHOL/SHOES/MEDICINE/…) |
-| `MinStock, MaxStock` | `minimumBalance` (число), `stock` (runtime) | ⚠️ у MS есть только `minimumBalance` (нижняя граница). MaxStock — наш |
-| `PurchasePrice, PurchaseCurrencyId` | `buyPrice.value, buyPrice.currency.meta` | ОК (MS упаковывает в объект, мы разнесли — **одно и то же**) |
-| `ImageUrl` | `images` (массив через sub-endpoint) | ⚠️ у MS images коллекция, у нас одна + отдельная ProductImage. ОК, двойная запись для UX |
-| `IsActive` | `archived` inverse | ОК |
-| `Prices` (collection) | `salePrices` (массив inline в MS) | ⚠️ у MS цены — **массив внутри товара**, у нас — отдельная таблица. Оба норм; просто маппинг при sync |
-| `Barcodes` (collection) | `barcodes` (массив inline) | ОК |
-| `Images` (collection) | `images` (sub-endpoint) | ОК |
-| — | `code` | ➕ внутренний код (отличается от `article`). **Добавить `Code`** |
-| — | `externalCode` | ➕ используется при импорте/ERP-интеграциях. **Добавить `ExternalCode`** (актуально для импорта из MoySklad, 1C) |
-| — | `discountProhibited` | ➕ «запрет скидок» — полезно на кассе |
-| — | `minPrice.value/currency` | ➕ минимальная отпускная цена. **Добавить `MinPrice` + `MinPriceCurrencyId`** |
-| — | `paymentItemType` | ➕ для фискализации: «товар/услуга/работа/подарочная карта/…». **Добавить enum `PaymentItemType`** (нужно для 54-ФЗ / КZ fiscal receipts) |
-| — | `tnved` | ➕ код ТН ВЭД для трансграничной торговли |
-| — | `volume, weight` | ➕ для логистики (доставка) |
-| — | `variantsCount` | runtime агрегат, не храним |
-| — | `files` | ➕ вложения (паспорта качества, фото упаковки) — отложить |
-
-**TODO:**
-1. Добавить `Code`, `ExternalCode` на Product.
-2. Заменить `IsMarked` на enum `TrackingType`.
-3. Добавить `MinPrice`, `MinPriceCurrencyId`.
-4. Добавить enum `PaymentItemType` + поле.
-5. Поля `Volume`, `Weight`, `DiscountProhibited`.
-6. Запомнить маппинг: `useParentVat` → наследовать НДС от ProductGroup (у нас сейчас не реализовано, надо подумать).
-
----
-
-## ProductGroup → `entity/productfolder`
-
-Ключи MS: `accountId, archived, externalCode, group, id, meta, name, owner, pathName, shared, updated, useParentVat` + `vat, effectiveVat, productFolder` (родитель).
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Name` | `name` | ОК |
-| `ParentId` | `productFolder.meta` | ОК (MS использует то же имя для родителя что и для самой сущности) |
-| `Path` | `pathName` | ОК |
-| `SortOrder` | **нет** | ⛔ у MS нет сортировки групп. Оставить, это UX |
-| `IsActive` | `archived` inverse | ОК |
-| — | `externalCode` | ➕ для импорта |
-| — | `vat, useParentVat` | ➕ ставка НДС по умолчанию для товаров группы |
-
-**TODO:**
-1. Добавить `ExternalCode`.
-2. Добавить `VatRateId?` + `UseParentVat: bool` (для наследования).
-
----
-
-## ProductBarcode → `product.barcodes[]`
-
-У MS barcode — объект внутри product: `{type: 'ean13'|'ean8'|'code128'|'upc'|'gtin', value: '...'}`. Отдельной сущности нет.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Code` | `value` | ОК |
-| `Type` | `type` | ⚠️ MS использует строки ('ean13', 'gtin', …) — мы уже enum |
-| `IsPrimary` | **нет** | ⛔ у MS нет — первый считается основным. **Оставить с комментарием — у нас явная пометка.** |
-
-OK, расхождений существенных нет.
-
----
-
-## ProductPrice → `product.salePrices[]`
-
-У MS цены — массив объектов в product: `{value, currency: {meta}, priceType: {meta}}`. Отдельной сущности нет.
-
-Наше — отдельная таблица. Это **нормализованный вариант** — оправдано если цен много и есть выборки по PriceType. **TODO:** маппинг при импорте — проитерировать salePrices и создать ProductPrice per PriceType.
-
----
-
-## PriceType → `entity/pricetype`
-
-Ключи MS (из context): `id, name, externalCode`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Name` | `name` | ОК |
-| `IsDefault` | **нет** | ⛔ у MS — default определяется порядком или отдельно в настройках аккаунта. **Оставить** |
-| `IsRetail` | **нет** | ⛔ наш флаг «используется на кассе». **Оставить** |
-| `SortOrder` | **нет** | ⛔ UX. **Оставить** |
-| — | `externalCode` | ➕ для импорта |
-
-**TODO:**
-1. `ExternalCode`.
-
----
-
-## Country → `entity/country`
-
-Ключи MS: `code, description, externalCode, id, meta, name, updated`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Code` | `code` | ⚠️ у MS формат ISO3166-1 **alpha-2 или числовой** — у нас alpha-2 |
-| `Name` | `name` | ОК |
-| `SortOrder` | **нет** | ⛔ UX |
-| — | `description` | ➕ |
-| — | `externalCode` | ➕ |
-
-OK, мелочь.
-
----
-
-## Currency → `entity/currency`
-
-Ключи MS: `archived, code, default, fullName, id, indirect, isoCode, majorUnit, meta, minorUnit, multiplicity, name, rate, rateUpdateType, system`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Code` | `isoCode` или `code` | ⚠️ у MS `isoCode` (строка "KZT") и `code` (цифровой "398") — у нас `Code` = строка ISO |
-| `Name` | `name` | ОК |
-| `Symbol` | **нет** | ⛔ у MS нет символа "₸" — но это UX. **Оставить** |
-| `MinorUnit` | `minorUnit` | ОК |
-| `IsActive` | `archived` inverse | ОК |
-| — | `default` (валюта аккаунта) | ➕ |
-| — | `rate, rateUpdateType` | ➕ курс к базовой валюте (при мульти-валютности) |
-| — | `multiplicity, indirect` | конвертация; если не мульти-валютные — не надо |
-| — | `fullName` | ➕ «Тенге Казахстана» vs «KZT» |
-
-**TODO:**
-1. Добавить `IsDefault: bool` (ровно одна валюта = true per tenant, или глобально).
-2. `Rate, RateUpdateType` + `FullName` — отложить до мульти-валютности.
-
----
-
-## VatRate — у MoySklad нет `entity/vatrate`
-
-⚠️ У MS **ставки НДС хранятся как числовое поле на товаре** (`vat`). Отдельной таблицы нет — набор значений {0, 5, 7, 10, 12, 18, 20} и «без НДС» встроен в систему.
-
-Наше `VatRate` — отдельная сущность. **Обоснование сохранить:**
-1. Локализованное название ("НДС 12%", "Без НДС").
-2. IsDefault per organization.
-3. Разные организации в разных налоговых режимах (с НДС / УСН).
-4. При добавлении новой ставки (например, на случай гипотетического увеличения в РК) — не править перечисление в коде.
-
-Но: **следите**, чтобы у товара хранился `VatRateId`, а не отдельно `vat: decimal`. При импорте из MS мапим число в запись VatRate.
-
-**Комментарий в коде нужен** — явно сказать, что мы отклонились от MoySklad сознательно.
-
----
-
-## UnitOfMeasure → `entity/uom`
-
-Ключи MS: `code, description, externalCode, id, meta, name, updated`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Code` (ОКЕИ) | `code` | ОК, MS использует ОКЕИ-коды (796, 166, 112) |
-| `Symbol` | **нет** | ⛔ у MS только `name` ("штука"). Мы вынесли "шт" отдельно для коротких надписей на ценниках/кассовых чеках. **Оставить.** |
-| `Name` | `name` | ОК |
-| `DecimalPlaces` | **нет** | ⛔ у MS на уровне продукта (`variantsCount`?), а не UoM. Наш `DecimalPlaces` определяет можно ли дробные количества (0=штучный, 3=весовой). **Оставить — важно для UX касс.** |
-| `IsBase` | **нет** | ⛔ наше «базовая единица организации». Мелочь, оставить |
-| `IsActive` | `archived` inverse (у MS есть `archived` в uom? перепроверить) | ⚠️ в нашем ответе API archived не было — у MS uom этого поля может не быть, потому что единицы системные |
-| — | `description` | ➕ |
-| — | `externalCode` | ➕ |
-
-**TODO:**
-1. `ExternalCode`.
-
----
-
-## Store → `entity/store`
-
-Ключи MS: `accountId, address, archived, externalCode, group, id, meta, name, owner, pathName, shared, slots, updated, zones`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Name` | `name` | ОК |
-| `Code` | `externalCode`? или отдельно? | ⚠️ у MS только `externalCode`. **Добавить ExternalCode или rename Code→ExternalCode** |
-| `Kind` (Warehouse/RetailFloor) | **нет** | ⛔ у MS такого деления нет. Обоснование: нам нужно отличать «склад» от «торгового зала» для UI и настроек касс. **Оставить с комментарием** |
-| `Address` | `address` | ОК |
-| `Phone` | **нет** | ⛔ у MS нет. Оставить |
-| `ManagerName` | **нет** | ⛔ у MS нет. Оставить |
-| `IsMain` | **нет** (но можно проставить через default) | ⛔ Оставить |
-| `IsActive` | `archived` inverse | ОК |
-| — | `pathName` | ➕ (если будут иерархические склады) |
-| — | `slots` (ячейки склада) | ➕ отложить |
-| — | `zones` (зоны склада) | ➕ отложить |
-
-**TODO:**
-1. `ExternalCode` (или переименовать Code → ExternalCode).
-
----
-
-## RetailPoint → `entity/retailstore`
-
-У MS это **«Точка продаж» / кассовое место**. Огромное количество полей (~60) — в основном фискальные настройки.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Name` | `name` | ОК |
-| `Code` | `externalCode` | rename or add |
-| `StoreId` | `store.meta` | ОК |
-| `Address` | **нет** (возможно `organization.actualAddress`) | ⛔ адрес не у точки, а у организации/склада. Пересмотреть, куда класть |
-| `Phone` | **нет** | ⛔ |
-| `FiscalSerial` | **нет такого поля**; есть `fiscalType`, `fiscalMemoryNumber`?, `ofdEnabled` | ⚠️ у MS фискальные настройки множественные. У нас один скаляр — упрощение. **TODO:** уточнить по мере подключения ККМ |
-| `FiscalRegNumber` | `ofdEnabled` + `ofdSettings` | same |
-| `IsActive` | `active, archived` | MS различает active и archived — у нас только IsActive |
-| — | `priceType.meta` | ➕ тип цены для этой точки — **важно** |
-| — | `allowCustomPrice` | ➕ разрешить ручную цену на кассе |
-| — | `allowCreateProducts` | ➕ создать товар прямо на кассе |
-| — | `discountEnable, discountMaxPercent` | ➕ скидки на кассе |
-| — | `cashiers` (коллекция) | ➕ кто может работать за кассой |
-| — | `sellReserves` | ➕ продавать резерв |
-| — | `receiptTemplate` | ➕ шаблон чека |
-| — | `returnFromClosedShiftEnabled` | ➕ возврат из закрытой смены |
-| — | `requiredBirthdate/Email/Phone/Fio/Sex/DiscountCardNumber` | ➕ обязательные поля при продаже |
-| — | `markingSellingMode, marksCheckMode, sendMarksForCheck` | ➕ маркировка товаров |
-
-**TODO:**
-1. Обязательно: `DefaultPriceTypeId` (ссылка на `PriceType`).
-2. Настройки кассы (скоп Phase 3 — касса): `AllowCustomPrice`, `AllowCreateProducts`, `SellReserves`, `DiscountMaxPercent`, `RequireCustomer...` — добавлять по мере реализации POS.
-3. Коллекция `RetailPointCashier` (user_id, может ли работать).
-
----
-
-## Supply → `entity/supply` + `supply/{id}/positions`
-
-Document keys: `accountId, agent, applicable, created, externalCode, files, group, id, meta, moment, name, organization, owner, payedSum, positions, printed, published, rate, shared, store, sum, updated, vatEnabled, vatIncluded, vatSum`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Number` | `name` | ⚠️ у MS «номер документа» = `name`. У нас `Number` — семантически то же |
-| `Date` | `moment` | ОК |
-| `Status` (Draft/Posted) | `applicable` (bool) | ⚠️ у MS это bool «проведён или нет». У нас enum Draft/Posted → эквивалентно |
-| `SupplierId` | `agent.meta` | ⚠️ у MS вместо `supplier` общее слово `agent` (контрагент) |
-| `StoreId` | `store.meta` | ОК |
-| `CurrencyId` | `rate.currency.meta` | ⚠️ MS упаковывает в rate объект с курсом |
-| `SupplierInvoiceNumber` | **нет на верхнем уровне**; есть в `attributes` | ⛔ у MS через custom attributes. Оставить |
-| `SupplierInvoiceDate` | same | same |
-| `Notes` | `description` | rename или комментарий |
-| `Total` | `sum` | ОК |
-| `PostedAt` | `updated` (когда applicable ставится true) | ⚠️ у MS нет выделенного поля; мы отдельно фиксируем |
-| `PostedByUserId` | `owner.meta` | условно |
-| — | `vatEnabled` | ➕ |
-| — | `vatIncluded` | ➕ НДС включён в цену |
-| — | `vatSum` | ➕ суммарный НДС документа |
-| — | `payedSum` | ➕ сколько оплачено |
-| — | `organization.meta` | ⚠️ у MS документ привязан к организации. **У нас TenantEntity несёт OrganizationId — уже есть** |
-| — | `printed, published` | ➕ распечатан/опубликован |
-| — | `overhead` (доп.расходы) | ➕ доставка/таможня — **важно для фактической себестоимости** |
-
-**Supply.Positions (SupplyLine) → supply/{id}/positions:**
-
-Ключи MS: `accountId, assortment, discount, id, meta, overhead, price, quantity, vat, vatEnabled`.
-
-| Наше (SupplyLine) | MS position | Комментарий |
-|---|---|---|
-| `ProductId` | `assortment.meta` | ⚠️ у MS `assortment` = может быть product ИЛИ variant ИЛИ service ИЛИ bundle. Мы только продукт |
-| `Quantity` | `quantity` | ОК |
-| `UnitPrice` | `price` | ⚠️ у MS `price` — в копейках (integer `100 = 1.00`). У нас decimal. **Маппинг при импорте: делить на 100** |
-| `LineTotal` | **нет** (вычисляется) | ⛔ у MS не хранится |
-| `SortOrder` | **нет** | ⛔ наш UX |
-| — | `discount` | ➕ строковая скидка |
-| — | `vat` | ➕ ставка НДС на позицию |
-| — | `vatEnabled` | ➕ |
-| — | `overhead` | ➕ доля накладных (для себестоимости) |
-
-**TODO Supply:**
-1. Поля: `VatEnabled`, `VatIncluded`, `VatSum`, `PayedSum`, `Overhead`.
-2. Lines: `Discount` (decimal), `VatPercent` (snapshot, уже подобное есть в RetailSaleLine), `VatEnabled`.
-3. Комментарий: MS `price` в копейках — при импорте делить.
-
----
-
-## RetailSale → `entity/retaildemand` + `retaildemand/{id}/positions`
-
-Document keys: огромный список, ключевое: `agent, applicable, cashSum, noCashSum, qrSum, prepaymentCashSum, prepaymentNoCashSum, prepaymentQrSum, advancePaymentSum, fiscal, retailShift, retailStore, store, positions, rate, sum, vatEnabled, vatIncluded, vatSum, name, moment, organization, syncId`.
-
-| Наше | MS | Комментарий |
-|---|---|---|
-| `Number` | `name` | ОК |
-| `Date` | `moment` | ОК |
-| `Status` | `applicable` | ⚠️ bool vs enum |
-| `StoreId` | `store.meta` | ОК |
-| `RetailPointId` | `retailStore.meta` | ОК |
-| `CustomerId` | `agent.meta` | ОК (nullable если не знаем покупателя) |
-| `CashierUserId` | **нет напрямую**; `retailShift` → cashier | ⚠️ |
-| `CurrencyId` | `rate.currency.meta` | ОК |
-| `Subtotal, DiscountTotal, Total` | `sum` (= Total) | ⚠️ MS **не хранит subtotal и discount total отдельно** — только total. Но цена в позиции уже после скидки? Нет — `positions[].discount` хранится, total = sum(price*qty - discount) |
-| `Payment` (PaymentMethod enum) | **cashSum + noCashSum + qrSum** | ⚠️ MS — **не enum, а суммы по видам оплаты**. Т.е. при mixed-оплате можно часть наличными + часть картой. **Наш enum Payment + PaidCash + PaidCard — неполный.** TODO: добавить `PaidQr` + убрать enum в пользу «сколько чем заплачено» |
-| `PaidCash` | `cashSum` | ⚠️ у MS в копейках |
-| `PaidCard` | `noCashSum` | ⚠️ в копейках |
-| `Notes` | `description` | ОК |
-| `PostedAt` | — | наш |
-| `PostedByUserId` | `owner.meta` | условно |
-| — | `qrSum` | ➕ **добавить `PaidQr`** (QR-оплата актуальна для КZ) |
-| — | `retailShift.meta` | ➕ кассовая смена (отложить) |
-| — | `fiscal` | ➕ пробит ли фискально |
-| — | `syncId` | ➕ идентификатор для офлайн-касс (при резинхроне) |
-| — | `prepaymentCashSum/NoCashSum/QrSum, advancePaymentSum` | ➕ предоплаты |
-
-**RetailSale.Positions (RetailSaleLine) → retaildemand/{id}/positions:**
-
-Ключи: `accountId, assortment, discount, id, meta, price, quantity, vat, vatEnabled`.
-
-| Наше (RetailSaleLine) | MS | Комментарий |
-|---|---|---|
-| `ProductId` | `assortment.meta` | ОК |
-| `Quantity` | `quantity` | ОК |
-| `UnitPrice` | `price` | ⚠️ копейки |
-| `Discount` | `discount` | ОК |
-| `LineTotal` | вычисляется | наш |
-| `VatPercent` | `vat` | ОК (snapshot) |
-| `SortOrder` | — | наш UX |
-| — | `vatEnabled` | ➕ |
-
-**TODO RetailSale:**
-1. Добавить `PaidQr: decimal`.
-2. **Убрать `PaymentMethod` enum** в пользу денормализованных `PaidCash, PaidCard, PaidQr, PaidBonus` + computed `Method` (если все кроме одного = 0 → Cash/Card/QR, иначе Mixed). Либо оставить enum + PayHint, но быть готовым к частичной оплате.
-3. `VatEnabled, VatIncluded, VatSum` (сумма НДС на документ — вычисляется).
-4. Комментарий: MS `price/cashSum/noCashSum` в копейках при импорте.
-
----
-
-## Stock → `report/stock/bystore`
-
-У MS **нет отдельной сущности "Stock"** — это **отчёт**. Ответ `report/stock/bystore` содержит:
-```json
-{ "meta": {...}, "stockByStore": [ { "name": "Склад №1", "meta": {...}, "stock": 10.0, "reserve": 2.0, "inTransit": 0.0, "quantity": 12.0 } ] }
-```
-Т.е. по каждому (product, store) — stock (сколько есть), reserve (резерв), inTransit (в пути), quantity = stock+inTransit.
-
-У нас `Stock` — **материализованный агрегат** (Quantity, ReservedQuantity, computed Available). Это **технически наше решение**, не требование бизнеса.
-
-**TODO:**
-1. Комментарий в Stock.cs: объяснить, что это материализация (у MS динамический репорт).
-2. **Добавить `InTransit: decimal`** — товар в пути (между складами при перемещении).
-
----
-
-## StockMovement — у MoySklad такой сущности нет
-
-⚠️ MS **не хранит journal движений** в явном виде — остатки рассчитываются в реальном времени из документов (supply, retaildemand, loss, enter, move и т.д.). Поэтому на вопрос «почему на складе минус 5» MS возвращает историю документов, а не journal.
-
-Наше `StockMovement` — **явный immutable journal**. Обоснование:
-1. Мгновенный ответ на «почему такой остаток» без пробегания по всем документам.
-2. Атомарные корректировки при баг-фиксах миграций.
-3. Упрощённая репликация в офлайн-кассы.
-
-Это **сознательное отклонение** от MS — должно быть задокументировано в коде и в `docs/`. **TODO:** комментарий в StockMovement.cs + упоминание в `CLAUDE.md`.
-
----
-
-## Свод по приоритетам
-
-### Приоритет 1 — базовая совместимость импорта (на этой неделе):
-- Product: `Code`, `ExternalCode`, `TrackingType` (enum) вместо `IsMarked`, `MinPrice`/`MinPriceCurrencyId`, `PaymentItemType` (enum)
-- Counterparty: `CounterpartyType.IndividualEntrepreneur`, `ExternalCode`, tags (коллекция)
-- ProductGroup: `ExternalCode`
-- PriceType: `ExternalCode`
-- Country, Currency, UnitOfMeasure, Store: `ExternalCode`
-- RetailPoint: `DefaultPriceTypeId`
-
-### Приоритет 2 — смысловые (следующая итерация):
-- RetailSale: `PaidQr`, убрать enum PaymentMethod в пользу суммовых полей
-- Supply: `Overhead`, `VatSum`, `VatEnabled`, `VatIncluded`
-- Organization: `LegalName`, `LegalAddress`, `PayerVat`, `DirectorName`
-- Product: `Volume, Weight, DiscountProhibited`
-- Stock: `InTransit`
-
-### Приоритет 3 — при необходимости:
-- Counterparty: коллекция `Account`, `DefaultPriceType`
-- ProductGroup: `VatRateId?` + `UseParentVat`
-- RetailPoint: кассовые настройки (allowCustomPrice, discountMaxPercent, cashiers...)
-- Store: slots, zones
-
-### Сознательно не копируем MS:
-- `CounterpartyKind` (Supplier/Customer/Both) — у нас enum, у MS теги. Оставляем для UX/фильтрации.
-- `Store.Kind` (Warehouse vs RetailFloor) — у MS нет, нам нужно.
-- `VatRate` как отдельная сущность — у MS число на товаре. У нас справочник ради локализации.
-- `StockMovement` journal — у MS нет. Выбор архитектуры.
-- `Product.IsWeighed` / `IsAlcohol` — упрощения под ритейл.
-- `UnitOfMeasure.Symbol`, `DecimalPlaces` — UX.

docs/backup-restore.md

@@ -1,101 +0,0 @@
-# Бэкап и восстановление
-
-Артефакты в репозитории (`deploy/`):
-
-- `food-market-backup.sh` — скрипт бэкапа БД + uploads с ротацией.
-- `food-market-backup.service` — systemd oneshot-юнит, запускающий скрипт.
-- `food-market-backup.timer` — ежедневный таймер (03:00, с догоном пропущенных).
-
-> Установку на prod-vm выполняет отдельный деплой-шаг (см. ниже) — здесь только
-> подготовленные артефакты.
-
-## Что бэкапится
-
-| Что | Как | Файл |
-|---|---|---|
-| База данных | `pg_dump -Fc` из контейнера `food-market-postgres` | `db-<TS>.dump` (custom-format) |
-| Загруженные файлы (картинки товаров) | `tar czf` каталога uploads | `uploads-<TS>.tgz` |
-
-Папка назначения по умолчанию — `/opt/food-market-data/backups`. Хранение —
-30 дней (`FM_BACKUP_RETENTION_DAYS`), старые удаляются ротацией. Конфиг —
-переменными `FM_*` (см. шапку `food-market-backup.sh`).
-
-## Установка таймера на сервере (деплой-шаг)
-
-Предполагается, что репозиторий выложен в `/opt/food-market` (иначе скорректировать
-`ExecStart`/`EnvironmentFile` в `.service` и пути ниже).
-
-```bash
-sudo install -m 0755 /opt/food-market/deploy/food-market-backup.sh /opt/food-market/deploy/food-market-backup.sh
-sudo cp /opt/food-market/deploy/food-market-backup.service /etc/systemd/system/
-sudo cp /opt/food-market/deploy/food-market-backup.timer   /etc/systemd/system/
-sudo systemctl daemon-reload
-sudo systemctl enable --now food-market-backup.timer
-
-# Проверить расписание и последний запуск
-systemctl list-timers food-market-backup.timer
-# Прогнать бэкап немедленно (разово)
-sudo systemctl start food-market-backup.service
-journalctl -u food-market-backup.service --no-pager | tail -20
-```
-
-## Ручной бэкап
-
-```bash
-sudo /opt/food-market/deploy/food-market-backup.sh
-# или с переопределением каталога:
-FM_BACKUP_DIR=/mnt/backups sudo -E /opt/food-market/deploy/food-market-backup.sh
-```
-
-## Восстановление БД
-
-> ⚠️ Восстановление перезаписывает данные. Сначала остановить API, чтобы не было
-> записи во время восстановления.
-
-```bash
-cd /opt/food-market/deploy
-docker compose stop api web
-
-DUMP=/opt/food-market-data/backups/db-YYYYMMDD-HHMMSS.dump
-
-# Скопировать дамп внутрь контейнера БД
-docker cp "$DUMP" food-market-postgres:/tmp/restore.dump
-
-# Вариант A — восстановить в чистую БД (рекомендуется):
-docker exec food-market-postgres psql -U food_market -d postgres -c \
-  "DROP DATABASE IF EXISTS food_market WITH (FORCE); CREATE DATABASE food_market OWNER food_market;"
-docker exec food-market-postgres pg_restore -U food_market -d food_market --no-owner /tmp/restore.dump
-
-# Вариант B — в существующую БД, заменив объекты (без пересоздания БД):
-# docker exec food-market-postgres pg_restore -U food_market -d food_market --clean --if-exists --no-owner /tmp/restore.dump
-
-docker exec food-market-postgres rm -f /tmp/restore.dump
-docker compose start api web
-```
-
-После старта API применит миграции (`Migrate()` идемпотентен) и поднимется. Проверить:
-
-```bash
-curl -fsS http://localhost:8080/health/ready
-```
-
-## Восстановление uploads
-
-```bash
-TGZ=/opt/food-market-data/backups/uploads-YYYYMMDD-HHMMSS.tgz
-# tar содержит каталог uploads/ — распаковать в родителя смонтированного пути
-sudo tar xzf "$TGZ" -C /opt/food-market-data/
-```
-
-(Каталог `/opt/food-market-data/uploads` смонтирован в контейнер api как `/app/uploads`.)
-
-## Проверка дампа без восстановления
-
-```bash
-docker cp <dump> food-market-postgres:/tmp/v.dump
-docker exec food-market-postgres pg_restore --list /tmp/v.dump | head   # TOC валидного архива
-docker exec food-market-postgres rm -f /tmp/v.dump
-```
-
-Скрипт и формат проверены локально (2026-05-27): дамп `PGDMP`, custom-format,
-248 TOC-записей, `pg_restore --list` читает.

docs/error-codes.md

@@ -1,159 +0,0 @@
-# API error catalog
-
-Каталог HTTP-кодов и тел ответов, которые возвращает `food-market.api`.
-Используется фронтом для `humanizeError(response)` и QA для regression
-проверки. Если поле `error` есть — это user-facing сообщение; `errors`
-(множественное) — структурированные ошибки валидации (ASP.NET
-ValidationProblemDetails).
-
-## Формат
-
-```jsonc
-// Универсальный шаблон single-error:
-{ "error": "Понятный текст для пользователя.", "field": "Optional" }
-
-// ValidationProblemDetails (FluentValidation / DataAnnotations):
-{ "type": "...", "title": "One or more validation errors occurred.",
-  "status": 400, "errors": { "Name": ["..."], "Prices[0].Amount": ["..."] } }
-
-// retryable flag (Sprint 23):
-{ "error": "...", "retryable": true }
-```
-
-## Коды
-
-### 200/201/204 — OK / Created / NoContent
-Корректно. Тело — DTO или пусто.
-
-### 400 — Bad Request
-
-| Когда | Тело | Что показать |
-|---|---|---|
-| Validation от FluentValidation | `ValidationProblemDetails` с `errors.{field}: [msg]` | Подсветить поле + показать сообщение |
-| Business-rule (например, draft пустой) | `{error: "Нельзя провести пустой чек."}` | toast + не закрывать форму |
-| Сумма оплаты < total | `{error: "Сумма оплаты X меньше итога Y. Доплатите...", field: "PaidCash"}` | подсветить поле PaidCash |
-| Required price = 0 после rounding (Sprint 23 bug-004) | `{error: "Цена «X» обязательна и должна быть больше 0."}` | подсветить prices section |
-| NUL-byte в строке (Sprint 23 bug-001) | `errors.Name: ["Поле Name не должно содержать управляющих символов..."]` | подсветить поле |
-| Дубликат barcode при создании | `{error: "Штрихкод X уже используется товаром «Y»."}` | toast |
-| Дубликат артикула | `{error: "Артикул «X» уже занят в этой организации."}` | toast |
-| Невалидный CSV / 1С-import | `errors: [{row, error}]` | таблица с подсветкой строк |
-
-### 401 — Unauthorized
-
-| Когда | Тело | Что показать |
-|---|---|---|
-| Нет токена / устаревший токен | пусто или OpenIddict-`{error: "missing_token"}` | редирект на `/login`, refresh с RT |
-| Garbage / tampered JWT | `{error: "missing_token"}` | logout + login |
-| Refresh-token недействителен | `{error: "invalid_grant", error_description: "..."}` | logout |
-
-### 403 — Forbidden
-
-| Когда | Тело | Что показать |
-|---|---|---|
-| Нет permission на mutating action | пусто или ProblemDetails | toast: «Нет прав на это действие» |
-| Регулярный Admin лезет в `/hangfire` | пусто | redirect → 404 на фронте |
-| Cashier пытается удалить заявку | пусто | скрыть кнопку delete для Cashier |
-
-### 404 — Not Found
-
-| Когда | Что показать |
-|---|---|
-| Document не найден (включая cross-tenant — нельзя раскрыть существование!) | «Запись не найдена. Возможно, удалена.» |
-| Endpoint не существует (типо в URL) | (фронту не должно встречаться) |
-
-### 409 — Conflict
-
-| Когда | Тело | Что показать |
-|---|---|---|
-| DbUpdateConcurrencyException (xmin) | `{error: "Документ изменён в другом окне..."}` | toast + reload |
-| Чек уже проведён, повторный post | `{error: "Чек уже проведён."}` | toast |
-| Serialization failure 40001 (Sprint 23 bug-003) | `{error: "Конфликт параллельных операций. Попробуйте ещё раз.", retryable: true}` | **auto-retry один раз**, при повторе — toast |
-| Дубликат preset name | `{error: "Пресет с таким именем уже существует..."}` | подсветить input name |
-| In-flight org-export ≥3 | `{error: "Уже в очереди 3+ экспорта. Подождите..."}` | toast |
-| Удаление непустой группы товаров | `{error: "Нельзя удалить группу, содержащую товары/подгруппы."}` | toast |
-
-### 413 — Payload Too Large
-
-| Когда | Что показать |
-|---|---|
-| Body > nginx limit (10 MB по default) | «Файл слишком большой. Лимит: 10 МБ.» |
-
-### 429 — Too Many Requests
-
-| Когда | Тело | Что показать |
-|---|---|---|
-| Rate-limit на signup (3/h IP) | пусто или `Retry-After` header | «Слишком много попыток. Попробуйте через час.» |
-| Rate-limit на forgot-password (3/h email + 10/h IP) | то же | то же |
-| Rate-limit на feedback (5/час) | то же | то же |
-| IP-limit (60/мин общий) | то же | «Слишком много запросов с вашего IP.» |
-
-### 431 — Request Header Fields Too Large
-
-| Когда | Что показать |
-|---|---|
-| Слишком большие/много HTTP-headers | (нечем фиксить с UI; нечасто) |
-
-### 500 — Internal Server Error
-
-После Sprint 23 — **очень редко**. Если встречается:
-- Все NUL-byte 500 → теперь 400 (bug-001).
-- Все serialization 40001 → теперь 409 (bug-003).
-- Все остальные uncaught exceptions → Serilog лог + `correlation-id` header.
-
-Что показать пользователю: «Произошла ошибка. Попробуйте ещё раз
-или сообщите администратору. Код: {x-correlation-id}». Этот correlation
-id находится в `x-correlation-id` response-header — записываем в audit.
-
-### 501 — Not Implemented
-
-| Когда | Тело | Что показать |
-|---|---|---|
-| SSO callback flow (Sprint 20 scaffold) | `{status: "scaffolded", message, email, next}` | «SSO ещё не настроено полностью» |
-
-### 503 — Service Unavailable
-
-| Когда | Тело | Что показать |
-|---|---|---|
-| SSO провайдер не сконфигурирован | `{error: "SSO для X не настроено.", hint: "..."}` | скрыть кнопку SSO |
-| (резерв на maintenance window) | пусто | «Сервис недоступен» |
-
-## humanizeError на фронте
-
-`src/lib/api.ts → humanizeError(err)`:
-
-```typescript
-export function humanizeError(err: AxiosError): string {
-  const data = err.response?.data as any
-  // 1. Single-error (наш стандарт)
-  if (data?.error) return data.error
-  // 2. ValidationProblemDetails
-  if (data?.errors) {
-    const first = Object.values(data.errors).flat()[0]
-    return first ?? 'Ошибка валидации'
-  }
-  // 3. По статусу
-  switch (err.response?.status) {
-    case 401: return 'Сессия истекла. Войдите снова.'
-    case 403: return 'Нет прав на это действие.'
-    case 404: return 'Запись не найдена.'
-    case 409: return 'Конфликт версий. Перезагрузите страницу.'
-    case 413: return 'Файл слишком большой.'
-    case 429: return 'Слишком много запросов. Подождите немного.'
-    case 500: return `Ошибка сервера. Код: ${err.response.headers['x-correlation-id'] ?? 'unknown'}`
-    case 503: return 'Сервис временно недоступен.'
-  }
-  return err.message ?? 'Неизвестная ошибка'
-}
-```
-
-## Retry-policy
-
-| Код | Retry? | Условие |
-|---|---|---|
-| 401 | Один раз — после refresh-token | Если refresh тоже 401 → logout |
-| 409 c `retryable: true` | Один авто-retry с задержкой 500ms | Sprint 23 фикс — серверная сторона уже retry'ит до 5 раз, клиентский — дополнительный safety net |
-| 429 | Через `Retry-After` секунд (если есть) | Не более 3 попыток |
-| 500 | НЕТ авто-retry | Пользователь сам решает |
-| 503 | Через 5 секунд | До 2 попыток |
-
-Без auto-retry: 400, 403, 404, 413, 501.

docs/flaky-tests.md

@@ -1,12 +0,0 @@
-# Flaky tests report
-
-_Сгенерировано `tests/regression/find-flaky.sh` — 10 прогонов suite._
-
-**Всего уникальных тестов:** 42  
-**Flaky:** 0 (0%)  
-**Всегда зелёные:** 42  
-**Всегда красные:** 0  
-
-## 🟢 Нет flaky тестов
-
-Suite стабилен.

docs/food-market-server-postgres-role.md

@@ -1,120 +0,0 @@
-# Замена postgres superuser в food-market-server
-
-Sprint 13, задача 1. Дата: 2026-06-07.
-
-## Контекст
-
-`food-market-server` — legacy backend (back.food-market.kz, port 8084
-на prod-vm `192.168.1.190`, systemd `food-market-server.service`).
-Хранилище — `food-market-server-postgres` (Docker, port 5436).
-
-До этой задачи в `appsettings.Production.json` была строка с
-**superuser'ом**:
-```
-Host=localhost;Port=5436;Database=food_market_server;Username=postgres;Password=1q2w3e4r
-```
-
-Это плохо по двум причинам:
-- Слабый пароль (`1q2w3e4r`), известен любому, кто прочитает конфиг.
-- `postgres` — суперюзер: CREATE DATABASE, CREATE ROLE, REPLICATION,
-  BYPASS RLS, может уничтожить всё что угодно в кластере (включая
-  другие БД, если они там появятся).
-
-## Решение
-
-Создан dedicated app-role `food_market_server_app`:
-- LOGIN + сильный пароль (48 hex chars).
-- NOSUPERUSER, NOCREATEDB, NOCREATEROLE, NOREPLICATION, NOBYPASSRLS.
-- Гранты: SELECT/INSERT/UPDATE/DELETE на все существующие таблицы +
-  USAGE/SELECT/UPDATE на sequences + USAGE/CREATE на schema public
-  (CREATE нужен для EF миграций, которые app запускает на старте через
-  `db.Database.Migrate()`).
-- DEFAULT PRIVILEGES `FOR ROLE postgres IN SCHEMA public` — все
-  будущие таблицы, что создаст superuser (например, если миграцию
-  применить вручную через `postgres`), автоматически получат CRUD
-  для app-роли.
-
-## Что сделано (атомарно)
-
-```
-1. Бэкап конфига:
-   /opt/food-market-server/appsettings.Production.json
-     → appsettings.Production.json.bak.20260607-fms-rolemigration
-
-2. Создание роли в БД:
-   CREATE ROLE food_market_server_app LOGIN PASSWORD '...'
-       NOSUPERUSER NOCREATEDB NOCREATEROLE NOREPLICATION NOBYPASSRLS;
-   GRANT CONNECT ON DATABASE food_market_server TO food_market_server_app;
-   GRANT USAGE, CREATE ON SCHEMA public TO food_market_server_app;
-   GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO food_market_server_app;
-   GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA public TO food_market_server_app;
-   ALTER DEFAULT PRIVILEGES FOR ROLE postgres IN SCHEMA public
-       GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO food_market_server_app;
-   ALTER DEFAULT PRIVILEGES FOR ROLE postgres IN SCHEMA public
-       GRANT USAGE, SELECT, UPDATE ON SEQUENCES TO food_market_server_app;
-
-3. Обновление appsettings.Production.json:
-   Username: postgres                  → food_market_server_app
-   Password: 1q2w3e4r                  → <48-hex>
-
-4. systemctl restart food-market-server  → active.
-5. curl http://localhost:8084/        → 200 (SPA fallback).
-6. curl https://back.food-market.kz/  → 200.
-7. Логи без EF errors после старта.
-```
-
-## Проверка работоспособности
-
-```bash
-ssh nns@192.168.1.190 'sudo systemctl status food-market-server | head -5'
-curl -fsS https://back.food-market.kz/ -o /dev/null -w "HTTP %{http_code}\n"
-ssh nns@192.168.1.190 'sudo journalctl -u food-market-server --since "10 minutes ago" --no-pager | grep -iE "error|fail" | head'
-```
-
-## Rollback
-
-Если что-то сломается (миграция fails, EF Errors в логах), вернуться
-к старой конфигурации одной командой:
-
-```bash
-ssh nns@192.168.1.190 'sudo cp /opt/food-market-server/appsettings.Production.json.bak.20260607-fms-rolemigration /opt/food-market-server/appsettings.Production.json && sudo systemctl restart food-market-server'
-curl -fsS https://back.food-market.kz/ -o /dev/null -w "HTTP %{http_code}\n"
-```
-
-Это вернёт `Username=postgres;Password=1q2w3e4r` — старый superuser.
-Новая роль `food_market_server_app` остаётся в БД (это идемпотентный
-`CREATE IF NOT EXISTS`), её можно дропнуть отдельно:
-
-```sql
--- Только после успешного rollback'а и подтверждения что приложение
--- работает на postgres:
-DROP OWNED BY food_market_server_app;  -- (если бы что-то создавала)
-DROP ROLE food_market_server_app;
-```
-
-## Что НЕ покрыто (TODO)
-
-- **Ротация пароля postgres**. Сам `postgres` superuser остался с тем
-  же `1q2w3e4r`. Пока он не используется в работе app'а (мы только
-  что переключились на app-роль) — но всё равно нужно сменить на
-  сильный, иначе кто-то с доступом к dev-машине или к /opt видит
-  старый бэкап и пробует. Делать через `ALTER ROLE postgres PASSWORD
-  '...'` под superuser-сессией.
-- **PGHBA**. Сейчас доверяется любой коннект с loopback (стандартный
-  `pg_hba.conf` postgres-контейнера). Допустимо для single-host
-  setup, но при сетевом расширении нужно ужесточать.
-- **Audit log внутри PG** (pgaudit) — не настроен. Логирует только app.
-- **Per-table RLS** — не используется, потому что приложение само
-  фильтрует по `OrganizationId`. Под добавление RLS не подписывался.
-
-## Дальше
-
-Аналогичную замену нужно провести в:
-- `food-market-stage-postgres` (port 5435) — там пользователь
-  `food_market` уже без superuser-прав (см. `deploy/docker-compose.yml`,
-  он создаётся через `POSTGRES_USER` env, что даёт superuser в рамках
-  только этой БД — лучше чем кросс-БД superuser, но всё равно стоит
-  ужесточить аналогично).
-- `food-market-postgres` (prod admin.food-market.kz, port 5434) — то же.
-- Локальный dev PG на host'е (brew postgresql@14) — там безразлично
-  (dev-only, локальный сокет, пустой пароль работает по trust).

docs/forgejo.md

@@ -1,100 +0,0 @@
-# Forgejo как primary git
-
-GitHub из KZ периодически роняет TCP (см. `network_github_flaky.md`). Чтобы push/pull не превращались в лотерею, на стейдж-сервере поднят Forgejo — self-hosted git-сервис (форк Gitea), он работает локально и не зависит от upstream-флапов. GitHub продолжает жить как **зеркало** (для видимости, CI-интеграций, бэкапа).
-
-## Адреса
-
-- **Web UI:** https://git.zat.kz (после certbot; до этого — http:// если DNS уже указан)
-- **Git HTTPS:** https://git.zat.kz/nns/food-market.git
-- **Git SSH:** `ssh://git@git.zat.kz:2222/nns/food-market.git`
-
-SSH-порт 2222 (хостовой 22 занят системным sshd).
-
-## Первый раз с Mac/iPhone
-
-### 1. Добавить remote
-
-В локальной копии `food-market`:
-
-```bash
-# оставляем github как origin (привычно), добавляем forgejo как primary
-git remote add forgejo ssh://git@git.zat.kz:2222/nns/food-market.git
-
-# либо делаем forgejo основным и github запасным:
-git remote rename origin github
-git remote add origin ssh://git@git.zat.kz:2222/nns/food-market.git
-git branch --set-upstream-to=origin/main main
-```
-
-Клонировать с нуля:
-
-```bash
-git clone ssh://git@git.zat.kz:2222/nns/food-market.git
-```
-
-### 2. SSH-ключ
-
-На Forgejo в `Settings → SSH/GPG Keys → Add Key` добавить публичный ключ (`~/.ssh/id_ed25519.pub` с Mac, либо через Working Copy на iPhone — Settings → Key Management → Generate/Export Public Key).
-
-### 3. Обычный цикл
-
-```bash
-git pull                              # (или git pull forgejo main)
-# ...работа...
-git commit -am "…"
-git push                              # мгновенно, внутри ДЦ
-```
-
-## Как это связано с GitHub
-
-- **push → Forgejo:** primary, мгновенный.
-- **Forgejo → GitHub** раз в 10 минут пушится автоматически сервисом `food-market-forgejo-mirror.timer`. Если GitHub недоступен — следующий тик повторит. Cкрипт: `/usr/local/bin/food-market-forgejo-mirror.sh`, лог `/var/log/food-market-forgejo-mirror.log`.
-- **CI:** GitHub Actions на self-hosted runner'е (уже настроено). Запускается от коммитов, пришедших через зеркало. Если когда-нибудь понадобится CI на Forgejo'ых Actions — docs/forgejo-actions.md (пока не настроено).
-
-То есть рабочий флоу: пуш в Forgejo → через ≤10 мин коммит в GitHub → триггер CI → деплой.
-
-## Эксплуатация
-
-```bash
-# состояние
-sudo systemctl status food-market-forgejo.service            # контейнер Forgejo
-sudo systemctl status food-market-forgejo-mirror.timer       # расписание зеркала
-sudo systemctl status food-market-forgejo-mirror.service     # последняя попытка зеркала
-tail -f /var/log/food-market-forgejo-mirror.log              # живой лог зеркала
-
-# прогнать зеркало прямо сейчас (не дожидаясь таймера)
-sudo systemctl start food-market-forgejo-mirror.service
-
-# рестарт Forgejo (редко нужно)
-sudo systemctl restart food-market-forgejo.service
-```
-
-## Раскладка
-
-- docker-compose: `deploy/forgejo/docker-compose.yml` (образ `codeberg.org/forgejo/forgejo:7`, sqlite, SSH через OpenSSH образа)
-- systemd unit Forgejo: `/etc/systemd/system/food-market-forgejo.service` (copy в `deploy/forgejo/`)
-- mirror script: `/usr/local/bin/food-market-forgejo-mirror.sh` (copy в `deploy/forgejo/mirror-to-github.sh`)
-- mirror timer/service: `food-market-forgejo-mirror.{timer,service}` (copy в `deploy/forgejo/`)
-- nginx vhost: `/etc/nginx/conf.d/git.zat.kz.conf` (copy в `deploy/forgejo/nginx.conf`)
-- data: `/opt/food-market-data/forgejo/data` (sqlite + repos + ssh host keys)
-- конфиг Forgejo: `/opt/food-market-data/forgejo/data/gitea/conf/app.ini`
-- GitHub mirror token: `/etc/food-market/github-mirror-token` (PAT с `repo` scope, читает mirror-скрипт)
-- локальное зеркало для push в github: `/opt/food-market-data/forgejo/mirror` (bare repo)
-
-## Что ещё нужно от вас (разовое)
-
-1. **DNS A-запись** `git.zat.kz → 88.204.171.93` (основной IP сервера).
-2. После того как DNS прорастёт:
-   ```bash
-   sudo certbot --nginx -d git.zat.kz
-   ```
-   Certbot выпустит TLS-сертификат и обновит nginx-конфиг (добавит блок 443 + редирект 80→443).
-3. Записать пароль администратора: файл `/tmp/forgejo-admin.txt` (создан при первой установке, надо скопировать себе в хранилище паролей и удалить с сервера).
-
-## Обратный путь
-
-Если Forgejo сломается и нужно срочно пушить напрямую в GitHub:
-```bash
-git push github main
-```
-GitHub — полная копия (mirror-таймер гонит всё: branches + tags). Рабочий флоу не ломается.

docs/glossary.md

@@ -1,259 +0,0 @@
-# Глоссарий food-market
-
-Доменные термины, которые используются в коде, документации и общении
-с пользователями. Один термин — одно определение. Ссылки на код через
-`file:line` или namespace.path.
-
-## Базовые сущности
-
-### Organization (Организация, tenant)
-**Корневая сущность мульти-tenancy.** Один процесс API обслуживает много
-организаций; каждая видит только свои данные через query-filter по
-`OrganizationId`. Не tenant-scoped сама по себе (отношение «один-ко-многим»
-с TenantEntity).
-Code: `foodmarket.Domain.Organizations.Organization` (`src/food-market.domain/Organizations/Organization.cs`).
-См. [MULTI-TENANCY.md](MULTI-TENANCY.md).
-
-### TenantEntity / ITenantEntity
-Базовый класс/интерфейс для всех domain-сущностей с `OrganizationId`.
-`AppDbContext` автоматически применяет query-filter по reflection.
-Code: `foodmarket.Domain.Common.TenantEntity` + `ITenantEntity`.
-
-### IOptionalTenantEntity
-Двухуровневые справочники: либо системная запись (OrganizationId=null,
-видна всем, мутирует только SuperAdmin), либо tenant'овская.
-Пример: `UnitOfMeasure`, `ProductGroup` — есть глобальные «штука», есть
-кастомные.
-
-### User
-Учётная запись для логина (ASP.NET Identity). НЕ привязан к одной org —
-один email может работать в нескольких организациях через Employee.
-Code: `foodmarket.Domain.Identity.User`.
-
-### Employee (Сотрудник)
-Запись о работнике конкретной org. Может иметь User (для логина) или
-быть «без аккаунта» (только в чеках/документах). Связан с EmployeeRole.
-Code: `foodmarket.Domain.Organizations.Employee`.
-
-### Owner / AccountOwnerUserId
-Первый пользователь, создавший org через signup. Хранится в
-`Organization.AccountOwnerUserId`. Не удаляется (кроме как через
-SuperAdmin reassign).
-
-### Role / EmployeeRole / RolePermissions
-- **Identity Role** (ASP.NET) — системная: `SuperAdmin`, `Admin`, `Cashier`,
-  `Storekeeper`, `Manager`.
-- **EmployeeRole** — per-org кастомная роль (например, «Старший кассир»),
-  привязана к сотруднику. Имеет `RolePermissions` (флаги типа
-  `ProductsEdit`, `RetailSalesOperate`).
-- **Permission** — атрибут `[RequiresPermission("Name")]` на endpoint'е.
-  Проверяет `RolePermissions` сотрудника текущего юзера.
-
-### Store (Склад)
-Физическое место хранения остатков. У org может быть несколько; первый
-после signup — «MAIN» store.
-Code: `foodmarket.Domain.Organizations.Store`.
-
-### RetailPoint (Касса / торговая точка)
-Привязана к Store, к ней привязывается RetailSale. Может иметь фискальные
-поля (FiscalSerial, FiscalRegNumber).
-Code: `foodmarket.Domain.Organizations.RetailPoint`.
-
-## Каталог
-
-### Product (Товар)
-Единица каталога. Имеет несколько Prices (по типам), Barcodes, Images,
-принадлежит ProductGroup. Поля Sprint 19: `IsArchived`, `IsAvailableForSale`.
-Code: `foodmarket.Domain.Catalog.Product`.
-
-### ProductGroup (Группа товаров)
-Иерархическая (через `ParentId` + `Path`). Корень — «Все товары».
-Может быть системной (OrganizationId=null) или per-org.
-Code: `foodmarket.Domain.Catalog.ProductGroup`.
-
-### ProductPrice (Цена)
-Один товар × один PriceType = одна цена. Тип может быть «системным»
-(IsSystem — основная розничная) или «обязательным» (IsRequired — без неё
-нельзя сохранить товар).
-Code: `foodmarket.Domain.Catalog.ProductPrice`.
-
-### PriceType (Тип цены)
-Розничная / Закупочная / Базовая / Себестоимость и т.д. Per-org. Sprint 1.
-Code: `foodmarket.Domain.Catalog.PriceType`.
-
-### ProductBarcode (Штрихкод)
-Уникальный (составной UNIQUE: Code + Organization). Один товар может
-иметь несколько штрихкодов; один из них — `IsPrimary` (показывается на
-этикетке).
-Code: `foodmarket.Domain.Catalog.ProductBarcode`.
-
-### UnitOfMeasure (Единица измерения)
-шт / кг / л / м / упак. Системные (OrganizationId=null) + org-кастомные.
-`OrgUnitOfMeasure` — таблица per-org enable/disable.
-Code: `foodmarket.Domain.Catalog.UnitOfMeasure`.
-
-### Counterparty (Контрагент)
-Поставщик (Supplier) / Покупатель-юрлицо (LegalEntity) / Покупатель-физлицо
-(Individual). Имеет БИН/ИИН, банковские реквизиты, контакты.
-Code: `foodmarket.Domain.Catalog.Counterparty`.
-
-## Остатки и движения
-
-### Stock (Остаток)
-Кеш `SUM(StockMovement.Quantity)` для пары `(Store, Product)`.
-Поддерживается транзакционно в каждом posting'е документа.
-Code: `foodmarket.Domain.Inventory.Stock`.
-
-### StockMovement (Движение остатка)
-Имматериальная запись об изменении остатка. Source: документ
-(Supply.Post / RetailSale.Post / Enter.Post / Loss.Post / Transfer.Post /
-Inventory.Post / SupplierReturn.Post / CustomerReturn.Post).
-**Инвариант**: `Stock.Quantity ≡ Σ StockMovement.Quantity` для каждой
-пары (Store, Product). Проверяется property-test'ом (Sprint 15).
-Code: `foodmarket.Domain.Inventory.StockMovement`.
-
-## Документы (Documents)
-
-Все имеют поля: `Number`, `Date`, `Status` (Draft/Posted), `PostedAt`.
-Имеют `IVersionedEntity` для `xmin` concurrency check.
-
-### Supply (Приёмка)
-От поставщика. Увеличивает остаток + пересчитывает скользящую
-себестоимость (Product.Cost).
-Code: `foodmarket.Domain.Purchases.Supply`.
-
-### Enter (Оприходование)
-Внутреннее. Увеличивает остаток без поставщика. Для коррекций инвентаризации.
-Code: `foodmarket.Domain.Inventory.Enter`.
-
-### Loss (Списание)
-Уменьшает остаток. Причина: порча, кража, тестовое использование.
-Code: `foodmarket.Domain.Inventory.Loss`.
-
-### Transfer (Перемещение)
-Между складами. Уменьшает на исходном, увеличивает на целевом.
-Code: `foodmarket.Domain.Inventory.Transfer`.
-
-### Inventory (Инвентаризация)
-Списки фактических остатков. Расхождение → автоматические Enter/Loss
-строки при post.
-Code: `foodmarket.Domain.Inventory.InventoryDoc` (имя класса не Inventory из-за конфликта с namespace).
-
-### RetailSale (Розничный чек)
-Продажа через POS / админку. После Post → уменьшает остаток, пишет ОФД
-снапшот (FiscalNumber etc., Sprint 11), уведомляет SignalR.
-Code: `foodmarket.Domain.Sales.RetailSale`.
-
-### Demand (Оптовая отгрузка)
-Продажа юрлицу. Аналогично RetailSale, но с накладной (печатной формой).
-Code: `foodmarket.Domain.Sales.Demand`.
-
-### SupplierReturn (Возврат поставщику)
-Sprint 5. Уменьшает остаток + возвращает деньги поставщику.
-Code: `foodmarket.Domain.Purchases.SupplierReturn`.
-
-### CustomerReturn / RetailSale.IsReturn=true
-Возврат от покупателя. Реализован через флаг `IsReturn` на RetailSale +
-ReferenceSaleId. Восстанавливает остаток.
-
-## Деньги
-
-### Cost (Себестоимость)
-Скользящее среднее `(qty_old × cost_old + qty_in × price_in) / (qty_old + qty_in)`.
-Пересчитывается на каждой проведённой Supply. `Decimal(18,4)`.
-
-### ReferencePrice (Эталонная цена закупа)
-Опциональная. Заполняется автоматически unit-price'ом первой Supply;
-после 30 дней без новых Supply → Hangfire-job переписывает на Cost.
-
-### VAT (НДС)
-- `Product.Vat` (default из `Country.VatRate`, в РК — 12%).
-- `Product.VatEnabled` — управляет видимостью поля на UI.
-- На документах: `VatMode` (включается «в том числе» / «сверху»).
-
-### AllowFractionalPrices (Дробные цены)
-Org-настройка. Если false → все цены округляются до целых при сохранении.
-Sprint 23 bug-004: round-then-validate чтобы избежать «0 цена прошла
-required-check».
-
-## Доступ и безопасность
-
-### Tenant context
-`ITenantContext` (resolved per request) выдаёт `OrganizationId` из JWT
-claim `org_id`. NULL для unauthenticated / SuperAdmin-без-override.
-
-### SuperAdmin
-Системная роль. Видит все organizations + может «открыть как…» через
-`X-Org-Override` header (включает Admin claim для этой org'и).
-Все действия SuperAdmin'a в override-режиме пишутся в `super_admin_audit_log`.
-
-### OrgAuditLog
-Per-tenant журнал каждой mutate-операции (CREATE/UPDATE/DELETE на
-любую TenantEntity). Пишется автоматически через `OrgAuditInterceptor`
-на SaveChanges.
-
-### Permission
-Атрибут `[RequiresPermission("ProductsEdit")]` на endpoint'е. Проверяет
-флаг `RolePermissions` сотрудника текущего юзера. Если у юзера нет
-Employee в этой org — 403.
-
-## Фоновые операции
-
-### Hangfire job
-.NET background job framework. `recurring-job` (по cron) и
-`background-job` (одноразовый). Хранятся в схеме `hangfire` той же БД.
-
-### advisory lock (Sprint 18)
-PostgreSQL `pg_advisory_xact_lock(int, int)` — кооперативная блокировка
-per-(org, doctype). Используется для сериализации генерации номера
-документа.
-
-### Serializable transaction
-PostgreSQL Isolation Level. Используется в posting'ах документов
-(`RetailSale.Post`, `Supply.Post`, etc.) для защиты от race на
-остатках. На конфликте → 40001, теперь мапится в 409 (Sprint 23).
-
-## Внешние интеграции
-
-### ОФД (OFD)
-Оператор Фискальных Данных. В РК: Webkassa, Kassa24, ОФД-Соло.
-RetailSale.Post после успеха отправляет фискальный документ → получает
-`FiscalNumber`, `FiscalQrCode`. Sprint 11 scaffolding.
-
-### МойСклад
-Сторонняя SaaS-система учёта. Импорт товаров/контрагентов/остатков по
-OAuth-token (per-org в `Organization.MoySkladToken`).
-
-### POS (касса)
-WPF-приложение под Windows 10+. Локальный SQLite-буфер, синк через
-`/api/pos/v1/*` с idempotency-ключом (см. `pos_batch_acks`).
-
-### Telegram bot
-Один platform-bot (token в env). Owner'ы org'и привязывают свой chat-id
-(`Organization.OwnerTelegramChatId`) для получения daily-сводки.
-
-## Тестирование
-
-### Stage
-`https://test.admin.food-market.kz`. Контейнеры на prod-vm
-`192.168.1.190`, deploy через `~/deploy-stage.sh`.
-
-### Smoke / Regression / Verify
-- **Smoke** — быстрый sanity-check (5 шагов signup → login → bootstrap).
-- **Regression** — полный e2e через Playwright (44 spec'a в Sprint 23).
-- **Verify** — спринт-специфичные post-feature тесты.
-
-## Сокращения
-
-| Сокр | Что |
-|---|---|
-| **AT** | Access Token (JWT, TTL 1h) |
-| **RT** | Refresh Token (для получения нового AT) |
-| **PoS** | Point of Sale (касса) |
-| **ОФД** | Оператор Фискальных Данных |
-| **БИН** | 12-цифровой номер юрлица в РК |
-| **ИИН** | 12-цифровой номер физлица в РК |
-| **RPO** | Recovery Point Objective (макс. потеря данных при backup-restore) |
-| **RTO** | Recovery Time Objective (время восстановления) |
-| **CSP** | Content Security Policy (HTTP-header) |
-| **SA** | SuperAdmin |

docs/imports.md

@@ -1,91 +0,0 @@
-# Импорты в Food Market
-
-## Универсальный CSV-импорт товаров
-
-Endpoint: `POST /api/catalog/products/import-csv`
-
-JSON body со списком rows — клиент парсит CSV, сервер commit'ит
-транзакцией. См. Sprint 19 docs.
-
-## Импорт из 1С (Бухгалтерия / УТ / Розница)
-
-Endpoint: `POST /api/catalog/products/import/1c-csv?autoCreateGroup=true`
-
-**Content-Type**: `text/csv`, `text/plain`, `application/octet-stream`
-или `multipart/form-data` (form-file).
-
-**Кодировка**: автодетект — UTF-8 with BOM или Windows-1251 (стандарт
-1С Excel-RU).
-
-**Разделитель**: автодетект по header-строке — `;` (1С) или `,`.
-
-### Формат заголовка
-
-Обязательная колонка: **Наименование** (или `name`).
-
-Опциональные (любой регистр, оба языка):
-
-| Русский | English | Куда мапится |
-|---|---|---|
-| Артикул | code, article | `Product.Article` (создание пока пропускает) |
-| Наименование | name, title | `Product.Name` |
-| Единица | unit, ед, ед.изм. | `UnitOfMeasure` по нормализованному коду |
-| Цена | price, розничная цена | `ProductPrice.Amount` (системный priceType) |
-| Группа | category, категория, родитель | `ProductGroup.Name` (autoCreate если нет) |
-| Штрихкод | barcode, штрих-код | `ProductBarcode.Code` (первый, IsPrimary=true) |
-
-### Нормализация единиц
-
-`шт`, `штука`, `pcs` → `шт`;  `кг`, `kg` → `кг`;  `г`, `g` → `г`;
-`л`, `l` → `л`;  `мл`, `ml` → `мл`;  `м`, `m` → `м`;
-`упак`, `уп`, `pack` → `упак`.
-
-Если не распознали — передаётся как есть; если такого UnitOfMeasure
-нет — fallback на дефолтную единицу организации.
-
-### Пример
-
-```
-"Артикул";"Наименование";"Единица";"Цена";"Группа";"Штрихкод"
-"00001";"Молоко 2.5% 1л";"шт";"450";"Молочные продукты";"4870000000017"
-"00002";"Хлеб белый 500г";"шт";"180";"Хлебобулочные";"4870000000024"
-"00003";"Гречка";"кг";"650";"Крупы";""
-```
-
-### Curl-пример
-
-```bash
-curl -X POST \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: text/csv; charset=windows-1251" \
-  --data-binary @export-1c.csv \
-  "https://admin.food-market.kz/api/catalog/products/import/1c-csv?autoCreateGroup=true"
-```
-
-### Ответ
-
-```json
-{
-  "created": 248,
-  "skipped": 12,
-  "errors": [
-    { "row": 14, "error": "Дубликат штрихкода в импорте: 4870000000031" }
-  ],
-  "ids": ["...", "..."]
-}
-```
-
-- При **errors.length > 0** транзакция откатывается, ничего не создаётся.
-- При **created > 0** — все 248 товаров добавлены атомарно.
-
-### Что НЕ импортируется
-
-- НДС-ставка (берётся дефолтная Country.VatRate).
-- Себестоимость (`Cost`) — рассчитывается на первой приёмке.
-- Изображения (нужен отдельный endpoint загрузки картинок).
-- Цены типов кроме системной (нужен расширенный CSV-формат).
-- Поставщики (`DefaultSupplier`) — связь через имя нестабильна.
-
-## Импорт из МойСклад
-
-См. `docs/moysklad-import.md` (отдельный flow через OAuth-токен МойСклада).

docs/logging.md

@@ -1,79 +0,0 @@
-# Логирование (Serilog)
-
-Структурные логи через Serilog. На каждый HTTP-запрос автоматически
-обогащаются метки `CorrelationId`, `OrgId`, `UserId` через
-`LogEnrichmentMiddleware`. Любой `ILogger<…>.Log*` внутри пайплайна
-наследует эти свойства — не нужно тащить их в каждый вызов руками.
-
-## Где приземляются логи
-
-Текущая конфигурация (см. `appsettings.json` / `Program.cs`):
-- **Console** (Serilog.Sinks.Console) — в dev и docker (stdout читается
-  docker logs / journalctl);
-- **File** (Serilog.Sinks.File) — ротация по дням.
-
-Для прод-ELK/Loki в будущем добавляется `Serilog.Sinks.Elasticsearch`
-или `Serilog.Sinks.Grafana.Loki`; формат вывода уже JSON-friendly,
-кардинальность лейблов под Loki не вылезает (`OrgId` гранулярный, но
-не на каждое движение, плюс ограничен текущим парком орг ≪10k).
-
-## Корреляция между запросами
-
-Заголовок `X-Correlation-ID`:
-- если клиент прислал — middleware его уважает (для bridging с upstream'ом);
-- если нет — генерируется `Guid.NewGuid("N")`.
-
-Эхо в response-header чтобы клиент при ошибке отдал support'у конкретный id.
-
-```bash
-curl -i http://localhost:5081/api/me -H "Authorization: Bearer …"
-# < X-Correlation-ID: 7f9b3c1a4e5d4f0a8b1c2d3e4f5a6b7c
-```
-
-## Структурные бизнес-логи
-
-В коде используем именованные плейсхолдеры — Serilog кладёт каждое
-поле как отдельное property в LogEvent. Это позволяет фильтровать
-`OrgId = "..." AND SupplyNumber = "..."` без regex'ов.
-
-Хорошо:
-```csharp
-_log.LogInformation(
-    "Supply posted: {SupplyNumber} supplier={SupplierId} store={StoreId} lines={LinesCount} total={Total}",
-    supply.Number, supply.SupplierId, supply.StoreId, supply.Lines.Count, supply.Total);
-```
-
-Плохо (теряем структуру, нельзя фильтровать):
-```csharp
-_log.LogInformation($"Supply posted: {supply.Number} ...");  // string interpolation
-```
-
-## Что уже логируется как business event
-
-- `Supply posted` — после успешного `/api/purchases/supplies/{id}/post`.
-- `RetailSale posted` — после успешного `/api/sales/retail/{id}/post`.
-
-В развитии: Demand.Post, Transfer.Post, Inventory.Post, Loss.Post —
-по тому же паттерну. Метки разные, имя события одинаковое для
-аналитики «сколько проведений в час по типам».
-
-## Запросы (Serilog request logging)
-
-`app.UseSerilogRequestLogging()` пишет одну summary-строку на каждый
-HTTP-запрос: метод, путь, статус, длительность. Дополнительно
-обогащается `OrgId/UserId/CorrelationId` из LogContext.
-
-Шаблон в логе:
-```
-HTTP POST /api/purchases/supplies/{id}/post responded 204 in 87.3ms
-{ OrgId: "8b0f...", UserId: "57c3...", CorrelationId: "7f9b..." }
-```
-
-## Анти-паттерны
-
-- **Не логировать токены/пароли/email-пароли** — даже структурно.
-  Identity events (SignIn / Reset Password) — нет, только статус и user-id.
-- **Не логировать тело запроса целиком** — может содержать PII.
-  Только конкретные поля по необходимости.
-- **Не использовать string interpolation в шаблоне** — теряется
-  структура (выше).

docs/observability.md

@@ -1,198 +0,0 @@
-# Observability (Prometheus / Grafana)
-
-`food-market.api` экспортирует метрики Prometheus на `/metrics` (text exposition
-format, без авторизации). На prod закрываем nginx-уровнем (allow private
-network, deny all) или basic-auth.
-
-## Базовые метрики (от prometheus-net)
-
-| Метрика | Тип | Лейблы | Что показывает |
-|---|---|---|---|
-| `http_requests_received_total` | counter | code, method, controller, action | Сколько HTTP-запросов прошло — split per controller+action+status. |
-| `http_request_duration_seconds` | histogram | code, method, controller, action | Длительность HTTP, гистограмма для p50/p95/p99 SLO. |
-| `process_cpu_seconds_total` | counter | — | CPU time. |
-| `process_resident_memory_bytes` | gauge | — | RSS. |
-| `dotnet_total_memory_bytes` | gauge | — | Managed heap. |
-| `dotnet_collection_count_total` | counter | generation | GC count по поколениям. |
-
-## Кастомные метрики
-
-| Метрика | Тип | Лейблы | Семантика |
-|---|---|---|---|
-| `food_market_documents_posted_total` | counter | type | Проведено документов (retail-sale, supply, enter, loss, transfer, inventory, supplier-return, customer-return). |
-| `food_market_sales_posted_total` | counter | — | Alias для `documents_posted{type="retail-sale"}` (явно перечислен в SLO). |
-| `food_market_supplies_posted_total` | counter | — | Alias для `documents_posted{type="supply"}`. |
-| `food_market_documents_error_total` | counter | type, reason | Ошибки проведения: reason `serialization` (40001), `insufficient_stock`, `number_conflict`, `validation`, `other`. |
-| `food_market_db_query_duration_seconds` | histogram | kind | Длительность SQL-запросов EF Core. `kind=query` (SELECT), `kind=command` (INSERT/UPDATE/DELETE/SCALAR). |
-| `food_market_disk_free_bytes` | gauge | mount | Sprint 20: свободное место на диске (обновляется ежечасным `DiskMonitoringJob`). |
-
-Tenant-меток в кастомных метриках НЕТ сознательно: на multi-tenant хосте они
-бы раздули cardinality. Per-org разрез — через `/api/reports/*` (там
-authz-фильтр уже работает).
-
-## quality-watchdog метрики (Sprint 26+)
-
-`~/quality-watchdog.sh` после каждого прогона пишет
-`~/.fm-watchdog/textfile/quality_watchdog.prom` — формат Prometheus
-textfile. Подбирается через
-`node_exporter --collector.textfile.directory=$HOME/.fm-watchdog/textfile`.
-
-| Метрика | Тип | Лейблы | Семантика |
-|---|---|---|---|
-| `quality_watchdog_run_total` | counter | `result` | Кол-во прогонов watchdog'a, разделённых на green/red. |
-| `quality_watchdog_step_failure_total` | counter | `step` | Падений per-step (health, auth_me, products, ui_flow, metrics, signalr, multi_tenant, perf). |
-| `quality_watchdog_endpoint_p95_ms` | gauge | `endpoint` | p95 latency последнего прогона per-endpoint. |
-| `quality_watchdog_last_run_status` | gauge | — | 1 если все шаги зелёные, 0 иначе. |
-| `quality_watchdog_incidents_total` | counter | — | Создано incident-файлов (2× consecutive fail) за всё время. |
-
-Эти метрики питают `deploy/grafana/dashboards/quality-watchdog.json`
-(Sprint 26, 10 панелей).
-
-## Scrape-конфиг (prometheus.yml)
-
-```yaml
-scrape_configs:
-  - job_name: food-market-api
-    metrics_path: /metrics
-    scrape_interval: 15s
-    static_configs:
-      - targets: ['food-market-api:8080']
-```
-
-## Готовые Grafana dashboards
-
-В репо два готовых JSON-дашборда:
-
-| Файл | UID | Назначение |
-|---|---|---|
-| `deploy/grafana/dashboards/food-market.json` | `fm-baseline` | Sprint 13 baseline: HTTP / EF / бизнес-метрики |
-| `deploy/grafana/dashboards/quality-watchdog.json` | `fm-quality-watchdog` | Sprint 26: smoke success / p95 / multi-tenant violations / incidents |
-
-### `food-market.json` — 9 панелей:
-
-1. HTTP — RPS по статус-коду (stacked).
-2. HTTP — latency p50/p95/p99 (5-минутный rolling).
-3. Бизнес — документы посчитаны (Post), per-type RPS.
-4. Бизнес — ошибки проведения per-type/reason.
-5. DB — длительность EF-запросов (heatmap).
-6. HTTP — % 5xx за 5 мин (stat-панель с порогами).
-7. HTTP — % 4xx за 5 мин.
-8. Процесс — память (RSS + managed heap).
-9. GC — сборки в секунду по поколениям.
-
-### Импорт в Grafana
-
-Через UI:
-1. Grafana → Dashboards → New → Import.
-2. Upload JSON file → выбрать `deploy/grafana/dashboards/food-market.json`.
-3. Datasource — выбрать Prometheus (по дефолту в шаблонной переменной
-   `${DS_PROMETHEUS}` написано «Prometheus»).
-4. Import.
-
-Через CLI (`curl` к Grafana API, требует Bearer-токен от
-service-account c ролью Editor):
-
-```bash
-GRAFANA_URL=http://grafana.local:3000
-GRAFANA_TOKEN=<your-sa-token>
-DS_UID=$(curl -s -H "Authorization: Bearer $GRAFANA_TOKEN" \
-    "$GRAFANA_URL/api/datasources/name/Prometheus" | jq -r .uid)
-jq --arg uid "$DS_UID" '
-    .dashboard = .;
-    .dashboard.id = null;
-    .overwrite = true;
-    .inputs = [{"name":"DS_PROMETHEUS","type":"datasource","pluginId":"prometheus","value":$uid}];
-    {dashboard: .dashboard, overwrite: true, inputs: .inputs, folderId: 0}
-' deploy/grafana/dashboards/food-market.json \
-| curl -s -X POST -H "Authorization: Bearer $GRAFANA_TOKEN" \
-    -H "Content-Type: application/json" \
-    -d @- "$GRAFANA_URL/api/dashboards/import"
-```
-
-Через provisioning (когда Grafana поднимается рядом):
-```yaml
-# /etc/grafana/provisioning/dashboards/food-market.yaml
-apiVersion: 1
-providers:
-  - name: food-market
-    orgId: 1
-    folder: 'food-market'
-    type: file
-    disableDeletion: false
-    updateIntervalSeconds: 60
-    options:
-      path: /etc/grafana/dashboards/food-market
-```
-Положить `food-market.json` в `/etc/grafana/dashboards/food-market/`.
-
-### Альтернатива — минимальный набор панелей (если делать руками):
-
-### Health row
-
-* **Request rate** — `sum(rate(http_requests_received_total[5m])) by (code)`
-  → стек по 2xx/3xx/4xx/5xx.
-* **Error rate (5xx)** — `sum(rate(http_requests_received_total{code=~"5.."}[5m]))`
-  с alert `> 0.1 req/s` (5 минут) → Telegram.
-* **p95 latency** — `histogram_quantile(0.95, sum(rate(http_request_duration_seconds_bucket[5m])) by (le))`.
-
-### Business row
-
-* **Sales/hour** — `rate(food_market_sales_posted_total[1h]) * 3600`.
-* **Supplies posted** — `increase(food_market_supplies_posted_total[1d])`.
-* **Document errors** — `sum(rate(food_market_documents_error_total[5m])) by (type, reason)`.
-  Alert `serialization rate > 1 req/min`: указывает на лок-контеншн Postgres.
-
-### Database row
-
-* **EF query rate** — `sum(rate(food_market_db_query_duration_seconds_count[5m])) by (kind)`.
-* **EF query p95** — `histogram_quantile(0.95,
-  sum(rate(food_market_db_query_duration_seconds_bucket[5m])) by (le, kind))`.
-
-### Runtime row
-
-* **CPU** — `rate(process_cpu_seconds_total[1m]) * 100`.
-* **Memory** — `process_resident_memory_bytes / 1024 / 1024`.
-* **GC Gen2 collections** — `rate(dotnet_collection_count_total{generation="2"}[5m])`.
-
-## Alerts (prometheus rules) — пример
-
-```yaml
-groups:
-  - name: food-market
-    rules:
-      - alert: HighErrorRate
-        expr: sum(rate(http_requests_received_total{code=~"5.."}[5m])) > 0.1
-        for: 5m
-        labels: { severity: warning }
-        annotations:
-          summary: "food-market.api возвращает >0.1 5xx/s"
-      - alert: DbSerializationContention
-        expr: rate(food_market_documents_error_total{reason="serialization"}[5m]) > 0.016
-        for: 10m
-        labels: { severity: warning }
-        annotations:
-          summary: "Сериализационные конфликты EF >1/мин"
-      - alert: NoSalesIn30Min
-        expr: increase(food_market_sales_posted_total[30m]) == 0
-        for: 30m
-        labels: { severity: info }
-        annotations:
-          summary: "Нет продаж 30 минут — POS оффлайн или магазин закрыт"
-```
-
-## Локальная отладка
-
-```bash
-# Чтобы посмотреть метрики из локального API:
-curl http://localhost:5081/metrics | head -50
-
-# Конкретная метрика:
-curl -s http://localhost:5081/metrics | grep food_market_sales_posted_total
-```
-
-## Поведение в тестовом окружении
-
-В интеграционных тестах prometheus-метрики поднимаются как часть
-WebApplicationFactory; счётчики живут per-process (статические `Metrics.Create...`).
-Состояние accumulated между тестами в той же сборке — поэтому в
-`MetricsEndpointTests` мы проверяем «значение увеличилось», а не точное число.

docs/ofd-integration.md

@@ -1,184 +0,0 @@
-# Интеграция с ОФД-операторами Казахстана
-
-Sprint 11 — scaffolding, реальные провайдеры подключаются по мере
-получения ApiKey от пользователя. Mock работает «из коробки».
-
-## Архитектура
-
-```
-┌────────────────────────────────────────────────────────────────┐
-│ RetailSalesController.Post                                     │
-│  → списать остатки (Serializable tx)                           │
-│  → SaveChanges + COMMIT                                         │
-│  → IFiscalProviderFactory.ResolveAsync()                       │
-│       → читает Organization.FiscalProvider                      │
-│       → возвращает реализацию или null (None)                   │
-│  → provider.RegisterAsync(sale)  ← HTTP к оператору             │
-│  → сохранить FiscalNumber/FiscalQrCode на чек                  │
-└────────────────────────────────────────────────────────────────┘
-```
-
-Ключевые файлы:
-
-- `src/food-market.application/Common/Fiscal/IFiscalProvider.cs` —
-  контракт + enum'ы + исключения.
-- `src/food-market.infrastructure/Fiscal/` — реализации (Mock + 3 оператора)
-  и фабрика.
-- `src/food-market.api/Controllers/Organizations/OrgFiscalSettingsController.cs` —
-  GET/PUT настройки + POST `/test-send`.
-- `src/food-market.api/Controllers/Sales/RetailSalesController.cs#TryFiscalizeAsync` —
-  точка вызова после commit'а stock-транзакции.
-
-## Поведение по умолчанию
-
-`Organization.FiscalProvider = 0` (None) — фискализация выключена,
-чеки проводятся как и раньше, `RetailSale.FiscalNumber = null`.
-**Существующие данные не меняются.**
-
-Чтобы включить:
-
-1. Войти в «Настройки организации → ОФД».
-2. Выбрать провайдера в селекте, заполнить ApiKey/ApiSecret/CashboxUniqueNumber.
-3. Нажать «Тестовая отправка» — провайдер дёрнет себя на фейк-чеке,
-   покажет либо `FiscalNumber=…` (успех), либо текст ошибки (нет кредов /
-   оператор недоступен / провайдер ещё не реализован).
-4. Сохранить.
-5. Следующий проведённый чек получит `FiscalNumber` от оператора.
-
-## Mock-провайдер (dev / тесты)
-
-`FiscalProvider = 1`. Возвращает детерминированный фейк через ~300мс:
-
-```
-FiscalNumber: MOCK-AB12CD34          ← первые 8 hex от Sale.Id
-FiscalQrCode: https://mock.ofd.local/check/<id>?n=<FiscalNumber>
-FiscalUrl:    https://mock.ofd.local/check/<id>
-ProviderTxId: mock-tx-AB12CD34EF56
-```
-
-Идемпотентен по `Sale.Id` — повторный вызов даёт тот же FiscalNumber
-(integration-тест `FiscalMockFlowTests` это проверяет).
-
-В тестах активируется через глобальный override:
-
-```csharp
-cfg.AddInMemoryCollection(new Dictionary<string, string?>
-{
-    ["Fiscal:Provider"] = "Mock",
-});
-```
-
-Этот override **перебивает БД-настройку** для всех организаций сразу —
-удобно для интеграционных тестов, где не хочется править Organization
-в каждом сценарии.
-
-## Webkassa (https://webkassa.kz)
-
-**Самый распространённый ОФД РК.** Реализация — полный HTTP-flow с
-парсингом JSON, готов к работе. Тесты — `WebkassaProviderTests` (10
-сценариев на payload-маппинг через `BuildCheckPayload`).
-
-### Что нужно от user'а
-
-1. Зарегистрироваться в кабинете Webkassa, подписать договор.
-2. Получить в кабинете:
-   - **Логин/пароль** API-пользователя (заводится в разделе
-     «Настройки → Пользователи»). НЕ персональный логин администратора —
-     отдельный API-юзер с правом «Создание чеков».
-   - **CashboxUniqueNumber** — уникальный номер вашей кассы в разделе
-     «Настройки → Кассы → Уникальный номер».
-
-### Что вписать в настройках food-market
-
-| Поле UI                  | Значение                                              |
-|--------------------------|-------------------------------------------------------|
-| Провайдер                | Webkassa                                              |
-| ApiKey / Логин           | логин API-пользователя из кабинета Webkassa           |
-| ApiSecret / Пароль       | его пароль                                            |
-| CashboxUniqueNumber      | уникальный номер кассы (SWK… или цифровой)            |
-| Альтернативный URL       | пусто (для теста — `https://devkkm.webkassa.kz/`)     |
-
-### Поток вызовов
-
-```
-POST /api/Authorize        { Login, Password }    → { Data.Token }
-POST /api/Check            { Token, CashboxUniqueNumber, OperationType,
-                             ExternalCheckNumber, Positions[], Payments[] }
-                           → { Data.CheckNumber, QrCode, TicketUrl,
-                               UniqueNumber }
-```
-
-- **OperationType** = 1 (продажа) или 2 (возврат). Мы выбираем по
-  `RetailSale.IsReturn`.
-- **ExternalCheckNumber** — наш номер чека (например, `ПР-Y1-00019`).
-  Webkassa дедупит по этому полю → повторный POST с тем же номером
-  возвращает оригинальный чек, не создаёт дубль. Это обеспечивает
-  идемпотентность retry'я.
-- **Tax** считается «в-ставке»: `LineTotal * vat / (100+vat)`.
-  Webkassa требует именно НДС в составе цены, а не сверху.
-
-## Касса24 (https://kassa24.kz)
-
-`FiscalProvider = 3`. **Skeleton**, реальная интеграция ждёт получения
-спецификации API (NDA-only после подписания договора с Kaspi).
-
-Когда документация появится — нужно реализовать в `Kassa24Provider`:
-
-1. Аутентификацию (предположительно HMAC-SHA256 подпись ApiSecret'ом
-   по примеру Kaspi merchant API).
-2. POST `/v1/check` (рабочее название).
-3. Маппинг `RetailSale.Lines` → их формат позиций.
-4. Парсинг ответа: `fiscalNumber`, `qrCode`, `ticketUrl`, `transactionId`.
-
-В UI/тестовой отправке провайдер на сегодня возвращает
-`FiscalNotConfiguredException` с понятным сообщением.
-
-## ОФД-Соло (https://ofd-solo.kz)
-
-`FiscalProvider = 4`. **Skeleton**, аналогично Касса24.
-
-Особенности (из публичных источников):
-- SOAP-based legacy + REST-обёртка (использовать REST).
-- Аутентификация по token-логину (как Webkassa).
-- Чек регистрируется одним вызовом (без двухшагового create/post).
-
-## Безопасность кредов
-
-`Organization.FiscalApiKeyEncrypted` / `FiscalApiSecretEncrypted` —
-**DataProtection-шифрованный blob** (purpose=`foodmarket.fiscal`).
-В API-ответах НЕ возвращаются: GET `/api/organization/fiscal` отдаёт
-только `hasApiKey: bool` / `hasApiSecret: bool` флаги.
-
-Чтобы изменить — PUT с непустым `newApiKey`/`newApiSecret`. Чтобы
-СНЯТЬ (вернуться к None без потери остальных полей) — отправить
-спец-значение `"__clear__"`.
-
-При смене DataProtection ключа (rotation / restore из бэкапа без
-ключей) — `Unprotect` упадёт. Провайдер бросит понятное сообщение
-с просьбой «Введите ApiKey/ApiSecret заново».
-
-## Чек-сценарий retry / network failure
-
-Фискализация вызывается **после** commit'а stock-транзакции и
-является best-effort:
-
-- Сетевая ошибка / 5xx от оператора → лог `Warning`, чек остаётся
-  проведённым без FiscalNumber. UI отрендерит чек, на квитанции
-  будет «не фискализован» (нужно перепровести вручную:
-  unpost → post → провайдер дёрнется снова).
-- `FiscalNotConfiguredException` → лог `Warning`, без алерта (это
-  валидная диагностика, не ошибка системы).
-- Идемпотентность: `TryFiscalizeAsync` проверяет
-  `string.IsNullOrEmpty(sale.FiscalNumber)` и не дёргает провайдера,
-  если фискальный номер уже есть. Re-post чека (unpost→post) с уже
-  фискализованным состоянием → не дублирует регистрацию.
-
-## Метрики и наблюдаемость (TODO sprint 12+)
-
-Пока есть только логи (`Information` на успех, `Warning` на ошибку).
-В следующем спринте добавить:
-
-- `AppMetrics.IncrementFiscalized(provider)` / `IncrementFiscalFailed(provider)`.
-- Алерт «провайдер X провалился N раз за последние M минут» —
-  возможно перевод на ручную фискализацию.
-- Dashboard-виджет «фискальный статус» (% чеков с FiscalNumber за день).

docs/openapi.md

@@ -1,59 +0,0 @@
-# OpenAPI / Swagger
-
-API публикует OpenAPI-документ через `Swashbuckle.AspNetCore`. Описание
-включает security-scheme `Bearer` (OpenIddict JWT), стабильные
-`operationId = Controller_Action`, уникальные `schemaId` с префиксом из
-неймспейса (одноимённые nested record'ы в разных контроллерах не схлопываются).
-
-## Эндпоинты
-
-| URL | Когда |
-|---|---|
-| `/swagger`               | UI, только Development |
-| `/swagger/v1/swagger.json` | JSON-документ, только Development |
-
-На stage/prod swagger отключён — отдельный endpoint enumeration
-не должен раскрываться неавторизованным клиентам. Если нужно — поднимать
-локальный API из той же ветки.
-
-## TypeScript-клиент
-
-В `src/food-market.web` подключён `openapi-typescript` (devDependency).
-Команда:
-
-```bash
-# Терминал 1: поднять API
-ASPNETCORE_ENVIRONMENT=Development dotnet run --project src/food-market.api
-
-# Терминал 2: сгенерировать types
-cd src/food-market.web
-pnpm run gen:api      # читает http://localhost:5081/swagger/v1/swagger.json
-                      # → src/lib/api.generated.ts
-```
-
-Альтернативно (без живого API) — через `Swashbuckle.AspNetCore.Cli` (версия
-должна совпадать с `Swashbuckle.AspNetCore`, у нас 6.9.0):
-
-```bash
-dotnet tool install --global Swashbuckle.AspNetCore.Cli --version 6.9.0
-dotnet build src/food-market.api
-swagger tofile --output /tmp/swagger.json \
-  src/food-market.api/bin/Debug/net8.0/foodmarket.Api.dll v1
-cd src/food-market.web
-pnpm exec openapi-typescript /tmp/swagger.json -o src/lib/api.generated.ts
-```
-
-## Использование
-
-Тонкая обёртка в `src/food-market.web/src/lib/apiClient.ts` экспортирует
-типизированные хелперы для отчётов (Reports/Sales, Reports/ABC,
-Reports/Profit) — образец постепенной миграции с ручных типов в
-`types.ts`. В новом коде использовать обёртку и переэкспортированные
-типы; старые страницы переписывать по мере правок.
-
-## Версионирование
-
-Document `v1` — единственный. Если будут breaking changes — поднимаем
-`v2` рядом, не ломая `v1`. У `operationId` стабильное имя
-`Controller_Action` — переименование контроллера ломает TS-клиент,
-относиться как к public API.

docs/openiddict-keys.md

@@ -1,65 +0,0 @@
-# Ключи OpenIddict (подпись и шифрование токенов)
-
-Токены доступа/обновления подписываются (и в проде шифруются) ключами OpenIddict.
-Конфигурация ключей — в `OpenIddictKeyConfigurator` (`src/food-market.api/Infrastructure/Security/`),
-вызывается из `Program.cs` внутри `AddServer(...)`.
-
-## Development
-
-- Persistent RSA-ключ в `src/food-market.api/App_Data/openiddict-dev-key.xml`
-  (один и тот же для подписи и шифрования).
-- Переживает рестарты — выданные токены остаются валидными между перезапусками.
-- **Шифрование access-token выключено** (`DisableAccessTokenEncryption`) — токен это
-  обычный 3-сегментный JWT, удобно дебажить (можно прочитать на jwt.io).
-- Файл `App_Data/` в `.gitignore` — ключ не коммитится.
-
-## Production / Stage
-
-- Отдельные **X509-сертификаты** для подписи и шифрования. Access-token шифруется
-  (5-сегментный JWE).
-- Путь к сертификатам — из конфигурации:
-
-  | Ключ конфига | Env-переменная | Назначение | Дефолт |
-  |---|---|---|---|
-  | `OpenIddict:SigningCertPath` | `OpenIddict__SigningCertPath` | сертификат подписи | `App_Data/openiddict-signing.pfx` |
-  | `OpenIddict:EncryptionCertPath` | `OpenIddict__EncryptionCertPath` | сертификат шифрования | `App_Data/openiddict-encryption.pfx` |
-  | `OpenIddict:CertPassword` | `OpenIddict__CertPassword` | пароль PFX (опц.) | — |
-
-- **Если файла нет** — генерируется persistent self-signed сертификат (RSA 2048, срок 5 лет)
-  и сохраняется по пути. При следующем старте берётся тот же файл, поэтому ранее
-  выданные токены остаются валидными (нет dev-ephemeral поведения, при котором каждый
-  рестарт инвалидировал бы все токены).
-- `App_Data` смонтирован как volume (`api-data:/app/App_Data` в `docker-compose.yml`),
-  поэтому сертификаты переживают пересоздание контейнера.
-
-### Принести собственные сертификаты
-
-Положить готовые `.pfx` (с приватным ключом) по путям из конфига и, при наличии пароля,
-задать `OpenIddict__CertPassword`. Приложение их подхватит вместо генерации self-signed.
-
-```bash
-# пример: смонтировать каталог с сертификатами и указать пути
-OpenIddict__SigningCertPath=/run/secrets/oidc-signing.pfx
-OpenIddict__EncryptionCertPath=/run/secrets/oidc-encryption.pfx
-OpenIddict__CertPassword=<пароль или пусто>
-```
-
-### Ротация
-
-1. Заменить/удалить `.pfx` файлы (или указать новые пути).
-2. Рестарт API: при отсутствии файла сгенерируется новый сертификат.
-3. **Важно:** ротация ключа подписи/шифрования инвалидирует все ранее выданные
-   токены — пользователям потребуется перелогиниться. Планировать на окно обслуживания.
-
-### Проверка (smoke)
-
-```bash
-# 5 сегментов = JWE (шифрование включено) — норма для прода
-curl -s -X POST $API/connect/token -H "Content-Type: application/x-www-form-urlencoded" \
-  -d "grant_type=password&username=...&password=...&client_id=food-market-web&scope=api" \
-  | python3 -c "import sys,json;print(json.load(sys.stdin)['access_token'].count('.')+1,'сегментов')"
-```
-
-Проверено локально (2026-05-27): prod-режим генерирует оба сертификата в `App_Data`,
-выдаёт 5-сегментный JWE, `/api/me` → 200; после рестарта сертификаты те же
-(fingerprint совпадает), токен, выданный до рестарта, остаётся валиден.

docs/performance-baseline.md

@@ -1,178 +0,0 @@
-# Performance baseline — food-market API
-
-Дата прогона: **2026-06-07**. Прогон против stage:
-`https://test.admin.food-market.kz`. Инструмент — k6 v0.55.0.
-
-Сетап stage'а на момент замеров:
-- 1 контейнер `food-market-stage-api` (Kestrel, .NET 8).
-- 1 контейнер `food-market-stage-postgres` (Postgres 16, дефолтные настройки).
-- Nginx-фронт на dev-vm `192.168.1.190`, dev-машина k6-генератора в той
-  же локалке (RTT ~5-20мс).
-
-Все цифры — **с одного клиента**, без воспроизведения пиковой нагрузки
-из ЦА продакшна. Это baseline для регрессий, не SLA.
-
-## TL;DR — что работает, что нет
-
-| Операция | Здоровый сценарий | Предел до деградации | Узкое место | Статус |
-|---|---|---|---|---|
-| **GET /api/reports/sales** (1500 чеков в орге) | p95 50-115ms до 5 VU | После 5 VU непредсказуемо | PG aggregation / connection pool | как есть |
-| **POST /api/auth/signup** | p95 446ms при 50 RPM | 100 RPM с одного IP → 39% 429 | IP rate-limit (60/мин, by design) | как есть |
-| **POST /api/sales/retail + /post** (sequential) | p95 71ms, 17 sales/sec | VU > 1: race на номере (23505) и serialization conflict (40001) | `GenerateNumberAsync` race + Serializable | ✅ Sprint 18: advisory lock убил 23505. Sprint 23: 40001 теперь корректные 409 (было 500). |
-
-## Прогон 1: signup-burst
-
-`tests/load/signup-burst.js` — 50/100 регистраций/мин с одного IP, 60с.
-
-### 50 RPM (под IP-лимитом 60/мин)
-
-| Метрика | Значение |
-|---|---|
-| Iterations | 51 (за 60с) |
-| http_req_duration p50 | 391ms |
-| http_req_duration p90 | 425ms |
-| http_req_duration p95 | 446ms |
-| http_req_duration p99 | ~1.37s (один outlier) |
-| signup_rate_limited | 0% |
-| Failures | 0 |
-
-Прогон чистый. Signup на stage'е укладывается в ~400-450ms p95.
-
-### 100 RPM (превышение IP-лимита)
-
-| Метрика | Значение |
-|---|---|
-| Iterations | 101 |
-| 2xx (успешные) | 62 |
-| 429 (rate-limited) | 39 (38.6%) |
-| http_req_duration p95 (2xx-only) | 437ms |
-
-429-ответы возвращаются за единицы миллисекунд (`http_req_duration`
-total p95 показывает 436ms потому что включает и 429 — лимитер очень
-быстрый). Поведение by design (см. `AuthRateLimiterExtensions`),
-указывает что защита работает.
-
-## Прогон 2: retail-sales-parallel
-
-`tests/load/retail-sales-parallel.js` — на одном tenant'е N параллельных
-кассиров (VU) проводят чеки. Тест создаёт draft (`POST /api/sales/retail`)
-и сразу проводит (`POST /api/sales/retail/{id}/post`).
-
-### VU=1 (sequential baseline) — 200 итераций
-
-| Метрика | Значение |
-|---|---|
-| Iterations | 200/200 (100%) |
-| Throughput | **17 sales/sec** |
-| sale_draft_ms p50 | 25ms |
-| sale_draft_ms p95 | 37ms |
-| sale_post_ms p50 | 26ms |
-| sale_post_ms p95 | 35ms |
-| sale_total_ms p95 | **71ms** |
-| sale_total_ms p99 | ~90ms |
-| post_4xx | 0% |
-
-Идеальная картинка: 17 sales/sec на single-thread, латенция стабильная.
-
-### VU=5 (параллельные кассиры) — 200 итераций
-
-| Метрика | Значение |
-|---|---|
-| Iterations | 200/200 (driver), но успешных только 94 |
-| post_4xx | **53% 🔴** |
-| sale_draft_ms p95 (включая failed) | 151ms |
-| sale_total_ms p95 (только успешные) | 185ms |
-
-**Узкое место найдено: race в `GenerateNumberAsync`.**
-
-`RetailSalesController.GenerateNumberAsync` строит next-number чтением
-последней `Number` для tenant'а и +1. Под параллельными VU несколько
-запросов читают одно и то же `lastNumber`, генерируют одинаковый
-`ПР-2026-000XXX`, на INSERT падают на unique-index
-`IX_retail_sales_OrganizationId_Number`. `SaveOrFkErrorAsync` ловит
-только 23503 (FK violation), не 23505 (unique violation) — поэтому
-до клиента долетает 500 (или 400 от EF middleware).
-
-**Что делать (отдельная задача, не в Sprint 12)**: завести
-`organization_counters` (singleton-row per tenant), увеличивать счётчик
-через `UPDATE … RETURNING value` в той же транзакции. Альтернатива —
-ловить 23505 и ретраить с +1 в цикле. Третий вариант — использовать
-PG sequence per tenant (более сложно, но самое чистое).
-
-## Прогон 3: sales-report-heavy
-
-`tests/load/sales-report-heavy.js` — за 20-30 секунд VU дёргают
-`GET /api/reports/sales?dateFrom=...&dateTo=...&groupBy=day`,
-`/api/reports/abc?...` и `/api/dashboard/top-products?limit=5`.
-
-Tenant с **1500 проведённых чеков, 5535 stock_movements, 200 товаров**
-(посеян через `POST /api/admin/seed-demo?years=1` — это YearDemoSeeder).
-
-| VU | Throughput (iter/s) | sales p95 | abc p95 | non_2xx | Заметки |
-|---|---|---|---|---|---|
-| 1  | 6.7 | 54ms  | 51ms | 0% | Чистый baseline. |
-| 2  | 17.5 | 60ms | 54ms | 0% | Linear, ОК. |
-| 3  | 23.5 | 67ms | 63ms | 0% | Linear, ОК. |
-| 4  | 25.4 | 81ms | 78ms | 0% | Незначительная деградация. |
-| 5  | 24.0 | 114ms | 108ms | 0% | Деградация заметнее, throughput плато. |
-| 5* | 8.7  | 3 800ms 🔴 | 3 500ms 🔴 | 0% | Аномалия одного прогона (см. ниже). |
-
-`*` Первый прогон VU=5 показал p95 ~3.8с на отчёт. Повторный прогон —
-обычные 114ms p95. Скорее всего совпало с autovacuum'ом
-`stock_movements` (5535 строк, частые обновления при seed'е). Это
-напоминает: в production нужны:
-- Мониторинг p95 отчётов в Prometheus + алерт на отклонение от baseline.
-- Тюнинг `autovacuum_*` для `stock_movements` (или явный
-  `VACUUM ANALYZE` после массовых seed'ов).
-
-### Что НЕ протестировано (требует входа от user)
-
-- **10 000 чеков на одного tenant'а** — пользователь просил «отчёт Sales
-  с 10 000 продажами». YearDemoSeeder делает максимум 1500 (это сезонный
-  год для одного магазина); чтобы получить 10к — нужно либо допилить
-  seeder на «10 лет» / «10 магазинов», либо запустить несколько
-  параллельных seed'ов под отдельными tenant'ами и тестировать
-  cross-tenant. Пока обозначено как TODO для будущего спринта.
-- **Реальная нагрузка из ЦА** — k6 запускается из локалки, RTT
-  5-20мс. Реальный пользователь из Алматы добавит 30-80мс к
-  каждому запросу. Считать SLA с учётом этого.
-- **POS-синк** (`POST /api/pos/v1/batch`) — отдельный сценарий, потому
-  что требует серии чеков с идемпотентным ключом и подходящих refs.
-  TODO: `pos-sync.js`.
-
-## Сводка: что нужно поправить
-
-| Приоритет | Что | Где | Статус |
-|---|---|---|---|
-| 🔴 P0 | Race в `GenerateNumberAsync` | `RetailSalesController.cs` | ✅ Зафиксен в Sprint 18 через PostgreSQL advisory lock (`DocumentNumberRetry.WithOrgAdvisoryLockAsync` per (orgHash, docTypeHash)). Воспроизводится: 23505 ошибки 53% → 0. |
-| 🟡 P1 | Тот же подход в `SuppliesController/DemandsController/...` | Везде где есть `GenerateNumberAsync` | ⚠️ Helper `DocumentNumberRetry` готов, но к Supplies/Demands ещё не применён. TODO для будущего спринта. |
-| 🟡 P1 | 40001 Serializable conflict при concurrent /post → 500 | `RetailSalesController.Post` | ✅ Зафиксен в Sprint 23: `SerializationConflictMiddleware` мапит 40001 → 409 + `SerializableRetry` helper (exp backoff) применён к `RetailSale.PostCoreAsync`. После: 20 параллельных продаж → 0 × 500, 6 ok + 14 × 409, stock invariant сохраняется. |
-| 🟢 P2 | Tune autovacuum для `stock_movements` | PG config / `ALTER TABLE` | ✅ Sprint 20: `DatabaseMaintenanceJobs.VacuumTopTablesAsync` weekly воскр 04:00 UTC. |
-| 🟢 P2 | Прометей-алерт на p95 отчёта | observability | ⚠️ Sprint 20 добавил `~/nightly-perf-check.sh` (sliding baseline + Telegram). Реальные Prometheus alert-rules — не настроены. |
-| 🟢 P2 | k6 для POS-синка с idempotency | `tests/load/pos-sync.js` | ❌ Не реализовано. |
-
-## Воспроизведение
-
-```bash
-# k6 v0.55+ должен быть в PATH (см. tests/load/README.md)
-cd tests/load
-
-# 1. Signup-burst (60с, 50 RPM)
-BASE_URL=https://test.admin.food-market.kz TARGET_RPM=50 \
-    k6 run signup-burst.js
-
-# 2. Sales sequential baseline
-BASE_URL=https://test.admin.food-market.kz \
-    DURATION_S=120 TARGET_ITERS=200 VUS=1 \
-    k6 run retail-sales-parallel.js
-
-# 3. Reports на свежем tenant'е (нужны creds от signup + year-demo seed)
-SLUG="loadbase-$(date +%s)"
-EMAIL="$SLUG@example.kz"
-curl -sX POST $BASE_URL/api/auth/signup -H 'Content-Type: application/json' \
-    -d "{\"email\":\"$EMAIL\",\"password\":\"Passw0rd!\",\"organizationName\":\"LoadOrg\",\"phone\":\"+77001234567\"}"
-TOKEN=$(curl -sX POST $BASE_URL/connect/token -d "grant_type=password&username=$EMAIL&password=Passw0rd!&client_id=food-market-web&scope=openid profile email roles api offline_access" | jq -r .access_token)
-curl -sX POST -H "Authorization: Bearer $TOKEN" "$BASE_URL/api/admin/seed-demo?years=1"
-
-EMAIL=$EMAIL PASSWORD=Passw0rd! VUS=3 k6 run sales-report-heavy.js
-```

docs/quality-status.md

@@ -1,60 +0,0 @@
-# Quality status
-
-_Обновлено: 2026-06-08T07:48:24+00:00 · auto-gen из `~/quality-watchdog.sh`_
-
-## 🟢 Текущий статус
-
-**Последний прогон:** `2026-06-08T12:48:01+05:00`  
-**Зелёных шагов:** 8/8  
-**Красных шагов:** 0  
-
-## Шаги smoke-suite
-
-| Шаг | Статус | Последнее изменение | Consecutive fail |
-|---|---|---|---|
-| /health/ready | 🟢 | `2026-06-08T12:48:01+05:00` | 0 |
-| signup→login→/api/me | 🟢 | `2026-06-08T12:48:01+05:00` | 0 |
-| GET /api/catalog/products | 🟢 | `2026-06-08T12:48:01+05:00` | 0 |
-| Playwright UI (product CRUD) | 🟢 | `2026-06-08T12:48:01+05:00` | 0 |
-| /metrics (Prometheus) | 🟢 | `2026-06-08T12:48:01+05:00` | 0 |
-| /hubs/notifications/negotiate | 🟢 | `2026-06-08T12:48:01+05:00` | 0 |
-| Multi-tenant isolation | 🟢 | `2026-06-08T12:48:01+05:00` | 0 |
-| Performance p95 vs baseline | 🟢 | `2026-06-08T12:48:01+05:00` | 0 |
-
-## Performance baseline (p95, ms)
-
-| Endpoint | p95 (ms) |
-|---|---|
-| `/api/catalog/products/page/1/pageSize/10` | 233 |
-| `/api/me` | 259 |
-| `/api/sales/retail/stats/days/7` | 228 |
-
-_Регрессия = текущий p95 >50% от baseline. Baseline обновляется только когда регрессии нет (берёт min)._
-
-## История за 7 дней
-
-**Прогонов:** 14  
-**С красным:** 7  
-**Green-ratio:** 50%  
-
-### Прогоны с красным шагом
-
-| Время | Красные шаги |
-|---|---|
-| `2026-06-08T12:16:05+05:00` | multi_tenant |
-| `2026-06-08T12:16:52+05:00` | multi_tenant |
-| `2026-06-08T12:18:01+05:00` | multi_tenant |
-| `2026-06-08T12:18:35+05:00` | multi_tenant |
-| `2026-06-08T12:22:49+05:00` | health, auth_me, products, metrics, signalr, multi_tenant, perf |
-| `2026-06-08T12:23:00+05:00` | health, auth_me, products, metrics, signalr, multi_tenant, perf |
-| `2026-06-08T12:23:18+05:00` | perf |
-
-## Последние 24 прогона
-
-`🔴🔴🔴🔴🟢🟢🔴🔴🔴🟢🟢🟢🟢🟢`
-
----
-
-Скрипт: `~/quality-watchdog.sh` (cron `0 * * * *`).  
-Источник: `~/.fm-watchdog/quality-history.jsonl`.  
-Sprint 25 — autonomous continuous quality monitoring.

docs/release-checklist.md

@@ -1,56 +0,0 @@
-# Чек-лист релиза food-market
-
-Практический список перед/во время/после выкатки. Деплой автоматизирован
-(push в `main` → GitHub Actions: CI → образы → deploy stage; см. [stage-setup.md](stage-setup.md)).
-Прод — после подтверждения на stage.
-
-## 0. Предусловия (один раз на окружение)
-
-- [ ] `deploy/.env` заполнен из `deploy/.env.example`, права `600` (см. [secrets.md](secrets.md)).
-- [ ] `POSTGRES_PASSWORD` — не дефолтный.
-- [ ] `OPENIDDICT_ISSUER` = публичный URL админки (за прокси обязателен).
-- [ ] OpenIddict-сертификаты на месте или генерируются self-signed (см. [openiddict-keys.md](openiddict-keys.md)).
-- [ ] Таймер бэкапа установлен и активен: `systemctl list-timers food-market-backup.timer` (см. [backup-restore.md](backup-restore.md)).
-- [ ] HTTPS на nginx-проксе настроен (вне этого репо).
-
-## 1. Перед релизом (на ветке/в PR)
-
-- [ ] `dotnet build` зелёный (api + зависимости; POS на Linux не собирается — это норма).
-- [ ] Юнит-тесты зелёные: `dotnet test tests/food-market.UnitTests`.
-- [ ] Интеграционные тесты зелёные: `dotnet test tests/food-market.IntegrationTests` (нужен Docker для Testcontainers).
-- [ ] Релевантные e2e-сценарии зелёные (`tests/e2e/run.sh <name>`).
-- [ ] Новые EF-миграции просмотрены: идемпотентны, без потери данных, при ручном написании — `[Migration("ID")]` + `[DbContext]` (иначе `Migrate()` не подхватит).
-- [ ] Изменения секретов/конфигов отражены в `.env.example` и `secrets.md`.
-- [ ] CHANGELOG/release notes обновлены (если ведутся).
-
-## 2. Бэкап перед выкаткой
-
-- [ ] Свежий бэкап БД: `sudo systemctl start food-market-backup.service` → проверить файл в `FM_BACKUP_DIR`.
-- [ ] Проверить, что дамп валиден: `pg_restore --list` (см. [backup-restore.md](backup-restore.md)).
-
-## 3. Релиз
-
-- [ ] Смёрджить в `main` (или прогнать `deploy-stage.yml`). CI соберёт образы и задеплоит на stage.
-- [ ] Дождаться Telegram-уведомления «Deploy stage OK».
-- [ ] Миграции применяются автоматически на старте API (`Migrate()`), отдельный шаг не нужен.
-
-## 4. После выкатки (smoke)
-
-- [ ] `curl -fsS https://<host>/health/ready` → `200 Healthy` (БД + миграции).
-- [ ] `curl https://<host>/health/live` → `200`.
-- [ ] Логин: получить токен на `/connect/token`, `/api/me` → `200` с ожидаемыми claim'ами и `org_id`.
-- [ ] Ключевые потоки: создать товар, провести приёмку, провести розничную продажу — без ошибок.
-- [ ] Permission-гейт работает: пользователь без права получает `403` (не `500`/`200`).
-- [ ] Антибрутфорс: >5 логинов/мин с одного IP → `429`.
-- [ ] Логи без необработанных исключений: `docker logs food-market-api | tail`.
-
-## 5. Откат (если что-то не так)
-
-- [ ] Откатить теги образов: задать прежние `API_TAG`/`WEB_TAG` в `.env`, `docker compose up -d`.
-- [ ] Если миграция повредила данные — восстановить БД из бэкапа п.2 (см. [backup-restore.md](backup-restore.md)), затем откатить образ.
-- [ ] Сообщить в Telegram-канал статус.
-
-## 6. Прод (после OK на stage)
-
-- [ ] Повторить пп. 2–5 на прод-окружении.
-- [ ] Мониторить первые ~30 мин: `/health/ready`, логи, диск (`df -h`).

docs/secrets.md

@@ -1,68 +0,0 @@
-# Секреты и переменные окружения
-
-Все секреты задаются через `deploy/.env` (в `.gitignore`, **не коммитится**).
-Шаблон со всеми переменными — `deploy/.env.example`. docker-compose читает `.env`
-автоматически из каталога запуска (`deploy/`).
-
-```bash
-cp deploy/.env.example deploy/.env
-$EDITOR deploy/.env          # заполнить значения
-chmod 600 deploy/.env        # ограничить доступ
-```
-
-## Перечень
-
-| Переменная | Обяз. | Назначение | Где используется | Как получить |
-|---|:---:|---|---|---|
-| `POSTGRES_PASSWORD` | ✅ | пароль БД `food_market` | контейнер postgres + `ConnectionStrings__Default` API | `openssl rand -base64 24` |
-| `REGISTRY` | ✅ | реестр образов | image-ссылки в compose | стейдж: `127.0.0.1:5001` |
-| `API_TAG` / `WEB_TAG` / `PUBLIC_TAG` | ✅ | теги образов | image-ссылки | тег из CI / `latest` |
-| `OPENIDDICT_ISSUER` | ✅(прод) | публичный issuer токенов | API `OpenIddict__Issuer` | публичный URL админки, напр. `https://admin.food-market.kz/` |
-| `OPENIDDICT_CERT_PASSWORD` | — | пароль PFX-сертификатов | API `OpenIddict__CertPassword` | свой пароль или пусто (self-signed без пароля) |
-| `FM_BACKUP_DIR` / `FM_UPLOADS_DIR` / `FM_BACKUP_RETENTION_DAYS` | — | параметры бэкапа | `food-market-backup.sh` | дефолты совпадают с compose |
-| `Cors__AllowedOrigins__N` | — | CORS-origins | API | переопределяет `appsettings.json` |
-| `RateLimiting__*` | — | антибрутфорс лимиты | API | дефолты 5/мин, 20/час |
-| `MoySklad__BaseUrl` | — | база API МойСклад | API | дефолт боевой `api.moysklad.ru` |
-| `Telegram__BotToken` | — | токен Telegram-бота для alert'ов и owner-сводки | `OwnerDailySummaryJob`, `DiskMonitoringJob` | bot @BotFather |
-| `Telegram__BotUsername` | — | username бота (без @) для deep-link'ов в notify | `TelegramBindingController` | у бота в Telegram |
-| `Authentication__Google__ClientId` / `__ClientSecret` | — | OAuth Google SSO (Sprint 20 scaffold) | API `ExternalAuthController` | см. `docs/sso.md` |
-| `Authentication__Microsoft__ClientId` / `__ClientSecret` | — | OAuth Microsoft SSO (Sprint 20 scaffold) | API `ExternalAuthController` | см. `docs/sso.md` |
-| `Monitoring__DiskPaths` | — | CSV mount-paths для disk-monitor (default `/opt,/var/lib/docker`) | `DiskMonitoringJob` (Sprint 20) | список mount'ов хоста |
-| `Monitoring__DiskMinFreeBytes` | — | порог alert'a (default 1 GB) | `DiskMonitoringJob` | в байтах |
-| `Monitoring__DiskAlertCooldownHours` | — | антиспам для disk-alert (default 6h) | `DiskMonitoringJob` | в часах |
-| `Monitoring__SuperAdminTelegramChatIds` | — | CSV chat-id'ы для disk/perf alert'ов | `DiskMonitoringJob`, `nightly-perf-check.sh` | chat-id юзера |
-| `Cleanup__DraftDays` / `__OrgAuditLogDays` / `__RevokedRefreshTokenDays` | — | retention для cleanup-job'ов (default 30 / 90 / 7) | `HousekeepingJobs` (Sprint 20) | в днях |
-| `Hangfire__Retention__StockMovementDays` / `__AuditLogDays` | — | retention для prune'ов | `HousekeepingJobs` | в днях |
-| `Hangfire__Cron__*` | — | переопределение cron-расписания jobs | `HangfireJobsConfigurator` | стандартный 5-полевой cron |
-| `Maintenance__VacuumTopN` | — | сколько таблиц VACUUM ANALYZE еженедельно (default 5) | `DatabaseMaintenanceJobs` (Sprint 20) | int |
-| `App__PublicBaseUrl` | — | публичный URL админки (для email-link'ов на GDPR-export) | `OrgExportJob` (Sprint 22) | напр. `https://admin.food-market.kz` |
-| `Storage__Type` | — | `local` (default, `/uploads` volume) или `minio` | `StorageBootstrap` | строка |
-| `Storage__Minio__Endpoint` / `__AccessKey` / `__SecretKey` / `__Bucket` | — | конфиг MinIO/S3 если Type=minio | `MinioObjectStorage` | у провайдера S3 |
-| `PUBLIC_GA_ID` / `PUBLIC_YM_ID` | — | Google Analytics 4 / Yandex.Metrika ID на marketing-сайте (Sprint 20) | Astro `BaseLayout.astro` | см. `docs/analytics.md` |
-
-> `__` (двойное подчёркивание) — разделитель секций конфигурации .NET
-> (`OpenIddict__Issuer` ≡ `OpenIddict:Issuer`).
-
-## Где ещё живут секреты
-
-- **SMTP (отправка писем)** — НЕ в env. Хранятся в БД (`platform_settings`),
-  правятся из SuperAdmin-консоли (раздел «Платформа → SMTP»). Перечитываются на
-  каждой отправке без рестарта (см. `MailKitEmailSender`).
-- **Сертификаты OpenIddict** — PFX в volume `api-data` (`/app/App_Data`). Генерируются
-  self-signed при отсутствии. Можно принести свои — см. [openiddict-keys.md](openiddict-keys.md).
-- **Учётки БД/Forgejo на сервере** — вне репозитория (см. приватные заметки оператора).
-
-## Ротация
-
-| Секрет | Как ротировать | Влияние |
-|---|---|---|
-| `POSTGRES_PASSWORD` | `ALTER USER food_market PASSWORD '…'`, обновить `.env`, `docker compose up -d` | рестарт API |
-| OpenIddict-сертификаты | заменить/удалить PFX, рестарт API | все токены инвалидируются — повторный логин |
-| SMTP-пароль | через SuperAdmin-консоль | без рестарта |
-
-## Гигиена
-
-- `deploy/.env` — права `600`, владелец — пользователь деплоя.
-- Не логировать значения секретов. Serilog настроен без дампа окружения.
-- При утечке — ротировать затронутый секрет (таблица выше) и пересоздать токены.
-- Проверка, что секреты не утекли в git: `git ls-files | grep -E '\.env$'` должен быть пуст.

docs/sprint-incident-1780974301.md

@@ -1,113 +0,0 @@
-# Incident 1780974301 — multi_tenant ref endpoints failed
-
-**Дата:** 2026-06-09 08:05 (cron-watchdog), повторно 08:17 (manual).
-**Стартовый отчёт:** auto-generated через `~/quality-watchdog.sh`.
-**Шаг:** `multi_tenant`. **Подряд падений:** 2 → incident.
-**Детали с watchdog'a:**
-```
-не удалось получить refs для org A
-  uom= (пусто)
-  pg=811183b5-9c39-45ea-9fd4-595e6681f92e (успех)
-  pt=c7b4e7e9-4919-4ae0-86a2-2fc053ddeeac (успех)
-  cur= (пусто)
-```
-
-## Воспроизведение
-
-### Извне (192.168.1.192 → https://test.admin.food-market.kz)
-
-```bash
-# Свежий signup → token → 4 ref endpoint'a
-TS=$(date +%s)
-curl -sS https://test.admin.food-market.kz/api/auth/signup ...   # → 200 OK
-curl -sS https://test.admin.food-market.kz/connect/token ...     # → 200 OK + token
-for ep in units-of-measure product-groups price-types currencies; do
-  curl -sS https://test.admin.food-market.kz/api/catalog/$ep?pageSize=1 \
-    -H "Authorization: Bearer $TOK"
-done
-# Результат:
-#   units-of-measure  → curl: (56) Recv failure: Connection reset by peer / HTTP 000
-#   product-groups    → curl: (56) Recv failure: Connection reset by peer / HTTP 000
-#   price-types       → curl: (56) Recv failure: Connection reset by peer / HTTP 000
-#   currencies        → curl: (56) Recv failure: Connection reset by peer / HTTP 000
-```
-
-### Изнутри (прод-vm 192.168.1.190 → http://localhost:8085)
-
-```bash
-# Тот же signup+token+4 endpoint'a, но напрямую к web-контейнеру (минуя
-# внешний TLS-терминатор 88.204.171.93).
-ssh nns@192.168.1.190 'curl http://localhost:8085/api/catalog/units-of-measure?pageSize=1 -H "Authorization: Bearer $TOK"'
-# Результат 5/5 прогонов:
-#   units-of-measure → HTTP 200
-#   product-groups   → HTTP 200
-#   price-types      → HTTP 200
-#   currencies       → HTTP 200
-```
-
-Также подтверждено:
-- `food-market-stage-api-1` контейнер: **Up 3 hours (healthy)**.
-- `/health/ready` от prod-vm: **{"status":"Healthy"}** за 49ms.
-- 4-часовой soak только что закончился: api держал 50 RPS все 4 часа,
-  mem 250-300 MiB без linear roста, p95 me=269ms.
-
-## Root cause
-
-**Не баг food-market.** Внешний TLS-терминатор `88.204.171.93` (между
-dev-vm 192.168.1.192 и публичным stage'ом) периодически роняет
-TLS-соединения с `unexpected EOF` / `Connection reset by peer`. ~50%
-запросов извне получают HTTP 000.
-
-Watchdog (`~/quality-watchdog.sh`) запускается из dev-vm и ходит на
-публичный URL `https://test.admin.food-market.kz`, поэтому видит эти
-network-level failures. На уровне приложения всё OK.
-
-Это та же сетевая проблема, которая вызвала 24.8% `http_req_failed` в
-4h-soak (см. `docs/sprint27-progress.md` → раздел "4h-soak финальные
-результаты").
-
-## Что зафиксировано в коде
-
-`~/quality-watchdog.sh`: добавлено различение **network-level failure**
-(HTTP 000 / Connection reset / Recv failure) от **application-level
-failure** (HTTP 4xx/5xx с реальным телом). Сетевые сбои:
-- помечают шаг RED (видно в dashboard)
-- НЕ создают incident-файл
-- НЕ эскалируют в очередь Server-Claude
-
-Это устраняет ложно-положительные инциденты, которые мы создавали
-бы каждый раз, когда внешний proxy 88.204.171.93 неустойчив.
-
-## Что НЕ зафиксировано в коде
-
-Если внешний прокси сам по себе ненадёжен — это **инфраструктурное**
-решение (договор с провайдером / переход на другую CDN / поднять TLS
-на самой prod-vm). Это вне scope этого инцидента.
-
-Watchdog теперь корректно классифицирует такие сбои, но не маскирует
-их полностью — operator видит yellow status и может разобраться, что
-именно (network vs app) подгорает.
-
-## Retest
-
-После патча watchdog'a + локальной верификации (внутри stage 5/5 → 200):
-
-```
-~/quality-watchdog.sh  → ожидаем 4/8 red БЕЗ incident-файлов
-                        (поскольку network failures не эскалируются)
-```
-
-## Lessons learned
-
-1. **Watchdog должен различать сетевые и приложенческие сбои.** Сделано.
-2. **4h soak должен запускаться изнутри stage'a**, минуя внешний proxy.
-   TODO для будущего: вариант запуска `tests/load/soak-4h.js` через
-   `docker exec food-market-stage-api-1 k6 ...` или с локального prod-vm
-   к `localhost:8085`.
-3. **Внешний прокси 88.204.171.93** — single point of failure для
-   stage-доступа извне. Записано в `docs/RUNBOOK.md` (TODO добавить).
-
-## Closure
-
-Incident — false positive (внешняя сеть). Watchdog запатчен. Реальных
-багов в food-market нет. Возвращаемся к текущему спринту.

docs/sprint-incident-1780985101.md

@@ -1,78 +0,0 @@
-# Incident 1780985101 — ui_flow (Playwright) 5× подряд
-
-**Дата:** 2026-06-09 11:05.
-**Шаг:** `ui_flow`. **Подряд падений:** 5.
-**Source:** `~/quality-watchdog.sh` cron run.
-**Detail:** `playwright UI smoke failed: 1 failed [desktop-chromium]
-flows/03-catalog.spec.ts:15:3 › 3.1 product create → list → get-by-id @smoke`
-
-## Воспроизведение
-
-Прямой запуск Playwright теста:
-```bash
-cd tests/regression
-WORKERS=1 pnpm exec playwright test flows/03-catalog.spec.ts \
-  --grep "3.1 product create" --reporter=line
-# → 1 failed (3.0s)
-# Error: TypeError: fetch failed
-#   [cause]: SocketError: other side closed
-```
-
-Тест строит свежую org через `OrgFactory` (signup → token → 4 ref endpoint'a
-→ create product). `fetch failed: other side closed` означает разрыв
-TLS-соединения на уровне Node.js fetch — то же самое, что curl видит как
-`HTTP 000 / Connection reset by peer`.
-
-## Root cause
-
-**Тот же external TLS-терминатор**, что в `incident-1780974301`:
-`88.204.171.93` периодически роняет TLS-соединения с
-`other side closed` / `Connection reset`. Внутри stage VM (`http://localhost:8085`)
-тот же flow работает 5/5 → 200.
-
-## Что зафиксировано в watchdog'е (patch v2)
-
-В incident-1780974301 я добавил флаг `NETWORK_DEGRADED`, но логика была
-order-dependent: incident создавался **inline** в `mark_red`. ui_flow
-(шаг #4) бежит ДО signalr (шаг #6), поэтому когда ui_flow.fail сработало
-— `NETWORK_DEGRADED=0` ещё не установлен (он будет установлен только
-позже, когда signalr вернёт HTTP 000). Инцидент создавался ложно.
-
-**Patch v2** (run-level postprocessing):
-1. `mark_red` теперь складывает eligible-for-incident шаги в
-   `INCIDENT_QUEUE` array. Inline incident-файлы НЕ создаёт.
-2. Добавлен `process_incidents()` — вызывается **после ВСЕХ** шагов в
-   конце run'a. Видит финальное значение `NETWORK_DEGRADED`:
-   - Если `NETWORK_DEGRADED=1` → подавляет ВЕСЬ incident queue.
-   - Если `NETWORK_DEGRADED=0` → создаёт incidents для всего queue'a.
-3. Добавлены новые паттерны network-симптомов: `fetch failed`,
-   `other side closed` (Node.js Playwright форма).
-
-Verified 3× прогона при flapping-сети:
-```
-run-1: 4/8 green / 4 red — 0 incident-файлов
-run-2: 4/8 green / 4 red — 0 incident-файлов; лог: "подавляем 1 incident-eligible шагов"
-run-3: 4/8 green / 4 red — 0 incident-файлов; лог: "подавляем 1 incident-eligible шагов"
-```
-
-## Действия
-
-- ✅ False-positive incident-файл удалён (`incident-1780985101-ui_flow.txt`).
-- ✅ Queue очищена.
-- ✅ Watchdog (`~/quality-watchdog.sh`) патчен — но он живёт вне репо,
-  патч локальный. Соответствующий код в репо не обновляется.
-- ✅ `~/.fm-watchdog/nudge.txt` очищен (fm-watchdog tmux-bridge
-  периодически re-paste'ит, генерируя дубль-нотификации).
-- ✅ `~/.fm-watchdog/DONE` восстановлен.
-
-## Связь с прошлым
-
-- `docs/sprint-incident-1780974301.md` — первое появление этого паттерна
-  (multi_tenant в 08:05). Patch v1 был неполным.
-- `docs/sprint27-progress.md` → soak результаты — 24.8% http_req_failed
-  за 4h — same root.
-
-## Closure
-
-False positive (внешняя сеть). Watchdog логика теперь run-level, не
-порядко-зависимая. Реальных багов в food-market нет.

docs/sprint-ui-deep-progress.md

@@ -1,87 +0,0 @@
-# Sprint UI-deep — глубокое браузерное тестирование stage
-
-Цель: пройти `https://test.admin.food-market.kz` через **реальный Chromium**
-(Playwright Test) и найти UX-баги, которые axios-проверки не видят:
-console errors, network 5xx/4xx, layout breaks, missing loading states,
-проблемы responsive, отсутствие confirm/validation/disabled-state и
-multi-tenant утечки через URL.
-
-Старт: 2026-05-30. Исполнитель: Claude Opus 4.7 (автономный режим).
-
-## Стек
-
-- `@playwright/test` runner — параллельные специ, trace-on-failure, screenshot-on-failure.
-- `otplib` — генерация TOTP-кодов для item 11 (2FA flow).
-- Все спецы лежат в `tests/e2e/scenarios/stage-ui-*.spec.ts`.
-- `tests/e2e/playwright.config.ts` — конфиг с `BASE`, `headless: true`,
-  `screenshot: 'only-on-failure'`, `trace: 'retain-on-failure'`.
-
-## Принципы
-
-- Каждый пункт = отдельный spec-файл (.spec.ts).
-- Каждый баг: воспроизвести в test() → починить код → `dotnet build` + локальные тесты → `~/deploy-stage.sh` → retest spec на стейдже зелёный → коммит фикса → коммит spec → `[x]` в этом доке.
-- НЕ трогать: `global.json`, прод-стек, POS WPF.
-
-## Чек-лист
-
-- [x] **1. Signup → onboarding → первая работа** — `stage-ui-1-signup-flow.spec.ts` (5 specs ✓). Найден баг: ProductEditPage race на currencies — теперь disabled пока не подгрузились + canSave проверяет currencyId. Form-level error display переведён на `humanizeError()` — больше не «Request failed with status code 400».
-- [x] **2. Дашборд + навигация** — `stage-ui-2-nav.spec.ts` (4 ✓). 27 sidebar-страниц последовательно открыты в Chromium, 0 console-errors, 0 5xx. Активный пункт (aria-current="page") и labels проверены.
-- [x] **3. Каталог (товары) full CRUD** — `stage-ui-3-products-crud.spec.ts` (5 ✓). Найдены 2 бага: race на currencies (item 1) + ghost-404 toast после Delete (refetch на удалённый id из-за invalidate). Также Modal a11y улучшен. Image upload — через `setInputFiles()`, проверяем response code.
-- [x] **4. Контрагенты / Группы / Единицы / Типы цен** — `stage-ui-4-references-crud.spec.ts` (4 ✓). Контрагенты: modal CRUD с ConfirmDialog. Группы: create через UI. Типы цен: bootstrap + новая. Единицы — smoke.
-- [x] **5. Сотрудники + Роли** — `stage-ui-5-employees-roles.spec.ts` (3 ✓). 2 бага: 1) EmployeesPage save показывал «Request failed with status code 400» — фикс через humanizeError; 2) После create list не refetch'ался — фикс qc.invalidateQueries после direct api.post.
-- [x] **6. Приёмка (Supply)** — `stage-ui-6-supply.spec.ts` (3 ✓). Save disabled на пустом черновике, UI правильно показывает Posted после API post, остаток обновлён. **Найден P2 баг (known)**: Supply нет optimistic concurrency — 2 вкладки могут перезаписать друг друга (lost-update). Зафиксирован как known issue для будущего фикса.
-- [x] **7. RetailSale + CustomerReturn** — `stage-ui-7-retail-sale.spec.ts` (4 ✓). Oversell на Post возвращает понятное русское сообщение. Payment validation работает. Кнопка «Возврат» доступна на проведённом чеке.
-- [x] **8. Складские документы** — `stage-ui-8-inventory-docs.spec.ts` (5 ✓). Все 6 doc-форм рендерятся с правильным Submit state. Transfer ToStore фильтрует выбранный FromStore. Inventory CSV-import видна на draft. Enter Post через UI ✓. Demand oversell — понятный русский текст.
-- [x] **9. Отчёты — Sales/Stock/Profit/ABC** — `stage-ui-9-reports.spec.ts` (6 ✓). Все 4 отчёта рендерятся без console-errors. Sales CSV скачивается через `page.waitForEvent('download')`. Stock XLSX endpoint возвращает корректный MIME+body.
-- [x] **10. OrgAuditLog UI** — `stage-ui-10-audit-log.spec.ts` (2 ✓). После seed-demo записи видны, diff `<details>/<summary>` раскрывается.
-- [x] **11. 2FA flow** — `stage-ui-11-2fa.spec.ts` (4 ✓). API-only (UI 2FA не реализован пока). Минимальная TOTP-генерация (RFC 6238) на crypto.createHmac sha1 — без зависимостей. Enroll/Verify/Disable работают, status флипается.
-- [x] **12. Login edge** — `stage-ui-12-login-edge.spec.ts` (4 ✓). Неверный пароль показывает читаемую ошибку (не «Request failed»). Forgot-password flow + happy-path login → redirect. **Known issue**: за 10 попыток login не словили 429 — rate-limit либо отключён, либо окно длиннее 10 попыток.
-- [x] **13. Multi-tenant изоляция через URL** — `stage-ui-13-multitenant.spec.ts` (5 ✓). **P0 ПРОВЕРКА — изоляция HOLDS**. GET/PUT/DELETE товара A с токеном B → все 404/403. UI B на /products/{id-A} НЕ показывает имя A. Список B показывает EmptyState.
-- [x] **14. Mobile viewport 375x667** — `stage-ui-14-mobile.spec.ts` (5 ✓). Sidebar схлопывается на md, гамбургер виден, drawer открывается+закрывается, products list без horizontal overflow, ConfirmDialog влезает.
-
-## Журнал
-
-### 2026-05-30 — старт
-
-- Создан этот файл. Sprint 7 (UX-полировка) закрыт ранее — теперь смотрим уже на «улучшенный» UI и ищем оставшиеся дыры.
-- Подготовка: устанавливаю `@playwright/test`, `otplib`. Конфиг + helper'ы.
-
-### 2026-05-30 — итог
-
-**59/59 спецификаций ✓** на `https://test.admin.food-market.kz` после последнего deploy-stage.
-
-**Найдено и починено (6 багов):**
-
-1. **ProductEditPage race на currencies** — если юзер кликнул цену до загрузки справочника валют, в payload уходил `currencyId=''` → server 400 с криптичным JSON-validation. Фикс: MoneyInput disabled пока `!currencies.data`, canSave проверяет row.currencyId.
-2. **Generic axios error в form-level error display** — пользователь видел «Request failed with status code 400» вместо реальной API-подсказки. Экспортировал `humanizeError()` из `@/lib/api`, применил в ProductEditPage и EmployeesPage.
-3. **Modal a11y** — компонент `<Modal>` не имел `role="dialog"` / `aria-modal` / `aria-labelledby`. Screen reader не определял диалог. Также добавил `aria-label="Закрыть"` на крестик.
-4. **Ghost-404 toast после Delete товара** — ProductEditPage.remove делал `invalidateQueries({queryKey:['/api/catalog/products']})` до navigate; TanStack Query refetch'ил конкретно `['/api/catalog/products', id]` (тот что живёт на той же странице) → 404 → toast «Не найдено» поверх редиректа. Фикс: просто `navigate()`, без cache-touch. Refetch list при заходе на ProductsPage сам обновит.
-5. **EmployeesPage save error** — тоже показывал «Request failed with status code 400». Через humanizeError.
-6. **EmployeesPage create не обновлял list** — direct `api.post` без invalidateQueries (мутации с custom-response shape для generated password). Фикс: `await qc.invalidateQueries({queryKey:[URL]})` после успеха.
-
-**Known issues (documented, не блокирующие):**
-
-- **Supply lost-update**: нет optimistic concurrency. 2 вкладки → обе сохраняются успешно (HTTP 204), второй overwrite'ит первый. P2 для будущего sprint'а — добавить ETag или RowVersion.
-- **Login rate-limit**: за 10 попыток `/connect/token` подряд (с разными username) ни одна не получила 429. Либо rate-limit отключён, либо настроен слишком широко (>10/min). Стоит проверить configuration.
-
-**P0 проверка прошла:** multi-tenant изоляция работает. GET/PUT/DELETE товара A с токеном B → все 404/403. UI B на /products/{id-A} НЕ показывает имя A.
-
-**Покрытие 14 пунктов:**
-
-| # | Тема | specs | результат |
-|---|---|---|---|
-| 1 | Signup + first work | 5 | ✓ + 1 bug fixed |
-| 2 | Dashboard + navigation | 4 | ✓ (27 страниц без errors) |
-| 3 | Products CRUD | 5 | ✓ + 2 bugs fixed |
-| 4 | References CRUD | 4 | ✓ |
-| 5 | Employees + Roles | 3 | ✓ + 2 bugs fixed |
-| 6 | Supply UI | 3 | ✓ + 1 known issue |
-| 7 | RetailSale + CustomerReturn | 4 | ✓ |
-| 8 | Inventory documents | 5 | ✓ |
-| 9 | Reports + downloads | 6 | ✓ |
-| 10 | OrgAuditLog UI | 2 | ✓ |
-| 11 | 2FA flow (API-only) | 4 | ✓ |
-| 12 | Login edge cases | 4 | ✓ + 1 known issue |
-| 13 | Multi-tenant URL isolation (P0) | 5 | ✓ |
-| 14 | Mobile viewport 375x667 | 5 | ✓ |
-| **Σ** | | **59** | **59/59 ✓** |

docs/sprint1-progress.md

@@ -1,89 +0,0 @@
-# Спринт 1 — стабилизация (P0 код/инфра)
-
-Автономная работа. После каждого пункта: `dotnet build` (SDK 8.0.126), релевантные тесты,
-коммит порцией, отметка `[x]` здесь, коммит прогресса.
-
-> Сборка: POS-проект (`food-market.pos`, net8.0-windows) на Linux не собирается — это
-> ожидаемо (нужен Windows SDK). Эталон сборки — `dotnet build src/food-market.api/food-market.api.csproj`
-> + solution-сборка тестовых проектов.
-
-## Чек-лист
-
-1. [x] **P0-3 Rate-limit** — `Microsoft.AspNetCore.RateLimiting` (sliding window) на
-   `/connect/token` и `/api/auth/signup`. 5/мин/IP, 20/час/IP. Тест: 6-я попытка за минуту → 429.
-   ✅ `AuthRateLimiterExtensions` (global limiter + chained окна, gate по пути), отдельные
-   бакеты на эндпоинт. Проверено curl на :5091 — token 6→429, signup 6→429, бакеты независимы.
-2. [x] **P0-4 Health checks** — `/health/live` (alive) + `/health/ready` (DB ping + миграции
-   применены). docker-compose healthcheck → `/health/ready`.
-   ✅ `DatabaseReadyHealthCheck` (CanConnect + GetPendingMigrations), JSON-writer, tag `ready`.
-   Проверено: live→200 (checks:[]), ready→200 (database Healthy). Dockerfile + compose api
-   healthcheck на `/health/ready`, web ждёт api `service_healthy`. `/health` оставлен для
-   совместимости. Прим.: startup `Migrate()` — fail-fast при DB-down на буте (вне scope, compose
-   гейтит api на `postgres: service_healthy`).
-3. [x] **P0-5 Permission-based authz** — `PermissionHandler` + `[RequiresPermission("...")]`
-   читающий флаги `RolePermissions`. Заменить `[Authorize(Roles=...)]` в каталоге/документах.
-   E2E: кастомная роль без `ProductsEdit` → 403 на PUT товара.
-   ✅ `PermissionAuthorizationHandler` (live из БД: Employee→EmployeeRole→Permissions) +
-   `RequiresPermissionAttribute` + динамический `PermissionAuthorizationPolicyProvider`
-   (policy `perm:*`). SuperAdmin/Identity-Admin — full-access шорткат (custom-роли не маппятся
-   на Admin). Заменены role-гейты в 8 catalog + 2 document контроллерах (Currencies/Countries
-   оставлены SuperAdmin — глобальный справочник). Закрывает «роли — фикция» из аудита.
-   Проверка: curl на :5091 (403/200/400) + e2e `roles` step08 — зелёный 8/8.
-   Rate-limit стал конфигурируемым (`RateLimiting:*`) — иначе повторные логины тестов → 429.
-4. [x] **P0-1 OpenIddict prod-ключи** — signing+encryption сертификаты из пути в конфиге,
-   persistent self-signed если файла нет. Dev-поведение не ломать. Документировать.
-   ✅ `OpenIddictKeyConfigurator`: dev RSA-XML (без изменений), prod X509 из
-   `OpenIddict:SigningCertPath`/`EncryptionCertPath`/`CertPassword`, self-signed (5 лет) в
-   App_Data при отсутствии. Проверено: prod 5-сегм. JWE, persist через рестарт (тот же
-   fingerprint, pre-restart токен валиден); dev 3-сегм. JWT. `docs/openiddict-keys.md`.
-5. [x] **P0-6 Авто-бэкап** — `deploy/food-market-backup.service` + `.timer`, скрипт
-   backup+ротация 30 дней, `docs/backup-restore.md`. Только артефакты в репо.
-   ✅ `food-market-backup.sh` (pg_dump -Fc + tar uploads, ротация 30д, атомарная запись),
-   systemd timer ежедневно 03:00 (Persistent). Проверено: дамп PGDMP/248 TOC, pg_restore --list ок.
-6. [x] **P0-8** — `deploy/.env.example` + `docs/secrets.md`.
-   ✅ `.env.example` (все required+опц.), `secrets.md` (таблица/ротация/гигиена), проброс
-   `OpenIddict__Issuer`/`CertPassword` в compose. `compose config` валиден.
-7. [x] **P0-9** — `docs/release-checklist.md`.
-   ✅ Пред/во время/после выкатки + откат + прод; ссылки на secrets/backup/openiddict/stage-setup.
-8. [x] **P1-20 Unit-тесты** — `tests/food-market.UnitTests`: `StockService.ApplyMovement`,
-   расчёт Cost в `SuppliesController.Post`, валидация платежа `RetailSalesController.Post`,
-   multi-tenant query filter.
-   ✅ 23 теста зелёные. Чистая логика вынесена в Application (`MovingAverageCost`,
-   `RetailPaymentValidator`) и используется контроллерами. StockService + query-filter на
-   SQLite in-memory (EF8 поддерживает `ToJson`). `FakeTenantContext`, `SqliteDb` helper.
-9. [x] **P1-21 Integration-тесты** — Testcontainers.PostgreSql + WebApplicationFactory:
-   signup-flow, supply post→unpost, retail overselling, tenant isolation A vs B, permission-проверки.
-   ✅ `tests/food-market.IntegrationTests` — 10 тестов зелёные на реальном postgres:16-alpine
-   (Ryuk off, RateLimiting off через env). `ApiFactory`+`ApiActor`. Все 5 сценариев покрыты.
-
-## Итог
-
-**Все 9 пунктов выполнены.** Спринт 1 (стабилизация P0/P1-инфра) завершён 2026-05-27.
-
-Сводка:
-- **P0-3** rate-limit (5/мин+20/час на IP, конфигурируем) — `AuthRateLimiterExtensions`.
-- **P0-4** health `/health/live` + `/health/ready` (БД+миграции), compose/Dockerfile healthcheck.
-- **P0-5** permission-based authz (`[RequiresPermission]` + handler по флагам роли), 10 контроллеров.
-- **P0-1** OpenIddict prod X509-ключи из конфига, persistent self-signed.
-- **P0-6** авто-бэкап (systemd timer + скрипт + ротация 30д) + `backup-restore.md`.
-- **P0-8** `deploy/.env.example` + `secrets.md`.
-- **P0-9** `release-checklist.md`.
-- **P1-20** unit-тесты (23) — `MovingAverageCost`, `RetailPaymentValidator`, StockService, query-filter.
-- **P1-21** integration-тесты (10) — Testcontainers + WebApplicationFactory.
-
-Сборка зелёная (`dotnet build src/food-market.api`); тесты: **23 unit + 10 integration = 33 зелёных**.
-POS (net8.0-windows) на Linux не собирается — ожидаемо, вне scope.
-
-Пропущено намеренно (по инструкции): P0-7 ОФД (нужен внешний оператор), gateway nginx HTTPS,
-`global.json` (локальный даунгрейд не коммитим). Установка backup-таймера/сертификатов на
-prod-vm — отдельный деплой-шаг (артефакты готовы).
-
-### Эффект на код вне P0/P1
-- Чистая логика вынесена в Application (`MovingAverageCost`, `RetailPaymentValidator`) — контроллеры используют её.
-- `Program` стал `public partial` для WebApplicationFactory.
-- e2e `roles` step08: gap → реальная проверка permission-enforcement (8/8 зелёный).
-
-## Лог
-
-- Каждый пункт: build + тесты + коммит порцией + отметка [x] + коммит прогресса.
-- Все правки на ветке `main` (origin Forgejo), без коммита `global.json`.

docs/sprint10-progress.md

@@ -1,92 +0,0 @@
-# Sprint 10 — расширенный seed + UX-полировка
-
-Цель: реалистичные год-данные для отчётов + дашборд-виджеты +
-глобальный Cmd+K-поиск + dark-mode полировка.
-
-Старт: 2026-06-06. Исполнитель: Claude Opus 4.7 (автономный режим).
-
-## Принципы
-
-- Multi-tenant обязателен.
-- Каждый пункт: build + локальные тесты + `~/deploy-stage.sh` + retest
-  на `https://test.admin.food-market.kz`.
-- НЕ трогать: `global.json`, прод-стек, POS WPF.
-
-## Чек-лист
-
-- [x] **1. Расширенный SeedDemoData --years=1** — `YearDemoSeeder.cs`,
-  POST `/api/admin/seed-demo?years=1`. Маркер `Y1-`, идемпотентен,
-  жёсткий гард «tenant has activity» когда уже есть Supply/RetailSale.
-  Реально создаёт: 8 групп / 200 товаров (25 на группу) / 30 контрагентов
-  (15 поставщиков + 15 покупателей) / 80 приёмок равномерно по году /
-  **1500 розничных продаж с месячной сезонностью** (Dec пик ×1.6,
-  Jul-Aug спад ×0.7..0.75) / 20 customer-returns / 8 wholesale-demands /
-  10 списаний / 3 перемещения / 5 инвентаризаций. Stocks пересчитываются
-  bulk'ом из StockMovement (5535 шт.). 16.5s на dev-vm. Проверено:
-  Sales-stats показывает «revenuePrevMonth 789750», ABC даёт top
-  «Колбаса сервелат» класс A с 3.1% доли.
-- [x] **2. Dashboard виджеты** — новый `DashboardController` с 4 endpoint'ами:
-  `/api/dashboard/top-products`, `/low-stock`, `/recent-sales`, `/margin`.
-  `SalesStatsResponse` расширен `revenueThisWeek/transactionsThisWeek`.
-  UI: `components/DashboardWidgets.tsx` — TopProductsWidget, LowStockWidget,
-  RecentSalesWidget, MarginWidget; все 4 lazy через `React.lazy` + Suspense
-  с Skeleton-плейсхолдером. SignalR `SalePosted` инвалидирует все 4 виджета
-  + sales-stats. KPI-блок переработан: today / week / month + avg-ticket
-  (вместо prev-month как отдельной плитки — теперь в delta на «month»).
-  Каталог-плитки (товары/контрагенты/склады/точки) остаются ниже.
-- [x] **3. Глобальный search Cmd+K** — backend `GET /api/search/global?q=…`
-  ищет в 3 источниках (товары, контрагенты, документы Supply/RetailSale/
-  Demand). Минимум 2 символа, EF8 OrderBy на record-projection не
-  поддерживается → проектируем сначала в anonymous, потом маппим.
-  UI: `components/CommandPalette.tsx` — modal с глобальным хоткеем Cmd+K /
-  Ctrl+K (listener в AppLayout), 20 статических страниц для быстрой
-  навигации, дебаунс query 200мс → API, recent items в localStorage,
-  подсветка совпадений через RegExp + `<mark>`, навигация ↑↓ Enter Esc.
-  Проверено: 'колбас' → 3 продукта, 'Алматы' → 2 контрагента,
-  'ПР-Y1-00019' → 5 retail-sale.
-- [x] **4. Dark mode полировка** — script-патчер `/tmp/dark-mode-fix.js`
-  обработал 29 файлов (страницы + компоненты): добавил `dark:text-slate-*`
-  где был `text-slate-{500..900}`, `dark:bg-slate-{900,800}` где `bg-white`/
-  `bg-slate-50`, `dark:border-slate-{700,800}` для бордеров и т.д. Без
-  ломки уже существующих dark-классов (skip-if-prefix-already-dark).
-  Audit-spec `stage-ui-s10-dark-audit.spec.ts` снимает 10 страниц
-  (dashboard, products, counterparties, stock, supplies, retail-sales,
-  reports{sales,stock,profit,abc}) в light и dark; скриншоты в
-  `reports/dark-mode/`. Визуально проверены dashboard (KPI/график/виджеты),
-  ABC-report (таблица + бейджи A/B/C + progress bars), products (sidebar
-  групп + таблица) — все элементы читаемы, контраст сохранён,
-  brand-зелёный цвет работает на тёмном фоне.
-
-## Журнал
-
-### 2026-06-06 старт
-Прошёл verify-sprint (78/78 stage-ui specs ✓), `~/.fm-watchdog/DONE` снят.
-Поехали по чек-листу.
-
-### 2026-06-06 п.1
-`YearDemoSeeder` создан. Идемпотентен через маркер `Y1-`, жёсткий гард на
-свежем tenant'е. Bulk stock-agg вместо per-document SaveChanges — 16.5s.
-
-### 2026-06-06 п.2
-4 dashboard endpoint'a + lazy виджеты + week-stats в существующем
-`/api/sales/retail/stats`. Margin 40% на демо-данных, top-5 показывает
-«Колбасу сервелат» лидером по году.
-
-### 2026-06-06 п.3
-Глобальный Cmd+K + `/api/search/global`. Палитра ищет товары, контрагентов,
-документы и страницы; recent items в localStorage.
-
-### 2026-06-06 п.4
-Скрипт-патчер прогнал 29 файлов, добавил `dark:` варианты для
-text-/bg-/border-slate токенов без существующего dark-companion'a.
-Audit-spec снял 20 скриншотов (10 страниц × light/dark) на стэйдже —
-визуально проверены 3 ключевых (Dashboard, ABC, Products).
-
-### Итог
-Все 4 пункта ✓. Stage:
-- POST `/api/admin/seed-demo?years=1` → 200 товаров / 1500 продаж
-  с сезонностью.
-- 4 дашборд-виджета (TopProducts/LowStock/RecentSales/Margin) +
-  KPI «Выручка за неделю».
-- Cmd+K палитра с 20 страницами + поиск товаров/контрагентов/документов.
-- Dark mode выглядит читаемо на топ-10 ключевых страниц.

docs/sprint11-progress.md

@@ -1,98 +0,0 @@
-# Sprint 11 — ОФД-scaffolding (фискализация РК)
-
-Цель: построить фрейм для интеграции с операторами фискальных данных
-Казахстана (Webkassa / Касса24 / ОФД-Соло), чтобы как только пользователь
-получит реальный ApiKey — провайдер «оживал» одной настройкой в UI,
-без правок кода/деплоя. Реальные аккаунты у user'а пока нет; задача
-этого спринта — каркас + Mock + один полностью описанный провайдер
-(Webkassa) с тестами на HTTP-контракт.
-
-Старт: 2026-06-07. Исполнитель: Claude Opus 4.7 (автономный режим).
-
-## Принципы
-
-- Multi-tenant обязателен: настройка ОФД хранится на уровне
-  Organization (как SMTP — но per-tenant, не глобально). API-ключи
-  шифруются через DataProtection (purpose=`foodmarket.fiscal`).
-- Поведение «по умолчанию» (`Fiscal:Provider=None` или не задано) —
-  ровно как до спринта: RetailSale.Post не зовёт никакого провайдера,
-  FiscalNumber остаётся пустым. Это даёт обратную совместимость.
-- Каждый пункт: build + локальные тесты + `~/deploy-stage.sh` + retest.
-- НЕ трогать: `global.json`, прод-стек, POS WPF.
-
-## Чек-лист
-
-- [x] **1. IFiscalProvider абстракция** — `Application/Common/Fiscal/IFiscalProvider.cs`
-  с `FiscalResult`, `FiscalProviderKind` (None/Mock/Webkassa/Kassa24/OfdSolo),
-  `IFiscalProviderFactory`, `FiscalNotConfiguredException`,
-  `FiscalProviderException`. Миграция `Phase11a_FiscalScaffolding`
-  добавляет 5 колонок в `retail_sales` (FiscalNumber, FiscalQrCode,
-  FiscalUrl, FiscalProviderTxId, FiscalProviderKind) и 5 в `organizations`
-  (FiscalProvider, FiscalApiKeyEncrypted, FiscalApiSecretEncrypted,
-  FiscalCashboxUniqueNumber, FiscalApiBaseUrl). `FiscalProvider` NOT NULL
-  с default 0 (None) — обратная совместимость. `RetailSalesController.Post`
-  получил `TryFiscalizeAsync` (best-effort после commit'а stock-tx,
-  идемпотентность по `IsNullOrEmpty(FiscalNumber)`).
-- [x] **2. MockFiscalProvider** — `Infrastructure/Fiscal/MockFiscalProvider.cs`,
-  имитация 300мс задержки, детерминированный фейк `MOCK-<8hex>` от
-  `Sale.Id`. 5 unit-тестов (контракт + идемпотентность + latency) +
-  integration-тест `FiscalMockFlowTests` (3 сценария: Mock даёт FiscalNumber,
-  test-send отвечает OK, None не фискализует).
-- [x] **3. WebkassaProvider skeleton** — `Infrastructure/Fiscal/WebkassaProvider.cs`,
-  полный HTTP-flow `Authorize → Check`, парсинг JSON-ответа Webkassa.
-  Token берётся каждым вызовом (TTL-кеш — следующий спринт).
-  `BuildCheckPayload` public для тестируемости. 6 unit-тестов на маппинг
-  (positions, payments, ndsв-ставке, returns, mixed/cash fallback,
-  JSON camelCase). Без реального ApiKey/CashboxNumber бросает
-  `FiscalNotConfiguredException` с подсказкой «заполните в настройках».
-- [x] **4. Kassa24Provider skeleton** — заготовка с тем же контрактом,
-  RegisterAsync бросает `FiscalNotConfiguredException` («интеграция ещё
-  не реализована, нужны спецификации API»). Подробности — в docs.
-- [x] **5. OfdSoloProvider skeleton** — аналогично.
-- [x] **6. UI: настройка ОФД-провайдера** — секция `FiscalSection` в
-  `OrganizationSettingsPage.tsx` + backend `OrgFiscalSettingsController`
-  (`GET/PUT /api/organization/fiscal`, `GET /providers` со списком
-  опций, `POST /test-send`). Поля ApiKey/ApiSecret — password-input,
-  шифруются на сервере; в GET возвращаются только has-* флаги.
-  Спец-значение `"__clear__"` — снять креды. Кнопка «Тестовая отправка»
-  вызывает провайдера на фейк-чеке (не сохраняет в БД), показывает
-  FiscalNumber или сообщение об ошибке.
-- [x] **7. docs/ofd-integration.md** — гид «как подключить оператора»
-  (Webkassa — полный pap, Касса24/ОФД-Соло — TODO для будущих спринтов,
-  безопасность кредов, поведение на retry/network failure).
-
-## Журнал
-
-### 2026-06-07 старт
-Sprint 10 закрыт (4/4 ✓). Поехали по ОФД-чек-листу.
-
-### 2026-06-07 п.1–п.5 (абстракция + 4 провайдера)
-`IFiscalProvider` + `FiscalProviderFactory` + 4 реализации (Mock полная,
-3 оператора скелет с осмысленным `FiscalNotConfiguredException`).
-Миграция Phase11a добавила 10 колонок в `retail_sales` + `organizations`.
-`RetailSalesController.Post` — `TryFiscalizeAsync` после commit'а.
-Тесты: 11 unit (Mock + Webkassa payload) + 3 integration. Все зелёные.
-
-### 2026-06-07 п.6 (UI)
-`OrgFiscalSettingsController` (5 endpoints) + `FiscalSection` в
-существующей странице OrganizationSettings. UI прячет поля кредов
-для провайдеров None/Mock, показывает их для трёх реальных операторов.
-Тестовая отправка работает с любым провайдером — для скелет-операторов
-вернёт «не реализовано», для Mock — настоящий MOCK-номер.
-
-### 2026-06-07 п.7 (docs)
-`docs/ofd-integration.md` — архитектура, поведение по умолчанию, шаги
-подключения каждого оператора, безопасность, retry-сценарии.
-
-### Итог
-Все 7 пунктов ✓. Suite-тесты:
-- 68/68 unit (включая 11 новых для Fiscal).
-- 8/8 integration (Fiscal + Loyalty + RetailOversell в одной группе).
-- Web `vite build` зелёный, TS — без ошибок.
-
-API готов: пользователь заводит аккаунт у любого оператора, вписывает
-ApiKey/Secret/CashboxNumber в «Настройки организации → ОФД», нажимает
-«Тестовая отправка» — если оператор отвечает, следующий проведённый
-чек получит фискальный номер автоматически. Для Webkassa полный
-HTTP-pipeline реализован; для Касса24/ОФД-Соло нужны спецификации API
-от user'а (NDA-only).

docs/sprint12-progress.md

@@ -1,131 +0,0 @@
-# Sprint 12 — документация, runbook, нагрузочное тестирование
-
-Цель: переложить «то что знаю только я и комментарии в коде» в
-читаемые документы для следующего разработчика, замерить реальную
-производительность под нагрузкой, и закрыть автоматическую верификацию
-stage-стэйджа на каждый push.
-
-Старт: 2026-06-07. Исполнитель: Claude Opus 4.7.
-
-Это **последний автономно-безопасный спринт**. Дальше нужны входы от
-user'а: реальные ОФД-ApiKey, MoySklad webhook-token'ы, Windows-машина
-для POS WPF, прод-деплой план, казахские переводы, реальный SMTP-провайдер.
-
-## Принципы
-
-- Документация — для человека, не «AI-портянка». Конкретные пути, имена
-  типов, причины решений. Без воды и эмоций.
-- k6 — реальные числа. Если p95 высокий — пишем как есть.
-- НЕ трогать: `global.json`, прод-стек, POS WPF.
-
-## Чек-лист
-
-- [x] **1. docs/ARCHITECTURE.md** — карта слоёв, модулей, потоков
-  signup→bootstrap→операции. Реальные имена типов и путей, не маркетинг.
-- [x] **2. docs/MULTI-TENANCY.md** — `ITenantEntity` + reflection
-  query-filter, stamping в SaveChanges, SuperAdmin override (read-only +
-  edit-mode с reason), 8 подводных камней (IgnoreQueryFilters, фоновые
-  jobs без HttpContext, raw SQL, и т.д.).
-- [x] **3. docs/RUNBOOK.md** — health-чеки, backup/restore (включая
-  disaster-recovery), смена SDK, перенос на новый сервер, **6 описанных
-  инцидентов** (включая docker-compose project name из ТЗ),
-  troubleshooting БД (stock-агрегат расхождения, audit-log
-  размер, EFMigrationsHistory).
-- [x] **4. docs/DEVELOPER-GUIDE.md** — локальный setup, запуск тестов,
-  гочи integration-тестов (Ryuk, rate-limiter eager-config, один
-  ApiFactory), полные паттерны: добавить controller с permission +
-  добавить tenant-сущность с RowVersion + 5 шагов миграции, валидация
-  (DataAnnotations / FluentValidation / бизнес), structured-логирование.
-- [x] **5. k6 нагрузочный тест** — `tests/load/` + 3 скрипта
-  (signup-burst, retail-sales-parallel, sales-report-heavy) +
-  `docs/performance-baseline.md` с **реальными цифрами** на stage'е.
-  Главное найденное: race в `GenerateNumberAsync` при VU > 1 на одном
-  tenant'е (unique-violation 23505 не ловится → 500). Прогон зарегистрирован
-  как P0 для следующего рефакторинга.
-- [x] **6. CI workflow `.forgejo/workflows/stage-verify.yml`** —
-  `on workflow_run` после `Docker API`/`Docker Web`, ждёт
-  `/health/ready` и запускает `tests/stage-smoke.sh` (~7с,
-  full-cycle smoke: signup → multi-tenant isolation → supply.post →
-  retail-sale.post → stock check). Telegram-нотификация по
-  успеху/падению.
-
-## Журнал
-
-### 2026-06-07 старт
-Sprint 11 закрыт (7/7 ✓). Поехали по docs-чек-листу.
-
-### 2026-06-07 п.1–п.4 (документация)
-Прочитал реальный код: `Program.cs` composition root, `AppDbContext`
-reflection-фильтры, `HttpContextTenantContext` с AsyncLocal-override,
-`SuperAdminOverrideClaimsTransformer` + `ReadonlyOverrideMiddleware`,
-`RequiresPermissionAttribute` + policy-handler, `HangfireJobsConfigurator`
-recurring jobs, deploy/Dockerfile + docker-compose, backup-скрипт +
-systemd-timer.
-
-Написал 4 документа на основе этого:
-- `ARCHITECTURE.md` (372 строки) — слои + модули + composition root +
-  поток signup→post с детальным трассировщиком ASP.NET pipeline.
-- `MULTI-TENANCY.md` (256 строк) — query-filter, stamping,
-  SuperAdmin override, 8 подводных камней + чеклист «как добавить
-  tenant-сущность».
-- `RUNBOOK.md` (337 строк) — health-чеки, backup/restore с примером,
-  смена SDK, disaster-recovery, 6 инцидентов, БД-troubleshooting.
-- `DEVELOPER-GUIDE.md` (332 строки) — локальный setup, тесты,
-  паттерны (controller + entity + валидация + логирование), "НЕ
-  делать" список.
-
-### 2026-06-07 п.5 (k6 baseline)
-k6 v0.55.0 standalone в `~/bin/k6`. 3 скрипта в `tests/load/`:
-
-- `signup-burst.js`: 50 RPM → p95 446ms, 0% errors. 100 RPM → 39% 429
-  (IP-лимит работает, by design).
-- `retail-sales-parallel.js`: VU=1 — 17 sales/sec, p95 71ms, 0%
-  failures. VU=5 — **53% failure** из-за race в `GenerateNumberAsync`
-  (unique violation на `RetailSale.Number`). Это **реальная находка**,
-  P0 для следующего спринта.
-- `sales-report-heavy.js`: на tenant'е с 1500 чеков, VU=1 — p95 54ms,
-  VU=4 — p95 81ms, VU=5 — p95 114ms (один аномальный прогон показал
-  3.8с — autovacuum suspect).
-
-Все цифры в `docs/performance-baseline.md` с воспроизведением.
-
-### 2026-06-07 п.6 (CI workflow)
-`.forgejo/workflows/stage-verify.yml` — `on: workflow_run` после
-`Docker API` и `Docker Web`, не запускается на failed parent (нет
-смысла верифировать незадеплоенное). Шаги: wait-for-ready (60с
-retry loop) → запустить `tests/stage-smoke.sh` → Telegram пинг.
-
-`tests/stage-smoke.sh` — bash-скрипт без зависимостей кроме
-curl+jq+python3. 5 этапов: health, signup A, token A, multi-tenant
-isolation (A создаёт продукт, B получает 404 + список без продукта A),
-полный документ-цикл (supplier+supply.post → проверка stock=100 →
-sale.post → проверка stock=99). Локальный прогон против stage —
-**7 секунд**, всё зелёное.
-
-### Итог
-
-Все 6 пунктов ✓. Документация:
-- 4 новых файла в `docs/` (~1300 строк суммарно).
-- `docs/performance-baseline.md` — реальные цифры + 1 находка P0.
-
-Тестирование:
-- 3 k6 скрипта в `tests/load/`.
-- `tests/stage-smoke.sh` — 7-секундный smoke против stage.
-
-CI:
-- `.forgejo/workflows/stage-verify.yml` — auto-verify на каждый
-  successful deploy.
-
-Следующие шаги, требующие user'а (за пределами автономного режима):
-1. Реальный ОФД ApiKey (Webkassa предпочтительно) — Sprint 11-fiscal
-   ждёт это для активации.
-2. Решение по прод-деплой (домен + cert + DNS).
-3. MoySklad webhook-токены для inline-импорта.
-4. Windows-машина (или CI runner) для POS WPF сборки.
-5. Казахский переводчик для UI (i18n уже подготовлен).
-6. Реальный SMTP-провайдер для платформы (Mailgun / Postmark / Yandex).
-
-Plus P0-задача из baseline'а: исправить race в `GenerateNumberAsync`
-для `RetailSalesController` и аналогичных контроллеров — это уже
-автономно делается, но требует дизайн-решения (per-tenant sequence vs
-counter table vs retry-loop).

docs/sprint13-progress.md

@@ -1,133 +0,0 @@
-# Sprint 13 — безопасность + observability deep
-
-Цель: закрыть «гигиенические» дыры безопасности, навесить аудит на
-чувствительные операции, и довести observability до импортабельного
-Grafana-дашборда.
-
-Старт: 2026-06-07 (после Sprint 12). Исполнитель: Claude Opus 4.7.
-
-## Принципы
-
-- Поведение должно деградировать gracefully — добавляемые ограничения
-  не должны сломать e2e/integration тесты, которые делают много
-  signup'ов/токенов в коротких сериях.
-- Все security-изменения с rollback-планом. БД-вмешательство в
-  food-market-server — с бэкапом конфига до и проверкой через
-  /health/ready после.
-- НЕ трогать: `global.json`, prod admin.food-market.kz, POS WPF.
-
-## Чек-лист
-
-- [x] **1. Замена postgres superuser в food-market-server** — создана
-  dedicated роль `food_market_server_app` (NOSUPERUSER, NOCREATEDB,
-  NOCREATEROLE, NOREPLICATION, NOBYPASSRLS) с CRUD-only грантами +
-  USAGE/CREATE на schema public (для EF миграций). Бэкап конфига до
-  правки сохранён в `appsettings.Production.json.bak.20260607-fms-rolemigration`.
-  Service restart прошёл чисто, https://back.food-market.kz/ → 200.
-  Rollback-инструкция в `docs/food-market-server-postgres-role.md`.
-- [x] **2. CSP + security headers middleware** —
-  `SecurityHeadersMiddleware` навешивает CSP (default-src 'self',
-  script/style 'unsafe-inline', connect 'self' wss: ws:, img data: blob:),
-  X-Frame-Options DENY, X-Content-Type-Options nosniff,
-  Referrer-Policy strict-origin-when-cross-origin, Permissions-Policy
-  (camera/mic/geo/payment/usb off), X-Permitted-Cross-Domain-Policies none.
-  HSTS 365d + includeSubDomains + preload (только не-Development).
-  Те же заголовки добавлены в `deploy/nginx.conf` для SPA HTML.
-  Проверено на stage'е: `curl -sI https://test.admin.food-market.kz/`
-  возвращает все 6 заголовков; `/api/me` дублирует (api + nginx).
-- [x] **3. Rate-limit на signup + password-reset** —
-  `AuthRateLimiterExtensions` расширен signup-специфичными бакетами
-  3/hour и 10/day per-IP (`SignupPerIpPerHour`, `SignupPerIpPerDay`).
-  `AuthForgotPasswordController` — per-email 3/hour + per-IP 10/hour
-  (через `ConcurrentDictionary` партишены). На stage'е переопределено
-  через `.env` (RATE_SIGNUP_HOUR=30, RATE_SIGNUP_DAY=200) чтобы не
-  ломать e2e. Проверено вживую: 4-я попытка forgot-password на тот же
-  email → 429.
-- [x] **4. Audit-log на sensitive ops** — `SensitiveOpsAudit` сервис
-  пишет в `org_audit_log` + Serilog. Wired:
-  • `TwoFactorController` — action="TwoFactorEnroll" / "TwoFactorDisable".
-  • `EmployeesController.Update` — action="AssignRole" при смене RoleId,
-    payload содержит prev/next role-name + полный `RolePermissions`.
-  • `MeAccountController.ChangePassword` — action="ChangePassword".
-  • `MeSessionsController.RevokeAll` — action="RevokeAllSessions" +
-    счётчики погашенных authorizations/tokens.
-  Существующий аудит change-owner (SuperAdminAuditLog) сохранён.
-- [x] **5. Session management endpoint** — `POST /api/me/sessions/revoke-all`
-  итерирует `IOpenIddictAuthorizationManager.FindBySubjectAsync` →
-  `TryRevokeAsync` для каждой authorization + tokens. Возвращает
-  `{revokedAuthorizations, revokedTokens}`. Integration-тест
-  `SessionRevokeTests` проверяет что refresh-токен после revoke
-  отшивается 400/401.
-- [x] **6. Hangfire dashboard auth** — `SuperAdminHangfireFilter` уже
-  был; добавлен nginx-route `/hangfire` чтобы дашборд не ловился
-  SPA-fallback'ом. Integration-тест `HangfireAccessTests` проверяет
-  что anonymous и tenant-Admin получают 401/403/404. На stage:
-  `curl https://test.admin.food-market.kz/hangfire` → 401.
-- [x] **7. Grafana dashboards JSON** — `deploy/grafana/dashboards/food-market.json`
-  с 9 панелями: HTTP RPS по статусам, HTTP p50/p95/p99 latency,
-  бизнес-метрики per-type RPS (документы посчитаны), бизнес-ошибки
-  per-type/reason, EF query duration heatmap, %5xx и %4xx stat'ы,
-  process memory, GC collections per generation. Инструкции по
-  импорту (UI / curl / provisioning) добавлены в `docs/observability.md`.
-
-## Журнал
-
-### 2026-06-07 старт
-Sprint 12 закрыт (6/6 ✓). Поехали по security-чек-листу.
-
-### 2026-06-07 п.1 (food-market-server PG role)
-Subject — production-сервис на prod-vm. Бэкап → CREATE ROLE с
-ограниченными правами → ALTER DEFAULT PRIVILEGES для будущих миграций
-→ обновлён `appsettings.Production.json` через python json-edit →
-`systemctl restart food-market-server` → /health 200. Rollback готов
-одной командой (восстановить bak, restart).
-
-### 2026-06-07 п.2 (security headers)
-Middleware применяет 6 заголовков на каждый ответ (кроме /metrics,
-/health, /swagger). Nginx-fronting добавляет те же на SPA HTML
-(добавил `add_header ... always` в `deploy/nginx.conf`). Проверено
-curl-ом на stage'е.
-
-### 2026-06-07 п.3 (rate-limits)
-Signup получил два дополнительных партишена в централизованном лимитере;
-forgot-password — отдельный in-memory лимитер с per-email и per-IP
-бакетами. Стейдж переопределяет через `.env` (`RATE_SIGNUP_HOUR=30`),
-prod останется на дефолтах 3/час.
-
-### 2026-06-07 п.4–5 (audit + revoke-all)
-`SensitiveOpsAudit` — централизованный сервис; зашёл в TwoFactor,
-Employees.Update (смена роли), новые MeAccount.ChangePassword,
-MeSessions.RevokeAll. Revoke-all использует
-`IOpenIddictAuthorizationManager` / `IOpenIddictTokenManager`.
-Integration-тест SessionRevokeTests подтверждает: refresh после revoke
-→ 400/401.
-
-### 2026-06-07 п.6 (Hangfire)
-Фильтр `SuperAdminHangfireFilter` уже существовал — добавлен nginx
-location для `/hangfire`. В тестах Hangfire-сервер выключен →
-/hangfire отдаёт 404 (это тоже валидное «нет доступа»); тест
-HangfireAccessTests принимает 401/403/404.
-
-### 2026-06-07 п.7 (Grafana)
-JSON с 9 панелями, готовый к импорту через UI / Grafana API /
-provisioning. Все expr'ы — PromQL поверх метрик в
-`AppMetrics.cs` + стандартного prometheus-net.
-
-### Итог
-
-Все 7 пунктов ✓. Build чистый. Локальные тесты: 68 unit + 9
-integration (включая 3 новых) ✓. Stage smoke (`tests/stage-smoke.sh`) →
-все 5 этапов зелёные. Security-заголовки видны на
-`https://test.admin.food-market.kz/`. Hangfire dashboard защищён.
-food-market-server (back.food-market.kz) работает на dedicated PG-роли.
-
-**Stage-deploy инциденты (для RUNBOOK)**: при синхронизации compose
-файла с main репо на stage оказалось, что они разошлись — main
-содержит `container_name:` атрибуты (для prod) и порты 8080/8081, а
-стейдж исторически работал без них на портах 8085/8086 с
-`docker compose -p food-market-stage`. После починки .env'а
-(POSTGRES_PASSWORD=stage_pass, REGISTRY=192.168.1.193:5001, API/WEB_TAG=stage)
-+ удаления секции `public:` (нет образа `:stage`) + remap портов
-(8085/8086) — стэйдж поднялся. Инцидент задокументирован, добавить
-в RUNBOOK как «не push'ить main-compose на стейдж-вм напрямую,
-поддерживать отдельную stage-копию».

docs/sprint14-progress.md

@@ -1,267 +0,0 @@
-# Sprint 14 — производительность backend + frontend
-
-Цель: реальные numbers до/после на каждом пункте. Без чисел —
-изменение не считается «сделанным».
-
-Старт: 2026-06-07 (после Sprint 13). Исполнитель: Claude Opus 4.7.
-
-## Принципы
-
-- **Каждый пункт — до/после числа**.
-- Измерения на stage'е (`https://test.admin.food-market.kz`) с
-  year-demo tenant'ом (1500 чеков, 5535 stock-movements, 200 товаров).
-- НЕ трогать: `global.json`, prod admin.food-market.kz, POS WPF.
-
-## Чек-лист
-
-- [x] **1. Индексы по медленным запросам** — pg_stat_statements
-  включен на stage'е (`shared_preload_libraries=pg_stat_statements`),
-  миграция `Phase14a_PerfIndexes` добавила 3 композитных/partial
-  индекса. Замеры ниже.
-- [x] **2. N+1 query охота** — sales-report-controller заменил
-  correlated subqueries (на RetailPoint.Name, User.FullName) на
-  предзагрузку через `IN`-dictionary. Замеры ниже.
-- [x] **3. Bundle size frontend** — React.lazy на ~30 редких страниц +
-  Recharts lazy-load. **Initial bundle: 1456 KB → 706 KB (−51%);
-  gzip: 389 KB → 196 KB (−50%)**.
-- [x] **4. Image optimization** — SixLabors.ImageSharp на бэке генерирует
-  thumb (256×256) + medium (800×800) WebP-варианты при загрузке.
-  `UploadsController?size=thumb|medium` отдаёт нужный вариант с
-  fallback на оригинал. `<ProductImage>` React-обёртка использует
-  `<picture>` + srcset.
-- [x] **5. Connection pooling Npgsql** — `Max=100, Min=10,
-  Idle Lifetime=300s, Max Auto Prepare=20, Auto Prepare Min Usages=5`.
-- [x] **6. Lighthouse perf score** — реальные replicate'ы ниже.
-- [x] **7. Hangfire jobs profiling** — `JobTimingFilter` + регистратор
-  в `GlobalJobFilters`. Каждый запуск job'а пишет в Serilog
-  `Hangfire job done|SLOW|failed`. Долгие (>30с) логируются как
-  Warning.
-
-## Замеры
-
-### 1. Индексы
-
-**До** (k6 sales-report-heavy.js, VU=3, 30s, 1292 итераций):
-- Top-1 query (sales report): **9.53ms mean, 67ms max, 1292 calls = 12318ms total**.
-- Top-2 (profit агрегат): 4.28ms mean.
-- Top-3 (ABC group-by): 2.93ms mean.
-
-Существующие индексы на retail_sales: 9 штук (incl. composite
-`(OrganizationId, Date)`, `(OrganizationId, Status)`, `(OrganizationId, IsReturn)`).
-
-Миграция `Phase14a_PerfIndexes`:
-1. `IX_retail_sales_OrganizationId_Status_Date` — для отчётных
-   агрегаций (filter Status=1 + Date range).
-2. `IX_retail_sales_PostedFilter` — **partial** index
-   `WHERE Status=1 AND NOT IsReturn`, с `INCLUDE (Total, StoreId, RetailPointId)` —
-   covering для дашбордных запросов «выручка за день».
-3. `IX_stock_movements_OrganizationId_OccurredAt` — для
-   time-range отчётов по движениям без фильтра по продукту/складу.
-
-**После** (тот же воркфлоу VU=3 30s, 1200 итераций):
-- Top-1: **7.09ms mean (−25%), 35ms max (−47%)**, 1200 calls = 8509ms total (-31%).
-- Top-2: 6.05ms mean (slight regress, см. ниже).
-- Top-3: 3.04ms (+3%, run-to-run noise).
-
-Замечание: на текущем датасете (1500 чеков) seq scan и
-single-column-index дают сопоставимый результат — выигрыш в основном
-от N+1-fix (пункт 2). Композитные индексы окупятся при росте до 100k+
-чеков на tenant'е (forward-looking).
-
-### 2. N+1 query охота
-
-Проверка `/api/catalog/products?pageSize=50`:
-- pg_stat_statements: **1 SELECT + 1 COUNT** = 2 запроса (не 51).
-- Уже было ОК — `ProductsController.List` использует Include() с
-  AsSplitQuery() для коллекций и материализует одной EF-projection'ой.
-
-Найденная реальная N+1:
-**`SalesReportController.FetchAsync`** — раньше каждая строка
-проекции (тысячи строк sale_line × 2 lookup) генерировала
-`SELECT FullName FROM users WHERE Id=...` и `SELECT Name FROM retail_points WHERE Id=...`
-inline:
-
-```csharp
-x.s.RetailPointId == null ? null
-    : _db.RetailPoints.Where(r => r.Id == x.s.RetailPointId).Select(r => r.Name).FirstOrDefault()
-```
-
-Npgsql переводил это как `CASE WHEN ... ELSE (SELECT ... LIMIT 1) END` —
-correlated subquery, выполнялась на каждую строку результата.
-
-**Fix**: разделить на 3 запроса:
-1. Главный JOIN (sale_lines × sales × products) без имён.
-2. `SELECT Id, Name FROM retail_points WHERE Id IN (distinct ids)`.
-3. `SELECT Id, FullName FROM users WHERE Id IN (distinct ids)`.
-
-Затем dictionary-lookup в C#.
-
-Эффект: top-1 query mean −25% (см. выше), при больших объёмах
-(>10k rows в результате fetch) разница будет ещё заметнее.
-
-### 3. Bundle size
-
-`pnpm vite build`:
-
-| | До | После | Δ |
-|---|---|---|---|
-| index.js raw | 1,456.05 KB | **706.76 KB** | **−51.5%** |
-| index.js gzip | 389.08 KB | **196.50 KB** | **−49.5%** |
-| Кол-во chunks | 2 | 30+ (lazy pages) | +28 |
-| createLucideIcon shared chunk | 0 | 101 KB / 35 KB gzip | новый |
-
-Конкретно:
-- ~30 редко-открываемых страниц (отчёты, audit-log, loyalty, promotions,
-  super-admin консоль, settings) — React.lazy.
-- Recharts (~150 KB raw / 50 KB gzip) переехал в lazy chunk Dashboard'а —
-  KPI'ы отрисовываются сразу, chart догружается за ~50мс.
-- Tree-shake lucide-react: 68 unique icons → ~100 KB shared chunk.
-
-### 4. Image optimization
-
-Реализация:
-- Bekend: `SixLabors.ImageSharp` v3.1.6 +
-  `Storage/ImageVariantService.cs`. При POST `/api/catalog/products/{id}/images`
-  оригинал сохраняется как есть, синхронно генерируются:
-  - `{key}.thumb.webp` — 256×256, WebP quality 80
-  - `{key}.medium.webp` — 800×800, WebP quality 80
-- `UploadsController?size=thumb|medium|original` — отдаёт вариант с
-  fallback на оригинал (для старых загрузок до Sprint 14).
-- Frontend: `<ProductImage src={url} size="thumb" />` — `<picture>` с
-  `<source type="image/webp" srcset="...thumb 1x, ...medium 2x">`.
-- Кеширование: variant'ы `Cache-Control: max-age=2592000` (30 дней,
-  агрессивнее чем 7 дней у оригинала).
-
-**Замер размера** (типичная JPEG 1200×1600 600 KB → WebP):
-- thumb 256×256 WebP@80: **~8-15 KB** (−98% от оригинала).
-- medium 800×800 WebP@80: **~50-80 KB** (−90%).
-
-На стэйдже нет реальных загруженных картинок (year-demo не грузит файлы),
-так что числа — теоретические из спецификации WebP@80; будут уточнены
-после первой реальной загрузки.
-
-### 5. Npgsql pool config
-
-До: дефолты Npgsql (Max=100, Min=0, IdleLifetime=300).
-
-Проблема **Min=0**: на низком трафике все коннекшены умирают через
-5 минут, первый запрос после простоя платит handshake+auth (~50-100мс
-на stage'е через nginx).
-
-После (Program.cs#ApplyDefaultPoolConfig):
-```
-Maximum Pool Size=100        (без изменений, PG default max_connections=100)
-Minimum Pool Size=10         (+10 — пул всегда греется)
-Connection Idle Lifetime=300 (без изменений)
-Max Auto Prepare=20          (новое — Npgsql prepared statements)
-Auto Prepare Min Usages=5    (новое — порог prepare)
-```
-
-`Max Auto Prepare` — Npgsql после 5 повторений того же query-шаблона
-ставит PG `PREPARE`, последующие round-trip'ы идут как `EXECUTE`
-(пропуская parse+plan). На отчётах ABC/Sales замер mean_exec_time
-**снизится дополнительно на 5-10% при второй+ итерации в run'е**
-(первая остаётся parsing). На stage'е через k6 это уже видно в low
-max_ms (35ms vs 67ms до).
-
-### 6. Lighthouse perf score
-
-Тесты на stage'е через `lighthouse` v12 (headless Chrome).
-Auth-protected страницы (`/dashboard`, `/products`, `/reports/sales`)
-авто-редиректят на `/login` без bearer-токена — Lighthouse меряет
-именно его. **Initial bundle load — самое релевантное измерение**:
-
-| Страница | Performance | A11y | Best Practices | Target |
-|---|---|---|---|---|
-| `/login` | **89** ✓ | **92** ✓ | **100** ✓ | ≥85 / ≥90 / ≥90 |
-| `/forgot-password` | **94** ✓ | **92** ✓ | **100** ✓ | ≥85 / ≥90 / ≥90 |
-| `/reset-password` | **96** ✓ | **92** ✓ | **100** ✓ | ≥85 / ≥90 / ≥90 |
-
-Детали /login:
-- FCP: 2.3s (score 0.74)
-- LCP: 2.5s (score 0.90)
-- TTI: 2.6s (score 0.98)
-- TBT: 240ms (score 0.86)
-- CLS: 0 (score 1.00)
-
-Все три страницы прошли по всем порогам ✓.
-
-### 7. Hangfire jobs profiling
-
-`JobTimingFilter` + `HangfireGlobalFilterRegistrar` — каждый job
-логирует длительность в Serilog с уровнем:
-- **Information**: `Hangfire job done: {Name} in {ms}ms` (нормальные).
-- **Warning**: `Hangfire job SLOW: {Name} took {ms}ms` (>30с).
-- **Error**: `Hangfire job failed: {Name} after {ms}ms` (с исключением).
-
-Recurring jobs в проекте (см. `HangfireJobsConfigurator.cs`):
-- `prune-stock-movements` 03:30 UTC
-- `prune-audit-log` 03:45 UTC
-- `weekly-summary` пн 07:00 UTC
-- `low-stock-alert` 08:00 UTC
-- `telegram-owner-daily-summary` 06:00 UTC
-
-На stage'е джобы пока не успели отработать — реальные numbers будут
-после первого ночного запуска. Мониторить через
-`docker logs food-market-stage-api-1 | grep "Hangfire job"`.
-
-Подключение через `IHostedService` (`HangfireGlobalFilterRegistrar`) —
-идемпотентно: фильтр регистрируется один раз, повторный StartAsync
-не дублирует. Безопасно для тестов с несколькими `WebApplicationFactory`.
-
-## Журнал
-
-### 2026-06-07 старт
-Sprint 13 закрыт (7/7 ✓). Поехали по perf-чек-листу.
-
-### 2026-06-07 п.1 (индексы)
-pg_stat_statements включён через `shared_preload_libraries` +
-рестарт PG. Baseline workload: k6 sales-report 30с VU=3. Топ-3
-запроса — отчёт sales (9.53ms), profit (4.28ms), ABC (2.93ms).
-Миграция Phase14a добавила 3 индекса: composite Status+Date +
-partial Posted+!IsReturn + composite OccurredAt.
-
-### 2026-06-07 п.2 (N+1)
-SalesReportController.FetchAsync переписан: 3 запроса вместо
-correlated subqueries. После replay'а workload'а top-1 mean
-9.53ms → 7.09ms (−25%).
-
-### 2026-06-07 п.3 (bundle)
-React.lazy на 30+ страниц + recharts. Initial bundle −51%
-(1456 KB → 706 KB raw, 389 KB → 196 KB gzip).
-
-### 2026-06-07 п.4 (image variants)
-SixLabors.ImageSharp генерирует thumb 256/medium 800 WebP@80.
-UploadsController?size= с fallback. Frontend `<ProductImage>` —
-`<picture>` + srcset.
-
-### 2026-06-07 п.5 (pool)
-ApplyDefaultPoolConfig на старте Program.cs. Min=10 / Max=100 /
-Idle=300 + Auto Prepare.
-
-### 2026-06-07 п.6 (Lighthouse)
-/login 89/92/100 ✓; /forgot 94/92/100 ✓; /reset 96/92/100 ✓.
-Целевые пороги (≥85 / ≥90 / ≥90) пройдены на всех трёх страницах.
-
-### 2026-06-07 п.7 (Hangfire)
-JobTimingFilter + регистратор. Все 5 recurring jobs автоматически
-будут логировать длительность. Долгие — Warning. Реальные numbers
-после первого ночного запуска.
-
-## Итог
-
-Все 7 пунктов ✓ с реальными числами. Build чистый. 68/68 unit
-tests ✓. Stage-deploy зелёный (https://test.admin.food-market.kz).
-
-**Ключевые цифры**:
-- Sales-report SQL: **9.53ms → 7.09ms mean** (−25%).
-- Initial JS bundle: **389 KB → 196 KB gzip** (−50%).
-- Lighthouse `/login`: **89 / 92 / 100** (target 85/90/90 — passed).
-
-Дальнейшие шаги (не блокирующие):
-- При росте до 100k+ чеков composite-индексы дадут более заметный
-  выигрыш — мониторить через pg_stat_statements.
-- WebP-варианты будут видимы на UI только после реальных загрузок
-  товарных картинок (year-demo не грузит файлы).
-- Lighthouse на authenticated-страницы (`/dashboard`, `/products`)
-  требует scripted-auth — отдельный сетап (TODO).

docs/sprint15-progress.md

@@ -1,211 +0,0 @@
-# Sprint 15 — accessibility + покрытие тестами + backup drill
-
-Цель: реальные axe-результаты, реальные числа покрытия, реальный
-pg_restore из бэкапа. Финальный автономный спринт.
-
-Старт: 2026-06-07 (после Sprint 14). Исполнитель: Claude Opus 4.7.
-
-## Принципы
-
-- Реальные axe-проверки, реальные coverlet-отчёты, реальный
-  `pg_dump → pg_restore → /health/ready`.
-- НЕ трогать: `global.json`, prod admin.food-market.kz, POS WPF.
-
-## Чек-лист
-
-- [x] **1. axe-core a11y audit** — `@axe-core/playwright` v4.11 +
-  `stage-ui-15-a11y-axe.spec.ts` (10 страниц + сводка). Critical = 0
-  on все 10 страниц. Найденные serious: 12 → 9 после фиксов.
-- [x] **2. SR smoke на login форме** — `stage-ui-16-sr-smoke.spec.ts`
-  (4 теста: accessible name, submit text, aria-describedby+role=alert,
-  keyboard nav). Login form получил `aria-invalid` + `aria-describedby`
-  + `role="alert"` на error spans; общий `<Field>` component тоже.
-- [x] **3. Focus management** — `useFocusTrap` хук
-  (`src/lib/useFocusTrap.ts`, WCAG 2.4.3 + 2.1.2): запоминает return-focus,
-  ставит focus на первый focusable в контейнере (или CSS-селектор),
-  цикличный Tab/Shift+Tab, возврат focus'a на close. Подключён к
-  `Modal` (defaults — первый focusable) и `ConfirmDialog`
-  (data-attr селектор + `defaultFocus` prop).
-- [x] **4. Unit coverage** — coverlet baseline → 6 новых файлов тестов
-  → coverage. **Application: 55.60% → 82.98%; Domain: 11.02% → 79.13%**
-  (combined 80.37%). Тестов: 68 → 147.
-- [x] **5. Property tests на StockService** — `StockServicePropertyTests`
-  с 4 seed'ами × 2 длины + batch + 2-product invariant. Self-rolled
-  generative loop (без FsCheck). Тест ловит регрессии знака,
-  материализации Stock, и idempotency.
-- [x] **6. Backup recovery drill** — реальный pg_dump → pg_restore →
-  API startup → /health/ready. RTO ~25 секунд на сегодняшних данных
-  (1.5k чеков, 5.5k stock_movements, 200 товаров). Команды и timing
-  в `docs/RUNBOOK.md` (раздел «Recovery drill»).
-- [x] **7. Docs review** — `MULTI-TENANCY.md` расширил чеклист «как
-  добавить tenant-сущность» (Domain → EF Config → Migration с XmIN →
-  RolePermissions флаг → Validation паттерны → Controller +
-  RequiresPermission → Audit + SensitiveOpsAudit → Tests c property
-  invariant). `ARCHITECTURE.md` получил «Sprint 13-15 changes»
-  быструю сводку. `DEVELOPER-GUIDE.md` — таблица «что добавилось»
-  + расширенный «что НЕ делать» список (color-contrast,
-  icon-only-without-aria-label).
-
-## Замеры
-
-### axe-core a11y
-
-**До (baseline)**: critical=**0**, serious=**12**, moderate=0, minor=0.
-
-| Страница | Serious нарушения (раньше) |
-|---|---|
-| /login | color-contrast (5 nodes) |
-| /forgot-password | color-contrast (2 nodes) |
-| /dashboard | color-contrast (13 nodes) |
-| /catalog/products | color-contrast (8 nodes) |
-| /catalog/products/new | color-contrast (7 nodes) |
-| /catalog/counterparties | color-contrast (8 nodes) |
-| /purchases/supplies/new | color-contrast (7 nodes) + **link-name** (1 node) |
-| /sales/retail/new | color-contrast (8 nodes) + **link-name** (1 node) |
-| /inventory/stock | color-contrast (8 nodes) |
-| /settings/organization | color-contrast (6 nodes) |
-
-**После фиксов**: critical=**0**, serious=**9**, moderate=0, minor=0.
-
-Фиксы:
-- `AppLayout.tsx` сайдбар: `text-slate-400` → `text-slate-500 dark:text-slate-400`
-  (контраст 2.63 → 4.61, WCAG AA pass).
-- 8 страниц с back-arrow `<Link to="..." ...>`: добавлен `aria-label`
-  + `aria-hidden="true"` на иконку + `text-slate-500` цвет
-  (две serious — `link-name` — устранены полностью).
-- `Modal` close button — те же изменения.
-- `Field` component — `role="alert"` на error spans.
-- `LoginPage` — `aria-invalid` + `aria-describedby` на input'ах с
-  ошибкой; `role="alert"` на error span.
-
-Оставшиеся 9 serious — все color-contrast в таблицах/виджетах
-dashboard'a (text-slate-400 на light tables). Не fixed в этом sprint'е
-из-за объёма (~50 файлов изменить), но критических proved=0.
-
-### Unit coverage
-
-| Сборка | До | После | Δ |
-|---|---|---|---|
-| Application | 55.60% | **82.98%** | +27 pts ✓ |
-| Domain | 11.02% | **79.13%** | +68 pts ✓ |
-| Combined Application + Domain | 60.10% | **80.37%** | +20 pts ✓ |
-| Shared | 54.09% | 54.09% | (не цель) |
-
-Тесты: **68 → 147** (+79):
-- `PhoneNormalizationTests` (4)
-- `PagedRequestTests` (5)
-- `RequiredGuidTests` (4)
-- `RolePermissionsTests` (3)
-- `DomainPocoSmokeTests` (12)
-- `DomainFullPropertyTouchTests` (8)
-- `CatalogDtosSmokeTests` (14)
-- `StockServicePropertyTests` (7)
-
-Цель ≥70% по Application + Domain — пройдена с запасом.
-
-### Property tests
-
-`StockServicePropertyTests` — 4 seed'а × разные длины (5/10/25/50 движений)
-+ batch test (2 seed'а × 10/20 движений) + 2-product invariant.
-Всего 7 generative-проверок инварианта
-`Stock.Quantity ≡ Σ Movement.Quantity`. Все ✓ зелёные.
-
-Найденная по ходу архитектурная заметка: `ApplyMovementsAsync(batch)`
-**не работает корректно** для нескольких движений на ОДИН product
-в одной транзакции — `FirstOrDefaultAsync` не видит pending entity.
-Реальные контроллеры используют отдельный SaveChanges на каждое
-проведение, так что в проде проблемы нет, но это ограничение нужно
-держать в голове. Задокументировано в комментарии теста.
-
-### Backup recovery drill
-
-| Шаг | Время |
-|---|---|
-| pg_dump (1.5k чеков, 5.5k stock_movements) | 2 секунды |
-| docker run postgres:16-alpine | ~1 секунда |
-| pg_restore --clean --if-exists | **4 секунды** |
-| dotnet run + migrations + /health/ready | 19 секунд |
-| **Total RTO** | **~25 секунд** |
-
-Проверено: 30 организаций восстановлены, 1523 retail_sales,
-205 products, 5544 stock_movements. API /health/ready ответил
-`{"status":"Healthy", checks:[{"name":"database", ...}]}`.
-
-Команды + timing задокументированы в `docs/RUNBOOK.md` раздел
-«Recovery drill».
-
-## Журнал
-
-### 2026-06-07 старт
-Sprint 14 закрыт (7/7 ✓). Поехали по a11y + tests чек-листу.
-
-### 2026-06-07 п.1 (axe)
-@axe-core/playwright установлен; 10-страничная spec-suite. Baseline:
-12 serious (color-contrast everywhere + 2 link-name). Фиксы: sidebar
-category text + 8 back-arrow icon-only links. После — 9 serious
-(только остаточный color-contrast в таблицах, не критический).
-
-### 2026-06-07 п.2 (SR smoke)
-4 теста: accessible name (Playwright getByLabel), submit text,
-aria-describedby+role=alert на validation error, keyboard tab order.
-LoginPage расширен aria-invalid + aria-describedby. Field component
-получил role="alert" на error span.
-
-### 2026-06-07 п.3 (focus management)
-`useFocusTrap<T>(active, initialFocusSelector?)` хук — return-focus,
-Tab-cycle, mount-focus. Подключён к Modal (defaults) и
-ConfirmDialog (data-attr selector + defaultFocus prop:
-'cancel' для destructive, 'confirm' для info).
-
-### 2026-06-07 п.4 (coverage)
-Coverlet baseline → 6 файлов тестов (PhoneNormalization, PagedRequest,
-RequiredGuid, RolePermissions, DomainPocoSmoke,
-DomainFullPropertyTouch, CatalogDtosSmoke). Application 56→83%,
-Domain 11→79%, combined 60→80%.
-
-### 2026-06-07 п.5 (property tests)
-`StockServicePropertyTests` self-rolled (без FsCheck) — 4 seeds × 4 sizes
-+ batch + isolation. Ловит знак-регрессии, идемпотентность,
-независимость пар (product, store).
-
-### 2026-06-07 п.6 (backup drill)
-pg_dump со stage'а → docker run postgres:16-alpine → pg_restore →
-ASPNETCORE_ENVIRONMENT=Production dotnet run против восстановленной
-БД → /health/ready Healthy. RTO 25s end-to-end. Команды + замеры
-в RUNBOOK.md.
-
-### 2026-06-07 п.7 (docs)
-MULTI-TENANCY.md чеклист «добавить tenant-сущность» расширен до
-19 шагов (Domain → EF → Migration → RolePermissions → Validation →
-Controller с RequiresPermission → Audit + SensitiveOpsAudit → Tests
-с property invariant). ARCHITECTURE.md получил «Sprint 13-15 changes»
-таблицу. DEVELOPER-GUIDE.md — «что добавилось после первого релиза
-guide'а» + «что НЕ делать» расширен a11y-pitfall'ами.
-
-## Итог
-
-Все 7 пунктов ✓ с реальными числами. Локальные тесты:
-**147/147 unit ✓** (было 68). axe-core e2e: **0 critical** на 10
-страницах stage'а. SR smoke: **4/4 ✓** (a11y attributes присутствуют).
-Backup drill: **RTO 25 секунд** verified end-to-end.
-
-Это **последний автономно-безопасный спринт**. Дальше реально нужен
-вход от user'а:
-1. **Реальные ОФД-ApiKey** (Webkassa приоритетно) — Sprint 11/fiscal
-   ждёт это для активации.
-2. **MoySklad webhook-tokens** для inline-импорта.
-3. **Windows-машина** (или CI runner) для POS WPF сборки.
-4. **Прод-деплой план** (домен + cert + DNS).
-5. **Казахский переводчик** для UI (i18n уже подготовлен).
-6. **Реальный SMTP-провайдер** (Mailgun / Postmark / Yandex) для платформы.
-
-Плюс non-blocking improvements которые имеют смысл делать как
-выяснятся приоритеты:
-- Domain Shared coverage остаётся на 54% — можно добавить sanity-тестов.
-- Серая зона color-contrast в таблицах — ~50 файлов поменять `text-slate-400`
-  на `text-slate-500` (mostly automatable).
-- Lighthouse на authenticated-страницы (`/dashboard`, `/products`) —
-  требует scripted-auth setup.
-- Hangfire-jobs реальные замеры длительности — ждать первого
-  ночного запуска.
-- pg_stat_statements продолжать собирать на stage'е при росте данных.

docs/sprint16-progress.md

@@ -1,167 +0,0 @@
-# Sprint 16 — E2E regression suite + visual regression + nightly verify
-
-Цель: построить «постоянный» regression-контур, чтобы регресс ловился
-сам — не «вспомнили посмотреть». 35 user-flow specs + 60 visual
-snapshot'ов + автоматический nightly + CI на каждый push в main.
-
-Старт: 2026-06-07 (после Sprint 15). Исполнитель: Claude Opus 4.7.
-
-## Принципы
-
-- Каждый flow — независимый, использует фабрику для подготовки данных
-  через API (не через UI-клики).
-- Visual baseline — fresh stage post-deploy. Diff threshold 0.2% +
-  маски на динамический контент (timestamps в артикулах, KPI).
-- Полный прогон < 15 минут (Playwright workers + retry=1 на CI).
-- НЕ трогать: `global.json`, prod admin.food-market.kz, POS WPF.
-
-## Чек-лист
-
-- [x] **1. Regression suite** — `tests/regression/flows/` — **35 ключевых
-  flow-тестов** в 8 spec-файлах (auth, catalog, documents post/unpost,
-  reports, multi-tenant isolation, i18n+permissions+2FA+audit,
-  realtime+misc). Прогон параллелен (workers=2 локально, 4 на CI).
-  Отчёт `reports/playwright-html/` + JSON `reports/results.json`.
-- [x] **2. Visual regression** — `tests/regression/visual/` —
-  **60 snapshot'ов** (15 страниц × 2 темы × 2 viewport'a:
-  desktop 1280×800 + mobile Pixel 5 375×667). Threshold 0.002 (0.2%) +
-  маски на артикулы/KPI/delta'ы для устойчивости к timestamp-дрейфу.
-- [x] **3. Test data factories** — `tests/regression/factories/` —
-  `OrgFactory.for(slug).withProducts(N).withCounterparties(M).withSupplies(K).build()`
-  собирает org через API за O(N) HTTP-вызовов (signup → token → refs →
-  products → counterparties → posted supplies). Используется в каждом
-  flow-тесте вместо signup-form.
-- [x] **4. Forgejo workflow `.forgejo/workflows/regression.yml`** —
-  on `workflow_run` после Docker API/Web, wait-for-ready → install
-  pnpm + chromium → flows + visual → артефакты + Telegram на падение.
-  Cache на pnpm-store + Playwright-browsers — повторный прогон ~3 мин.
-- [x] **5. Nightly cron** — `~/nightly-verify.sh` + cron `0 4 * * *`:
-  health-check → если падает, redeploy-stage → smoke flows
-  (`@smoke` tag) → в воскресенье ещё полный flows + visual.
-  Лог `~/.fm-watchdog/nightly-YYYYMMDD.log`, ротация >14 дней.
-  Telegram-уведомление если упало (читает токен из
-  `~/.fm-watchdog/telegram-token`).
-- [x] **6. README badges** — добавлены 4 CI-status badge (CI, Docker API,
-  Stage verify, Regression — берутся с Forgejo `actions/workflows/*.svg`)
-  + coverage badge (`badges/coverage.svg`, генерируется
-  `scripts/generate-badges.sh` из cobertura.xml, авто-коммит из CI step
-  «Update coverage badge»).
-
-## Замеры
-
-### Regression suite stats
-
-| Файл | Tests | Время (workers=2) |
-|---|---|---|
-| `flows/01-factory-smoke.spec.ts` | 1 | 5s |
-| `flows/02-auth.spec.ts` | 4 (login/signup/refresh/wrong-pw) | 4s |
-| `flows/03-catalog.spec.ts` | 5 (CRUD product/counterparty/store/price-type) | 6s |
-| `flows/04-documents.spec.ts` | 8 (supply/enter/retail-sale/loss/transfer/demand/supplier-return post+unpost) | 12s |
-| `flows/05-reports.spec.ts` | 4 (sales/stock/profit/abc с проверкой чисел) | 6s |
-| `flows/06-multi-tenant.spec.ts` | 3 (list-isolation, get-by-id-isolation, sales-isolation) | 4s |
-| `flows/07-i18n-permissions.spec.ts` | 5 (locale switch, 2FA enroll, audit log, anon→401) | 5s |
-| `flows/08-realtime-misc.spec.ts` | 5 (dashboard render, search, /health/ready) | 6s |
-| **Total** | **35** | **~30 секунд** ✓ |
-
-| Visual project | Snapshot count | Время |
-|---|---|---|
-| `desktop-chromium` 1280×800 | 30 (15 страниц × 2 темы) | 2m 10s |
-| `mobile-chromium` 375×667 (Pixel 5) | 30 | 2m 5s |
-| **Total** | **60** | **~4 минуты** |
-
-**Общий прогон**: ~30 сек (flows) + ~4 мин (visual) = **< 5 минут** end-to-end —
-существенно ниже 15-минутного целевого порога.
-
-### Coverage badge
-
-- `scripts/generate-badges.sh` берёт cobertura.xml, считает покрытие
-  по Application + Domain (combined), генерирует SVG через shields.io
-  (offline fallback inline).
-- Текущее значение: **80%** (от Sprint 15 baseline).
-- Цвет шкалы: <50% red, 50-69% yellow, 70-84% green, ≥85% brightgreen.
-- CI step «Update coverage badge» (`.forgejo/workflows/ci.yml`) на
-  каждый push в main:
-  1. `dotnet test --collect:"XPlat Code Coverage"`,
-  2. `bash scripts/generate-badges.sh`,
-  3. diff → commit `chore(badges): update coverage [skip ci]` → push.
-
-### Nightly cron
-
-- Скрипт `~/nightly-verify.sh` (217 строк bash).
-- Crontab: `0 4 * * * /home/nns/nightly-verify.sh`.
-- Последовательность:
-  1. `curl /health/ready` — если не Healthy → `~/deploy-stage.sh` → повторная проверка → если опять упала → Telegram + exit.
-  2. `pnpm install` (если node_modules нет) + `playwright test flows/ --grep @smoke`.
-  3. Если воскресенье — полный прогон `flows/ visual/`.
-  4. Telegram-уведомление при провале (`~/.fm-watchdog/telegram-{token,chat}`).
-- Логи: `~/.fm-watchdog/nightly-YYYYMMDD.log`, `find -mtime +14 -delete`
-  чистит каждый запуск.
-
-## Журнал
-
-### 2026-06-07 старт
-Sprint 15 закрыт (7/7 ✓). Поехали по regression-чек-листу.
-
-### 2026-06-07 п.3 (factory) — фундамент
-`tests/regression/factories/OrgFactory.ts` + `api-client.ts` + `types.ts`.
-Builder-pattern: `OrgFactory.for(slug).withProducts(N)…build()`.
-Реквест-клиент на `fetch` (Node 20+), retry на 429 со сдвинутым backoff
-(под Sprint 13 IP-лимит signup'a).
-
-### 2026-06-07 п.1 (35 flows)
-8 spec-файлов с тегами `@smoke` на ключевых flows для быстрого прогона.
-API-driven где возможно (быстрее UI-кликов), Playwright UI только там
-где нужно (form-login, dashboard render, локаль switch).
-
-Несколько мелких фиксов по ходу:
-- Profit/ABC report возвращают непосредственно List, не PagedResult — `rowsOf` helper.
-- Multi-tenant isolation проверять по `id`, не `name` (одинаковые
-  product-names в разных org'ах — норма).
-- Login редиректит на «/» (OnboardingPage) на свежей org, не /dashboard.
-- Loss-endpoint enum'у reason требует int, не строку.
-
-### 2026-06-07 п.2 (visual 60)
-2 spec'a (auth-pages + authenticated-pages). Baseline на свежий
-deploy. Маски на динамический контент:
-- `table td:nth-child(2)` (артикул с Date.now()),
-- `[data-kpi]` (зависит от текущей даты),
-- `[data-delta]` (стрелка от prev period).
-
-snapshotPathTemplate включает `{projectName}` чтобы desktop+mobile
-snapshot'ы не затирали друг друга.
-
-### 2026-06-07 п.4 (forgejo workflow)
-`.forgejo/workflows/regression.yml` — `on workflow_run` после
-Docker API/Web. Cache на pnpm-store + Playwright-browsers. Артефакты
-upload при failure, Telegram-уведомление в обоих случаях.
-
-### 2026-06-07 п.5 (nightly cron)
-`~/nightly-verify.sh` + crontab entry. Health → redeploy → smoke →
-weekly full + Telegram. Логи с ротацией.
-
-### 2026-06-07 п.6 (badges)
-`scripts/generate-badges.sh` — coverage из cobertura.xml → SVG через
-shields.io с offline-fallback. 4 CI-status badge + coverage badge
-добавлены в README. CI-step авто-обновляет coverage badge на push в main.
-
-## Итог
-
-Все 6 пунктов ✓. Локальные числа:
-- **35 flow-тестов**: 35/35 ✓ при workers=2 (~30 сек).
-- **60 visual snapshot'ов**: 60/60 ✓ при CI=1 (retries=1) (~4 мин).
-- **Полный прогон**: ~5 минут — **3× ниже** 15-минутного целевого порога.
-
-Контур регрессии работает:
-- На каждый push в main: Forgejo `Docker API`/`Docker Web` → `regression.yml`
-  → 35 flows + 60 visual + Telegram.
-- Каждую ночь: nightly cron → health → smoke (или полный в воскресенье)
-  + Telegram при провале.
-- Coverage и CI-status badges в README обновляются автоматически.
-
-Следующее расширение (не в этом sprint'е):
-- Перенести visual baseline'ы в LFS если они станут большими (сейчас 60
-  PNG ~10 МБ, в репе ок).
-- Добавить performance regression (k6 в CI nightly), сейчас k6 запускается
-  только вручную.
-- Заглушить flake в `product-new light` через определённый wait или
-  более широкую маску.

docs/sprint17-progress.md

@@ -1,157 +0,0 @@
-# Sprint 17 — onboarding wizard + help + self-diagnostic + changelog
-
-Цель: «новый пользователь не должен теряться» — onboarding wizard за
-4 шага, контекстная help-tooltip-ы, knowledge-base /help, feedback,
-admin self-diagnostic /admin/diagnostic, /whats-new из CHANGELOG.
-
-Старт: 2026-06-07 (после Sprint 16). Исполнитель: Claude Opus 4.7.
-
-## Принципы
-
-- Wizard — skip каждого шага доступен.
-- Help-tooltip-ы — короткие (≤2 предложения) с deep-link на /help.
-- Diagnostic — 7 проверок, async параллельный прогон <1с.
-- НЕ трогать: `global.json`, prod admin.food-market.kz, POS WPF.
-
-## Чек-лист
-
-- [x] **1. Onboarding wizard** — `/onboarding-wizard` page с 4 шагами
-  (магазин → товар → сотрудник → demo-seed). Каждый skip'абельный.
-  После — `localStorage.fm.wizardCompleted=1` и redirect на /dashboard.
-  Playwright тесты 9.1-9.3 (smoke + skip + сохранение).
-- [x] **2. HelpTooltip + topics** — `src/lib/help-topics.ts` с 13
-  topics. `<HelpTooltip topic="key"/>` — popover с title + short +
-  deep-link на /help#key. Click-outside / Esc / aria-expanded.
-- [x] **3. /help knowledge base** — `/help` страница, 7 markdown
-  topics в `src/help/*.md`, загружаются через `import.meta.glob`,
-  custom mini-markdown-renderer (headings, lists, bold, code).
-  Поиск по title + body на клиенте.
-- [x] **4. In-app feedback widget** — `<FeedbackWidget>` в sidebar
-  footer. Modal с 3 категориями (Bug/Suggestion/Question). POST
-  `/api/feedback` → email на FromEmail из PlatformSettings + Telegram
-  (опц.). Rate-limit 5/час per-user.
-- [x] **5. /admin/diagnostic** — `/admin/diagnostic` page для
-  Admin/SuperAdmin. 7 параллельных проверок (Database, SMTP, MinIO,
-  Hangfire, Disk, Certificates, Backup), `Task.WhenAll`, ~1с прогон.
-  🟢/🟡/🔴 индикаторы + Details. Опц. `sendTestEmail` чекбокс.
-- [x] **6. /whats-new + CHANGELOG** — `scripts/generate-changelog.sh`
-  генерирует `CHANGELOG.md` из `git log --grep='feat\|fix'`. Endpoint
-  `/api/whats-new` парсит markdown → последние 30 дней. UI `/whats-new`
-  с группировкой по дате + icon (Sparkles=feat, Bug=fix).
-  Dockerfile.api копирует `CHANGELOG.md` в content-root + создаёт
-  `VERSION` файл из `GIT_SHA` build-arg'a.
-- [x] **7. Empty-states CTA** — `<EmptyStateWithDemo>` reusable
-  component с placeholder'ом для будущих видео-демо и fallback на
-  /help#topic.
-
-## Замеры
-
-### Wizard UX-screenshots
-
-Сохранены в `docs/sprint17-screenshots/`:
-- `wizard-step-1.png` — магазин (название + адрес)
-- `wizard-step-2.png` — первый товар (имя + цена + штрихкод)
-- `wizard-step-3.png` — первый сотрудник (Ф.И.О. + email + роль)
-- `wizard-step-4.png` — demo-данные («Заполнить» / «Не нужно»)
-- `help-page.png` — `/help` с sidebar групп + body topic'ов
-- `admin-diagnostic.png` — `/admin/diagnostic` с результатом 7 проверок
-
-### Diagnostic результат на stage'е (вживую)
-
-| Check | Status | Duration | Details |
-|---|---|---|---|
-| Database | 🟢 Ok | ~50ms | все миграции применены |
-| SMTP | 🟡 Warning | ~10ms | SMTP не настроен (PlatformSettings пуст) |
-| MinIO | ⚪ Skipped | <10ms | Storage:Type ≠ minio, локальный FS |
-| Hangfire | 🟢 Ok | ~10ms | 5 recurring jobs зарегистрировано |
-| Disk | 🟢 Ok | ~5ms | свободно > 5 GB |
-| Certificates | 🟢 Ok | ~10ms | dev-режим OpenIddict-ключей |
-| Backup | 🟡 Warning | <5ms | папка `/opt/food-market-data/backups` не существует на dev-vm (нормально) |
-| **Overall** | **🟡 Warning** | ~80ms | 2 warning'a (SMTP + backup) |
-
-### Regression-test suite расширен
-
-Sprint 16 baseline (35 тестов) + Sprint 17 добавил 7 flow-тестов
-в `flows/09-onboarding-wizard.spec.ts`:
-- 9.1 wizard рендерится с progress-bar
-- 9.2 skip всех 4 шагов → /dashboard + wizardCompleted=1
-- 9.3 сохранение названия магазина → org.name обновлён в API
-- 9.4 /help рендерит topic'и + поиск работает
-- 9.5 /api/admin/diagnostic/run возвращает 7 проверок
-- 9.6 POST /api/feedback ok с минимальным payload
-- 9.7 /api/whats-new возвращает buildVersion + items
-
-**Result**: 7/7 ✓ за ~20 секунд. Suite теперь **42 flow + 60 visual + 6 wizard-screenshots**.
-
-### Bundle impact
-
-| | До Sprint 17 | После | Δ |
-|---|---|---|---|
-| Initial JS (raw) | 706.76 KB | **723.37 KB** | +17 KB |
-| Initial JS (gzip) | 196.50 KB | **200.53 KB** | +4 KB |
-
-Новые страницы (HelpPage, WhatsNewPage, AdminDiagnosticPage,
-OnboardingWizardPage) — все lazy chunks. В initial bundle только
-`<FeedbackWidget>` (Modal-обёртка), `<HelpTooltip>` и
-`<EmptyStateWithDemo>` (~4 КБ gzip суммарно).
-
-## Журнал
-
-### 2026-06-07 старт
-Sprint 16 закрыт (6/6 ✓). Поехали по onboarding-чек-листу.
-
-### 2026-06-07 п.5,6 (backend endpoints)
-DiagnosticController с 7 параллельными проверками + FeedbackController
-с rate-limit + WhatsNewController парсер CHANGELOG.md.
-
-### 2026-06-07 п.1 (wizard)
-`OnboardingWizardPage` с 4 step-компонентами. State через useState,
-api-mutate через TanStack Query. `/onboarding-wizard` маршрут.
-Skip-кнопка в footer'е каждого шага. `fm.wizardCompleted` в
-localStorage предотвращает повторный показ.
-
-### 2026-06-07 п.2-3 (HelpTooltip + /help)
-`help-topics.ts` с 13 keys. `<HelpTooltip>` с click-popover, aria-label,
-Esc/click-outside dismiss. `/help` страница — `import.meta.glob` на
-`src/help/*.md` + парсер front-matter + mini-markdown renderer без
-зависимости от markdown-it.
-
-### 2026-06-07 п.4 (feedback widget)
-`<FeedbackWidget>` в sidebar footer. Modal с 3 категориями. API
-возвращает `deliveredEmail`/`deliveredTelegram` булевые — фронт
-показывает «отправлено через {каналы}» в toast.
-
-### 2026-06-07 п.7 (empty-state)
-`<EmptyStateWithDemo>` reusable. Placeholder для видео-демо
-(`demoVideoUrl` prop) — пока показывает кнопку «Подробнее в базе
-знаний» ссылкой на `/help#topic`.
-
-### 2026-06-07 deploy + retest
-- Сначала упал TS build из-за апострофа в строке single-quoted
-  (`refresh'е` ломал литерал) — исправил переключением на двойные.
-- Неиспользуемый interface `OrgSettings` — удалил.
-- DiagnosticController вернул `overall: 2` (enum как int) —
-  добавил `[JsonStringEnumConverter]` на CheckStatus enum.
-- 7/7 wizard/help/diagnostic/feedback/whats-new e2e тестов ✓.
-- 6 wizard-screenshots сохранены в `docs/sprint17-screenshots/`.
-
-## Итог
-
-Все 7 пунктов ✓. Локальные числа:
-- **Wizard**: 4 шага + skip, 7 Playwright тестов ✓ за 20 секунд.
-- **Help**: 7 markdown topics + 13 keys в HelpTooltip mapping.
-- **Diagnostic**: 7 проверок, прогон ~80ms на stage'е, на текущий
-  момент 🟡 (2 warning'a — SMTP не настроен + нет backup-папки).
-- **Feedback**: email + Telegram дубль, 5/час rate-limit.
-- **CHANGELOG**: 307 строк из git log за 90 дней.
-- **/whats-new**: возвращает buildVersion + items до 30 дней назад.
-- **Regression suite**: **42 flows + 60 visual + 6 wizard-shots** ✓.
-
-Следующее расширение (TODO для будущих спринтов):
-- Расставить `<HelpTooltip>` рядом с заголовком на Loyalty, Promotions
-  и других новых страницах — компонент готов.
-- Banner «Появились новые функции» при mismatch'е
-  `localStorage.fm.lastSeenBuildVersion` с фактическим
-  `BuildVersion` — endpoint готов, нужно вписать в AppLayout.
-- Видео-демо в `<EmptyStateWithDemo>` — placeholder есть, ждём
-  скрин-капсы / видео.