133 lines
8.2 KiB
Markdown
133 lines
8.2 KiB
Markdown
# food-market
|
||
|
||
<!-- quality-badge --> 🟡 **Quality:** [`docs/quality-status.md`](docs/quality-status.md) <!-- /quality-badge -->
|
||
|
||
[](http://192.168.1.193:3000/nns/food-market/actions)
|
||
[](http://192.168.1.193:3000/nns/food-market/actions)
|
||
[](http://192.168.1.193:3000/nns/food-market/actions)
|
||
[](http://192.168.1.193:3000/nns/food-market/actions)
|
||
|
||
|
||
Аналог системы МойСклад для розничной торговли в Казахстане. Multi-tenant
|
||
SaaS + web-админка + Windows-касса. Поддерживает 8 типов документов учёта,
|
||
ОФД-интеграцию (scaffolding), кассу на POS WPF с offline-буфером, отчёты,
|
||
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.application/ # DTO, FluentValidation, MediatR-handler'ы, Mapster.
|
||
│ ├── food-market.infrastructure/ # EF Core, миграции, Identity, OpenIddict storage.
|
||
│ ├── food-market.api/ # Controllers (60), middleware, Hangfire jobs (10 recurring), OpenIddict server.
|
||
│ ├── food-market.web/ # React 19 SPA админки.
|
||
│ ├── food-market.public/ # Astro marketing-сайт.
|
||
│ ├── food-market.shared/ # DTO-контракты сервер↔POS.
|
||
│ ├── 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 Python smoke.
|
||
│ └── load/ # k6 (нагрузочные).
|
||
├── deploy/ # Dockerfile.{api,web,public}, compose, nginx, prod-toolchain.
|
||
├── docs/ # 50+ markdown файлов.
|
||
└── food-market.sln
|
||
```
|
||
|
||
## Ключевая документация
|
||
|
||
- **[ARCHITECTURE.md](docs/ARCHITECTURE.md)** — общая картина: слои, deployment, что реализовано / scaffolding / не реализовано.
|
||
- **[ONBOARDING.md](docs/ONBOARDING.md)** — first 3 days для нового разработчика.
|
||
- **[glossary.md](docs/glossary.md)** — все доменные термины с ссылками на код.
|
||
- **[MULTI-TENANCY.md](docs/MULTI-TENANCY.md)** — как изолируются org'и.
|
||
- **[api-reference.md](docs/api-reference.md)** — auto-generated список всех 195 endpoint'ов.
|
||
- **[error-codes.md](docs/error-codes.md)** — каталог HTTP-кодов для humanizeError на фронте.
|
||
- **[secrets.md](docs/secrets.md)** — env-vars + где хранятся секреты.
|
||
- **[RUNBOOK.md](docs/RUNBOOK.md)** — операционные процедуры (что делать при инциденте).
|
||
- **[performance-baseline.md](docs/performance-baseline.md)** — k6 цифры + bottleneck'и.
|
||
|
||
## Мультитенантность
|
||
|
||
Один процесс API обслуживает много организаций. Каждая видит только свои
|
||
данные через EF Core query-filter по `OrganizationId`. `SuperAdmin` роль
|
||
видит всё. См. [MULTI-TENANCY.md](docs/MULTI-TENANCY.md).
|
||
|
||
## Деплой
|
||
|
||
- **Stage**: `https://test.admin.food-market.kz`. Деплой одной командой:
|
||
```bash
|
||
~/deploy-stage.sh # docker build api+web → push в local registry → ssh prod-vm → 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-история (что было сделано)
|
||
|
||
Хронология в `docs/sprintNN-progress.md`. По состоянию на Sprint 28:
|
||
- **1-7** — фундамент: auth (OpenIddict), multi-tenancy, каталог, документы, кассы.
|
||
- **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).
|
||
|
||
## Лицензия
|
||
|
||
Internal proprietary, не для публикации без разрешения владельца. |