Intelligens Marketing Automatizálási Platform

Verzió: Beta 0.1

Ez a projekt egy TypeScript alapú intelligens marketing automatizálási platform fejlesztését célozza. A webalkalmazás mesterséges intelligencia segítségével automatizálja és optimalizálja a különböző marketing feladatokat, különös tekintettel az e-mail kampányokra, AI ügynökökre és SEO tartalomkészítésre. Képes kapcsolódni WooCommerce webshopokhoz termékadatok lekérésére és elemzésére.

Főbb Funkcionalitások

• E-mail Kampánykezelés: Kampányok létrehozása, ütemezése, küldése, nyomon követése, A/B tesztelés, automatizált e-mailek (Unlayer, React Email).
• Marketing AI Ügynök Feladatok (AI Job Tracker): Előre definiált marketing feladatok automatizálása (pl. Elhagyott Kosár, Üdvözlő E-mail, Kupon Generátor, Influencer AI, Termékleírás SEO AI, Árfigyelő AI) webhookok és AI segítségével. A feladatok státusza követhető és naplózható.
• AI SEO Tartalomírás: Mesterséges intelligencia alkalmazása SEO-optimalizált tartalmak (blogbejegyzések, termékleírások stb.) létrehozására és optimalizálására.
• WooCommerce Integráció: Termékadatok (leírás, ár, SEO metaadatok) lekérése és elemzése API kulcsok segítségével.
• Influencer Platform: Influencerek regisztrációja, keresése, kampánykezelés.

Felhasznált Technológiák

Frontend & UI:

• Next.js (v15+, App Router)
• React (v18+)
• TypeScript (v5+)
• HeroUI/React
• Radix UI
• Tailwind CSS
• Class Variance Authority (cva) (Hasonló a Tailwind Variants-hez)
• tailwind-merge
• Framer Motion
• Recharts
• Lucide React
• Iconify
• @hello-pangea/dnd (Drag & Drop)
• next-themes (Téma váltás)

Backend & Adatbázis:

• Supabase (Backend as a Service: PostgreSQL, Auth, Storage)
• Next.js API Routes
• Drizzle ORM
• Drizzle Kit (Migrációk)

AI Integrációk:

• Vercel AI SDK
• OpenAI
• OpenRouter
• Together AI
• DeepSeek
• Google Gemini
• Firecrawl (Web tartalom feldolgozás)

E-mail:

• Unlayer (react-email-editor) (Szerkesztő)
• React Email (Sablonok, küldés)

Fizetés:

• Stripe

Állapotkezelés & Adatlekérés:

• SWR
• React Context API

Fejlesztési Eszközök & Egyéb:

• Biome (Linting/Formázás)
• ESLint (Linting)
• Zod (Validáció)
• Upstash RateLimit
• Vercel Blob (Fájltárolás)
• Vercel Analytics
• Git (Verziókezelés)
• Docker (Opcionális konténerizáció)

Telepítés és Indítás

Előfeltételek:

• Node.js (ajánlott LTS verzió)
• npm vagy yarn csomagkezelő
• Git

Telepítés:

1. Klónozd a repository-t:

   git clone https://github.com/NagyVikt/rankedapp.git # Helyettesítsd be a saját repository URL-eddel
   cd rankedapp

2. Telepítsd a függőségeket:

   npm i

   (Vagy ha yarn-t használsz: yarn install)

3. Környezeti Változók Beállítása:

   • Másold le a .env.example fájlt .env.local néven: cp .env.example .env.local
   • Töltsd ki a .env.local fájlt a szükséges értékekkel (Supabase URL/kulcsok, Stripe kulcsok, AI API kulcsok, adatbázis URL, Vercel Blob token, Upstash Redis URL/token stb.). Ezeket a megfelelő szolgáltatók adminisztrációs felületein találod.
   • Fontos: A .env.local fájlt soha ne tedd a verziókövető rendszerbe (a .gitignore fájlnak tartalmaznia kell).

4. Adatbázis Migráció (Drizzle):

   • Győződj meg róla, hogy a DATABASE_URL helyesen van beállítva a .env.local fájlban.
   • Futtasd a migrációt a séma létrehozásához/frissítéséhez:

     npm run db:push

     (Vagy a Drizzle Kit specifikus parancsát, ha van ilyen definiálva a package.json-ban)

5. Fejlesztői Szerver Indítása:

   npm run dev

   (Vagy ha yarn-t használsz: yarn dev)

Az alkalmazás alapértelmezetten a http://localhost:3000 címen lesz elérhető.

Következő Lépések

A projekt további fejlesztése a "Projekt Terv Vázlat" dokumentumban részletezett ütemezés szerint halad, beleértve a funkciók részletes specifikálását, UI/UX tervezést és az egyes modulok implementálását.