---

sparc_phase: S project: med-detective created: 2026-04-18 last_updated: 2026-05-10 author: Сергій (owner) + Claude (PM) status: approved approved_date: 2026-05-10 legacy_baseline: true

⚠️ legacy_baseline: true означає: цей файл фіксує існуючий scope umbrella, який вже у production з readiness 80%. PM-Agent НЕ переключатиме readiness на SPARC-формулу для legacy_baseline проектів. Нові великі фічі med-detective (Lead Capture, GA4, Filtrum, нова форма) — кожна стартує власний SPARC-цикл у своїй sparc/ папці.

Specification — Специфікація: вимоги, цілі, метрики — Med Detective (umbrella)

Контекст і мотивація

Платформа інтерактивних edu-веб-квестів для сімейних лікарів. Лікар веде чат-анамнез з AI-пацієнтом, замовляє лабораторні тести через Investigation Panel, ставить діагноз — отримує оцінку 100 балів за rubric (40 діагноз + 30 анамнез + 15 продукт + 15 ефективність) і бренд-релевантний продукт-наказ.

Це не реклама і не розваги — це навчальний контент під брендами Deltamedical, через який ми досягаємо одночасно 4 цілей (нижче). Зараз 4 форми: Schönen-main (11 кейсів), Menopace (3 кейси), Fables (1 кейс) — live; Filtrum — заплановано (заблоковано на DNS+CRM). Сумарно 15 кейсів на 8 продуктах.

Цілі (Goals) — спільні і per-форма

Спільні umbrella-цілі (для всіх форм)

• [x] Бренд-контакт з лікарями / користувачами через освітній формат
• [x] Бренд-релевантне просування SKU — 15 кейсів з прив'язкою до 8 продуктів
• [x] Платформа під нові кампанії — 3-агентний паттерн (Patient + Intent + Judge) повторно використовується
• [ ] Lead-capture (email + CME-сертифікат) — модалка перед скачуванням → Supabase. Зараз 0 emails (топ-2 беклогу)
• [ ] Аналітика — GA4 + custom events. Зараз працюємо «наосліп»

4 форми × 4 окремі бізнес-цілі

