Funnel_Wiki/Architektura.md

Architektura

Technologický stack

Vrstva	Technologie
Framework	Laravel 12, PHP 8.2+
Frontend	Livewire 3, Tailwind CSS, Vite
Autentizace	Laravel Jetstream + Sanctum
Queue	Laravel Queue (databáze nebo Redis)
Debugging	Laravel Telescope, Laravel Pulse
Email	SMTP / Microsoft Graph
Externí integrace	SmartEmailing API, Vario SOAP, PBX

Adresářová struktura

app/
├── Console/Commands/     # Artisan příkazy (sync, rebuild, backfill...)
├── Http/
│   ├── Controllers/
│   │   ├── Api/Tracking/ # Browser tracking endpointy
│   │   ├── Api/Eshop/    # Server-to-server eshop endpointy
│   │   └── Admin/        # Web admin controllery
│   └── Middleware/
│       ├── ResolveTrackingSite  # Ověření X-Site-Key
│       ├── CorsForTracking      # CORS pro tracking API
│       └── LogEshopRequest      # Logování eshop requestů
├── Jobs/                 # Background joby (queue)
├── Livewire/Admin/       # Livewire komponenty admin UI
├── Models/               # Eloquent modely
├── Services/
│   ├── Actions/          # ActionRunner + drivery akcí
│   ├── Ai/               # OpenAI integrace
│   ├── Funnel/           # RulesEngine, FunnelAssigner
│   ├── GeoIP/            # Geo-lookup
│   ├── Ingest/           # IngestEvent pipeline
│   ├── Integrations/     # SmartEmailing klient
│   ├── Tracking/         # IdentityLinker, CategoryTree, BotDetector...
│   └── Vario/            # Vario SOAP sync
public/
└── collect.js            # Tracking skript pro weby/eshopy
routes/
├── api.php               # API endpointy
└── web.php               # Admin web rozhraní

Klíčové modely

Model	Tabulka	Popis
Contact	contacts	Identifikovaný zákazník/návštěvník
FunnelCart	funnel_carts	Nákupní košík
FunnelEvent	funnel_events	Každá trackovací událost
FunnelRule	funnel_rules	Pravidlo automace (trigger + podmínky)
FunnelAction	funnel_actions	Akce spouštěná pravidlem
FunnelState	funnel_states	Aktuální stav kontaktu v segmentu/sloupci
Segment	segments	Skupina kontaktů s vlastními pravidly
FunnelColumn	funnel_columns	Sloupec (stav) v segmentu
EmailCampaign	email_campaigns	Emailová kampaň
EmailCampaignSend	email_campaign_sends	Jeden plánovaný email send
EmailTemplate	email_templates	Šablona emailu
TrackingSite	tracking_sites	Web/eshop identifikovaný Site Key
TrackingProduct	tracking_products	Produkt zaznamenaný z košíků
VisitorIdentity	visitor_identities	Mapping visitor_id → contact_id

Multi-tenancy

Aplikace je multi-tenant přes team_id. Každý tým má vlastní kontakty, segmenty, kampaně a tracking sites. Autentizace týmů probíhá přes Laravel Jetstream.