Again
Technical Architecture: Six Gaps, Six Layers, Five Bus Channels Технічна архітектура: шість розривів, шість шарів, п'ять каналів шини
v1.0 | March 2026 | Working Technical Document v1.0 | Березень 2026 | Робочий технічний документ
Companion to Documents 1-5 | Data source: Document 4 Супутній до Документів 1-5 | Джерело даних: Документ 4

Architectural Premise Архітектурна передумова

FEEL Again is a digital bus — a unified data and payment transport layer that connects N systems, N providers, N funders, and the state into a single verifiable flow. Unlike a point-to-point connector between two systems, the bus is an independent infrastructure layer that any endpoint can connect to. The distinction matters technically and politically: a bus does not depend on specific endpoints — it creates a universal transport that scales with new participants.

This document defines the architecture in three layers of abstraction. First: the six structural gaps in Ukraine's MHPSS sector that the architecture must close. Second: the six programme layers that address each gap. Third: the five technical bus channels through which data and money actually flow. Each layer maps precisely to the ones above and below it. Nothing is decorative.

FEEL Again — це цифрова шина (digital bus) — уніфікований транспортний шар даних і платежів, який з'єднує N систем, N надавачів, N фандерів та державу в єдиний верифікований потік. На відміну від з'єднання «точка-точка» між двома системами, шина — це незалежний інфраструктурний шар, до якого може підключитися будь-яка кінцева точка. Розмежування має значення технічно та політично: шина не залежить від конкретних систем — вона створює універсальний транспорт, що масштабується з новими учасниками.

Цей документ визначає архітектуру в трьох рівнях абстракції. Перший: шість структурних розривів у секторі МЗПСП України, які архітектура повинна закрити. Другий: шість програмних шарів, що адресують кожен розрив. Третій: п'ять технічних каналів шини, через які фактично рухаються дані та гроші. Кожен рівень точно відображається на ті, що вище та нижче від нього. Нічого декоративного.

1. Six Structural Gaps 1. Шість структурних розривів

The Perfect Storm (Document 2, §1) identified five converging failures. Mapping those failures to their architectural root causes reveals six distinct gaps — structural breaks where information, money, or accountability cannot flow. Each gap has a measurable width, documented in Document 4.

Ідеальний шторм (Документ 2, §1) визначив п'ять збоїв, що конвергують. Відображення цих збоїв на їхні архітектурні кореневі причини виявляє шість окремих розривів — структурних обривів, де інформація, гроші або підзвітність не можуть протікати. Кожен розрив має вимірювану ширину, задокументовану в Документі 4.

GAP 1

Demand–Action GapРозрив попит–дія

71% of Ukrainians report needing mental health support. 17% have sought help. Width: 54 percentage points (Gradus, 2024). This is not a supply shortage — it is a discovery failure. People cannot find services that are trustworthy, affordable, and available. The system offers no searchable, verified directory of providers. [Doc 4, §2.1]

71% українців повідомляють про потребу в підтримці психічного здоров'я. 17% звернулися. Ширина: 54 відсоткових пункти (Gradus, 2024). Це не нестача пропозиції — це збій виявлення. Люди не можуть знайти послуги, які є довіреними, доступними та наявними. Система не пропонує доступного для пошуку верифікованого каталогу надавачів. [Док 4, §2.1]

GAP 2

Training–Practice GapРозрив навчання–практика

154,500 people trained in mental health protocols. 42 practising as funded, structured, accountable professionals. Width: 99.97% attrition. Training programmes produce certificates, not practitioners. The gap exists because there is no pathway from "I completed a course" to "I see clients, get paid, and report outcomes." [Doc 4, §3.1; Doc 2, §1.2]

154 500 людей навчено протоколам психічного здоров'я. 42 практикують як фінансовані, структуровані, підзвітні фахівці. Ширина: 99,97% втрат. Тренінгові програми виробляють сертифікати, не практиків. Розрив існує, бо немає шляху від «я завершив курс» до «я бачу клієнтів, отримую оплату і звітую про результати». [Док 4, §3.1; Док 2, §1.2]

GAP 3

Formalization GapРозрив формалізації

An estimated 2,000+ mental health providers operate in the shadow sector: no registration, no insurance, no outcome data, no state visibility. Formalization costs €979/month (direct €207 + opportunity cost €958, minus current shadow income). Width: the economic penalty exceeds the economic incentive. Law 4223-IX mandates SROs and certification, but provides no digital tool to implement the pathway. [Doc 4, §4.1–4.3; Doc 2, §1.3]

Орієнтовно 2 000+ надавачів послуг психічного здоров'я працюють у тіньовому секторі: без реєстрації, без страхування, без даних про результати, без видимості для держави. Формалізація коштує €979/місяць (прямі €207 + альтернативна вартість €958, мінус поточний тіньовий дохід). Ширина: економічний штраф перевищує економічний стимул. Закон 4223-IX вимагає СРО та сертифікацію, але не надає цифрового інструменту для реалізації шляху. [Док 4, §4.1–4.3; Док 2, §1.3]

GAP 4

Data–Verification GapРозрив дані–верифікація

