ShiftOS

Рабочий фундамент цифрового управляющего заведением. Sprint 1, версия 0.1.0.

Открыть демо → · HTTPS · вымышленные данные · вход не требуется

Команда, задачи, чек-листы, меню и обучение в одном рабочем пространстве. ShiftOS помогает видеть состояние смены и следующий шаг — от экрана владельца до телефона сотрудника.

Архитектура · Развёртывание · План развития · Разработка · Безопасность

Доступно сейчас	Следующий этап
Интерактивное демо desktop + mobile	Реальный пилот с отдельным Supabase-проектом
Основа Auth, multi-tenant RLS и операций с задачами	Приглашения, исполнители и история чек-листов
Независимый AI gateway, отключённый в production	AI на проверенных фактах, с квотами и аудитом

Это ранняя версия продукта. Демо использует вымышленные данные; готовность интерфейса не означает, что все модули уже подключены к рабочей базе.

Быстрый запуск

Требуется Node.js 22.14+ и npm. Версии зависимостей закреплены в package-lock.json.

git clone https://github.com/arturuseinov49-collab/ShiftOS.git
cd ShiftOS
npm ci
npm run dev

Откройте http://127.0.0.1:3000/demo. Ключи не нужны. Демо отделено от базы, содержит вымышленные заведения и людей. Задачи и отметки чек-листов сохраняются только в localStorage этого браузера. Сброс: Настройки → Сбросить демо-данные. Числа на обзоре рассчитываются из текущих данных.

Что реализовано

• Next.js 16 App Router, TypeScript strict, Tailwind 4, локальные компоненты shadcn/ui (Radix).
• Адаптивный dashboard, мобильная навигация, разделы задач, чек-листов, команды, меню, обучения, AI и настроек. В демо работают создание/выполнение задач, поиск, фильтры, переключение заведений, отметки чек-листов, чтение учебных материалов и сброс состояния.
• Supabase SSR: отдельные browser/server clients, обновление cookie в proxy.ts, проверка пользователя на сервере, вход/регистрация по почте и паролю, PKCE callback, выход.
• /workspace: список доступных организаций и атомарное создание организации, заведения, ролей и owner membership. /workspace/[organizationId]/[section]: реальные данные через RLS.
• Server Actions создания задачи и изменения её статуса с Zod и проверкой tasks.write.
• 20 публичных таблиц, private answer keys, миграции RLS, RBAC и Storage. Типы получены из проверенных миграций, воспроизводятся через npm run db:types.
• Независимый AI gateway, интерфейс провайдера, тестовый адаптер, timeout/abort. API /api/ai/briefing получает факты только после проверки пользователя, организации и ai.use.
• Контракты событий и место под vision. Камеры, видео и распознавание не реализованы.

Подключить Supabase

1. Создайте отдельный пустой проект Supabase. Существующую базу другого продукта не используйте.
2. Примените по порядку оба файла из supabase/migrations через SQL Editor Supabase. Альтернатива: Supabase CLI supabase link --project-ref <ref> и supabase db push.
3. Скопируйте .env.example в .env.local, заполните NEXT_PUBLIC_SUPABASE_URL и NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY из Connect. Для обычного приложения service role не нужен.
4. В Auth → URL Configuration укажите Site URL http://127.0.0.1:3000 и Redirect URL http://127.0.0.1:3000/auth/callback. При использовании localhost добавьте его отдельно. Включите email/password и подтверждение почты, минимальный пароль 12 символов.
5. Перезапустите приложение, откройте /login, зарегистрируйтесь и подтвердите почту в том же браузере (PKCE). Затем войдите, создайте организацию и первую задачу.

Для локального Supabase нужны Docker и Supabase CLI: supabase start, затем supabase db reset. db reset удаляет данные локальной базы, используйте только для одноразового dev-окружения. supabase/config.toml уже включён. В этой среде Docker/Supabase не запускались; Auth, SMTP, Storage HTTP API и реальный PostgREST требуют отдельной интеграционной проверки.

Для сервера подготовлены standalone-сборка, systemd и Caddy с HTTPS. Отдельная рабочая база Supabase подключается по инструкции выше; её создание не входит в установку веб-приложения. Порядок запуска и отката описан в руководстве.

Структура

src/
  app/
    demo/[[...section]]/        публичное, изолированное демо
    login/                     вход и регистрация
    auth/callback/             обмен PKCE-кода на сессию
    workspace/                 выбор/создание организации
      [organizationId]/...     защищённое рабочее пространство
    api/ai/briefing/            серверная граница AI
    api/health/                проверка доступности приложения
  components/
    ui/                        shadcn/ui
    workspace/                 адаптивная оболочка и экраны
  lib/
    supabase/                  typed clients + database.types.ts
    env.ts                     доступность конфигурации
  modules/
    identity/                  пользователь, tenant, onboarding
    tasks/                     безопасные действия с задачами
    workspace/                 модели представления, демо, repository
    ai/                        gateway, contracts, providers
    events/                    контракт будущей доставки событий
    vision/                    граница будущего модуля
  proxy.ts
supabase/
  migrations/                  схема, политики, приватный bucket
  config.toml
scripts/                       PostgreSQL test harness и генерация типов
tests/                         изоляция организаций и AI gateway
e2e/                           проверки desktop/mobile
docs/                          архитектура, границы и следующий спринт
deploy/                        установка, релизы, systemd и Caddy
.env.example
.github/workflows/ci.yml

Проверки

npm run lint
npm run typecheck
npm test
npm run build
npm run db:types
npx playwright install chromium
npm run test:e2e

npm test выполняет миграции в настоящем PostgreSQL движке PGlite/WASM. В тестах auth.uid() и служебные схемы Supabase моделируются: это проверка SQL/политик, не интеграционный тест всего Supabase. Playwright запускает production build на порту 3100; предварительно выполните npm run build.

Ограничения первого спринта

• UI команды/меню/обучения в live-режиме пока только читает данные. Приглашений и редакторов нет.
• Live-чек-листы показывают шаблоны; выполнение смен/история не подключены. В демо отметки работают.
• Нет POS/складских данных, выручки, учёта присутствия, live-AI, grading тестов, уведомлений или vision.
• Роль staff по умолчанию имеет только чтение базовых модулей. Менеджер пишет рабочие данные. Прямое изменение memberships/roles/role_permissions через клиент закрыто для всех.
• Права пока уровня организации; выбор заведения — фильтр, не дополнительная граница доступа.
• Списки задач, сотрудников и меню ограничены первыми 200 записями. Это стартовая выборка, не аналитическое хранилище. Пагинация и полные агрегаты нужны до роста пилота.
• users — глобальный профиль собственной учётной записи; permissions — глобальный справочник. Все рабочие сущности и связи принадлежат organization_id.
• AI_PROVIDER=disabled по умолчанию. mock работает только в development/test, без внешней модели. В production провайдер закрыт до добавления квот, журнала запросов и проверки интеграции.

Следующий конкретный шаг

Подключить отдельный Supabase dev-проект и пройти сквозной сценарий: два аккаунта → две организации → заведения → задачи → проверка отсутствия доступа к чужой организации. Затем второй спринт: приглашение сотрудников, назначение ролей через защищённые RPC, назначение задач исполнителям и реальные запуски чек-листов с историей выполнения.

Источники решений: Next.js App Router, Supabase SSR, Supabase RLS, Storage access control, shadcn/ui.

Лицензия

Открытая лицензия пока не выбрана. Публичная доступность репозитория не означает предоставления разрешения на использование, распространение или коммерческое применение кода.