Перейти до змісту

Інструкції менеджера-впроваджувача DOP (серія по модулях)

Ланцюг документів для менеджера, що продає та впроваджує DOP. Кожен документ — по одному модулю: що це, кому продавати, які болі закриває, документообіг, потоки інформації, як показати на демо, чек-лист впровадження — з прикладами на наших демо-даних (анонімізований НІБУЛОН — ТОВ «Зерноплюс»).

Це не операторська інструкція (як натиснути кнопку) і не технічна документація (як влаштований код) — це проміжний шар «бізнес + демо + впровадження».

Документи серії

# Модуль backend Статус
01 Облік зерна (ККУ) shipcore_grain ✅ готово
02 Авто-транспорт fleet / shipcore_auto ✅ готово
03 Логістика та консолідація logistic ✅ готово
Залізниця shipcore_rail ✅ (у складі 02/03)
Морський експорт shipcore_sea
Прохідна / вагова gatehouse
Поле (рослинництво) agro_field

Документи зв'язані між собою посиланнями в точках інтеграції (відвантаження зерна → ТТН/ЖД-накладна → консолідація → морський експорт). Наскрізний бізнес-сценарій, що проходить крізь усі модулі, описаний у blueprint засіювання Зерноплюс (від поля та черги авто перед прохідною до сплати податку на прибуток державі).

Операторський гайд (окремий жанр)

  • Логістика — простими словами, за сценаріямиоператорська інструкція (як натиснути кнопку) для кінцевого користувача, оформлена як самодостатня HTML-сторінка. Три сценарії напрямків потоку: (1) контейнер Київ→Торонто авто-поїзд-море, (2) збір зерна в порт за найменшою ціною (оптимізатор), (3) розвіз останньої милі (Зібрати з замовлень → Оптимізувати → карта). Доповнює менеджерську серію знизу — той рівень «як користуватись», якого серія свідомо не покриває.

Структура кожного документа (шаблон)

  1. Що за модуль і навіщо (+ болі клієнта, орієнтири-конкуренти)
  2. Ключові поняття (словник для менеджера)
  3. Що налаштувати (довідники + залежності)
  4. Документообіг (повна схема)
  5. Потоки інформації (звідки/куди дані — точки інтеграції)
  6. Наскрізний демо-сценарій (готовий скрипт показу на наших даних)
  7. Чек-лист впровадження
  8. Точки інтеграції та зв'язок із серією
  9. Інтеграція у F1-довідку (план)

Зв'язок із вбудованою довідкою (F1)

Кожен документ серії — джерело для вбудованої довідки DOP (кнопка F1/Help на формах і довідниках, фреймворк frontend/core/src/components/Help/). При інтеграції матеріал ріжеться на статті по сутностях через skill add-help-article (двомовні *.md + *.ua.md). Розділ «Інтеграція у F1-довідку» в кінці кожного документа фіксує, на які статті він розкладається.