Documentație
Genesis SMM CMS — Product Manual
Genesis SMM CMS v1.5.10 · Documentație 1.5.10
1. [Introducere](introduction.md)
2. [Funcționalități](features.md)
3. [Arhitectură](architecture.md)
4. [Pornire rapidă](quick-start.md)
5. [Instalare](installation.md)
6. [Activarea licenței](license-activation.md)
7. [Configurare inițială](initial-setup.md)
8. [Tablou de bord](dashboard.md)
9. [Clienți](clients.md)
10. [Proiecte](projects.md)
11. [Brand Center](brand-center.md)
12. [Conținut](content.md)
13. [Calendar de conținut](content-calendar.md)
14. [AI Studio](ai-studio.md)
15. [AI Assistant](ai-assistant.md)
16. [Flux de aprobare](approval-workflow.md)
17. [Client Portal](client-portal.md)
18. [Media Library](media-library.md)
19. [Campaign Manager](campaign-manager.md)
20. [Social Accounts](social-accounts.md)
21. [Publishing Queue](publishing-queue.md)
22. [Analytics](analytics.md)
23. [CRM & Leads](crm.md)
24. [Automatizare](automation.md)
25. [Website](website.md)
26. [Marketing (Telegram)](marketing.md)
27. [Widgeturi și coduri](widgets.md)
28. [Traduceri](translations.md)
29. [Utilizatori și securitate](users.md)
30. [Security Center](security-center.md)
31. [Update Center](update-center.md)
32. [Marketplace Pairing](marketplace-pairing.md)
33. [IuVe Identity](iuve-identity.md)
34. [Cron](cron.md)
35. [Backup](backup.md)
36. [Restaurare](restore.md)
37. [API](api.md)
38. [Integrări](integrations.md)
39. [Performanță](performance.md)
40. [Securitate](security.md)
41. [FAQ](faq.md)
42. [Depanare](troubleshooting.md)
43. [Roadmap](roadmap.md)
AI Assistant
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 15
/api/ai-chat.php trimite mesajul împreună cu profilul de brand al proiectului către IuVeAI folosind cheia kai_live_*. Impune HTTPS, host-ul www.iuve.eu și prefixul /api/; dacă cloud-ul este indisponibil și fallback-ul este oprit, returnează un 502 controlat și nu fabrică niciodată conținut.
AI Studio
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 14
Un hub cu legături către IuVeAI Center, un brief de conținut și Brand Center. Generarea se face prin asistentul IuVeAI, ancorat în contextul de brand al proiectului. Generatoarele dedicate (Prompt Builder, generatoare de Calendar/Campanii, Rewrite/Summarize/Expand/SEO/CTA) sunt pe Roadmap.
Analytics
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 22
Website Analytics urmărește evenimentele prin /api/analytics-track.php cu o vizualizare de admin și export CSV; consimțământul pentru cookie prin /api/consent.php. Metricile social-media (reach, afișări, rată de engagement) sunt un registru doar-citire; dashboard-urile avansate sunt Roadmap v1.1.
API
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 37
Endpoint-uri publice: /api/ai-chat.php (asistent IuVeAI), /api/lead.php (captare lead-uri), /api/analytics-track.php (analiză), /api/consent.php (consimțământ cookie), /api/system/about.php. Toate datele de intrare sunt validate; răspunsurile folosesc JSON UTF-8.
Flux de aprobare
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 16
Etapele de workflow ale conținutului (idea → editor review → design review → manager review → client review → approved → scheduled → published) sunt reale și se pot seta pe fiecare element de conținut. Ecranul dedicat de aprobări este un registru doar-citire în v1.0.0; acțiunile interactive de aprobare din acea listă sunt pe Roadmap.
Arhitectură
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 3
Genesis Core (bootstrap, setări, audit, CSRF) → Security → IuVe Identity → Marketplace Pairing/Update → IuVeAI → module SMM (clienți/proiecte/brand/conținut/calendar/campanii/aprobări/publicare/analiză/CRM/automatizare) → website-ul public al agenției și Client Portal.
Automatizare
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 24
Registru de reguli de automatizare (nume, tip de declanșator, activat, ultima rulare) cu un tabel de rulări. Editorul de reguli și motorul de execuție sunt pe Roadmap.
Backup
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 35
Faceți backup bazei de date și fișierelor (în special config/, storage/uploads/ și installed.lock) înainte de actualizări. Restaurați importând dump-ul bazei de date și refăcând fișierele, apoi revalidați licența în Marketplace Pairing.
Brand Center
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 11
Profilurile de brand pe proiect (nume de brand, misiune, tone of voice, termeni permiși/interziși, public-țintă, instrucțiuni AI) sunt stocate și folosite de asistentul IuVeAI la fiecare cerere. În v1.0.0 ecranul Brand Center pe client este un registru doar-citire; editorul interactiv pe client este pe Roadmap. Editarea brandului la nivel de agenție este disponibilă în CMS Brand & Design.
Campaign Manager
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 19
Registru de campanii (nume, obiectiv, status, început/sfârșit). Câmpurile de buget/KPI există în schemă; constructorul complet de campanii și interfața de asociere a conținutului sunt pe Roadmap.
Client Portal
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 17
Cabinetul /account.php este doar pe invitație: managerul creează contul în Admin → Customers și îl leagă de clientul CRM. Clientul se autentifică pentru a aproba materiale, a vedea proiecte și documente și a deschide raportul de publicare în rețele (rețea, oră, status și link) pentru postările clientului său. Dacă un material a fost publicat de la clientul greșit, deschideți-l în admin, alegeți clientul corect și un proiect al lui, apoi salvați. Raportul apare în cabinetul acelui client. Postarea live nu se retrimite.
Clienți
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 9
CRUD complet: nume, denumire juridică, industrie, țară, email de facturare, telefon, website și status (active/paused/archived).
Calendar de conținut
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 13
Registru de intrări planificate (dată planificată, status, prioritate) legate de elementele de conținut. Listă doar-citire în v1.0.0; calendarul drag-and-drop este Roadmap v1.1.
Conținut
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 12
CRUD complet cu tipuri de conținut (post, story, reel, short, video, carousel, article, poll, ad, telegram_post, linkedin_article), limbă, status, etapă de workflow și scheduled_at. Fiecare editare creează un snapshot al versiunii de conținut. Dacă un material publicat aparține clientului greșit, setați clientul și un proiect al lui și salvați: raportul de publicare trece în cabinetul acelui client, fără republicarea postării live.
CRM & Leads
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 23
Lead-uri cu status (new/contacted/qualified/offer_sent/follow_up/won/lost/spam/archived), prioritate, note interne, următorul follow-up și o cronologie a notelor. Captare publică prin /api/lead.php.
Cron
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 34
Endpoint unificat cron-health.php cu un token de securitate rotativ și alegerea intervalului (5/10/15/30/60 min), folosit pentru publicarea pe Telegram, verificarea actualizărilor și notificări.
Tablou de bord
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 8
Afișează contoare (clienți, proiecte, conținut, programate, publicate, aprobări în așteptare), un Production Overview (Bază de date, Pairing, IuVeAI, PHP) și Acțiuni rapide pentru a adăuga un client/proiect/conținut sau a deschide AI Studio.
FAQ
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 41
Autorizează licența AI? Nu — mp_live_* validează licența/domeniul/entitlement-ul; AI necesită o cheie separată kai_live_*. Ce rețele publică automat astăzi? Telegram; celelalte rețele sunt Roadmap v1.2.
Funcționalități
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 2
Complet implementate: Dashboard, Clienți, Proiecte, Conținut (CRUD + versionare + etape de workflow), CMS Brand & Design, CRM & Leads, Contractori, Marketing (distribuție Telegram), Traduceri, Widgeturi și consimțământ, Analiză website, IuVe Control Center, IuVeAI Center, Marketplace Pairing, IuVe Identity, Update Center, Users & Security, Cron, Portalul de aprobare al clientului și corectarea clientului unui material deja publicat, astfel încât raportul de publicare să apară în cabinetul acestuia. Registre gestionate (liste doar-citire în v1.0.0): Calendar de conținut, Campanii, Profiluri de brand pe client, Social Accounts, Aprobări, Publishing Queue, Media Library, Analiză social-media, Reguli de automatizare.
Configurare inițială
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 7
Configurați brandul agenției în CMS Brand & Design (nume, culori, logo, hero, SEO, contacte), creați utilizatori cu roluri (owner/admin/editor/sales/viewer), configurați distribuția Telegram în Marketing și salvați o cheie kai_live_* în IuVeAI Center.
Instalare
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 5
Cerințe: PHP 8.1+ (8.2/8.3 acceptate) cu PDO/PDO_MySQL, JSON, cURL, mbstring, OpenSSL, fileinfo; MySQL 8+/MariaDB 10.4+; Apache/Nginx; HTTPS; drept de scriere pe storage/ și uploads/. Programul de instalare (/install.php) verifică codul de achiziție, creează schema (install/schema.sql), utilizatorul Owner, configurația runtime și installed.lock. În versiunile cu nucleu protejat (source-guard), nucleul de licențiere este livrat criptat; la activare, programul de instalare primește automat cheia de decriptare de la serverul de licențe IuVe Marketplace — fără pași manuali, este necesară extensia PHP OpenSSL (activă implicit).
Integrări
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 38
IuVeAI (kai_live_*), IuVe Marketplace (mp_live_*), IuVe Identity (OIDC) și Telegram Bot API. Integrările OAuth cu rețelele sociale sunt Roadmap v1.2.
Introducere
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 1
Genesis SMM CMS este o platformă self-hosted PHP/MySQL pentru agenții SMM, departamente de marketing și specialiști social-media. Unifică gestionarea clienților și proiectelor, profilurile de brand, producția de conținut cu workflow și versionare, un calendar de conținut, campanii, aprobări, publicare, analiză social-media, CRM/lead-uri, automatizare și un asistent IuVeAI. Se instalează pe serverul propriu al cumpărătorului; IuVe Marketplace rămâne sursa de adevăr pentru licență.
IuVe Identity
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 33
Single sign-on OIDC (issuer https://www.iuve.eu/api/identity): diagnostice discovery și JWKS, asociere/dezasociere, installation_id și scope-urile openid profile email iuve:installation iuve:entitlement.
Activarea licenței
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 6
Cheia de licență are formatul mp_live_* și se obține din „Achizițiile mele” în Marketplace. În IuVe Control Center → Marketplace introduceți cheia și domeniul de producție normalizat, apoi rulați Activate / Validate / Entitlement. Marketplace verifică produsul, achiziția, semnătura și domeniul și creează pairing-ul.
Marketing (Telegram)
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 26
Marketing Center configurează distribuția prin Telegram Bot API: token bot, id chat/canal, activare, auto-publicare, includere imagine, mesaj de test, trimitere backlog și un token cron securizat. Acesta este canalul real de publicare în v1.0.0.
Marketplace Pairing
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 32
Lanțul de pairing: Admin UI → MarketplacePairingLifecycleManager → MarketplacePairingService → https://www.iuve.eu/api. Folosește mp_live_*; Clear Local Pairing nu eliberează activarea de la distanță.
- Architecture v1.0: /static/marketplace/docs/MARKETPLACE_PAIRING_ARCHITECTURE_V1.md
- CMS task: /static/marketplace/docs/MARKETPLACE_PRODUCT_PAIRING_CMS_TASK.md
- API pairing agent: /static/marketplace/docs/MARKETPLACE_CMS_IUVE_API_PAIRING_AGENT.md
Media Library
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 18
Registru de resurse media (fișier, tip, dimensiune, creat). Încărcările folosesc helper-ul de upload securizat în storage/uploads. Un manager complet cu drag-drop este pe Roadmap.
Performanță
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 39
Interogări preparate PDO, schemă indexată, liste limitate (LIMIT 200), OPcache recomandat. În producție folosiți HTTPS și un CDN pentru resursele statice.
Proiecte
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 10
CRUD complet, mai multe pe client: nume, descriere, status (active/paused/completed/archived), buget lunar și monedă.
Publishing Queue
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 21
Registru de publicații cu ora programată, stare și încercări. Livrarea reală în v1.0.0 se face prin Telegram Bot API, cu reîncercări și jurnalizare; execuția cozii pe mai multe rețele este Roadmap v1.2.
Pornire rapidă
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 4
1) Creați o bază de date MySQL/MariaDB goală. 2) Încărcați și dezarhivați pachetul. 3) Deschideți /install.php, completați formularul și introduceți codul de achiziție Marketplace. 4) Autentificați-vă în /admin. 5) În IuVe Control Center introduceți mp_live_*, activați domeniul, salvați o cheie AI kai_live_*. 6) Creați un client, un proiect și primul element de conținut.
Restaurare
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 36
Restaurare din backup-uri: importați dump-ul bazei de date, refaceți fișierele (în special config/, storage/uploads/ și installed.lock), verificați permisiunile fișierelor, apoi revalidați licența în IuVe Control Center → Marketplace și IuVeAI în AI Center. Confirmați că site-ul și /admin se încarcă și că Update Center raportează versiunea corectă.
Roadmap
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 43
v1.1 — calendar de conținut drag-and-drop, rapoarte de analiză avansate. v1.2 — conectori OAuth (Meta/LinkedIn/TikTok/X) și publicare automată programată în rețele. v1.3 — AI Vision, generare de scenarii video AI și pipeline video. v2.0 — agenții multi-tenant, distribuția sarcinilor, aplicație mobilă, integrare profundă cu IuVe Connect.
Security Center
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 30
Prezentare generală a securității care acoperă PHP, baza de date, încărcările, permisiunile, licența, Marketplace, HTTPS, sesiunile, CSRF și auditul.
Securitate
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 40
Hashing de parole (password_hash), token-uri CSRF pe toate cererile POST, escaparea ieșirii (e()), încărcări sigure cu uploads/.htaccess, separarea mp_live_* de kai_live_*, mascarea secretelor, jurnal de audit și verificarea semnăturii actualizărilor semnate.
Social Accounts
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 20
Registru de conturi sociale (platformă, nume cont, status, ultima sincronizare). Astăzi canalul de publicare funcțional este Telegram (Marketing Center). Conectorii OAuth pentru Meta/Instagram/LinkedIn/TikTok/X/YouTube/Pinterest/Threads și publicarea automată programată în rețele sunt Roadmap v1.2.
Traduceri
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 28
Traduceri pe entitate (client/proiect/conținut/pagină) în limbile admin acceptate.
Depanare
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 42
Erori de instalare: verificați credențialele BD și dreptul de scriere pe storage/uploads. Erori de licență: verificați mp_live_* și domeniul normalizat în Marketplace Pairing. AI 502: verificați kai_live_* și HTTPS-ul de ieșire către https://www.iuve.eu/api. Publicare: verificați token-ul botului Telegram și token-ul cron.
Update Center
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 31
Flux de actualizare semnat: check → preflight → install. Verifică semnătura manifestului față de registrul de chei de încredere (key_id marketplace-release-key-2026-01, ed25519), reîncarcă un manifest proaspăt, verifică SHA-256 și necesită confirmarea explicită a instalării semnate. Banner/insignă de notificări cu email/Telegram opțional.
Utilizatori și securitate
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 29
CRUD utilizatori cu roluri (owner/admin/editor/sales/viewer), hashing de parole (minim 10 caractere), cod de recuperare de urgență pentru Owner și jurnalizare de audit.
Website
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 25
Website-ul public al agenției (index.php) cu brand, contacte, mesagerii flotante și formulare de lead-uri, generat din setările CMS Brand & Design și Contacts.
Widgeturi și coduri
Genesis SMM CMS v1.5.10 · Documentație 1.5.10 · Secțiunea 27
Fragmente HTML/JS externe în patru sloturi (head, body_start, before_footer, footer), fiecare cu o categorie de consimțământ pentru cookie (necessary/functional/analytics/marketing) și un domeniu (all/home).