Licențiere și facturare

aihummer license show          # inspectează licența / planul curent

{
  "error": "Plan limit reached: your plan allows 2 AI employees.",
  "code": "plan_limit",
  "feature": "ai_employees",
  "upgrade": "https://aihummer.ru/pricing/"
}

AiHummer este un produs self-hosted cu un model de licențiere comercială. Orice instalare rulează — **fără licență și fără cont** — pe planul gratuit **Community**; un plan plătit deblochează limite mai mari și funcții enterprise. Aplicarea limitelor trăiește în întregime în propriul tău gateway (nimic din datele tale nu părăsește gazda) și **eșuează închis către Community**: o licență lipsă, alterată sau expirată se rezolvă la planul gratuit, niciodată la nelimitat. ## Planuri Un „angajat AI” este un agent/personă configurat. Planurile sunt sursa unică de adevăr partajată de gateway și de pagina de prețuri. | Plan | Angajați AI | Tenanți | Canale | Funcții enterprise | |---|---|---|---|---| | **Community** (gratuit) | 2 | 1 | Doar canalele de bază | — | | **Starter** | 3 | 1 | Toate canalele | — | | **Business** | 5 | 1 | Toate canalele | White-label, RBAC, audit | | **Enterprise** | Nelimitat | Nelimitat | Toate canalele | + SSO, RLS, SLA | O licență semnată poate purta și override-uri explicite `MaxSeats` / `MaxTenants` / `Features`, care au prioritate față de valorile implicite ale planului. ## Cum ajunge o licență pe instanța ta Licențierea este **centrată pe instanță** și, în cazul obișnuit, nu cere nicio jonglare manuală cu tokenuri: 1. **Auto-înregistrare.** La prima pornire gateway-ul se înregistrează la serviciul de fleet al vendorului printr-o magistrală de mesaje autentificată, cu TLS pinned. Fără licență se înregistrează ca **Community** — acesta este comportamentul normal și nu îți cere nimic. 2. **Cumpărarea / gestionarea planului** în [contul personal my.aihummer.ru](/ro/v1.0/commercial/personal-account). Vendorul atribuie planul instanței tale. 3. **Livrarea licenței prin magistrală.** Billing-ul semnează o licență **legată de amprenta (fingerprint)** instanței tale specifice și **o trimite gateway-ului prin magistrală**. Gateway-ul verifică semnătura față de rădăcina de încredere **încorporată în binar** și aplică noile drepturi în direct — fără restart, fără copy-paste. Licența semnată este legată de amprenta instanței tale, deci nu poate fi refolosită pe o altă gazdă. ### Fallback pentru rețele izolate: token detașat Dacă instanța ta nu poate ajunge la magistrală (o rețea complet izolată), vendorul poate emite un **token de licență detașat**, pe care îl instalezi manual: ```bash aihummer license show # inspectează licența / planul curent ``` Lipește tokenul emis în Web UI-ul de administrare (sau în mediul documentat de installer), iar gateway-ul îl verifică și îl aplică în același mod. Tokenul rămâne legat de amprenta instanței tale. ## Fluxul de upgrade 402 Aplicarea limitelor este **soft**: resursele existente nu sunt niciodată dezactivate sau „blocate”. Doar o acțiune **nouă** care ar depăși planul tău este oprită, iar aceasta returnează HTTP **402 Payment Required** cu un corp lizibil de mașină: ```json { "error": "Plan limit reached: your plan allows 2 AI employees.", "code": "plan_limit", "feature": "ai_employees", "upgrade": "https://aihummer.ru/pricing/" } ``` De exemplu, crearea unui al 3-lea angajat AI pe Community, activarea unui canal care nu e de bază, pornirea brandingului white-label, a RBAC-ului sau a citirii de audit sub planul necesar — toate returnează acest răspuns. Web UI-ul de administrare afișează linkul `upgrade`, astfel încât un operator să poată trece la un plan superior; resursele deja create continuă să funcționeze. > [!NOTE] > Răspunsurile de limită de plan / facturare folosesc această formă dedicată > `402 plan_limit` și **nu** fac parte din registrul general de coduri `AIH-*` > ([referință](/ro/v1.0/reference/env-vars)) — ele sunt documentate aici. ## Contul personal Planurile, plata, datele de facturare și documentele de închidere trăiesc în [contul personal my.aihummer.ru](/ro/v1.0/commercial/personal-account). După cumpărare sau prelungire, licența sosește pe instanța ta **automat, prin magistrală** — ca client self-hosting interacționezi cu licențierea prin propriul gateway și, la nevoie, prin fallback-ul offline cu token detașat de mai sus. Pentru schimbări de plan, contactează vendorul prin pagina „Suport” a interfeței de administrare. ## Unde rulează aplicarea limitelor - **Doar în gateway-ul tău.** Drepturile sunt re-derivate prin re-verificarea licenței semnate la fiecare verificare; nu există un singur comutator „if licensed” care să poată fi scos. - **Fail-closed.** Orice licență neîncrezută → Community, niciodată nelimitat. - **Soft.** Acțiunile noi peste limită sunt oprite (402); resursele existente rămân neatinse.