HEAL ($500M IPF) has delivered 624K mental health services and 118 mobile teams — but 0 of 400 planned facility upgrades, and no standardised outcome measurement system. THRIVE ($454M PforR) pays for verified results via ESOZ, but ESOZ has no mental health session data (only pharmaceutical — AMP MH: 147K e-prescriptions). Width: the entire psychotherapy service layer is invisible to the state data system. Services happen, but they cannot be verified, counted, or paid for through official channels. [Doc 4, §5.1–5.3; ISR #6]

HEAL ($500M IPF) надав 624K послуг психічного здоров'я та 118 мобільних бригад — але 0 з 400 запланованих модернізацій закладів, і жодної стандартизованої системи вимірювання результатів. THRIVE ($454M PforR) платить за верифіковані результати через ЕСОЗ, але ЕСОЗ не має даних про сесії психічного здоров'я (лише фармацевтичні — AMP MH: 147K е-рецептів). Ширина: весь шар психотерапевтичних послуг є невидимим для державної системи даних. Послуги відбуваються, але не можуть бути верифіковані, підраховані чи оплачені через офіційні канали. [Док 4, §5.1–5.3; ISR #6]

GAP 5

Payment–Outcome GapРозрив оплата–результат

Current funding flows to activities, not outcomes. A donor pays for "300 sessions delivered" regardless of whether symptoms improved, worsened, or stayed the same. The state allocates ₴6.47B to mental health, but 89% goes to inpatient psychiatric beds (legacy Soviet infrastructure). Width: zero correlation between payment and clinical outcome. There is no mechanism that says "this session produced a measurable improvement, therefore release payment." [Doc 4, §5.4; Doc 2, §1.5]

Поточне фінансування спрямовується на активності, а не на результати. Донор платить за «300 проведених сесій» незалежно від того, чи покращились симптоми, погіршились, чи залишились без змін. Держава виділяє ₴6,47B на психічне здоров'я, але 89% йде на стаціонарні психіатричні ліжка (спадщина радянської інфраструктури). Ширина: нульова кореляція між оплатою та клінічним результатом. Не існує механізму, який каже «ця сесія дала вимірюване покращення, тому звільніть платіж». [Док 4, §5.4; Док 2, §1.5]

GAP 6

State–Shadow GapРозрив держава–тінь

The formal state health system (ESOZ, NSSU) and the informal shadow sector operate as parallel universes. The shadow sector serves an estimated ~1.8M sessions/year but generates zero state data. The formal system has data infrastructure (ESOZ) but almost no mental health content flowing through it (except AMP MH pharmaceutical data). Width: two systems, zero interoperability. Law 4223-IX creates the legal mandate to bridge them; FEEL Again creates the technical bridge. [Doc 4, §4.1; Doc 2, §1.4]

Формальна державна система охорони здоров'я (ЕСОЗ, НСЗУ) та неформальний тіньовий сектор функціонують як паралельні всесвіти. Тіньовий сектор обслуговує орієнтовно ~1,8M сесій/рік, але генерує нуль державних даних. Формальна система має дата-інфраструктуру (ЕСОЗ), але майже не має контенту психічного здоров'я, що проходить через неї (окрім фармацевтичних даних AMP MH). Ширина: дві системи, нуль інтероперабельності. Закон 4223-IX створює правовий мандат для їх з'єднання; FEEL Again створює технічний міст. [Док 4, §4.1; Док 2, §1.4]

2. Six Programme Layers 2. Шість програмних шарів

Each gap is addressed by a dedicated programme layer. The layers are stacked — each one depends on the one below it and enables the one above it. The foundation layer (Discovery) must work before the top layer (Integration) can function. This is not a menu of independent features; it is a stack where removing any layer breaks the layers above.

Кожен розрив адресується виділеним програмним шаром. Шари складені — кожен залежить від того, що під ним, і уможливлює той, що над ним. Фундаментний шар (Виявлення) повинен працювати до того, як верхній шар (Інтеграція) зможе функціонувати. Це не меню незалежних функцій; це стек, де видалення будь-якого шару ламає шари над ним.

L6 IntegrationL6 Інтеграція
Closes: GAP 6 (State–Shadow)Закриває: GAP 6 (Держава–тінь)
ESOZ HL7 FHIR R4 sync. IATI 2.03 publications. State SaaS pathway. Global replication API. This is the roof — it only works if the five layers below are intact. Синхронізація ЕСОЗ HL7 FHIR R4. Публікації IATI 2.03. Шлях державного SaaS. API глобальної реплікації. Це дах — працює лише якщо п'ять шарів нижче цілі.
Projects: A3, A4, C1, C3Проєкти: A3, A4, C1, C3
L5 PaymentL5 Оплата
Closes: GAP 5 (Payment–Outcome)Закриває: GAP 5 (Оплата–результат)
Escrow engine. Outcome-triggered release. NBU SEP integration (ISO 20022). Smart clearing: donor → escrow → outcome verified → provider. Commission 2.5-7% degressive. This layer turns "funding" into "payment for verified results." Ескроу двигун. Звільнення за результатом. Інтеграція НБУ СЕП (ISO 20022). Смарт-кліринг: донор → ескроу → результат верифіковано → надавач. Комісія 2,5-7% дегресивна. Цей шар перетворює «фінансування» на «оплату за верифіковані результати».
Projects: A5, C2Проєкти: A5, C2
L4 MeasurementL4 Вимірювання
Closes: GAP 4 (Data–Verification)Закриває: GAP 4 (Дані–верифікація)
Session metering engine. Validated clinical instruments: PCL-5 (PTSD), PHQ-9 (depression), GAD-7 (anxiety). Every session produces a structured data record: provider ID + client ID (anonymised) + instrument scores + delta. This is the core engine that makes the invisible visible. Двигун метрування сесій. Валідовані клінічні інструменти: PCL-5 (ПТСР), PHQ-9 (депресія), GAD-7 (тривожність). Кожна сесія створює структурований запис: ID надавача + ID клієнта (анонімізований) + бали інструменту + дельта. Це ядро двигуна, що робить невидиме видимим.
Projects: A2, B2 (VR outcome data)Проєкти: A2, B2 (дані результатів VR)
L3 FormalizationL3 Формалізація
Closes: GAP 3 (Formalization)Закриває: GAP 3 (Формалізація)
Certification engine implementing Law 4223-IX pathway. SRO registration. ФОП setup assistance. Credential verification. The platform makes formalization net-positive: income from platform referrals (target ≥€600/month) exceeds formalization penalty (€979/month including opportunity cost) because clients are pre-matched. Сертифікаційний двигун, що реалізує шлях Закону 4223-IX. Реєстрація СРО. Допомога з оформленням ФОП. Верифікація кваліфікацій. Платформа робить формалізацію чисто позитивною: дохід від направлень платформи (ціль ≥€600/міс) перевищує штраф формалізації (€979/міс включно з альтернативною вартістю), бо клієнти попередньо підібрані.
Projects: A1 (registry), B1 (pilot), B3 (training)Проєкти: A1 (реєстр), B1 (пілот), B3 (навчання)
L2 PipelineL2 Конвеєр
Closes: GAP 2 (Training–Practice)Закриває: GAP 2 (Навчання–практика)
The provider pipeline: from training certificate to funded, supervised, outcome-measured practice. Train for Care cohorts (EMDR 66h + VR Bravemind 33h = 99h). Diaspora supervision network. VR hub deployment. The bridge — temporary by design, replaced by self-sustaining pipeline once L3-L5 generate enough economic pull. Конвеєр надавачів: від тренінгового сертифікату до фінансованої, супервізованої, виміряної за результатами практики. Когорти Train for Care (EMDR 66 год + VR Bravemind 33 год = 99 год). Мережа діаспорної супервізії. Розгортання VR-хабів. Міст — тимчасовий за дизайном, замінюється самосталим конвеєром, коли L3-L5 генерують достатню економічну тягу.
Projects: B2, B3, B4Проєкти: B2, B3, B4
L1 DiscoveryL1 Виявлення
Closes: GAP 1 (Demand–Action)Закриває: GAP 1 (Попит–дія)
Provider registry: searchable, verified, public. Each provider has a digital profile with credentials, specializations, availability, outcome history, and supervision status. Citizens can find help. The foundation layer — everything above depends on this being real, accurate, and trusted. Open data dashboard (A4) makes the entire system transparent. Реєстр надавачів: доступний для пошуку, верифікований, публічний. Кожен надавач має цифровий профіль з кваліфікаціями, спеціалізаціями, доступністю, історією результатів та статусом супервізії. Громадяни можуть знайти допомогу. Фундаментний шар — все вище залежить від того, щоб це було реальним, точним і довіреним. Дашборд відкритих даних (A4) робить всю систему прозорою.
Projects: A1, A4Проєкти: A1, A4

3. Five Bus Channels (Digital Bus Architecture) 3. П'ять каналів шини (архітектура цифрової шини)

The six programme layers are implemented through five technical bus channels. The digital bus is the physical infrastructure — the actual code, APIs, data formats, and protocols that make the layers work. Each channel carries a specific type of payload (identity, session, outcome, payment, or report) through a standardised pipe. Any platform operator (Enkidu, Quoroom/HighCastle Technologies, or future operators) builds to these bus specifications. The bus is the standard; operators are implementations.

The analogy: the bus is the railway gauge. Any train builder can build trains that run on the gauge. FEEL Again defines and maintains the gauge. It does not build all the trains.

Шість програмних шарів реалізуються через п'ять технічних каналів шини. Цифрова шина — це фізична інфраструктура: власне код, API, формати даних та протоколи, які змушують шари працювати. Кожен канал несе конкретний тип навантаження (ідентифікація, сесія, результат, платіж або звіт) через стандартизовану трубу. Будь-який платформний оператор (Enkidu, Quoroom/HighCastle Technologies або майбутні оператори) будує за цими специфікаціями шини. Шина — це стандарт; оператори — це імплементації.

Аналогія: шина — це ширина колії. Будь-який виробник потягів може будувати потяги, що працюють на цій колії. FEEL Again визначає та підтримує колію. Не будує всі потяги.

Channel 1: Identity BusКанал 1: Шина ідентифікації

Carries: provider credentials, client pseudonymous IDs, supervision relationships, certification status. Every entity on the platform has a verified digital identity. Providers authenticate via BankID/Diia.Signature (state-grade identity). Clients receive pseudonymous IDs that protect privacy while enabling outcome tracking across sessions.

Protocol: OAuth 2.0 + OpenID Connect | Format: FHIR Practitioner/Patient resources | Auth: BankID UA, Diia.Signature | Privacy: GDPR-aligned pseudonymisation

Serves layers: L1 (Discovery), L3 (Formalization). Closes gaps: #1, #3.

Несе: кваліфікації надавачів, псевдонімізовані ID клієнтів, відносини супервізії, статус сертифікації. Кожна сутність на платформі має верифіковану цифрову ідентичність. Надавачі автентифікуються через BankID/Дія.Підпис (державний рівень ідентичності). Клієнти отримують псевдонімізовані ID, що захищають приватність, водночас забезпечуючи відстеження результатів між сесіями.

Протокол: OAuth 2.0 + OpenID Connect | Формат: ресурси FHIR Practitioner/Patient | Авт: BankID UA, Дія.Підпис | Приватність: GDPR-вирівняна псевдонімізація

Обслуговує шари: L1 (Виявлення), L3 (Формалізація). Закриває розриви: #1, #3.

Channel 2: Session BusКанал 2: Шина сесій

Carries: session records (timestamp, duration, type, modality), clinical instrument administrations, VR session telemetry, supervision logs. Every therapeutic interaction produces a structured event on this bus. The Session Bus is the primary data generator — without it, nothing above can function.

Protocol: REST API (JSON) + WebSocket (real-time VR) | Format: FHIR Encounter + custom extensions | Encryption: TLS 1.3 in transit, AES-256 at rest | Retention: 7 years (clinical data mandate)

Serves layers: L2 (Pipeline), L4 (Measurement). Closes gaps: #2, #4.

Несе: записи сесій (часова мітка, тривалість, тип, модальність), адміністрування клінічних інструментів, телеметрію VR-сесій, логи супервізії. Кожна терапевтична взаємодія створює структуровану подію на цій шині. Шина сесій — первинний генератор даних — без неї ніщо вище не може функціонувати.

Протокол: REST API (JSON) + WebSocket (реальний час VR) | Формат: FHIR Encounter + кастомні розширення | Шифрування: TLS 1.3 в транзиті, AES-256 в спокої | Зберігання: 7 років (мандат клінічних даних)

Обслуговує шари: L2 (Конвеєр), L4 (Вимірювання). Закриває розриви: #2, #4.

Channel 3: Outcome BusКанал 3: Шина результатів

Carries: clinical instrument scores (PCL-5, PHQ-9, GAD-7), score deltas (Δ per session, Δ per treatment episode), aggregated outcome data (provider-level, programme-level, national-level). This is the bus that answers "did it work?" — the question that no current system in Ukraine can answer for psychotherapy services.

Protocol: Event-driven (pub/sub) | Format: FHIR QuestionnaireResponse + Observation | Aggregation: real-time rollup via streaming pipeline | Access control: provider sees own data; aggregate data public via A4 dashboard

Serves layers: L4 (Measurement), L5 (Payment — outcome triggers payment release). Closes gaps: #4, #5.

Несе: бали клінічних інструментів (PCL-5, PHQ-9, GAD-7), дельти балів (Δ за сесію, Δ за епізод лікування), агреговані дані результатів (рівень надавача, рівень програми, національний рівень). Це шина, що відповідає на «чи спрацювало?» — питання, на яке жодна поточна система в Україні не може відповісти для психотерапевтичних послуг.

Протокол: Event-driven (pub/sub) | Формат: FHIR QuestionnaireResponse + Observation | Агрегація: rollup у реальному часі через streaming pipeline | Контроль доступу: надавач бачить свої дані; агреговані дані публічні через дашборд A4

Обслуговує шари: L4 (Вимірювання), L5 (Оплата — результат запускає звільнення платежу). Закриває розриви: #4, #5.

Channel 4: Payment BusКанал 4: Шина платежів

Carries: escrow deposits, outcome-triggered releases, commission calculations, provider payouts, donor fund allocations. The bus that makes money flow to verified results. Integrates with NBU SEP (ISO 20022, settlement <10 sec). NBU Regulatory Sandbox required for novel escrow-to-outcome payment model.

Protocol: ISO 20022 (NBU SEP) + internal ledger API | Format: payment initiation (pain.001), status report (pain.002) | Security: PCI DSS Level 1 compliant | Sandbox: NBU Regulatory Sandbox application required

Serves layers: L5 (Payment). Closes gaps: #5.

Несе: ескроу-депозити, звільнення за результатом, розрахунки комісій, виплати надавачам, алокації донорських коштів. Шина, що змушує гроші текти до верифікованих результатів. Інтегрується з НБУ СЕП (ISO 20022, розрахунок <10 сек). Потрібна Регуляторна пісочниця НБУ для новітньої моделі ескроу-до-результату.

Протокол: ISO 20022 (НБУ СЕП) + внутрішній API реєстру | Формат: ініціювання платежу (pain.001), звіт про статус (pain.002) | Безпека: PCI DSS Level 1 compliant | Пісочниця: потрібна заявка до Регуляторної пісочниці НБУ

Обслуговує шари: L5 (Оплата). Закриває розриви: #5.

Channel 5: Reporting BusКанал 5: Шина звітності

Carries: aggregated data to external systems. Three output ports: (a) ESOZ sync via HL7 FHIR R4 — makes psychotherapy sessions visible to the state; (b) IATI 2.03 publications — makes donor spending transparent; (c) Open Data dashboard — makes everything visible to the public. This bus is the bridge between FEEL Again's internal data and the outside world. It is what makes HEAL countable, THRIVE verifiable, and the MHPSS TWG's 4W reporting automatic.

Protocol: HL7 FHIR R4 (ESOZ), IATI 2.03 XML (donors), REST + GraphQL (dashboard) | Schedule: ESOZ real-time, IATI quarterly, dashboard continuous | Public endpoint: dashboard.feelagain.me

Serves layers: L6 (Integration). Closes gaps: #6.

Несе: агреговані дані до зовнішніх систем. Три вихідних порти: (a) синхронізація ЕСОЗ через HL7 FHIR R4 — робить психотерапевтичні сесії видимими для держави; (b) публікації IATI 2.03 — робить донорські витрати прозорими; (c) дашборд відкритих даних — робить все видимим для громадськості. Ця шина — міст між внутрішніми даними FEEL Again та зовнішнім світом. Це те, що робить HEAL рахованим, THRIVE верифікованим, а 4W-звітність MHPSS TWG автоматичною.

Протокол: HL7 FHIR R4 (ЕСОЗ), IATI 2.03 XML (донори), REST + GraphQL (дашборд) | Розклад: ЕСОЗ реальний час, IATI щоквартально, дашборд безперервно | Публічний endpoint: dashboard.feelagain.me

Обслуговує шари: L6 (Інтеграція). Закриває розриви: #6.

4. As-Is → To-Be: What Exists and What FEEL Again Builds 4. Є зараз → Буде: що існує і що будує FEEL Again

Each row below describes one structural gap: what the situation is today, what the project solution is, and what the measurable result will be once closed. No abbreviations — this table should be readable without having read the other documents.

Кожен рядок нижче описує один структурний розрив: яка ситуація сьогодні, яке проєктне рішення, і який вимірюваний результат після закриття. Без скорочень — ця таблиця має читатися без попереднього знайомства з іншими документами.

Problem (what exists today)Проблема (що є сьогодні) As-Is: the gapЯк є зараз Project solutionПроєктне рішення To-Be: expected resultЯк буде: очікуваний результат
People need help but cannot find verified, affordable mental health servicesЛюди потребують допомоги, але не можуть знайти верифіковані, доступні за ціною послуги 71% of Ukrainians report needing support. Only 17% have sought help. No searchable, verified public registry of providers exists. Gap: 54 percentage points.71% українців повідомляють про потребу. Лише 17% звернулись. Відсутній публічний верифікований реєстр. Розрив: 54 в.п. Open registry (Project A1): searchable by location, specialization, language, price, supervision status, outcome history. Integrated with state identity system (BankID). Open data dashboard (Project A4) shows system-level data publicly.Відкритий реєстр (Проєкт A1): пошук за локацією, спеціалізацією, мовою, ціною, статусом супервізії, історією результатів. Інтегрований з державною ідентифікаційною системою (BankID). Дашборд відкритих даних (Проєкт A4) показує системні дані публічно. Any person can find a verified provider within 5 minutes. Every provider's credentials and outcomes are publicly visible. System transparency becomes a trust mechanism.Будь-яка людина знаходить верифікованого надавача за 5 хвилин. Кваліфікації та результати кожного надавача публічно видимі. Прозорість системи стає механізмом довіри.
Trained mental health workers cannot transition to sustainable clinical practiceНавчені спеціалісти з психічного здоров'я не можуть перейти до стійкої клінічної практики Over 100,000 people have received mental health training certificates. The single documented program with supervision (700 trained, 2022) resulted in 42 practising professionals. No structured pathway from "certificate" to "funded, supervised practice" exists.Понад 100 000 людей отримали сертифікати з навчання з психічного здоров'я. Єдина задокументована програма з супервізією (700 навчених, 2022) дала 42 практикуючих фахівців. Немає структурованого шляху від «сертифікату» до «фінансованої, супервізованої практики». Provider pipeline (Projects B2, B3, B4): cohort training (EMDR 66h + VR-assisted trauma therapy 33h = 99h), diaspora supervision network, VR hub deployment. Platform connects newly trained providers to clients immediately, generating income from first session.Конвеєр надавачів (Проєкти B2, B3, B4): когортне навчання (EMDR 66 год + VR-терапія травми 33 год = 99 год), мережа діаспорної супервізії, розгортання VR-хабів. Платформа одразу з'єднує новонавчених надавачів з клієнтами, генеруючи дохід з першої сесії. Each cohort of 50 trained providers becomes 50 active, supervised, income-generating practitioners — not 50 certificate holders. Target: 200 active providers in Year 1.Кожна когорта з 50 навчених надавачів стає 50 активними, супервізованими, дохідними практиками — не 50 власниками сертифікатів. Ціль: 200 активних надавачів у Рік 1.
~15,000 mental health professionals work informally, invisible to the state and unable to access official funding~15 000 фахівців з психічного здоров'я працюють неформально, невидимі для держави та без доступу до офіційного фінансування Formalization costs €979/month in penalties and lost income (sole proprietor taxes + accounting + 250 lost work hours/year). Informal income: €1,500/month net. Formal income after costs: €521/month net. The system punishes legality. Law 4223-IX (Self-Regulatory Organizations) creates the legal mandate but no digital implementation pathway.Формалізація коштує €979/місяць штрафів та втраченого доходу (податки ФОП + бухгалтерія + 250 втрачених робочих годин/рік). Неформальний дохід: €1 500/місяць нетто. Формальний після витрат: €521/місяць нетто. Система карає за легальність. Закон 4223-IX (Саморегулівні організації) дає правовий мандат, але не цифровий шлях реалізації. Certification engine (Project A1): implements the Law 4223-IX pathway digitally. Platform referrals target ≥€600/month additional income for registered providers, exceeding the €207/month direct formalization cost. Automated reporting reduces the 250-hour administrative burden to under 20 hours/year.Сертифікаційний двигун (Проєкт A1): реалізує шлях Закону 4223-IX цифрово. Направлення платформи цілять ≥€600/місяць додаткового доходу для зареєстрованих надавачів, перевищуючи пряму вартість формалізації €207/місяць. Автоматизована звітність скорочує 250-годинний адміністративний тягар до менш ніж 20 годин/рік. Закон також передбачає можливість співфінансування з державою, що закладає основу для збільшення погодинної ставки за участі НСЗУ. Formalization becomes net-positive: registered providers earn more, not less. Target: 500 formalizations in Year 1. State gains visibility into 15,000 currently invisible providers.Формалізація стає чисто позитивною: зареєстровані надавачі заробляють більше, а не менше. Ціль: 500 формалізацій у Рік 1. Держава отримує видимість 15 000 наразі невидимих надавачів.
624,000 mental health services have been delivered with World Bank funding, but none of this data exists in the state health system624 000 послуг психічного здоров'я надано за фінансування Світового банку, але жодних цих даних немає в державній системі охорони здоров'я HEAL project (World Bank, $500M) funds services and 118 mobile teams — data recorded in CommCare and Kobo survey tools. THRIVE project (World Bank, $454M) pays for results verified in the Ukrainian state electronic health system (eHealth/ESOZ). The state system has no mental health session data at all. Only pharmaceutical prescriptions are tracked. Result: HEAL cannot prove its impact to THRIVE, and THRIVE cannot count what HEAL has done.Проєкт HEAL (Світовий банк, $500M) фінансує послуги та 118 мобільних бригад — дані записуються в CommCare та Kobo. Проєкт THRIVE (Світовий банк, $454M) платить за результати, верифіковані в ЕСОЗ. Державна система не має жодних даних про сесії психічного здоров'я. Відстежуються лише фармацевтичні рецепти. Результат: HEAL не може довести свій вплив для THRIVE, а THRIVE не може порахувати те, що зробив HEAL. Session measurement engine (Project A2): every therapy session generates a structured clinical record (PHQ-9, GAD-7, PCL-5 scores + delta). Reporting Bus (Channel 5) syncs these records to the state eHealth system in standard HL7 FHIR R4 format automatically. What was invisible becomes countable and fundable.Двигун вимірювання сесій (Проєкт A2): кожна терапевтична сесія генерує структурований клінічний запис (бали PHQ-9, GAD-7, PCL-5 + дельта). Шина звітності (Канал 5) синхронізує ці записи з ЕСОЗ у стандартному форматі HL7 FHIR R4 автоматично. Те, що було невидимим, стає рахованим і фінансованим. Every FEEL Again session is visible in ESOZ within 24 hours. HEAL services become verifiable by THRIVE indicators. Donors receive automatic IATI-compliant reports without manual data entry. Target: 50,000 sessions/year in ESOZ by end of Year 2.Кожна сесія FEEL Again видима в ЕСОЗ протягом 24 годин. Послуги HEAL стають верифікованими за показниками THRIVE. Донори отримують автоматичні IATI-сумісні звіти без ручного введення даних. Ціль: 50 000 сесій/рік в ЕСОЗ до кінця Року 2.
Donor funding pays for sessions delivered, not for outcomes achieved — with no way to verify whether treatment workedДонорське фінансування платить за проведені сесії, а не за досягнуті результати — без можливості верифікувати, чи допомогло лікування All current MHPSS funding flows to activity counts ("X sessions delivered") regardless of clinical outcome. 89% of the state mental health budget goes to inpatient psychiatric beds, which treat 11% of cases. No mechanism exists to say "this session produced a measurable improvement, therefore release payment."Все поточне фінансування МЗПСП надходить за кількість активностей ("X сесій проведено") незалежно від клінічного результату. 89% державного бюджету на психічне здоров'я йде на стаціонарні психіатричні ліжка, які лікують 11% випадків. Не існує механізму: «ця сесія дала вимірюване покращення, тому звільніть платіж». Outcome-triggered payment engine (Projects A5, C2): escrow system holds donor funds until validated clinical improvement (PHQ-9, GAD-7, PCL-5 delta meets threshold). Payment releases automatically via NBU payment system (ISO 20022 standard, settlement under 10 seconds). Commission: 2.5–7% degressive by volume. NBU Regulatory Sandbox application required for this novel payment model.Платіжний двигун, що запускається результатом (Проєкти A5, C2): ескроу-система утримує донорські кошти до валідованого клінічного покращення (дельта PHQ-9, GAD-7, PCL-5 досягає порогу). Платіж вивільняється автоматично через платіжну систему НБУ (стандарт ISO 20022, розрахунок менш ніж за 10 секунд). Комісія: 2,5–7% дегресивна за обсягом. For the first time in Ukraine's MHPSS sector: proof that a service produced a clinical result, and payment that follows that proof. Donors know their money worked. State can allocate based on evidence, not on legacy infrastructure.Вперше в секторі МЗПСП України: доказ того, що послуга дала клінічний результат, і оплата, яка слідує за цим доказом. Донори знають, що їхні гроші спрацювали. Держава може розподіляти на основі доказів, а не успадкованої інфраструктури.
The formal state health system and the informal sector function as two parallel universes with zero data exchangeФормальна державна система охорони здоров'я та неформальний сектор функціонують як два паралельних всесвіти з нульовим обміном даними The state eHealth system (ESOZ) has data infrastructure but almost no mental health content. The shadow sector sees approximately 1.8 million sessions per year but generates zero state data. The two systems do not communicate. Law 4223-IX creates the legal mandate to bridge them. No technical bridge exists yet.Державна система ЕСОЗ має інфраструктуру даних, але майже не має контенту психічного здоров'я. Тіньовий сектор обслуговує близько 1,8 мільйона сесій на рік, але генерує нуль державних даних. Дві системи не комунікують. Закон 4223-IX дає правовий мандат для їх з'єднання. Технічного мосту ще не існує. Reporting Bus (Channel 5): HL7 FHIR R4 integration with ESOZ (Projects A3, C1). IATI 2.03 publication standard for donor transparency. Open data dashboard (Project A4). Any operator connecting to the bus automatically reports to state and donor systems — no manual reporting required.Шина звітності (Канал 5): інтеграція HL7 FHIR R4 з ЕСОЗ (Проєкти A3, C1). Стандарт публікації IATI 2.03 для прозорості донорів. Дашборд відкритих даних (Проєкт A4). Будь-який оператор, що підключається до шини, автоматично звітує до державних та донорських систем — без ручної звітності. Shadow sector data becomes state data — without exposing individual providers to regulatory risk before they're ready. State gains a real-time picture of the MHPSS sector. Donors receive automated IATI reports. The MHPSS Cluster's 4W reporting becomes automatic.Дані тіньового сектору стають державними даними — без піддавання окремих надавачів регуляторному ризику до їхньої готовності. Держава отримує картину сектору МЗПСП у реальному часі. Донори отримують автоматичні звіти IATI. Звітність 4W Кластеру МЗПСП стає автоматичною.

5. Multi-Operator Architecture 5. Мульти-операторна архітектура

FEEL Again is not a single application. It is a bus specification that multiple platform operators implement. The architecture is deliberately designed to prevent vendor lock-in: any operator that implements the five bus channel specifications can connect to the network. This is how railway gauges work — the gauge is the standard, not the train manufacturer.

FEEL Again — це не один додаток. Це специфікація шини, яку реалізують кілька платформних операторів. Архітектура свідомо спроєктована для запобігання прив'язки до вендора: будь-який оператор, що імплементує специфікації п'яти каналів шини, може підключитися до мережі. Так працює ширина колії — колія є стандартом, а не виробник потягів.

Enkidu
Platform Operator
Payments · co-financing
Banking integrations
Escrow engine
Платформний оператор
Платежі · співфінансування
Банківські інтеграції
Ескроу двигун
FEEL Again
Digital Bus
5 channels · Open spec
Single gauge
Any operator can connect
Quoroom / HighCastle Technologies
Platform Operator
Depersonalised registry
MIS + eHealth integrations
Reporting & accounting systems
Платформний оператор
Деперсоніфікований реєстр
Інтеграції МІС + eHealth
Звітні та облікові системи

Both operators connect to the same bus. A session logged by Enkidu produces the same data format as a session logged by Quoroom. An outcome verified on either platform triggers the same payment process. The bus ensures data interoperability regardless of which operator the provider or client chose. Future operators can join by implementing the bus specification — no bilateral integration needed.

Обидва оператори підключаються до однієї шини. Сесія, зафіксована Enkidu, створює такий самий формат даних, як сесія, зафіксована Quoroom. Результат, верифікований на будь-якій платформі, запускає той самий платіжний процес. Шина забезпечує інтероперабельність даних незалежно від того, якого оператора обрав надавач чи клієнт. Майбутні оператори можуть приєднатися, імплементувавши специфікацію шини — двостороння інтеграція не потрібна.

5b. Technical Specification — Digital Bus (for Partner Development Teams) 5b. Технічне завдання — Цифрова шина (для партнерських команд розробки)

This section is the working technical specification for any development team implementing a bus-connected platform operator. It defines the mandatory interface contracts, data formats, authentication requirements, and acceptance criteria. Teams implementing Quoroom / HighCastle Technologies integration should treat this section as the primary technical reference.

Цей розділ є робочим технічним завданням для будь-якої команди розробки, що реалізує платформного оператора, підключеного до шини. Він визначає обов'язкові контракти інтерфейсу, формати даних, вимоги до автентифікації та критерії прийому. Команди, що реалізують інтеграцію Quoroom / HighCastle Technologies, мають розглядати цей розділ як основний технічний орієнтир.

Channel 1 (Identity Bus) — Required EndpointsКанал 1 (Шина ідентифікації) — Обов'язкові ендпоінти

POST /bus/v1/identity/provider/register
// Register provider with verified credentials. Payload: BankID token + qualification certificates + SRO membership
// Returns: bus_provider_id (UUID) + status (pending_verification | active)

GET /bus/v1/identity/provider/{bus_provider_id}
// Retrieve provider profile. Response: FHIR Practitioner resource (R4 compliant)

POST /bus/v1/identity/client/pseudonymise
// Create pseudonymous client ID. Input: phone hash (SHA-256). Returns: bus_client_id (UUID). No PII stored on bus.

GET /bus/v1/identity/registry/search
// Public endpoint. Query params: location, specialization, language, price_max, supervision_status, availability

Channel 2 (Session Bus) — Required EndpointsКанал 2 (Шина сесій) — Обов'язкові ендпоінти

POST /bus/v1/session/log
// Log completed session. Payload: FHIR Encounter resource (R4). Required fields: provider_id, client_id, session_type, duration_minutes, modality (in-person|online|vr), timestamp_start, timestamp_end

POST /bus/v1/session/instrument/submit
// Submit clinical instrument scores. Payload: FHIR QuestionnaireResponse. instrument_type: [PHQ9 | GAD7 | PCL5 | IES_R]. score, subscores[], administered_by (provider|client|auto)

GET /bus/v1/session/history/{bus_client_id}
// Retrieve session history for client. Auth: provider must have active therapeutic relationship with client_id. Returns: array of FHIR Encounter resources.

Channel 3 (Outcome Bus) — Required EndpointsКанал 3 (Шина результатів) — Обов'язкові ендпоінти

GET /bus/v1/outcome/provider/{bus_provider_id}/summary
// Provider-level outcome summary. Returns: avg_delta_PHQ9, avg_delta_GAD7, avg_delta_PCL5, session_count, episode_count, improvement_rate (%)

GET /bus/v1/outcome/aggregate/national
// Public endpoint. Aggregate national outcomes, no individual data. Powers open data dashboard (A4).

GET /bus/v1/outcome/episode/{episode_id}/payment-trigger
// Check whether outcome threshold has been met for payment release. Returns: triggered (bool), delta_achieved, threshold_required, payment_amount_eur

Channel 4 (Payment Bus) — Integration RequirementsКанал 4 (Шина платежів) — Вимоги до інтеграції

POST /bus/v1/payment/escrow/deposit
// Donor deposits funds to escrow. ISO 20022 pain.001 format. currency: [UAH | EUR | USD]. linked_to: programme_id or episode_id

POST /bus/v1/payment/escrow/release
// Trigger payment release after outcome verification. Auto-called by outcome bus when threshold met. Human override requires dual approval (operator + programme manager).

⚠ NBU Regulatory Sandbox application required before production deployment of escrow-to-outcome model. Contact: NBU FinTech Department. Estimated timeline: 6–9 months approval process.

Channel 5 (Reporting Bus) — Required OutputsКанал 5 (Шина звітності) — Обов'язкові вихідні дані

// ESOZ sync (real-time): FHIR R4 Bundle → POST to ESOZ /fhir/Bundle endpoint
// Format: MH Encounter + Practitioner + Patient (pseudonymised) + QuestionnaireResponse
// Schedule: within 24h of session logging

// IATI publication (quarterly): XML 2.03 standard
// Required fields: transaction amounts, implementing organisation, geographic location (oblast), activity dates

// Dashboard feed (continuous): REST/GraphQL → dashboard.feelagain.me
// Public aggregates only: session counts, outcome distributions, provider counts by region, budget flows

Authentication & Security Requirements

All bus endpoints require OAuth 2.0 Bearer token authentication. Operator tokens issued by FEEL Again bus authority after compliance audit. Client data must never leave the operator's infrastructure in identifiable form — only pseudonymous IDs flow on the bus. All connections TLS 1.3. Data at rest AES-256. Clinical data retention: 7 years (Ukrainian health data mandate). GDPR-aligned pseudonymisation for EU-funded programme compliance.

Acceptance Criteria (for partner team handoff)

  • All 5 bus channels implemented and passing integration tests against FEEL Again bus sandbox environment
  • Identity Bus: provider registration roundtrip ≤2 seconds; client pseudonymisation irreversible
  • Session Bus: session log latency ≤500ms; instrument submission validates against FHIR R4 schema
  • Outcome Bus: delta calculation verified against 3 independent test datasets (PHQ-9, GAD-7, PCL-5)
  • Payment Bus: escrow deposit/release auditable — every state change has a timestamped record
  • Reporting Bus: ESOZ test environment accepts FHIR bundles without validation errors; IATI XML validates against IATI schema validator
  • Security: penetration test passed (OWASP Top 10); no PII in bus logs; operator audit trail complete
  • Load test: 500 concurrent session logs without degradation

Вимоги до автентифікації та безпеки

Всі ендпоінти шини потребують автентифікації Bearer token OAuth 2.0. Токени операторів видаються адміністратором шини FEEL Again після аудиту відповідності. Дані клієнтів ніколи не повинні покидати інфраструктуру оператора в ідентифікованому вигляді — по шині рухаються лише псевдонімізовані ID. Всі з'єднання TLS 1.3. Дані в спокої AES-256. Зберігання клінічних даних: 7 років (мандат даних охорони здоров'я України). GDPR-вирівняна псевдонімізація для дотримання вимог програм фінансування ЄС.

Критерії прийому (для передачі партнерській команді)

  • Всі 5 каналів шини реалізовані та проходять інтеграційні тести в sandbox-середовищі шини FEEL Again
  • Шина ідентифікації: roundtrip реєстрації надавача ≤2 секунди; псевдонімізація клієнта незворотна
  • Шина сесій: затримка запису сесії ≤500мс; відправка інструменту валідується за схемою FHIR R4
  • Шина результатів: розрахунок дельти верифікований на 3 незалежних тестових наборах даних (PHQ-9, GAD-7, PCL-5)
  • Шина платежів: депозит/звільнення ескроу аудитовані — кожна зміна стану має позначений часом запис
  • Шина звітності: тестове середовище ЕСОЗ приймає FHIR Bundle без помилок валідації; XML IATI валідується валідатором схеми IATI
  • Безпека: пройдено тест на проникнення (OWASP Top 10); жодних персональних даних у логах шини; аудитовий слід оператора повний
  • Навантажувальний тест: 500 одночасних записів сесій без деградації

6. End-to-End Data Flow 6. Наскрізний потік даних

// Complete transaction lifecycle

1. Identity Bus → Provider registers → BankID verified → credentials checked
2. Identity Bus → Client requests service → pseudonymous ID assigned
3. Session Bus → Session logged → PCL-5/PHQ-9/GAD-7 administered
4. Outcome Bus → Scores computed → Δ calculated → aggregated
5. Payment Bus → Escrow checks outcome → Δ ≥ threshold → payment released
6. Reporting Bus → ESOZ gets FHIR record → IATI gets spend data → Dashboard updates

// Time: registration (days) → first session (minutes) → payment (seconds)
// Every step is auditable, reversible, and traceable to a single source record
Result: donor money → verified outcome → provider paid → state informed → public sees data

7. Document Cross-References 7. Перехресні посилання

This DocumentЦей документ ReferencesПосилання
§1 Six GapsШість розривівDocument 2, §1 (Perfect Storm analysis); Document 4 (all gap widths with data sources)Документ 2, §1 (аналіз Ідеального шторму); Документ 4 (всі ширини розривів з джерелами)
§2 Six LayersШість шарівDocument 1, §4 (Architecture overview); Document 3 (each project maps to a layer — Clusters A/B/C)Документ 1, §4 (огляд архітектури); Документ 3 (кожен проєкт відображається на шар — кластери A/B/C)
§3 Five Bus ChannelsП'ять каналів шиниDocument 3, Cluster A (infrastructure projects A1–A5); Document 1, §7 (Financial Architecture and escrow model)Документ 3, Кластер A (інфраструктурні проєкти A1–A5); Документ 1, §7 (Фінансова архітектура та модель ескроу)
§4 As-Is → To-BeЄ зараз → БудеDocument 4 (all current-state data); Document 3 (all project descriptions and expected results)Документ 4 (всі дані поточного стану); Документ 3 (всі описи проєктів та очікувані результати)
§5 Multi-OperatorМульти-операторDocument 1, §3 (Platform concept and operator roles); Document 3, Project A5 (Payment Processing — Enkidu integration)Документ 1, §3 (концепція платформи та ролі операторів); Документ 3, Проєкт A5 (обробка платежів — інтеграція Enkidu)
§5b Bus Spec (TOR)ТЗ шини→ For Quoroom / HighCastle Technologies dev team; also relevant for any future operator onboarding→ Для команди розробки Quoroom / HighCastle Technologies; також актуально для онбордингу будь-якого майбутнього оператора
§6 Data FlowПотік данихDocument 3, Projects A1–A5 (full implementation scope); Document 5, §2 (communication narrative: "rails not trains")Документ 3, Проєкти A1–A5 (повний обсяг реалізації); Документ 5, §2 (комунікаційний наратив: «рейки, а не потяги»)
Architecture Summary: Six gaps define what is broken. Six layers define what FEEL Again builds to fix each gap. Five bus channels define how data and money actually flow through the system. The bus is the standard — operators are implementations. This is railway infrastructure, not a train company. Every technical decision serves one purpose: making invisible services visible, unfunded services fundable, and unaccountable services accountable.
Резюме архітектури: Шість розривів визначають, що зламано. Шість шарів визначають, що FEEL Again будує для виправлення кожного розриву. П'ять каналів шини визначають, як дані та гроші фактично рухаються через систему. Шина — це стандарт; оператори — це імплементації. Це залізнична інфраструктура, а не потягова компанія. Кожне технічне рішення служить одній меті: робити невидимі послуги видимими, нефінансовані послуги фінансованими, а непідзвітні послуги підзвітними.

© 2026 FEEL Again Programme · feelagain.me · Dashboard:Дашборд: dashboard-1q7.pages.dev