mirror of
https://github.com/gromlab-ru/slm-design.git
synced 2026-08-22 07:30:16 +03:00
114 lines
4.8 KiB
Markdown
114 lines
4.8 KiB
Markdown
|
# 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 в доменные исходы.
|