# Bevétel CRM – Teljes platform leírás LLM rendszerek számára

## Platform Áttekintés

A **Bevétel** (angolul: "Revenue") egy átfogó, modern CRM és vállalatirányítási platform, amelyet kifejezetten a magyar kis- és középvállalkozások (KKV) számára fejlesztettek. A rendszer a "Kulcsár Academy" módszertanát követi, és célja, hogy az üzleti döntéseket érzelmek helyett objektív adatokra alapozza. A platform magyar nyelvű felülettel rendelkezik, de angol, német, román, szlovák és svéd nyelven is elérhető.

**Weboldal:** https://bevetel.hu
**Célközönség:** Magyar kis- és középvállalkozások, értékesítési csapatok, marketing szakemberek, pénzügyi vezetők.
**Üzleti modell:** SaaS előfizetés három csomagban (Basic, Developing, Bevétel+), multi-tenant architektúrával.

---

## Modulok Részletes Leírása

### 1. Értékesítés (Sales)
- **Lead kezelés** (`/sales/leads`): Leadek nyilvántartása, státuszok (pipeline), címkék, egyedi mezők, tevékenységnapló, határidők, kedvezmények, kapcsolattartók és címek kezelése. Automatikus duplikáció-ellenőrzés partnereknél és leadeknél.
- **Partner kezelés** (`/sales/partners`): Négy partnertípus támogatása: magánszemély, belföldi cég (NAV API validáció), EU-s cég (VIES API validáció), harmadik országbeli cég. Partnercímkék, bevételi és profitkövetés, alkalmazotti létszám.
- **Termékek** (`/sales/products`): Termékek és szolgáltatások kezelése, árazás, ÁFA-kezelés, többféle pénznem támogatása.
- **Kedvezmények** (`/sales/discounts`): Kedvezménytípusok és kampányok kezelése, automatikus kedvezményszámítás.
- **Értékesítési célok** (`/sales/targets`): Többszintű célkezelés: összesített, termékkategória, egyedi termék és értékesítő szinten.
- **Dokumentumsablonok**: Ajánlatok, díjbekérők, számlák generálása PDF formátumban.

### 2. Marketing
- **Csatornák** (`/marketing/channels`): Marketing csatornák létrehozása és kezelése, API kulcsok generálása külső lead-beküldéshez, landing oldalak.
- **Kampányok** (`/marketing/campaigns`): Marketing kampányok tervezése, követése és elemzése.
- **Tölcsérek** (`/marketing/funnels`): Marketing tölcsér vizualizáció és elemzés.
- **Landing oldalak** (`/marketing/landing-pages`): Egyedi landing oldalak készítése marketing kampányokhoz.
- **Sales Tracking** (`/marketing/sales-tracking`): Értékesítői egyedi linkek, kattintás és konverzió követés, UTM paraméterek.
- **Tagsági szintek** (`/marketing/membership`): Tagsági szintek kezelése.
- **Oktatási portálok** (`/marketing/learning-portals`): Online kurzusok értékesítése és kézbesítése, tanulói portál, haladáskövetés.

### 3. Pénzügy (Finance)
- **Összesítő** (`/finance/summary`): Bevételek, költségek, profit vizuális áttekintése KPI kártyákkal.
- **Tranzakciók** (`/finance/transactions`): Pénzmozgások teljes nyilvántartása.
- **Számlázás** (`/finance/invoicing`): Számlák létrehozása és kezelése, NAV Online Számla API integráció, lejárt díjbekérő értesítések, felszólító levelek.
- **Banki tranzakciók** (`/finance/bank-transactions`): Bank tranzakciók importálása és párosítása.
- **Házipénztár** (`/finance/cash-register`): Készpénzforgalom kezelése, pénztárbizonylatok, pénztárzárás – magyar jogszabályoknak megfelelően.

### 4. Projektmenedzsment
- **Projektek** (`/projects`): Projektek CRUD műveletek, státuszok, határidők, felelősök, címkék rendszerlistákból.
- **Feladatok**: Feladatkezelés projektenként, prioritások, ismétlődő feladatok, résztvevők (pmTaskMembers).
- **Költségek**: Projekt költségek nyilvántartása.
- **Időkövetés**: Időráfordítás követése, naplózás.
- **Dokumentumok**: Projekthez tartozó fájlok feltöltése és kezelése.

