D
My Darrin
🏠 Acasă Admin Sync Architecture
D
My Darrin
Home Best Pal SRL
Sync Live · Hybrid Architecture

Cum comunică Backoffice,
Deviz Engine și Catalogul public

Documentație completă a fluxului de sincronizare — de la configurarea unui serviciu în Backoffice, calculul devizului în Cost Engine, până la afișarea în catalogul public și pagina de serviciu văzută de client.

Backoffice — Creare serviciu Deviz Engine — Arhitectură Catalog public — v3
Diagrama completă de sincronizare — Backoffice → Engine → Public
⚙️
BACKOFFICE
Admin · SuperAdmin · CRUD
Admin
📋 Catalog → Creare serviciu
slug · titlu · descriere · categorie · subcategorii · CAEN · safety_note · hero_headline · external_links · galerie foto/video
🥇 Service Tiers
tierKey · title · cost_nivel_lei · benefitsMarkdown · parteneri necesari · nivel_minim · opțional
🧮 Deviz Engine
rețetă resurse · ESCO/NACE · PriceConfigRecord · VMC · zone · Rate Card
📡 Canale notificare
WhatsApp · SMS · Email · Push · Web · timer · rază · Full Package Priority
🌍 Geo-Fiscal + Zone
TVA per țară · VMC · zone polygon · Rate Card ESCO · legislație
TRIGGER SYNC
PUT /api/v1/backoffice/site-content/{slug}
→ invalidare cache imediată → SSE push
Salvează → Sync
Cache bust
🧮
DEVIZ ENGINE
Cost Calc · Cache · Sync API
Auto
📐 Formula calcul
COST_BRUT = cant × preț_unitar
COST_BAZĂ = max(COST_BRUT, VMC)
COST_NIVEL = BAZĂ + Σresurse
+ indirecte + marketing + HBP
× zonă × legislație × urgență
× (1 + TVA)
💾 Cache Layer
content_version token · Redis/in-memory · TTL configurabil · invalidare automată la PUT BO
🌍 Geo-IP detect
IP → CountryRecord → ZoneRecord (polygon) → TaxRule → LaborRate → preț localizat
🗺 Zone geografice
Bacău (exemplu): Zona 1 +5% · Zona 2 +10% · Zona 3 +15%
Polygon GeoJSON → detect lat/lng → cotă aplicată automat
📦 ACA BUSINESS GROUP
CUI 32667674 · Bacău, Calea Moinești 24
Furnizor principal MATERIAL + EQUIPMENT din catalog_resources
📡 Hybrid Sync APIs
GET /public/pages/{slug}
GET /public/sync/catalog-price/{slug}
GET /public/sync/order-status/{ref}
GET /public/vmc/{country}
GET /public/zones/detect?lat=&lng=
claimPartnerLiveJob(broadcast_id)
content_version: v2026.06.11
Versiunea curentă a cache-ului · auto-invalidat la save BO
API Response
SSE Stream
🌐
CATALOG PUBLIC
mydarrin-v3.html#catalog
LIVE
🔧
Popular
AI alocă
Înlocuire calorifer
Instalații termice · ISCIR autorizat
280 Lei · de la
💰 VMC: 100 Lei min · 📍 Zona 1 detectată
Titlu + descriere + rating
Preț live (catalog-price API)
Monedă localizată (IP detect)
VMC aplicat automat
Rețeta devizului (ascunsă)
Cum se declanșează sincronizarea — 3 tipuri de trigger
🔴 Push (imediat)
Admin salvează serviciu în BO → PUT /backoffice/site-content → cache invalidat → SSE push la toți clienții conectați
🟡 Pull (la cerere)
Client deschide pagina → GET /public/pages/{slug} → verifică content_version → dacă nou, fetch complet → dacă identic, din cache
🔵 Stream SSE (live)
Statusuri comenzi live → GET /sync/order-status/stream/{ref} → WebSocket/SSE → dashboard client actualizat în timp real
Catalog public (v3) — Ce se încarcă din Backoffice și Deviz Engine
Card catalog public — date din BO (annotate)
🔧
Popular
📸 galerie foto BO
Înlocuire calorifer
name_ro BO
Instalații termice · ISCIR autorizat
description BO
★★★★★ 4.97 (312 rec.)
De la
280 Lei
/ manoperă bronz
cost_nivel BRONZ · API catalog-price
💰 VMC 100 Lei 📍 Zona 1 auto 🌐 RON detectat
Sursa fiecărui câmp din card
Câmp vizibilSursă BOAPI endpoint
Titlu serviciuname_ro/public/pages/{slug}
Descriere scurtădescription/public/pages/{slug}
Galerie foto/videoentity_attachments/public/pages/{slug}
Badge (Popular/Nou)badge_label/public/pages/{slug}
Preț „de la"cost_nivel_BRONZ/sync/catalog-price/{slug}
Monedă (RON/EUR)CountryRecordIP → /public/vmc/{cc}
VMC afișatmin_order_value/public/vmc/{country}
Zonă detectatăZoneRecord/zones/detect?lat&lng
Rating / recenziiReviewRecord/public/reviews/{slug}
„AI alocă automat"ai_dispatch: true/public/pages/{slug}
Pagina serviciu publică — Ce se sincronizează din fiecare modul BO
📋 Tab: Serviciu & Media
hero_headline → titlu H1 pagină publică
safety_note → „Ce trebuie să ai la adresă"
description_extended → descriere completă
entity_attachments → galerie + video
external_links[] → YouTube/Drive embed
pricing_note → nota tarife informatii
🥇 Tab: Tier-uri serviciu
tierKey → taburi Bronz/Argint/Aur/Platinum
title → „Aur — Pachet complet"
benefitsMarkdown → ✓/✗ tabel
cost_nivel_lei → preț „de la X Lei"
Garanție (luni) → afișată pe card tier
Rețeta exactă → ASCUNSĂ
🧮 Tab: Deviz Engine
Formula completă → calcul preț live booking
VMC per țară → max(brut, VMC) automat
Zone polygon → cotă zonă aplicată
urgency_coeff → ×1.0/1.3/1.5/2.0 live
TVA auto-detect → din IP/CountryRecord
Preț final = afișat în booking panel
💲 Tab: Tarife speciale
Multiplicatori configurați → afișați informativ pe pagina publică
Tabel ×1.0/×1.3/×1.5/×2.0 → fără câmpuri editabile
Calendar sărbători → auto-detectat la booking
Booking panel → aplică automat la selecție dată/oră
📡 Tab: Canale notificare
Canale active → Darrin AI notifică simultan
Timer 5 min → extindere rază automată
claimPartnerLiveJob(broadcast_id) → primul acceptă
Identitate parteneri → afișat doar pseudonim+cod
🔒 Tab: Parteneri (Admin Only)
KYC complet → vizibil DOAR admin
required_cert_codes → filtru dispatch AI
Zone active + țări → eligibilitate comandă
Client vede ZERO date reale partener
Toate API-urile de sincronizare — Public + Backoffice
🌐 Public APIs (catalog + pagini)
GET/api/v1/public/pages/{slug}content complet
GET/api/v1/public/sync/catalog-price/{slug}preț live
GET/api/v1/public/sync/order-status/{ref}status comandă
GET/api/v1/public/sync/order-status/stream/{ref}SSE live
GET/api/v1/public/vmc/{country_code}VMC per țară
GET/api/v1/public/zones/{country_code}zone active
GET/api/v1/public/zones/detect?lat=&lng=zonă GPS
GET/api/v1/public/rate-card/{esco}/{country}tarif orar
GET/api/v1/public/reviews/{slug}recenzii
GET/api/v1/public/sync/manifestversiuni cache
⚙️ Backoffice APIs (admin)
PUT/api/v1/backoffice/site-content/{slug}save+invalidate
POST/api/v1/backoffice/sync/order-status/{ref}update status
PUT/api/v1/backoffice/vmc/{country_code}update VMC
POST/api/v1/backoffice/zonescreare zonă
PUT/api/v1/backoffice/zones/{zone_id}editare zonă
DEL/api/v1/backoffice/zones/{zone_id}ștergere zonă
POST/api/v1/backoffice/zones/{id}/polygonGeoJSON polygon
POST/api/v1/backoffice/rate-cardtarif nou
PUT/api/v1/backoffice/rate-card/{id}editare tarif
DEL/api/v1/backoffice/rate-card/{id}ștergere tarif
Flow complet — De la „Creare serviciu" în BO la „Vizibil în catalog"
📋
Admin creează
BO → Catalog
→ Serviciu nou
→ completare câmpuri
Tab 1: Serviciu
🥇
Configurare tiers
Bronz→Platinum
cost_nivel_lei
benefitsMarkdown
Tab 2: Tier-uri
🧮
Rețetă deviz
resurse ESCO/NACE
VMC + zone
PriceConfig
Tab 3: Deviz Engine
💾
Salvare + Sync
PUT /backoffice
/site-content
cache invalidat
API trigger
🌐
Live în catalog
mydarrin-v3.html
#catalog
card vizibil
✓ LIVE
~5-15 min
Completare câmpuri
~5-10 min
Config tiers
~10-20 min
Rețetă deviz
< 1 sec
API trigger sync
INSTANT
Vizibil în catalog
D
My Darrin — Arhitectură Sincronizare
Home Best Pal SRL · Hybrid Sync Architecture · Iunie 2026
→ Backoffice → Deviz Engine → Catalog public
D
My Darrin
© 2026 Home Best Pal SRL · Bacău, România
🏠 Acasă 📦 Catalog 🏪 Marketplace 👷 Parteneri 💼 Investitori 📱 App Mobile 🔐 Admin