Integrace REMP s Folio CMS (Economia)
Shrnutí
Economia se rozhodla pro systém REMP (remp2020) jako řešení pro správu předplatného, paywallu a čtenářského engagementu. REMP dodává a provozuje FatChilli. Integraci s Folio CMS zajišťuje Sinfin. Tento dokument shrnuje podklady pro třístrannou spolupráci na integraci.
Scope 1. fáze: Integrace všech modulů REMP kromě Beam tracking (analytics/pageview tracking).
Klíčové zjištění: REMP monorepo (Beam, Campaign, Mailer, SSO) neobsahuje CRM/subscription/payment modul. Ten existuje jako samostatný produkt — REMP CRM s moduly crm-subscriptions-module, crm-payments-module, crm-users-module atd. Nasazení a konfiguraci REMP CRM řeší FatChilli. Na Sinfin je připravit integrační rozhraní na straně Folio CMS a společně s FatChilli a Economia vyřešit API kontrakt.
Dokumenty
| # | Dokument | Popis |
|---|---|---|
| 1 | 01-system-boundary.md | Hranice odpovědnosti mezi CMS a REMP |
| 2 | 02-api-contract.md | API kontrakt mezi systémy, endpointy, flow |
| 3 | 03-implementation-plan.md | Implementační plán napojený na konkrétní endpointy a třídy |
| 4 | 04-estimate.md | Nacenění, tým, harmonogram od 21. 7. 2026 |
| 5 | 05-identity-integration.md | Ecoidentita × REMP × CMS – identita a autentizace |
| 6 | 06-notifications-emails.md | E-mailové notifikace, newslettery, REMP Mailer |
| 7 | 07-open-questions.md | Otázky, rizika, rozhodnutí k ověření |
| 8 | 08-function-coverage.md | Matice pokrytí funkcí systémy, nepokryté oblasti |
Technologický kontext
| Systém | Stack | Účel |
|---|---|---|
| Folio CMS | Ruby on Rails 8, PostgreSQL, Sidekiq, Stimulus | Redakční systém, obsah, šablony, paywall UI, integrační vrstva na REMP |
| REMP Beam | Laravel (PHP) + Go (Tracker, Segments) + Elasticsearch + Kafka | Tracking, segmentace, real-time analytika |
| REMP Campaign | Laravel (PHP) | Bannery, showtime, A/B testy, cílení dle segmentů |
| REMP Mailer | Nette (PHP) + Redis (Hermes queue) | Newslettery, hromadné maily, uživatelské odběry |
| REMP SSO | Laravel (PHP) + JWT | Autentizace admin nástrojů REMP, API tokeny |
| REMP CRM | Nette (PHP), moduly (users, subscriptions, payments, segments…) | Správa uživatelů, předplatných, plateb, entitlementů |
| Ecoidentita | SSO provider (Economia) | Jednotné přihlášení across ECO weby |
K vyjasnění mezi třemi stranami
-
Source of truth pro předplatné — REMP CRM (FatChilli) je SoT pro produkty, předplatné a platby. CMS potřebuje jen cache/proxy vrstvu. K vyjasnění: detaily API kontraktu a webhook notifikací.
-
Identita uživatele — Jak propojit Ecoidentita → Folio::User → REMP CRM User? Kdo spravuje mapovací tabulku?
-
Paywall engine — Server-side (CMS volá CRM API — latence?) vs. client-side (JS widget od FatChilli)? Jaká cache strategie?
-
Checkout UX — Checkout flow je v REMP CRM. Bude mít vlastní UI, nebo CMS poskytne frontend, který volá CRM backend API?
-
Self-care — Uživatelský profil a správa předplatného v REMP CRM. Bude integrováno do webu (iframe / API), nebo jako oddělená stránka?
-
API kontrakt — Které REMP CRM endpointy bude CMS volat (entitlement, user sync)? Jaké webhooky pošle CRM směrem k CMS?
Předpoklady dokumentu
- Analýza vychází z kódu v repozitářích
remp(monorepo) aeconomia-cms(Folio). - FE integrační dokumentace od FatChilli — PDF guides v
economia-cms/docs/tasks/CMS-REMP/src/: Paywall Integration (Non-WordPress), Campaign integration, Beam tracking, CRM User management. Tyto soubory jsou vstupní vendor podklady, ne autoritativní dokumentace tohoto repozitáře. - REMP CRM moduly (crm-subscriptions-module, crm-payments-module, crm-users-module) jsou k dispozici na github.com/remp2020, ale nebyly součástí dodané dokumentace — vycházíme z API kontraktů, které REMP Mailer a Campaign očekávají.
- REMP jako celek (CRM, Campaign, Mailer, Beam, SSO) dodává a provozuje FatChilli. Sinfin neřeší nasazení REMP.
- Sinfin řeší integrační kód na straně Folio CMS a koordinuje s FatChilli API kontrakt.
- HN.cz epics & stories 2.0 slouží jako referenční přehled stávajícího scope prací.
- Ceny za integrační práce na straně Sinfin jsou orientační a vyžadují refinement po zodpovězení otevřených otázek a upřesnění scope od FatChilli.
Co není obsahem této fáze
- Beam tracking (pageview tracking, real-time dashboard) — plánováno jako fáze 2
- Migrace legacy e-shopu HN — řeší se paralelně dle
boutique-legacy-integration.md - Platební brána — řeší FatChilli v rámci REMP CRM
- Mobilní aplikace — stávající API zůstává, doplní se o entitlement kontroly