Інструкції менеджера-впроваджувача 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) розвіз останньої милі (Зібрати з замовлень → Оптимізувати → карта). Доповнює менеджерську серію знизу — той рівень «як користуватись», якого серія свідомо не покриває.
Структура кожного документа (шаблон)¶
- Що за модуль і навіщо (+ болі клієнта, орієнтири-конкуренти)
- Ключові поняття (словник для менеджера)
- Що налаштувати (довідники + залежності)
- Документообіг (повна схема)
- Потоки інформації (звідки/куди дані — точки інтеграції)
- Наскрізний демо-сценарій (готовий скрипт показу на наших даних)
- Чек-лист впровадження
- Точки інтеграції та зв'язок із серією
- Інтеграція у F1-довідку (план)
Зв'язок із вбудованою довідкою (F1)¶
Кожен документ серії — джерело для вбудованої довідки DOP (кнопка F1/Help на формах і
довідниках, фреймворк frontend/core/src/components/Help/). При інтеграції матеріал ріжеться
на статті по сутностях через skill add-help-article (двомовні *.md + *.ua.md).
Розділ «Інтеграція у F1-довідку» в кінці кожного документа фіксує, на які статті він
розкладається.