📖 Инструкция Wally AI

1. Как начать

1. Откройте бота в личке и нажмите «Старт».
2. Нажмите «🔑 Авторизоваться в DodoIS» (или /auth) и войдите рабочим аккаунтом.
3. Бот напишет, сколько пиццерий доступно, и покажет кнопку «📱 Открыть приложение».

Уровень доступа и пиццерии подтягиваются сами — по должности в DodoIS (подробно — «Уровни доступа»). Работаете на нескольких точках — бот привяжет ко всем.

Владелец после покупки подписки в маркетплейсе DodoIS пишет боту /astart → «👑 Авторизоваться как владелец». Бот сам подключит все пиццерии из подписки. После продления — снова /astart.

Открыть приложение: кнопка «Открыть» слева от поля ввода в чате с ботом, «📱 Открыть приложение» в /menu или команда /app. Приложение работает только внутри Telegram.

При первом входе приложение само покажет короткое обучение: подсветит перетарку на складе, главные карточки дашборда и страницу здоровья. «Далее» и «Назад» — по шагам, в конце «Готово». Пройти ещё раз — ⚙️ Настройки → «🎓 Обучение».

2. Как устроено приложение

• Название пиццерии сверху — нажмите, чтобы выбрать другую. Приложение запоминает последнюю. ↻ — обновить данные.
• 🔔 Колокольчик — копии всех сообщений бота: отчёты, аномалии, заявки Алисы, ответы поддержки. Красная цифра — непрочитанные; внутри «Отметить все прочитанными» и «Очистить историю».
• 🎙 Микрофон — круглая кнопка под вкладками (менеджер и заместитель). Нажмите и скажите «спиши перец 2 кг порча» — заявка появится в Склад → Очередь; «будильник на тесто в 14:00» — будильник заведётся сразу. Ещё раз нажать или «Готово» — остановить, «Отмена» — выбросить. Запись до минуты.
• «Подождите, не нажимайте повторно» — идёт долгая загрузка из DodoIS.
• «🔒 Подписка закончилась» вместо данных — у точки кончилась подписка; рядом «🔑 Авторизоваться заново».

3. 📊 Дашборд

Всё главное о точке на одном экране. Сверху — период:

Изменения показаны к прошлому периоду той же длины: «Эта неделя» — к тем же дням прошлой недели, «Прошлая неделя» — к позапрошлой. «📅 Период» — свои даты, не длиннее 92 дней.

Карточки сверху вниз:

• Склад сейчас — перетарка (с учётом тары), минус и что кончается.
• Показатели — выручка, фудкост, списания; стоп-лист.
• Статистика ревизии неделя к неделе и «Неактуальная ревизия»: «Нет в бланке» — остаток есть, а в ревизии позиции нет; «Пора убрать» — в бланке, но на складе ноль 14 дней и дольше.
• Перемещения — сколько отдали и получили, с подсказками.
• Можно переместить в своей сети новое — у вас лишнее, а у соседней пиццерии вашей сети эта позиция кончается. Бот подсказывает, куда, сколько и на какую сумму передать.
• Аномальные приходы — цена за единицу на складе резко изменилась: возможна ошибка в накладной.
• Топ списаний, причины, резкие списания (больше обычного для этой позиции), сравнение пиццерий вашей сети.

4. 🛒 Заказы

Только администратор бота. Поставщик — 🥗 Салатерия: дата поставки → количество упаковок (− и +, или впишите число) → «📄 Сформировать бланк». Дальше «📧 Отправить в Салатерию» (отменить нельзя), «Тестовое письмо себе» или «⏰ Отправить позже».

5. 📦 Склад

С уровня 2. Три раздела: Остатки, Сроки, Очередь.

Остатки и перетарка

• Карточки «минус» (остаток ниже нуля), «кончается» (меньше чем на сутки), «перетарка» (запас больше чем на 8 дней). Нажатие на карточку — только эти позиции; ещё раз — снять фильтр. Есть чипсы и поиск по названию.
• У позиции — количество и на сколько дней хватит. У перетарки — сколько лишнего в рублях и в штуках или килограммах: «лишнего на 2 120 ₽ (45 шт)».
• Переключатель «С учётом тары / Без учёта тары». С тарой норма — 8 дней расхода, но не меньше минимальной поставки: если коробка больше, чем уходит за 8 дней (пита — 144 шт), остаток в пределах одной коробки перетаркой не считается.
• С какого запаса считать перетарку, у каждой пиццерии можно задать своё (по умолчанию 8 дней): ⚙️ Настройки → 🏪 Настройка пиццерий → ⚙️ Другое, с уровня 5.
• «📑 Таблица склада» — Google-таблица «Перетарка — …»: одна на всю сеть, у каждой пиццерии свой видимый лист, редактировать может любой, у кого есть ссылка. Обновляется сама раз в сутки; «🔄 Обновить таблицу сейчас» — сразу.

