← всі звіти · feedback_report_delivery.md

name: Reports — завжди через Reports Hub, не MD-файли description: Сергій не читає .md файли напряму. Усі звіти віддавати посиланням через http://31.131.26.203/reports/<path>, який рендерить MD у веб-сторінку. type: feedback originSessionId: af564bcd-a210-4cb2-b2be-94d8aace8d83

Формат доставки звітів Сергію

Сергій сказав 2026-04-20 (msg 2113): «Я не вмію читати МД файли» — потрібно віддавати звіти у читабельному форматі.

Why: MD у чистому вигляді — для агентів та розробників. Для клієнт-фасінг ролі Сергія (Digital Lead) потрібна кнопка «відкрив → прочитав → показав клієнту».

How to apply:

  1. Default = Reports Hub (http://31.131.26.203/reports/). FastAPI рендерить MD у чистий HTML із Geist-шрифтом, OKLCH палітрою, нормальними таблицями. Виглядає як Notion, не встидно шарити клієнтам.

  2. Підключені директорії (SOURCES у /srv/reports/server.py):

    • `` (root) → /srv/reports/ — ручне складання
    • crewai/ → /srv/projects/crewai-content/reports/ — автоматично всі CrewAI брифи
    • research/ → /srv/research/ — всі мої research-звіти (додано 2026-04-20, рекурсивний rglob)

  3. Як давати лінки: завжди повний URL http://31.131.26.203/reports/research/2026-04-20/<file>.md, не просто ім'я файлу. Сергій в Telegram клікає і відкриває.

  4. Якщо Reports Hub не підходить (напр. клієнт потребує файл) — альтернативи:

    • PDF (pandoc: pandoc in.md -o out.pdf --pdf-engine=weasyprint)
    • Google Docs через Drive API (треба OAuth)
    • Короткий текст прямо у Telegram-повідомленні

  5. Новий research-звіт → одразу два лінки: повний звіт + короткий executive summary (3-5 bullet) у тілі Telegram-повідомлення. Сергій часто читає тільки summary; повний звіт — коли треба деталі або клієнту.

  6. Index: http://31.131.26.203/reports/ показує всі звіти рекурсивно (rglob з усіх SOURCES, сортовано по mtime desc).