SLM Store

Облегчённое React + Vite приложение по Scoped Layered Module Design. Оно использует только маленький контракт ../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:

cd examples/demo-backend
npm install
npm run dev:simple

Затем в отдельном терминале запустите frontend:

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`

Конфигурация

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:

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

Свёрнутый граф модулей:

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

Проверки

npm run lint
npm run typecheck
npm run test
npm run build
npm run check

Тесты покрывают полный login-to-checkout smoke, объединение конкурентных 401 в один refresh и независимое преобразование source errors в доменные исходы.

4.8 KiB Raw Blame History Unescape Escape