Сроки

• Будильники по срокам годности, которые ещё не отработаны. Сверху счётчики: «впереди», «≤ 6 часов», «срок вышел».
• У просроченного — «✅ Прошло» и «❗ Списать» (спросит количество и положит в очередь). ✕ — удалить, если продукт кончился раньше.
• Будильники заводятся по фото этикетки в чате, словом «будильник» или кнопкой 🎙.

Очередь списаний

• Сверху — «Заявки от Алисы» и от 🎙: услышанная фраза, позиция, количество, причина. Кнопки «✅ В очередь», «🏷 Причина», «✏️ Кол-во», «❌ Отклонить». Заявка ждёт 30 минут.
• Если позиция в DodoIS учитывается в других единицах (сказали «20 шт», а учёт в кг), будет предупреждение — поправьте «✏️ Кол-во».
• Ниже — списания, которые ещё не внесены в DodoIS. Нажмите на позицию — поменяйте количество, причину, комментарий. ✕ убирает позицию.
• «📤 Внести списания (N)» — отправить всё в DodoIS. Итог: «✅ Списано», «⚠️ Отклонено Dodo» с причиной, «❗ Не найдено в остатках».
• Если DodoIS в этот момент не отвечает, очередь не очищается — отправьте ещё раз позже.

6. 🔎 Ревизия и страница здоровья

С уровня 2. Нужны две завершённые ревизии (недельные или месячные; ежедневные не учитываются).

• «Считать ОТ» и «ДО» — какие ревизии сравнить («Авто — две последние»). «Посчитать» — до минуты, экран обновится сам.
• Карточки «недостача» и «излишки» в рублях; чипсы «>30%», «>1000 ₽», «Шт» и поиск сужают список.
• «📊 Показать статистику» — как отчёт DodoIS «Потери и избыток»: потери, неучтённые, списания, брак, отказы, избыток — в рублях и % выручки, с изменением к прошлому периоду.

Как считаем: ожидаемый остаток = прошлая ревизия + приходы + перемещения к нам − перемещения от нас − расход − списания. Отклонение = новая ревизия − ожидаемый. Минус — недостача, плюс — излишек.

🩺 Страница здоровья по ревизии

Кнопка внизу вкладки «Ревизия». Оценка от A до E: правили ли ревизию в первые сутки после того, как её сняли. Бот запоминает потери, избыток и брак сразу после ревизии и сравнивает через сутки. Если показатели «подкрутили» вниз, оценка падает. Под потерями — сноска «из них списания», ниже «Что нашёл Wally» и диаграмма оценок последних четырёх ревизий (пунктир — средняя, она же оценка точки). Норма — не больше: потери и избыток до 1 %, брак до 0,1 %; ниже нормы баллы не снимаются. Внизу — рейтинг точек с действующей подпиской (по ним идёт сбор ревизий), с названиями. Работает на тарифах «Продвинутый» и «Безлимит» (первые 7 дней — на любом).

7. 📉 Списания

С уровня 4. «Сегодня», «Неделя», «Месяц» — все списания пиццерии из DodoIS по себестоимости с НДС: сумма, причины, топ позиций и сколько внесено через бота. Переключатель «Эта точка / Все точки» — свод по всем своим пиццериям.

8. 🔀 Анализ — сравнение пиццерий новое

С уровня 4, если у вас 2 и больше пиццерий с подпиской. Три шага:

1. Пиццерии — отметьте галочками (или «Выбрать все») и нажмите «Далее». Выбор запоминается.
2. Период — «Сегодня», «Вчера», «Прошлая неделя» (с понедельника), «30 дней», «Текущий месяц» или «📅 Свои даты», затем «Показать».
3. Таблица — по строке на пиццерию. Лучшее значение в столбце — зелёным, худшее — красным.

• Выручка и списания (₽ и % выручки) — за выбранный период.
• Неучтённые потери и излишки — % по последней паре ревизий каждой точки (даты ревизий — под цифрой).
• Перетарка — % склада сейчас, с учётом тары.
• Динамика — стрелка под цифрой: изменение к такому же прошлому периоду (прошлая неделя — к позапрошлой, вчера — к позавчера и т.д.). Зелёная — стало лучше, красная — хуже. Для своих дат динамики нет.
• Сбор идёт до пары минут. «🔄 Пересчитать» — заново, «← Изменить выбор» — к шагу 1.

9. ⚙️ Настройки

Вверху — ваше имя и уровень, внизу — Telegram-id.

❓ Справка

Первый пункт настроек, для всех. Разделы инструкции и поле вопроса: спросите своими словами («где посмотреть перетарку?») — ИИ-помощник ответит по справке. «👍 Помогло» / «👎 Не помогло»: если не помогло, вопрос уходит команде, ответ придёт в бота и в 🔔. Внизу — «🆘 Написать в поддержку».

