Вітаю. Потрібно зробити простенького бота для працівників складу які вранці будуть скидати фото звіт зі складу. ТЗ написане за допомогою джіпіті. Можна зробити простіше ідеї вітаються. Головне щоб працювало. Крок інструкція - далі фото - і наступний крок. І приходило керівнику.

1) Ціль та очікуваний ефект

• Дисципліна та порядок: щоденні ранкові чек-тури з фото- та чекліст-звітами по зонах відповідальності

2) Ролі користувачів

• Працівник (кладовщик): отримує індивідуальні завдання по своїх зонах; надсилає фото + чекліст; отримує фідбек.

• Старший зміни: бачить дашборд виконання по зміні, приймає/відхиляє звіти, відкриває інциденти.

Мета

Зробити простий Telegram-бот, який щодня о 09:30 надсилає одному працівнику покрокове завдання: сфотографувати ключові зони на двох складах + зону повернень + кладовку. Після завершення бот надсилає зведення менеджеру.

Сценарій (користувач → бот)

1. 09:30 — бот надсилає: “Почати перевірку”.

2. Етап 1 — Склад №1:

   • Фото кожного ряду (видно ряд повністю, прохід не заставлений).

   • Фото загального вигляду складу №1.

   • Правила: товар тільки на стелажах; по артикулах (не змішуємо); на підлозі нічого; підлога чиста; документи відсортовані.

3. Етап 2 — Склад №2:

   • Фото кожного ряду (повна довжина ряду).

   • Фото загального вигляду складу №2.

   • Правила як вище: чистота, проходи, без сміття й “тимчасових” коробок.

4. Етап 3 — Зона повернень:

   • 1 фото зони повернень.

   • Правила: цілі — разом; пошкоджені/неповні — окремо, підписано; нічого на підлозі; розкладено блоками за артикулами.

5. Етап 4 — Кладовка/гардероб/принтер:

   • 1 фото зони.

   • Правила: особисті речі — в шафах; взуття поскладене; підлога чиста; стіл з принтером прибраний; папір/скотч/стрічка в наявності.

6. Фініш — бот показує підсумок “Звіт відправлено менеджеру”.

Негайні відхилення фото (бот показує підказку і просить перезняти)

• Видно не весь ряд або загороджені проходи.

• Товар на підлозі чи змішані артикули.

• Сміття/плівка/коробки у робочій зоні.

• Нерізке/темне фото.

Ролі

• Працівник (1 Telegram ID) — проходить 4 етапи.

• Менеджер (1 Telegram ID) — отримує зведення (список фото з мітками: Склад1/Склад2/Повернення/Кладовка) одним повідомленням.

Результат для менеджера

Після завершення — одне повідомлення типу:

• “Іван — 09:43.
  📸 Склад №1 — 3 фото (ряди + загальне)
  📸 Склад №2 — 3 фото (ряди + загальне)
  📸 Повернення — 1 фото
  📸 Кладовка — 1 фото”
  (опціонально — альбомом/галереєю).

Де розгортаємо це в Laravel і як

Техстек

• Laravel 10/11 (твій існуючий проєкт).

• БД: SQLite/PostgreSQL (на пілот можна SQLite).

• Черги: Redis (або sync для тесту).

• Файли: локально storage/app/public/photos (на пілот), далі — S3/MinIO.

Пакети (composer)

composer require irazasyed/telegram-bot-sdk:^3.0 predis/predis:^2.0

(Якщо вже маєш інший SDK — ок.)

ENV (приклад)

TELEGRAM_BOT_TOKEN=xxxx

TELEGRAM_BOT_NAME=warehouse_pilot_bot

APP_URL=https://your-domain

TIMEZONE=Europe/Warsaw



REDIS_HOST=127.0.0.1

REDIS_PASSWORD=null

REDIS_PORT=6379

QUEUE_CONNECTION=redis   # або sync на пілот

Роути

POST /bot/telegram/webhook   # прийом апдейтів

Контролер/Сервіс

• App\Http\Controllers\BotWebhookController@handle — приймає апдейти, керує стейтом “який етап/який ряд”.

• Простий стан у БД: хто на якому кроці, скільки фото вже є.

Мінімальні таблиці

• bot_users (id, telegram_id, role[worker|manager], name).

• runs (id, worker_id, date, started_at, finished_at, status).

• run_photos (id, run_id, stage[wh1|wh2|returns|cloak], note, path, created_at).
  (На пілот KPI/чекбокси не зберігаємо — тільки фото і етап.)

Планувальник (Scheduler)

• У app/Console/Kernel.php:

  • 09:30 Europe/Warsaw — джоб “SendMorningReminderToWorker” → надсилає “Почати перевірку”.

Webhook

Після деплою:

curl -F "url=https://your-domain/bot/telegram/webhook" \

  https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook

Деплой

• Все в існуючому Laravel-проєкті.

• Для тесту достатньо nginx + PHP-FPM + HTTPS (Let’s Encrypt).

• На прод — Supervisor для queue:work (або поки QUEUE_CONNECTION=sync).

Обсяг робіт фрілансера

Що зробити

1. Підключити Telegram webhook у Laravel.

2. Реалізувати покроковий флоу з 4 етапами (включно з підказками “як має виглядати фото”).

3. Зберігати фото локально, групувати за “ранком/датою/етапом”.

4. Після завершення — відправляти менеджеру зведення (одне повідомлення з альбомом).

5. Команди для планувальника та інструкція з налаштування webhook.

6. Налаштувати простий “reset” командою /reset для пілоту (скинути прогрес).

Прийомка

• О 09:30 працівник отримує нагадування.

• Проходить усі 4 етапи, бот приймає придатні фото, відхиляє непридатні (за правилами вище).

• Менеджер отримує одне підсумкове повідомлення з фото та позначками етапів.

• Повторний запуск у той же день можливий командою /start або /reset (для тестів).

Передача

• Репозиторій (Git) + README.md з інструкцією.

• .env.example заповнений полями бота.

• Міграції (bot_users, runs, run_photos).

• Команди: php artisan schedule:work (на тест), php artisan queue:work (за потреби).

• Налаштування Supervisor (опційно).

Додаток: еталонні підказки до фото (виводити в боті перед кроком)

Склад №1 (кожен ряд + загальне):
— Ряд у кадрі повністю; проходи чисті; товар на стелажах, не на підлозі; без “тимчасових” коробок; артикули не змішані.
Склад №2 (кожен ряд + загальне):
— Те саме: повна довжина ряду, чисто, відсутні зайві речі, артикули окремо.
Зона повернень:
— Цілі — разом; пошкоджені/неповні — окремо й підписані; нічого на підлозі; порядок видно на фото.
Кладовка/принтер:
— Особисті речі в шафах; взуття поскладене; підлога чиста; стіл з принтером прибраний; є папір/скотч/стрічка.

Цей текст можна прямо публікувати на фріланс. Якщо треба — зберу з цього PDF/Word і віддам файлом разом із коротким шаблоном відповіді для кандидатів, щоб простіше порівнювати пропозиції.