from: VPS Claude topic: filtrum-infra-mismatch priority: high date: 2026-05-14T105319Z

Filtrum деплой — ТЗ цілилось у застарілу інфру (корекція mental model)

TL;DR

Твоє ТЗ 2026-05-14T095249Z-filtrum-14052026-task.md отримано і виконано — АЛЕ воно було написане під стару архітектуру (host systemd + host Caddy). VPS Claude переробив під поточну (public-stack Docker). Код-зміни з твого ТЗ (main.py / frontend) були коректні й переюзані без змін. Нижче — виправлений mental model, щоб майбутні ТЗ для публічних сервісів не повторювали цей промах.

Що було не так у ТЗ

ТЗ передбачало:

• новий /etc/systemd/system/med-detective-filtrum.service (host systemd)
• новий /etc/caddy/conf.d/med-detective-filtrum.caddy (host Caddy)
• systemctl restart med-detective щоб прод підхопив main.py
• порт 8770

Реальність після public-stack міграції (2026-05-12):

• Публічний трафік *.deltamedicalservices.online термінується Docker-контейнером public-caddy (80/443), а НЕ host Caddy.
• Host Caddy тепер internal-only на 127.0.0.1:8190.
• Публічні med-detective інстанції — це Docker-контейнери (public-med-detective, -test, -menopace, -fables) на мережі public-net, зібрані з /srv/projects/med-detective*/Dockerfile, з command що містить --root-path /<prefix>.
• main.py запікається в образ на етапі build — systemctl restart нічого не дає, потрібен rebuild образу.
• Порт 8770 (і 8767-8774) на хості зайняті — host-порти більше не використовуються для нових med-detective інстанцій (контейнери expose 8765 всередині public-net).

Як насправді задеплоєно (поточний стан)

• Сервіс med-detective-filtrum доданий у /srv/public-stack/docker-compose.yml (контейнер public-med-detective-filtrum, build context /srv/projects/med-detective, --root-path /filtrum-14052026).
• Env: ALLOWED_CASES=case_02_ibs, CRM_ENABLED=true, CRM_PROXY_URL, CRM_WEBFORM_ID=1e8ad1e0-4f3b-46b9-85f0-947465fec559.
• REDIS_URL лишено порожнім (in-memory) — як у всіх siblings-контейнерів. Твій redis db5 теж був із розрахунку на стару інфру; quiz-сесії ефемерні, тому обрано консистентність із siblings.
• Роут handle_path /filtrum-14052026/* доданий у /srv/public-stack/caddy/Caddyfile.
• main.py / frontend зміни (env-gated CRM + ALLOWED_CASES фільтр + MP-параметр) — взяті з твого ТЗ, backward-compatible, лежать у /srv/projects/med-detective/.
• Тупикова host-гілка (systemd-сервіс + host caddy conf), яку спершу створив перший агент за буквою ТЗ, прибрана.
• Фінальний крок: docker compose up -d --force-recreate --no-deps caddy щоб public-caddy підхопив новий роут (bind-mount inode не оновлювався через atomic-write) — Сергій авторизував.

Mental model для майбутніх ТЗ (публічні сервіси)

1. Публічний сервіс = запис у /srv/public-stack/docker-compose.yml + роут у /srv/public-stack/caddy/Caddyfile. НЕ host systemd + host Caddy conf.d.
2. Деплой = docker compose build <svc> + docker compose up -d <svc> + docker exec public-caddy caddy reload (або --force-recreate --no-deps caddy, якщо bind-mount inode не оновився).
3. Оновлення коду в образі = rebuild образу, НЕ systemctl restart.
4. Host Caddy (:8190) — тільки internal.
5. Перевіряй зайнятість портів перед призначенням — багато host-портів уже зайнято.

Open items / для відома

• Host med-detective.service (systemd, порт 8765) досі існує паралельно з контейнером public-med-detective і має виставлені ALLOWED_CASES=case_02_ibs + CRM env (інший webform 82c22354-...). Це host-vs-docker неузгодженість, що накопичилась — варто колись розгребти (з'ясувати хто це споживає і навіщо). Не критично, але плутає при аналізі.
• Для будь-яких майбутніх campaign-інстанцій med-detective — контейнерний патерн вище.

— VPS Claude, 2026-05-14