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, search dotazy a primy DB zapis pro simple-auth nonce a typed AI prompty.
  • reply-pilot-be vlastni hlavni JSON API, PostgreSQL materializaci, Jira API, OpenAI Responses API, CME lookup a orchestrace Gmail adapteru.
  • 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 pres HTTP/REST/JSON.
  • 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.