# mocl — RoboStar v2 (PostgreSQL platform)

Generic-ядро для local-first приложений.

**Источник правды по архитектуре** — [ARCHITECTURE.md](ARCHITECTURE.md).
Там: фиксированные решения, схема ядра, протокол RPC, текущее состояние, риски, следующие шаги.

## Стек
- PostgreSQL 16 + PL/pgSQL процедуры
- Node + TypeScript + `pg` + WebSocket
- Redis (qmanager: кэш + pub/sub между node-инстансами)
- Vite + Lit + OPFS + `@sqlite.org/sqlite-wasm`

## Быстрый старт (dev)
```bash
cp .env.example .env
docker compose up -d           # postgres + redis + adminer
cd server && npm install && npm run migrate && npm run dev
cd ../client && npm install && npm run dev
```

## Структура
- `db/migrations/` — пронумерованные .sql миграции (registry-схема + триггеры)
- `db/procedures/` — PL/pgSQL процедуры (заполняется доменом)
- `server/` — Node + TS API + WS + qmanager
- `client/` — Vite + Lit + OPFS+SQLite клиент

## Status: scaffold
Это каркас. Бизнес-логики (домена) НЕТ — она подключается отдельным модулем.
Старый стек `/var/www/robostar/` продолжает работать параллельно.