chore: demo app

examples/react-vite/README.md

@@ -0,0 +1,113 @@
+# SLM Store
+
+Облегчённое React + Vite приложение по Scoped Layered Module Design. Оно использует только маленький контракт [`../demo-backend/openapi/simple.json`](../demo-backend/openapi/simple.json); `complex.json` намеренно не включён в runtime-граф.
+
+## Возможности
+
+- JWT login, однократный конкурентный refresh и idempotent logout.
+- Вход под admin и customer demo-учётными записями.
+- Каталог с поиском, категориями, сортировкой и offset pagination.
+- Admin create, update с optimistic locking и delete продукта.
+- Draft order с фиксацией версии и цены продукта.
+- Checkout, stock/currency validation, история и отмена заказов.
+- Собственные доменные модели, исходы и runtime-проверка внешних ответов.
+
+## Запуск
+
+Требуются Node.js 20+ и npm 10+.
+
+Сначала запустите Simple backend:
+
+```bash
+cd examples/demo-backend
+npm install
+npm run dev:simple
+```
+
+Затем в отдельном терминале запустите frontend:
+
+```bash
+cd examples/react-vite
+npm install
+npm run dev
+```
+
+Frontend откроется на `http://localhost:5173`, backend работает на `http://localhost:3001`.
+
+## Demo-пользователи
+
+| Роль | Email | Пароль |
+|---|---|---|
+| Administrator | `admin@demo.local` | `demo1234` |
+| Customer | `customer@demo.local` | `demo1234` |
+
+## Конфигурация
+
+```bash
+cp .env.example .env
+```
+
+| Переменная | Назначение | Значение по умолчанию |
+|---|---|---|
+| `VITE_SIMPLE_API_URL` | Base URL Simple API | `http://localhost:3001` |
+
+Access token живёт в памяти вкладки. Refresh token хранится в `sessionStorage` и очищается вместе с session-scoped SWR cache при logout или окончательном истечении сессии.
+
+## OpenAPI
+
+Generated-код находится в `src/infra/simple-rest-api/generated` и не редактируется вручную. Регенерация использует зафиксированную версию `@gromlab/api-codegen`:
+
+```bash
+npm run codegen:simple-rest-api
+```
+
+OpenAPI ошибочно описывает `page` и `limit` через пустую `Object` schema. Исправленный browser-контракт локализован внутри `infra/simple-rest-api/types`; generated-файлы остаются неизменными.
+
+## SLM
+
+SLM root: `src`.
+
+| Слой | Владельцы и ответственность |
+|---|---|
+| `app` | Vite entry, router, application providers и cache lifecycle |
+| `compositions` | `sign-in`, `storefront`, `app-shell`; только размещение и связывание публичных API |
+| `domains` | `session`, `catalog`, `orders`; модели, сценарии, исходы, состояние, UI и source adaptation |
+| `infra` | `simple-rest-api`; generated SDK, transport credentials, refresh race и SWR GET-хуки |
+| `ui` | Универсальные `button` и `field` |
+| `shared` | Чистые formatters и value predicates |
+
+Свёрнутый граф модулей:
+
+```text
+app -> compositions
+app -> domains
+compositions -> compositions
+compositions -> domains
+domains -> infra
+domains -> ui
+domains -> shared
+```
+
+Каждый внешний импорт проходит через корневой `index.ts` целевого модуля. В корне модуля находятся только публичные фасеты и не более одного главного implementation/assembly-файла; context, hooks, source, types и прочая реализация находятся в сегментах.
+
+### Владение состоянием
+
+| Состояние | Владелец | Область жизни |
+|---|---|---|
+| Пользователь и session status | `domains/session` | Всё browser-приложение |
+| JWT credentials и refresh promise | `infra/simple-rest-api` | Вкладка / transport singleton |
+| Product/order server state | REST hooks + доменная адаптация | Application SWR cache |
+| Draft order | `domains/orders` | Авторизованный storefront route |
+| Фильтры и editor state | `domains/catalog` | Экземпляр CatalogPanel |
+
+## Проверки
+
+```bash
+npm run lint
+npm run typecheck
+npm run test
+npm run build
+npm run check
+```
+
+Тесты покрывают полный login-to-checkout smoke, объединение конкурентных 401 в один refresh и независимое преобразование source errors в доменные исходы.