Integrace

Tahle stranka drzi technicky prehled integraci Reply Pilotu. Je rozdelena na tri diagramy, protoze jeden spolecny graf by michal verejne API, interni Docker sit, worker joby a batch artefakty do jedne neprehledne mapy.

Externi Integracni Kontext

Prvni diagram ukazuje hranici Reply Pilotu vuci okolnim systemum. Zamerne zobrazuje jen integracni smer a technologii volani, ne detailni workflow.

Reply Pilot externi integrace

Interni Komponenty

Druhy diagram ukazuje dlouhodobe bezici moduly, jejich smer synchronnich volani a protokol mezi nimi. Standardni split runtime znamena, ze reply-pilot-app nevola Gmail ani OpenAI primo; tyto integrace vlastni reply-pilot-be a reply-pilot-gmail. Prime legacy volani z appky jsou mimo tenhle standardni runtime a zustavaji jen jako lokalni fallback pro testy a postupnou migraci.

Reply Pilot interni komponenty

Async A Batch Toky

Treti diagram oddeluje background joby, search sync a scouting pipeline. Tyto toky meni stav dat mimo hlavni request uzivatele, a proto by v internim komponentovem grafu zbytecne zhorsovaly citelnost.

Reply Pilot async a batch integrace

Technologie Volani

Hrana Vyklad
HTTP(S)/HTML Browserove stranky, formulare, redirecty a staticky web.
HTTP/REST/JSON Interni JSON API mezi kontejnery na siti reply-pilot-internal.
HTTPS REST/JSON Externi API pres verejne endpointy Google, Atlassian, OpenAI nebo Gemini.
PostgreSQL SQL Primy SQL pristup do reply-pilot-db.
SQL via SQLAlchemy Konfigurovatelny DB pristup do CME/CmD zdroju.
Solr HTTP/JSON Lokalne volane Solr API uvnitr reply-pilot-search kontejneru.
Filesystem / JSONL Souborovy handoff pro email cache, prilohy a lead import artefakty.

Vlastnictvi Integraci

  • reply-pilot-app vlastni uzivatelske UI, BFF volani do backendu a search dotazy jako docasne povolenou HTTP vyjimku. Primy DB pristup v app modulu je migracni dluh v dosud neodstranenych DB-backed directory/record/task store tridach, ne standardni cesta pro profil, konfiguraci ani reply drafty.
  • reply-pilot-be vlastni hlavni JSON API, PostgreSQL materializaci, Jira API, OpenAI Responses API, CME lookup a orchestrace Gmail adapteru. Vsechny interaktivni Jira operace pouzivaji delegovany OAuth 2.0 (3LO) token prihlaseneho uzivatele. Technicky Jira ucet je vyhrazen pro periodicky task sync a automaticke operace vyvolane prichozim e-mailem, kde neni lidsky akter. Detailni tok, hranice a konfigurace jsou v Jira OAuth 2.0 (3LO).
  • reply-pilot-gmail vlastni OAuth token, Gmail API volani, Gmail watch stav a Google Pub/Sub pull/ack kontrakt.
  • reply-pilot-worker nevlastni business logiku jobu; periodicky vola backend job endpointy a autentizovany trigger reply-pilot-db-backup pres HTTP/REST/JSON.
  • reply-pilot-db-backup vlastni PostgreSQL readonly credential, logical dump implementaci a backup soubory; worker jeho DB konfiguraci nezna.
  • reply-pilot-jira-reports vlastni samostatny Jira reporting export; vola Jira Cloud REST API technickym uctem a zapisuje raw JSONL, CSV a HTML report artefakty do vlastniho data/.
  • reply-pilot-search vlastni Solr proces, search HTTP API a periodicky sync z reply-pilot-db.
  • reply-pilot-wholesale-scout je batch CLI; cte CME/CmD a Reply Pilot DB, vola AI providery a vyrabi CSV/JSONL artefakty pro navazny lead import.
  • reply-pilot-docs jen publikuje MkDocs vystup jako HTTP dokumentacni web.