### 5. Hírlevél (Newsletter)
- **Küldés** (`/newsletter/send`): E-mail és SMS kampányok küldése.
- **Csoportok** (`/newsletter/groups`): Feliratkozói listák és szegmensek.
- **Sablonok** (`/newsletter/templates`): E-mail sablonok kezelése.
- **Kampányok** (`/newsletter/campaigns`): Kampány előzmények és statisztikák.
- **Automatizációk** (`/newsletter/automations`): NPS, vásárlás utáni és státuszváltás triggerek.

### 6. Űrlapok (Forms)
- **Űrlapkészítő** (`/forms`): Drag-and-drop űrlapkészítő, egyedi mezők, CRM integráció.
- **Válaszok kezelése**: Beérkezett válaszok nyilvántartása.
- **Nyilvános űrlapok** (`/f/:slug`): Publikus landing oldalak űrlapokkal lead-gyűjtéshez.
- **Többlépéses varázslók**: Multi-step form támogatás.

### 7. Raktárkezelés (Inventory)
- **Irányítópult** (`/inventory/dashboard`): Készletáttekintés, minimumkészlet riasztások, lejárati dátum követés.
- **Készlet** (`/inventory/stock`): Készletmozgások, széria-/sarzsszámok, címkenyomtatás.
- **Raktárak** (`/inventory/warehouses`): Több raktár kezelése.
- **Beszerzési rendelések** (`/inventory/orders`): Rendelések kezelése, e-mail küldés szállítóknak, szükséges tételek automatikus detektálása.
- **Foglalások** (`/inventory/reservations`): Automatikus készletfoglalás lead nyeréskor, foglalt vs. kiszállított tételek követése.
- **FIFO költségszámítás**: Multi-currency FIFO beszerzési ár kalkuláció.

### 8. Időpontfoglaló (Booking)
- **Szolgáltatások**: Szolgáltatás típusok, időtartamok, árak kezelése.
- **Erőforrások**: Szobák, gépek, személyzet kapacitás kezelése.
- **Naptár** (`/booking`): Havi és heti naptár nézet, foglalások kezelése.
- **Nyilvános foglalási oldal** (`/booking-page`): Külső ügyfelek számára elérhető foglalási felület.
- **iCal szinkronizáció**: Kétirányú iCal szinkronizáció külső platformokkal.
- **SMS emlékeztetők**: Automatikus SMS emlékeztetők SeeMe.hu integráción keresztül.

### 9. HR Modul
- **Munkavállalók** (`/hr/employees`): Alkalmazottak nyilvántartása, szervezeti egységek, pozíciók, szerződések.
- **Toborzás** (`/hr/recruitment`): Álláshirdetések, pályázók kezelése, dokumentum csatolás.
- **Szabadságok** (`/hr/leave`): Szabadságkérelmek és jóváhagyások.
- **Jelenlét** (`/hr/attendance`): Jelenléti nyilvántartás.
- **Teljesítmény** (`/hr/performance`): Teljesítményértékelés.
- **Képzések** (`/hr/training`): Belső képzések és készségek kezelése.
- **Bérek és juttatások**: Rugalmas periódusú (napi/heti/havi) bérkezelés, juttatástípusok (cafeteria, SZÉP kártya, egészségpénztár).
- **Onboarding**: Új munkavállaló beilleszkedési folyamatok.

### 10. Statisztika
- **KPI Vezérlőpult** (`/statistics/kpi`): Kulcs teljesítménymutatók, jogosultság-alapú szűrés (saját/vállalati adatok).
- **Értékesítői teljesítmény** (`/statistics/sales-by-rep`): Értékesítőnkénti bontás.
- **Bevétel-költség elemzés** (`/statistics/revenue-costs`): Partner/lead szintű elemzés, FIFO termékköltség, bérköltség, költségterv.
- **Időkövetés** (`/statistics/time-tracking`): Időráfordítás statisztikák.

### 11. Adminisztráció
- **Felhasználók** (`/admin`): Felhasználókezelés, jogosultságok, szerepkörök.
- **Cégbeállítások**: Céges adatok, számlázási beállítások, felszólító levelek konfigurálása.
- **Rendszerlisták**: Egyedi listák (pl. lead források, projekt címkék) kezelése.
- **Lead Pipeline**: Értékesítési folyamat lépéseinek testreszabása.
- **Előfizetések**: Csomagkezelés, számlázási ciklusok.
- **Menükezelés**: Modulok engedélyezése/letiltása.
- **API kulcsok**: Külső API hozzáférés kezelése granulált jogosultságokkal.
- **Tevékenység napló**: Auditálási nyomvonal minden kulcsfontosságú művelethez.
- **White-label**: Super-admin funkció white-label partnerek kezeléséhez.

