sparc_phase: R project: med-detective created: 2026-05-10 last_updated: 2026-05-10 author: Claude (post-hoc документація існуючої системи) status: approved approved_date: 2026-05-10 legacy_baseline: true spec_link: ./01-specification.md pseudocode_link: ./02-pseudocode.md architecture_link: ./03-architecture.md

Refinement — Реалізація: TDD-цикл — Med Detective (umbrella)

Post-hoc журнал реалізації. Тут не повний TDD-цикл (TDD не велося), а підсумок реальної інженерної історії і поточних тестів.

Тип тесту	Інструмент	Що покриває	Запуск
Case validation	`scripts/validate_case.py`	key_tests_to_order ⊆ LAB_CATALOG ∪ extra_tests	`python3 scripts/validate_case.py backend/cases/<file>.json`
Smoke test (manual)	curl	API health + base flow	`curl http://31.131.26.203/<form>/api/health`
Кейс flow (manual)	браузер	E2E лікар-пацієнт-діагноз-judge	відкрити кейс і пройти

⚠️ Що відсутнє (відомий борг):

Створено backend з 4 початковими кейсами + один patient prompt
Replicate + Llama-3-70B (15с латентність)
Redis як session store
Caddy у Docker
⚠️ Порушено правила гри: titles містили діагноз («Скаргa на mensual cycle disorder») — health-anxiety не реалізовано → довелось переписувати

Caddy migration з Docker на host-systemd — після того як docker compose restart caddy зніс iptables DOCKER chain і поклав всі сайти. Перейшли на cloudsmith apt-repo + drop-in у /etc/caddy/conf.d/
LLM swap 70B→8B — користувачі (Сергій тестував) скаржились на 15с очікування. Перейшли на Llama-3-8B + паралелізація patient+intent → 1.0-1.4с p95 ✅
Investigation Panel Phase A live — search-bar по 39 тестах, ціна+turnaround, +5 нових тестів за рекомендацією Gemini medical QA
Blue/green swap — створено med-detective-test slot для безпечного rollback'у. Caddy маршрути міняються sed-командою + systemctl reload caddy (3 секунди revert)

No-spoiler titles — заголовки не містять діагнозу, лише нейтральну скаргу
Health-anxiety trigger — у persona пацієнт сам себе налякав (наприклад, brain fog → боїться Альцгеймера). Один страх на персону.
Gender balance — мінімум 30% чоловіків у концептах
Усі 3 правила вшито у Case Builder Crew prompts (Marketer + Medical + Writer)

Не на med-detective прямо, але аналогічна проблема: tracking pixel'и → метрики 6.9% engaged / 75.5% passive. Урок переніс на med-detective: для GA4 інтеграції важливо одразу планувати custom events, не покладатися на default tracking.

Реалізовано: search + price/turnaround
Phase B (бюджет 500₴/24h, recommended-теги, графіки результатів, reset) — на паузі до 11.05 (Сергій з відпустки)

Wiki розділена: med-detective/ umbrella + {schonen-main, menopace, fables, filtrum}/
Спільну архітектуру (3-агентний паттерн, blue/green) винесено в umbrella
Filtrum створено як planned підпроект (заблоковано на DNS+CRM)

Створено цей sparc/ пакет
Med Detective umbrella → legacy_baseline: true (не міняти readiness через формулу)

#	Border	Severity	Mitigation
1	Llama-3-8B іноді даю русизми («Рукі» замість «Руки»)	Medium	Acceptable обмеження моделі. Можна посилити prompt «тільки українська» — TODO
2	Workdir/URL mapping переплутано після swap'у	Low	Зафіксовано в архітектурі і коментарях у Caddy конфігах
3	Pytest unit-тестів немає	Medium	План: написати mocked Replicate + judge тести у Q3
4	Без analytics — працюємо «наосліп»	High	TODO топ-3: GA4 + custom events
5	Lead-capture не реалізовано — 0 emails	High	TODO топ-2: Supabase + email confirmation flow
6	Гендерний дисбаланс у case_07/08 (Menopace) — 20% чоловіків	Low	Виправлено новими правилами Case Builder з 2026-04-18
7	STT Whisper issue на Menopace recall-режим	Medium	Гіпотеза: Gemini Flash Audio як заміна. Не пріоритет.

Latency p95 (Patient + Intent паралельно): 1.0-1.4с ✅ Target був <2с
Replicate cold-start: 0.3-0.5с overhead на перший запит сесії
Redis: <5мс
К-сть паралельних сесій: не виміряно під load. Поточний trafic <1 RPS, не bottleneck

$ pytest --cov=backend  # коли тести з'являться
TODO

Поточне реальне покриття: ~5% (тільки validate_case offline-скрипт + manual smoke).