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.

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

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
- Inițializarea sesiunii: Clientul solicită o sesiune de verificare prin POST /start-verification Aceasta generează un token de validare unic, legat de un ID de sesiune, ambele stocate într-o bază de date redis.
- 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
- Extragerea numărului: Backendul găzduit de Vonage primește un webhook de la WhatsApp și extrage numărul de telefon din mesajul WhatsApp
- 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

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ță
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
/start-verificationInițializează o nouă sesiune de verificare
/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
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.