Форма	Primary user	Бізнес-ціль	Канал розповсюдження
schonen-main	Stakeholder'и Schönen + B2B-партнери	Showcase/demo великого кейсу (11 кейсів) — продемонструвати масштаб і якість для нових бренд-контрактів	Прямі демо-зустрічі, портфоліо
menopace	Medreps Vitabiotics	Інструмент M2M sales — medrep показує лікарю на планшеті під час візиту, ілюструє менопаузальні кейси і Menopace як рішення	Корпоративна (Vitabiotics medreps app, 3 кейси)
fables	Medreps Deltamedical	Інструмент M2M sales — те ж саме що Menopace, але «казковий» формат (м'який сторітелінг, для брендів з ліричним позиціонуванням, 1 кейс наразі)	Корпоративна (medreps Deltamedical)
filtrum	Кінцеві користувачі (B2C)	Public distribution — розсилка кейсу користувачам (через email/SMM/реклама) щоб вони пограли, дізналися про продукт	Public web (filtrum.deltamedicalservices.online через CRM Creatio)
test slot	Внутрішня dev-команда	Blue/green rollback + новий бренд готується — internal env	Internal-only

Не-цілі (Non-goals)

• Не робимо CME-акредитацію МОЗ (це окремий регуляторний трек, не входить у цей edu-формат)
• Не намагаємось замінити медичну освіту чи протоколи — це доповнення, не основний інструмент
• Не приймаємо платежі / монетизацію через сам квест — це бренд-контактна точка
• Не плануємо мобільний нативний додаток — web-only (мобільний браузер достатній)

Користувачі / стейкхолдери

• B2C (Filtrum): кінцеві користувачі — заходять з email-розсилки / реклами / SMM, грають кейс із Filtrum-продуктом. Очікують 5-10 хв розваги + користі.
• Medreps Vitabiotics (Menopace): показують лікарю на планшеті під час візиту як ілюстрацію проблематики
• Medreps Deltamedical (Fables): те ж M2M sales, але казковий стиль для брендів з м'яким позиціонуванням
• B2B-стейкхолдери (Schönen-main 11 кейсів): бренд-партнери, нові потенційні клієнти — переглядають демо для оцінки якості і масштабу платформи перед кампанією
• Owner: Сергій (Digital Lead Deltamedical)
• Бренд-партнери (донорі контенту): Schönen (Swiss), Vitabiotics, Deltamedical brands
• Внутрішня команда: Case Builder Crew (генерує кейси), Dev Crew (підтримка)

Вимоги (Requirements)

Функціональні

• FR1: Чат-симуляція пацієнта українською мовою з персоною (вік, скарги, anxiety-trigger)
• FR2: Лікар може замовити обстеження через Investigation Panel (39 тестів, 6 категорій), бачити ціну і turnaround
• FR3: Лікар вписує діагноз вільним текстом, потім обирає продукт-рекомендацію
• FR4: Judge оцінює сесію за 4-критерійним rubric, повертає 100-бальний результат
• FR5: Result-екран показує бал, правильний діагноз, рекомендований SKU
• FR6: Можливість скачати CME-PDF (TODO Phase B)
• FR7: Lead-capture модалка перед скачуванням (TODO топ-2)

Нефункціональні

• NFR1 (latency): patient/intent відповідь — <2с p95 (Llama-3-8B на Replicate, зараз 1.0-1.4с ✅)
• NFR2 (мова): чистий український output, без русизмів. Llama-3-8B іноді дає русизми («Рукі»), приймаємо як обмеження моделі
• NFR3 (security): без PII у logs, секрети у /srv/passepartout/replicate/, Redis TTL 24h
• NFR4 (deploy): blue/green через swap Caddy routes — instant rollback за 3 секунди
• NFR5 (compliance): кожен БАД-кейс проходить Legal Gate у Case Builder Crew (наказ МОЗ №1145)

Edge cases

• Лікар призначив тест якого немає у кейсовому key_tests_to_order → Judge зменшує бал «ефективність»
• Replicate API down → Gemini fallback (тільки на Schönen-main, треба розширити)
• Redis недоступний → нова сесія, попередній прогрес втрачено (acceptable)
• Лікар закриває вкладку посередині → 24h Redis TTL зберігає state до повернення

Метрики успіху

Метрика	Baseline (2026-05-10)	Target Q3 2026
К-сть форм live	3	5+ (з Filtrum, Zest, ще одна)
К-сть кейсів сумарно	15	30+
Avg score (діагноз)	TODO виміряти	>70/100
Емейлів захоплено	0	200+ за квартал
Бренд-impressions per лікар	?	вимірюється з GA4

Залежності і блокери

• Filtrum: чекає DNS handoff Hostiq→Cloudflare + Creatio whitelist (домен *.deltamedicalservices.online)
• Lead-capture: потрібна Supabase інстанція + email-confirmation flow
• GA4: треба додати tracking-код у frontend, налаштувати custom events
• Whisper STT (Menopace): відомий issue на recall-режим — фейлбек на Gemini Flash Audio

Відкриті питання + пропозиції

1. Структура доменів (узгоджено 2026-05-10)

Рішення Сергія: med-detective.deltamedicalservices.online/<form> для всіх форм med-detective umbrella.

Тобто:

• med-detective.deltamedicalservices.online/ — головна landing/lobby
• med-detective.deltamedicalservices.online/schonen — Schönen-main (11 кейсів, B2B showcase)
• med-detective.deltamedicalservices.online/menopace — Menopace (medreps tool)
• med-detective.deltamedicalservices.online/fables — Fables (medreps tool)
• med-detective.deltamedicalservices.online/filtrum — Filtrum (B2C public distribution через CRM Creatio)
• med-detective.deltamedicalservices.online/test — internal test slot

Чому path-based під одним subdomain (а не окремі subdomains): (1) Cloudflare wildcard SSL *.deltamedicalservices.online не покриває 2-й рівень (*.med-detective.deltamedicalservices.online потребував би dedicated cert), (2) логічна ієрархія — med-detective umbrella гуртує всі форми, далі 4 проекти Deltamedical отримують власні subdomain'и (pediatric-news, biogaia, med-detective, ще). Filtrum-форма всередині med-detective потрапляє у CRM whitelist через wildcard *.deltamedicalservices.online, оскільки med-detective.deltamedicalservices.online сама собою поглинає /filtrum path.

2. CME-PDF: digital signature vs м'який

Рекомендую м'який PDF без digital signature.

Чому: формальна CME-акредитація — це окремий регуляторний трек через МОЗ і фахові асоціації, з вимогами до контролю знань, годин, акредитованих провайдерів. Ми позиціонуємо Med Detective як educational tool («pre-CME», «навчальний кейс»), а не як formal CME-провайдер. Якщо у Q3-Q4 2026 захочемо ввести formal CME — це окремий SPARC-цикл з юристами і МОЗ-партнером.

3. API назовні для партнерів

Рекомендую closed API.

Чому: Vitabiotics medreps уже мають доступ через окрему frontend-форму (/med-detective-menopace/) — додатковий API-інтерфейс не потрібен. Відкритий API = більше attack surface, потребує rate limiting, auth, документації, SLA — overhead не виправданий поточними use-case'ами. Якщо партнерам знадобиться програмний доступ — окремо обговорюємо у власному SPARC-циклі (з API-key vault, rate limits, monitoring).

Sign-off

• [x] Сергій schválив scope: 2026-04-18 (стартовий контракт), уточнено 2026-05-10
• [ ] Дата approval статусу S → P (Pseudocode): TBD — після відповіді на open-questions і коли візьмемо у роботу будь-яку нову велику фічу через SPARC pipeline
• [ ] Перехід на наступну фазу: P (Pseudocode) — поки на паузі (umbrella вже у фазі maintenance, окремі фічі будуть у власних SPARC-циклах: Lead Capture, GA4 integration, Filtrum)

Примітка для Сергія: Med Detective як umbrella вже у production (readiness 80%) — ми не робимо повний SPARC-цикл «з нуля». Цей 01-specification.md фіксує існуючий scope як baseline. Нові великі фічі (Lead Capture, GA4, Filtrum, ще одна форма) — кожна стартує окремий SPARC-цикл у власній sparc/ папці підпроекту або як модуль.