Rychlý start - EmbedDataFeed

📋 Co se naučíte

Přehled systému
První vyhledávání
Základy API
Rychlá n8n integrace
Monitoring systému
Další kroky

🎯 Přehled systému

Co je EmbedDataFeed?

Inteligentní vyhledávací systém pro produkty z Heureka XML feedu s využitím AI embeddings. Umožňuje sémantické vyhledávání v češtině pomocí Seznam AI modelu.

🔍 Sémantické vyhledávání

Najde produkty i podle významu, ne jen klíčových slov

🤖 AI embeddings

Seznam/simcse-dist-mpnet-paracrawl-cs-en model

🔗 n8n integrace

Jednoduché napojení na automatizační workflow

📊 Real-time monitoring

Webový dashboard s live statistikami

🔍 První vyhledávání za 2 minuty

1. Otevřete dashboard

Přejděte na http://localhost:8085/

✅ Měli byste vidět zelený status všech služeb

2. Zkuste vyhledávání

V sekci "Test vyhledávání" zadejte dotaz:

Příklady dotazů:
• "iPhone 15 Pro"
• "herní klávesnice"
• "bezdrátová sluchátka"
• "fitness náramek"
• "kávovar pro domácnost"
                

3. Prozkoumejte výsledky

Systém vrátí nejrelevantnější produkty s:

Názvem produktu
Popisem
Cenou
Skóre relevance (0-1)

⚡ API za 3 minuty

1. Test základního vyhledávání

curl -X POST "http://localhost:8085/api/search" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "smartphone",
    "limit": 3
  }'
            

2. n8n formát (pro automatizaci)

curl -X POST "http://localhost:8085/api/proxy?url=http://localhost:8001/n8n/search" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hledám notebook do 30000 Kč",
    "limit": 3
  }'
            

3. Přímé embedování textu

curl -X POST "http://localhost:8085/api/proxy?url=http://localhost:8001/embed" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "herní počítač"
  }'
            

💡 Tip pro vývojáře

Použijte /api/proxy endpoint pro CORS-free volání z prohlížeče, nebo přímo IP:port pro server-to-server komunikaci.

🔗 n8n integrace za 5 minut

1. Vytvořte nový workflow v n8n

Otevřete http://localhost:5678 (váš n8n)

2. Přidejte HTTP Request node

URL: http://localhost:8085/api/proxy?url=http://localhost:8001/n8n/search
Method: POST
Body Type: JSON

Body:
{
  "message": "{{$json.query}}",
  "limit": 5
}
            

3. Test s ukázkovým dotazem

{
  "query": "bezdrátová myš"
}
            

🎉 Hotovo!

Máte funkční AI vyhledávání v n8n. Detailní návod najdete v n8n dokumentaci.

📊 Monitoring za 1 minutu

✅ Rychlý health check

Dashboard načítá bez chyb Všechny služby jsou "healthy" Počet produktů > 0 API test vyhledávání funguje SSL certifikát je platný

Automatický monitoring script

#!/bin/bash
# Uložte jako health-check.sh a spusťte pravidelně

echo "=== EmbedDataFeed Health Check ==="
echo "Timestamp: $(date)"

# API test
response=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8085/api/proxy?url=http://localhost:8001/health)
if [ $response = "200" ]; then
  echo "✅ API: OK"
else
  echo "❌ API: FAILED ($response)"
fi

# Database check
count=$(curl -s http://localhost:8085/api/qdrant-stats | jq -r '.collections[0].points_count // 0')
echo "📊 Produkty v DB: $count"

# Docker status
echo "🐳 Docker služby:"
docker compose -f /srv/projects/embedDataFeed/docker-compose.yml ps --format "table {{.Service}}\t{{.Status}}"
            

🎯 Další kroky

📚 Prostudujte dokumentaci

🔧 Přizpůsobte systém

Upravte XML feed URL
Nastavte automatické aktualizace
Konfigurujte search parametry

🚀 Rozšiřte funkcionalitu

Implementujte autentifikaci
Přidejte více datových zdrojů
Vytvořte custom dashboard

📊 Optimalizujte výkon

Monitorujte response times
Laďte Qdrant parametry
Optimalizujte search queries

⚠️ Důležité poznámky pro produkci

Zálohy: Pravidelně zálohujte Qdrant data
Monitoring: Nastavte alerty pro výpadky služeb
Aktualizace: Sledujte aktualizace Docker images
Bezpečnost: Zvažte přidání API autentifikace

🆘 Potřebujete pomoc?

Zkontrolujte troubleshooting guide
Prohledejte logy: docker compose logs [service-name]
Restartujte služby: docker compose restart
Kontaktujte správce systému s detailním popisem problému

🚀 Rychlý start