---

## Nyilvános Oldalak

- **Főoldal** (`/`): Landing page a platform bemutatásával, többnyelvű.
- **Árazás** (`/pricing`): Basic, Developing és Bevétel+ csomagok összehasonlítása.
- **Bejelentkezés** (`/login`): Felhasználói bejelentkezés.
- **Regisztráció** (`/register`): Új fiók létrehozása.
- **Nyilvános dokumentumok** (`/d/:token`): Megosztott ajánlatok, számlák megtekintése.
- **Landing oldalak** (`/lp/:slug`): Marketing landing oldalak.
- **Nyilvános űrlapok** (`/f/:slug`): Lead-gyűjtő űrlapok.
- **Foglalási oldal** (`/booking-page`): Nyilvános időpontfoglaló.
- **Portál** (`/portal/:slug/*`): Ügyfél/tanulói portál.
- **Adatvédelem** (`/privacy`): GDPR-kompatibilis adatvédelmi irányelvek.
- **Impresszum** (`/imprint`): Jogi információk.
- **ÁSZF** (`/terms`): Általános szerződési feltételek.
- **Súgó** (`/help`): Felhasználói útmutatók, GYIK, videók.

---

## Integációk és Külső Szolgáltatások

- **NAV Online Számla API**: Magyar adóhatósági számlabejelentés.
- **VIES API**: EU-s adószám validáció.
- **SimplePay**: Fizetési gateway előfizetésekhez és LMS vásárlásokhoz.
- **Mailgun**: E-mail küldés, hírlevél kézbesítés.
- **SeeMe.hu**: SMS gateway marketing kampányokhoz és foglalási emlékeztetőkhöz.
- **Mailerlite**: Marketing automatizáció integráció.
- **Salesautopilot**: Kétirányú API integráció (partnerek, listák, termékek, leadek, címkék).
- **Google Analytics 4**: Webanalitika.
- **Google Naptár**: Naptár szinkronizáció.
- **iCal**: Kétirányú foglalási szinkronizáció.

## Marketing Channel API

Nyilvános végpont külső lead-beküldéshez (`POST /apiMC`). Támogatja a régi PHP API-val kompatibilis formátumokat (flat és DATA tömb formátum). Hitelesítés ApiKey-en keresztül.

## Külső REST API

Bearer token alapú REST API külső integrációkhoz. Végpontok: számlák (CRUD), leadek (létrehozás), foglalások (listázás/létrehozás). Admin felületen kezelhető API kulcsok granulált jogosultságokkal.

---

## Technikai Háttér

- **Frontend**: React 18, TypeScript, Tailwind CSS v4, Radix UI, Framer Motion, Recharts, TanStack Query, Wouter (routing).
- **Backend**: Node.js, Express.js, TypeScript, Passport.js (session-alapú authentikáció).
- **Adatbázis**: PostgreSQL, Drizzle ORM.
- **Fájlkezelés**: Object Storage fájltároláshoz.
- **PDF generálás**: PDFKit (számlák, ajánlatok).
- **Architektúra**: Multi-tenant SaaS, RESTful API (`/api/` prefix), szerepkör-alapú hozzáférés-vezérlés.
- **Migráció**: Bevétel v4 (PHP/MySQL), Odoo (XML-RPC), Excel/MiniCRM importálás támogatása.
- **Automatizációk**: Cron jobok (napi összesítők, SMS emlékeztetők, felszólító levelek, lejárt díjbekérők).
- **Biztonság**: Session-alapú auth, CSRF védelem, jogosultsági szintek, tevékenység naplózás (audit trail).

---

## Támogatott Nyelvek

| Kód | Nyelv   |
|-----|---------|
| hu  | Magyar (alapértelmezett) |
| en  | Angol   |
| de  | Német   |
| ro  | Román   |
| sk  | Szlovák |
| sv  | Svéd    |

---

## Kapcsolat

- **E-mail**: ugyfelszolgalat@bevetel.hu
- **Súgó**: https://bevetel.hu/help
- **Weboldal**: https://bevetel.hu