Обзор

Принятое направление · решено 2 октября 2026 · ничего не реализовано

Согласованное решение — одно приложение и для управляющих, и для сотрудников: в браузере и, пока, на телефонах через Capacitor, — а за ним один API. Ничего из этого ещё не создано.

Одно приложение, две роли. Управляющий и сотрудник открывают одно и то же приложение и видят разные его части.

Из чего это состоит

Часть	Что она будет делать	Статус
Приложение	Здесь управляющий описывает магазин, проверяет и публикует график, а сотрудник видит свои смены и просит об изменениях. Одна кодовая база на Nuxt.	Принятое направление, не создано
Мобильное приложение	То же приложение, упакованное для iOS и Android с помощью Capacitor.	Принято на сейчас, не создано
API	Хранит магазины, команды, правила, графики и запросы на изменения; всё, что показывает приложение, приходит из него. На NestJS.	Принятое направление, не создано
Агент составления графика и солвер	Превращают просьбы людей в ограничения, строят график и объясняют результат.	Гипотеза; солвер для первой версии выбран — см. Агент и солвер
Ассистент сотрудника	Принимает просьбу об изменении обычными словами, проверяет правила и готовит одно решение для управляющего.	Предложение — см. Ассистент сотрудника

Как части будут связаны — это целевая схема, а не работающая система:

      Управляющий              Сотрудник
            \                     /
      ┌───────────────────────────────┐
      │  Приложение (Nuxt)            │   браузер · iOS и Android
      │  одна кодовая база, две роли  │   через Capacitor
      └───────────────┬───────────────┘
                      │
      ┌───────────────┴───────────────┐
      │  API (NestJS)                 │
      └───────┬───────────────┬───────┘
              │               │
     агент составления    ассистент
     графика и солвер     сотрудника

Одно приложение на телефонах, через Capacitor — пока

Мобильное приложение — не второй продукт. Это то же приложение, которое управляющий может открыть в браузере, упакованное для iOS и Android с помощью Capacitor, а не написанное дважды как нативные приложения.

Что это значит для людей, которые им пользуются:

• Управляющий и сотрудник устанавливают одно и то же приложение. Что увидит каждый из них, определяет роль в учётной записи.
• Управляющий может работать и в браузере. Это то же самое приложение, а не отдельная панель администратора.
• «Пока» — часть решения. Capacitor — выбор для старта, а не навсегда. Что заставит нас его заменить и на что, не решено.

Остаётся открытым: как приложение распространяется, как люди узнают о новом графике или о решении, которое их ждёт, и работает ли что-нибудь без связи. Смогут ли сотрудники писать ещё и из мессенджера, которым уже пользуются (Telegram, Viber, WhatsApp), — открытый вопрос.

Как будет организован код

NestJS для API и Nuxt для приложения, организованные по CleanSlice — соглашению, по которому построены другие наши продукты: код сгруппирован по возможностям продукта, а не по техническим слоям.

Это выбор инструментов, а не проект функций. Модели данных, списка методов API и экранов пока нет.

Агент и солвер

Расставить людей по сменам при жёстких правилах — задача оптимизации, и специализированные солверы хорошо с ней справляются. Наше рабочее допущение: языковая модель сама эту арифметику не делает. Она понимает просьбу, превращает её в ограничения, вызывает солвер и объясняет результат. Это гипотеза, которой нужен прототип. На странице Агент и солвер описано, что такое солвер, какие инструменты получит агент и почему солвер — это сервис, а не MCP-сервер.

Не решено

• База данных и где она размещена — а значит, и где хранятся данные сотрудников; это нужно определить до любого пилота.
• Какая языковая модель и где работает агент — внутри нашего API или на внешней платформе. Солвер для первой версии выбран (YALPS); см. Агент и солвер.
• Хостинг для приложения и API. Сегодня развёрнут только этот сайт документации; см. DevOps. Единственное высказанное намерение — что более поздний сервис солвера будет работать в Kubernetes рядом с API.
• Вход в систему и то, как сотрудника приглашают в магазин.
• Уведомления.
• Мессенджер как второй канал для сотрудников.
• Интеграции с кассовыми системами и счётчиками посетителей. Первым способом ввода, скорее всего, будут таблицы; см. Входные данные.
• Отдельная панель администратора и публичный сайт. Ни то, ни другое не спроектировано.

Что читать дальше

• Путь пользователя: что управляющий и сотрудник будут делать в приложении.
• Агент и солвер: что считает график и как агент будет этим пользоваться.
• DevOps: что развёрнуто сегодня.
• Открытые вопросы: что решено, а что нет.
• Две недели до демо: план только для веба к 18 октября; Capacitor — позже.