Личное

• 🌍 Часовой пояс — берётся с телефона при первом входе; можно выбрать вручную.
• 💳 Подписка — сколько дней осталось по каждой пиццерии.
• 🔑 Авторизоваться заново — «👤 Как сотрудник» или «👑 Как владелец». Помогает, если не видно точки, вкладки или уровень не тот.
• 🎓 Обучение — пройти мини-обучение ещё раз.

🏪 Настройка пиццерий новое

С уровня 4. Все настройки точек теперь в одном месте: список ваших пиццерий, у каждой — ряд кнопок.

Остальное администрирование

• 👥 Пользователи (с уровня 4) — все люди ваших точек списком, поиск по имени, @нику или ID, фильтр по уровню; нажмите на человека и выберите уровень — он поставится на всех его точках.
• ➕ Назначить сотрудника (с уровня 4) — уровень, точки, поиск человека по имени, @нику или id → «Назначить». «🔗 Ссылка-приглашение» — одноразовая, на 7 дней, для тех, кто ещё не запускал бота.
• 📋 Мои пиццерии — подписка, часовой пояс, сотрудники, какие чаты не заданы.
• Администратору бота также доступны «🚧 Закрыть приложение» (баннер со своим текстом на время сбоя), «🛠 Пользователи 5+», «📢 Рассылка», «⚙️ Автоматика», «📦 Минимальная тара», «🎯 Эффект Wally» и «🔗 Google для таблиц».

10. Рабочие чаты: как привязать

1. Добавьте бота в рабочую группу и сделайте администратором.
2. Напишите в группе /getid — бот покажет ID (число со знаком минус).
3. ⚙️ Настройки → 🏪 Настройка пиццерий → 💬 у точки → нужный чат → «Изменить» → вставьте ID → «Сохранить».

Группа с темами — вставьте ссылку на тему: тема → ⋯ → «Копировать ссылку». «Пиццерия не привязана к чату» — ID этой группы не указан в настройках.

11. Что делает бот в Telegram

Распознавание фото и голоса живёт в боте, поэтому это делается в рабочих чатах. Подтверждать и править — в приложении.

• Списания текстом и голосом (с уровня 2) — в чате голосового помощника или в личке: «спиши перец 2 кг порча», можно несколько позиций сразу. Бот покажет карточку с кнопками «✅ Добавить», «🏷 Изменить причину», «❌ Отклонить». Причины: срок, порча, упаковка, человеческий фактор, маркетинг (не назвали — «срок»).
• Лист списания — /список: «✅ Внести всё», «🗑 Очистить список». Править позиции — в приложении.
• Фото этикеток — в чат маркировок 🏷 (до 10 фото за раз). Срок в порядке — 👍; кончается до завтра 12:00 — «⚠️ Возможно списание» и кнопка «В будильник»; просрочено — «⚠️ ПРОСРОЧКА!». Распознавание платное, лимит в сутки зависит от тарифа.
• Будильники — из фото, словом «будильник на лук в 13:00» или 🎙 в приложении. Когда срок наступит — «⏰ СРОК ВЫШЕЛ!» с «✅ Прошло» и «❗ Списать». Список — /alarm или Склад → Сроки.
• Напоминания в чаты — замер теста, чек-листы, проверка сроков. Бот отмечает старшего, кто сейчас фактически на смене.
• Отчёты в личку (с уровня 4) — недельный по списанию, минусовой остаток, нулевая цена, нулевой остаток 2 недели, аномальные приходы. Время и вкл/выкл — 🏪 Настройка пиццерий → 🕐.

12. Голосовой навык Алисы

1. Установите «Яндекс — с Алисой», «Яндекс Старт», колонку с Алисой или Яндекс Браузер и войдите в свой Яндекс-аккаунт.
2. На том же устройстве откройте ссылку навыка clck.ru/3VQmvL и нажмите «Добавить».
3. Скажите «Алиса, запусти навык списание Додо». В первый раз Алиса отправит заявку на подключение — после подтверждения ответит «Навык подключён».
4. Говорите: «спиши лук 2 килограмма срок». Алиса ответит «Записала, подтвердить можно в приложении».

13. Уровни доступа

Каждый уровень умеет всё, что предыдущие. Выдаётся сам по должности в DodoIS.

14. Подписка и тарифы

• Подписка — отдельно на каждую пиццерию, в маркетплейсе DodoIS. Новой точке первые 7 дней дашборд и страница здоровья открыты в подарок.
• Подписка закончилась — точка остаётся с 🔒, данные и настройки сохраняются. Продлили — владелец проходит /astart, и всё работает сразу.

15. Частые вопросы

16. Поддержка

• ⚙️ Настройки → ❓ Справка — вопрос своими словами; в боте то же — /ask.
• «🆘 Написать в поддержку» внизу справки или /reports в боте — ответ придёт в бота.