Skip to content
Inginerie
8 min de citit29 septembrie 2025

Analiză tehnică aprofundată: construirea unui sistem modern de verificare a telefonului

O privire de ansamblu asupra arhitecturii, tehnologiilor și deciziilor de inginerie din spatele platformei noastre de verificare a telefonului. Explorați infrastructura backend, designul API-ului, aspectele de securitate și fluxul de verificare în timp real.

Diagramă de arhitectură tehnică ce prezintă componentele sistemului de verificare a telefonului

Prezentarea generală a sistemului

Sistemul nostru de verificare a telefonului este construit pe o arhitectură modernă și scalabilă, care combină puterea Supabase pentru serviciile de backend, Vonage pentru infrastructura de telecomunicații și un frontend bazat pe React, cu capabilități în timp real. Sistemul poate gestiona mii de cereri de verificare, cu timpi de răspuns sub o secundă și un uptime de 99,9%.

Stack-ul de frontend

  • React 18 - Interfață bazată pe componente, cu funcții concurente
  • TypeScript - Dezvoltare cu tipuri sigure
  • Vite - Dezvoltare rapidă și build-uri optimizate
  • Tailwind CSS - Stilizare utility-first cu un sistem de design personalizat
  • Framer Motion - Animații și tranziții fluide
  • React Query - Gestionarea stării serverului și caching

Stack-ul de backend

  • Supabase - Bază de date PostgreSQL cu abonamente în timp real
  • Supabase Edge Functions - Mediu de execuție Deno serverless pentru endpointurile API
  • Supabase Row Level Security - Control al accesului la nivelul bazei de date
  • Vonage API - Infrastructură de telecomunicații
  • Vonage Cloud Runtime - Servicii backend găzduite, scalabile și de înaltă performanță
  • Stripe - Procesarea plăților și gestionarea abonamentelor
Diagrama fluxului de integrare Reverse OTP

Arhitectura Reverse OTP

Inovația centrală a sistemului nostru este fluxul „Reverse OTP”, care elimină nevoia ca utilizatorii să introducă manual codurile de verificare. În schimb, utilizatorii scanează un cod QR cu telefonul și trimit un mesaj WhatsApp pentru a finaliza verificarea.

Pașii fluxului de verificare

  1. Inițializarea sesiunii: Clientul solicită o sesiune de verificare prin POST /start-verification
  2. Aceasta generează un token de validare unic, legat de un ID de sesiune, ambele stocate într-o bază de date redis.
  3. Integrarea WhatsApp: Se generează un deep link WhatsApp direct, care conține un mesaj precompletat cu tokenul. Acest link poate fi prezentat ca un cod QR care duce la WhatsApp, cu un mesaj precompletat către botul nostru
  4. Extragerea numărului: Backendul găzduit de Vonage primește un webhook de la WhatsApp și extrage numărul de telefon din mesajul WhatsApp
  5. Validarea: Sistemul validează formatul numărului de telefon și îl asociază cu sesiunea inițială datorită tokenului de verificare. Frontendul poate verifica starea verificării în mod continuu
Diagrama fluxului de integrare Reverse OTP

Designul schemei bazei de date

Supabase oferă o bază de date PostgreSQL robustă, cu capabilități în timp real, ceea ce o face o alegere ideală pentru sistemul nostru de verificare. Servește drept coloană vertebrală a portalului și ca depozit de date pentru informațiile utilizatorilor, cheile API și cotele acestora. Este folosită și pentru logare și analitice. Schema noastră PostgreSQL este concepută pentru scalabilitate, securitate și performanță. Folosim politici Row Level Security pentru a ne asigura că utilizatorii pot accesa doar propriile date, în timp ce rolurile de serviciu gestionează operațiunile de sistem.

Funcții de securitate

  • Row Level Security: Utilizatorii pot accesa doar propriile sesiuni de verificare
  • Validarea cheii API: Toate cererile sunt validate pe baza cheii API
  • Expirarea sesiunii: Curățare automată a sesiunilor de verificare expirate
  • Limitarea ratei: Protecție încorporată împotriva abuzului și a spamului
  • Jurnal de audit: Logare completă a tuturor încercărilor de verificare

Arhitectura de securitate

Securitatea este esențială într-un sistem de verificare a telefonului. Implementăm mai multe straturi de protecție pentru a preveni frauda, abuzul și accesul neautorizat. Folosim tokenuri de validare cu durată scurtă de viață și stocăm pe termen scurt numărul complet de telefon scanat, fără posibilitatea de a-l lista. Nu păstrăm niciun număr de telefon în clar și folosim o versiune trunchiată în scopuri de analitice și depanare.

Performanță și scalabilitate

