RetailPOS — Architecture + PRD

• Что это: Point-of-Sale платформа для ритейла («RetailPOS»): продажи, склад, товары/комплекты, учёт остатков по нескольким терминалам с защитой от оверселлинга, офлайн-режим с протоколом синхронизации, десктопная касса. Построена на личном fullstack-скаффолде пользователя (тот же стек, что и fin_fullstack/shipkit).
• Тип / статус / роль: web-app (+desktop) · active · contributor (архитектор / автор спецификаций) — пользователь написал PRD/архитектуру (4 коммита, но это ядро спецификации), основной реализатор — Nuriddinkhuja (23 коммита).
• Активный период: 2026-01-02 → 2026-02-17 (~1.5 месяца), 27 коммитов.

• Monorepo: Turborepo + Bun, .mcp.json (shadcn MCP). Приложения: web (Next.js 16 + React 19, next-intl ru/en/uz, Better Auth, Eden Treaty, Tailwind v4), api (Elysia/Bun + Better Auth + Swagger), admin (Next.js), `desktop` (десктопная касса с офлайн-синхронизацией). Пакеты: auth/cache/cli/db/email/entities/eslint-config/typescript-config/ui — идентичны бойлерплейту пользователя.
• Бэкенд: Elysia + Drizzle ORM + Postgres, версионированные модули /src/modules/v1.
• Документация (ядро вклада пользователя): docs/prd/ — структурированный PRD: 00-overview (336L), 01-architecture (680L), 02-database-schema (1103L), 03-api-specification (1006L), apps/{desktop-app 717L, admin-panel 873L, sync-protocol 809L}, modules/{sales 466L, inventory 308L, products 548L}, 13-roadmap (487L) + поэтапный roadmap.

Подтверждено коммитами/PRD (авторство пользователя):

• Offline-first протокол синхронизации для POS (docs/prd/apps/12-sync-protocol.md, 809L): спроектирован протокол синхронизации десктопной кассы с сервером для работы офлайн — одна из самых сложных задач в POS. → дизайн распределённой консистентности.
• Мультитерминальное резервирование остатков (0e5aaa7, DB schema + API): комплекты товаров + резервирование остатков с защитой от оверселлинга, когда несколько касс продают одновременно. → понимание конкурентности/склада.
• Spec-driven архитектура: ~8000 строк PRD (DB schema 1103L, API spec 1006L) до/параллельно с реализацией — постановка задачи для команды и AI. → роль tech-lead/архитектора.
• Переиспользование личного бойлерплейта: RetailPOS поднят на личном Turborepo-скаффолде (Elysia+Next+Better Auth+Drizzle+Eden) — тот же фундамент, что и fin_fullstack/shipkit. → системность и переиспользуемость.

• Найдено сессий: 0 транскриптов. Директория сессий содержит только sessions-index.json (нет .jsonl). В репозитории есть .claude/ + .claude/commands/roadmap.md (кастомная slash-команда roadmap-status, добавленная пользователем).
• Что делалось с AI: spec-driven процесс — PRD + roadmap + кастомные .claude/commands указывают, что пользователь настроил AI-воркфлоу для команды (агент кодит по PRD).
• Паттерны AI-воркфлоу: PRD-first + кастомные slash-команды для roadmap; пользователь как «архитектор, направляющий AI/команду».

• ~8000 строк структурированного PRD (архитектура, БД, API, протокол синхронизации), написанных пользователем.
• Fullstack POS с web + admin + desktop + офлайн-синхронизацией на одном Turborepo.
• Мультитерминальное резервирование остатков (защита от оверселлинга).
• i18n ru/en/uz.