Sistemul nostru este conceput pentru a gestiona cereri de verificare de volum mare, cu latență minimă. Obținem acest lucru prin alegeri arhitecturale atente și strategii de optimizare.

Metrici de performanță

< 200ms
Timp de răspuns API
99.9%
SLA de uptime
până la 500 rps
și scalabil

Considerații privind scalarea

Pe măsură ce volumul de verificări crește, arhitectura noastră se scalează orizontal prin:

  • • Scalarea automată a Edge Functions
  • • Procesarea cozii de webhookuri
  • • Echilibrarea încărcării între regiuni
  • • Scalarea automată a instanțelor Vonage

Integrare și designul API-ului

API-ul nostru REST este conceput pentru simplitate și fiabilitate. Dezvoltatorii pot integra verificarea telefonului în aplicațiile lor cu doar câteva apeluri API.

Endpointuri API

POST
/start-verification

Inițializează o nouă sesiune de verificare

GET
/check-verification-status/{session_id}

Verifică starea verificării în timp real

Gestionarea sesiunilor și a tokenurilor

Sistemul nostru de verificare folosește un sistem sofisticat de gestionare a sesiunilor și a tokenurilor pentru a asigura securitatea, a urmări progresul și a preveni abuzurile. Fiecare cerere de verificare creează o sesiune unică, cu mai multe puncte de urmărire de-a lungul parcursului utilizatorului.

Ciclul de viață al sesiunii

1. Crearea sesiunii

Când este inițiată o cerere de verificare, sistemul generează:

  • • ID de sesiune: UUID unic pentru urmărirea încercării de verificare
  • • Token de validare: Token securizat criptografic, încorporat în codul QR
  • • Timp de expirare: Fereastră de 15 minute pentru finalizare

2. Validarea tokenului

Tokenul de validare are mai multe roluri: autentifică mesajul WhatsApp, previne atacurile de tip replay și asociază numărul de telefon cu sesiunea corectă. Tokenurile sunt de unică folosință și expiră automat.

Stările de verificare

Sistemul de verificare urmărește informații detaliate despre stare de-a lungul parcursului utilizatorului, oferind feedback în timp real și permițând analitice precise asupra comportamentului utilizatorilor și a ratelor de conversie.

Progresia stărilor

pending

Starea inițială, când se creează sesiunea de verificare. Codul QR este generat, dar încă nescanat.

qr_code_scanned

Utilizatorul a scanat codul QR cu dispozitivul său. URL-ul de urmărire a fost accesat.

whatsapp_previewed

WhatsApp a fost deschis și mesajul a fost previzualizat, dar nu a fost încă trimis.

opened

Conversația WhatsApp a fost deschisă complet, iar mesajul este gata de trimis.

verified / sms_validated

Numărul de telefon a fost extras și validat cu succes. Verificare finalizată.

expired / failed

Sesiunea a expirat (timeout de 15 min) sau a eșuat din cauza unui token/număr de telefon nevalid.

Previzualizarea WhatsApp și urmărirea codului QR

Mecanisme avansate de urmărire monitorizează interacțiunea utilizatorului la fiecare pas al procesului de verificare, oferind analitice detaliate asupra comportamentului utilizatorilor și ajutând la optimizarea ratelor de conversie.

Detectarea scanării codului QR

Generarea URL-ului de urmărire

Fiecare cod QR conține un URL de urmărire unic, care înregistrează evenimentul de scanare înainte de redirecționarea către WhatsApp:

https://t.phone-verif.com/t/{validation_token}?sid={session_id}

Urmărirea stării WhatsApp

Detectarea previzualizării

WhatsApp apelează URL-ul nostru de urmărire la generarea previzualizărilor de link, ceea ce ne permite să detectăm când mesajul este în curs de redactare, dar încă netrimis.

  • • Analiza User-Agent: Distingerea boților de previzualizare WhatsApp de utilizatorii reali
  • • Analiza temporală: Diferențierea dintre previzualizare și accesul efectiv
  • • Geolocalizarea IP: Verificarea coerenței geografice

Analitice ale pâlniei de conversie

100%
Cod QR generat
~90%
Cod QR scanat
~89%
WhatsApp deschis
~85%
Mesaj trimis

Rate de conversie tipice, de la generarea codului QR până la verificarea reușită

Planul de dezvoltare

Îmbunătățim continuu platforma cu funcții și optimizări noi.

Începeți acum

Sunteți gata să integrați verificarea telefonului în aplicația dumneavoastră? API-ul nostru este conceput pentru dezvoltatori, cu documentație cuprinzătoare și SDK-uri pentru limbaje de programare populare.

🚀 Plan gratuit: 100 de verificări/lună
📚 Documentație API completă
🛠️ SDK-uri pentru JS, Python, PHP, Go