← Tutti i progetti
Caso di studio · Edtech · Mobile · Pagamenti

Inglese per il tuo lavoro, in 14 settori professionali.

Belka Tech English insegna inglese professionale a lavoratori e studenti algerini. Lezioni bilingue inglese/arabo, esercizi di pronuncia con riconoscimento vocale, certificati PDF e livelli a pagamento in dinari. Il telefono non può concedere da solo gli accessi. Realizzata da me, disponibile sul Play Store dal 2026.
ProdottoBelka Tech Italiano (com.belka.app)
StatoLive su Google Play, v1.4.1, 9 versioni firmate
PiattaformaAndroid e iOS, React Native 0.84 nudo, Nuova architettura
TecnologieReact 19, TypeScript, Supabase Postgres + Funzioni Edge, Chargily Pay
Home screen Belka con traccia attuale, striatura e goal giornaliero
14
settori professionali, 5 livelli ciascuno
488
lezioni, generate e controllate per tipo
1,931
domande quiz, risposte chiavi verificate
71
Documenti di Word analizzati in TypeScript

Panoramica.

Per chi è, per cosa è stato difficile, per cosa è stato rilasciato.
Lo studente

Professionisti algerini che hanno bisogno dell’inglese al lavoro

Infermieri, elettricisti, insegnanti, commercialisti e tirocinanti che non hanno bisogno di inglese generale. Hanno bisogno del vocabolario del proprio mestiere, spiegato in arabo, al telefono, ad un prezzo che uno stipendio locale sostiene.

Il problema

Le app generiche non insegnano il lessico professionale necessario

Le app mainstream insegnano viaggi e piccole conversazioni. Niente copriva l'inglese specializzato per questi campi in arabo, e nulla ha preso un metodo di pagamento che gli algerini effettivamente detengono.

Il prodotto

Un programma bilingue per settore, con accessi a pagamento protetti

Cinque livelli graduati per campo, pratica di pronuncia che porta avanti, striature e certificati per la conservazione e pagamenti dinar attraverso Chargily applicati in Postgres piuttosto che nell'app.

Schermate.

Catturato dalla build rilasciata in esecuzione su un simulatore iPhone.
Iscrizioni per settore professionale, anziché a un corso generico
01 · I miei corsi

Iscrizioni per settore professionale, anziché a un corso generico

Belka insegna inglese per un lavoro, quindi l'unità di iscrizione è un campo professionale. Uno studente sceglie tra 14 di loro all'onboarding e ogni schermata dopo che è oggetto di tali scelte.

  • 1
    Campi, non capitoliIstruzione, elettronica, ingegneria, informatica, diritto, marketing, medicina, turismo, mestieri, risorse umane, affari, contabilità, amministrazione, agricoltura.
  • 2
    Un diritto in tutti i campiUn livello viene sbloccato una volta e si applica a ogni campo in cui lo studente si è iscritto, motivo per cui il paywall recita "Livello 1 sbloccato in TUTTI i tuoi campi".
  • 3
    Progressi per campoCompletamento, conteggi delle lezioni e percentuali sono aggregati per campo da Postgres lesson_progress tabella, con un mirror AsyncStorage come backup locale.
Cinque livelli ispirati al QCER: uno gratuito, gli altri a pagamento in dinari
02 · La scala di livello

Cinque livelli ispirati al QCER: uno gratuito, gli altri a pagamento in dinari

Ogni campo è una scala di cinque livelli. Il livello 0 è gratuito in modo che uno studente possa giudicare il prodotto prima di pagare; i livelli da 1 a 5 sono venduti individualmente in DZD, con una bandiera globale di sconto sul lancio che l'azienda può lanciare e disattivare.

  • 1
    Primo rung liberoIl livello 0 fornisce 7 lezioni e circa 70 minuti di contenuti in ogni campo iscritto, senza restrizioni di account.
  • 2
    Prezzo per livelloDa 1.500 a 3.500 DZD per livello, o 10.000 DZD per tutto, con uno sconto sul lato server. Lo screenshot mostra l'offerta di lancio in diretta a · 25%.
  • 3
    Bloccato nel database, non nell'interfaccia utenteIl lucchetto è cosmetico. Ciò che effettivamente cancella il contenuto è una riga in user_level_access Il cliente non ha il permesso di scrivere.
Le lezioni si sbloccano in ordine, quindi nessuno salta il vocabolario
03 · Moduli di lezione

Le lezioni si sbloccano in ordine, quindi nessuno salta il vocabolario

All'interno di un livello, le lezioni sono sequenziali. Il modulo due rimane in grigio fino a quando il modulo uno è finito, il che mantiene il carico del vocabolario cumulativo piuttosto che lasciare che uno studente salti alle schermate interessanti.

  • 1
    Circa 7 lezioni per livelloCirca 488 lezioni in tutto il catalogo, ognuna con cinque vocaboli e un proprio mini-quiz.
  • 2
    Un test di livello alla fineOgni livello si chiude con un test dedicato, generato dalla stessa pipeline di contenuti dei quiz per lezione.
  • 3
    Il progresso sopravvive reinstallaCompletamento, punteggio, tempo trascorso e conteggio corretto/sbagliato vengono aggiunti a Postgres sulla chiave (utente, campo, livello, lezione).
La traduzione araba è a un tocco, nascosta per impostazione predefinita
04 · Lezioni bilingui

La traduzione araba è a un tocco, nascosta per impostazione predefinita

Mostrare l'arabo accanto a ogni riga inglese permette allo studente di leggere la risposta invece di richiamarla, il che sconfigge l'esercizio. Così le traduzioni rendono come una pillola “Mostra traduzione” e rivelano al tocco.

  • 1
    Una difficoltà introdotta con uno scopoNascosta di default è la pedagogia, non una supervisione. I fallimenti di comprensione sono ancora un tocco di una traduzione.
  • 2
    Nascondere tutte le traduzioniUn interruttore AR a livello di lezione è persistente in AsyncStorage. Rovesciarlo crolla ogni singola linea rivelata, quindi “nascondersi” si nasconde davvero.
  • 3
    Sintesi vocale disponibile ovunqueOgni parola di frase e vocabolario ha un pulsante di altoparlante collegato al motore TTS sul dispositivo, quindi gli studenti sentono il bersaglio prima di provarlo.
Si prosegue solo quando il riconoscitore accetta la pronuncia
05 · Pratica di pronuncia

Si prosegue solo quando il riconoscitore accetta la pronuncia

Il passo del vocabolario è un cancello. Ascolta la parola, poi ripeti; l'app valuta il tentativo perfetto, buono oppure Riprova e solo un passaggio muove lo studente.

  • 1
    Ascolta prima di parlareIl microfono rimane disattivato fino a quando lo studente non ha effettivamente riprodotto la parola, quindi il tentativo è una riproduzione piuttosto che un'ipotesi.
  • 2
    Una valutazione, non un confronto esattoL'output di riconoscimento vocale è normalizzato e confrontato in livelli piuttosto che con l'uguaglianza di stringa. L'immersione profonda qui sotto spiega perché questo è importante.
  • 3
    Mic e speaker non si sovrappongono maiL'avvio di una registrazione interrompe TTS e la riproduzione di audio abbatte il riconoscitore, che è l'unico modo per impedire a un motore vocale Android di ascoltare se stesso.
Chargily Pay, dinari e codici promozionali non riutilizzabili
06 · Pagare in Algeria

Chargily Pay, dinari e codici promozionali non riutilizzabili

Gli studenti algerini pagano con una carta Dahabia tramite Chargily Pay. Il checkout si apre nel browser di sistema e ritorna tramite link profondo, il che rende la parte interessante di questa funzione tutto ciò che accade mentre l'app non è in primo piano.

  • 1
    Pagamenti localiChargily Pay V2, creato e selezionato attraverso una funzione Edge di Supabase. I prezzi sono in DZD e lo sconto di lancio è applicato lato server.
  • 2
    I codici promozionali sono atomiciRedemption è una singola funzione SECURITY DEFINER che convalida il codice, masterizza un utilizzo e concede l'accesso in una transazione, quindi due tocchi non possono richiedere lo stesso codice due volte.
  • 3
    L'app non si concede mai l'accessoIl cliente è un osservatore di sola lettura dei propri diritti. Le sovvenzioni provengono da un webhook verificato da HMAC o dal RPC promozionale, mai dal telefono.
Completa un settore e ricevi un certificato PDF numerato
07 · Certificati

Completa un settore e ricevi un certificato PDF numerato

Gli studenti vogliono qualcosa per mostrare un datore di lavoro. Il completamento di tutte le lezioni in un campo produce un certificato PDF scaricabile e condivisibile reso sul dispositivo.

  • 1
    Generazione sul dispositivoHTML a PDF localmente, in modo che un certificato può essere prodotto e condiviso senza un round trip o un server-side rendering.
  • 2
    Tracciato per campoGuadagnato, pronto e in corso sono conteggiati separatamente, con l'eccezionale conteggio delle lezioni mostrato su ogni campo.
  • 3
    Limite notoI numeri di certificato sono attualmente generati lato client senza un controllo di unicità. Spostare l'emissione dietro una funzione server è la prima correzione nell'elenco.
Continuità di studio, obiettivi giornalieri e tre promemoria bilingue al giorno
08 · Continuità di utilizzo

Continuità di studio, obiettivi giornalieri e tre promemoria bilingue al giorno

La conservazione su un'app di apprendimento autonomo è l'intero gioco. Belka traccia una serie giornaliera, imposta un obiettivo giornaliero di due lezioni e pianifica le notifiche locali randomizzate in arabo e in inglese.

  • 1
    Serie di giorni di studio con traguardiGiorni attivi attuali, più lunghi e totali, con notifiche di milestone a 3, 7, 14 e 30 giorni.
  • 2
    Tre finestre al giornoLe spine del mattino, del pomeriggio e della sera sono programmate sul dispositivo tramite Notifee, randomizzate all'interno di ogni finestra in modo che non si sentano meccaniche.
  • 3
    Profilo costruito per l'AlgeriaLa registrazione cattura la wilaya dello studente da tutte le 58 province, oltre alla città e ai campi scelti, in modo che le coorti possano essere lette geograficamente.
Tema chiaro e scuro
58 wilayas algerini
Indicazioni sull’accento delle sillabe
TTS sul dispositivo
Endpoint per eliminare l’account
17 schermi, 6 componenti condivisi

Architettura.

Nessun server personalizzato. Supabase è il backend e il curriculum è compilato nel bundle.
Dispositivo
React Native app17 schermi su un navigatore a pila. Contesto per auth e tema, refs per lo stato critico del ciclo di vita.
Motori su dispositivoTTS, riconoscimento vocale, scheduler Notifee, rendering di certificati HTML-to-PDF.
AsyncStorageSessione, backup dei progressi, striatura, tema, visibilità araba.
Programma incluso nell’app · 64.000 righe di dati di lezione tipizzati. Nessun CMS, nessun contenuto over-the-air.
→
Supabase
Postgres + RLSprofili, lesson_progress, field_progress_sommary, user_level_access, promo_code, certificati, app_config.
AuthEmail e password, sessione persistita e auto-rinfrescata, reindirizzare su errore di aggiornamento.
Edge Functionschargily-checkout, chargily-webhook, delete-account.
claim_promo_code()SECURITY DEFINER: valida, consuma e concede l’accesso in un’unica transazione.
→
Terzi
Chargily Pay V2Pagamenti con carta algerina e Dahabia in DZD. HMAC-signed webhooks.
Pipeline durante la build71 .docx · Python parser · moduli TypeScript tipizzati, controllati da tsc.
Patch native5 patch-pacchetto contro le dipendenze di Nuova Architettura RN 0.84.

Approfondimenti tecnici.

I sei problemi che hanno richiesto più tempo, incluso il costo di ciascuno.

1. Chiudere una vulnerabilità che aggirava i pagamenti

Problema
In origine, il client scriveva gli sblocchi dei livelli. Poiché user_level_access ha portato una politica INSERT client, qualsiasi utente iscritto potrebbe inserire righe e concedere se stessi ogni livello pagato. Un secondo foro lascia che una fila promo con un livello NULL sblocchi qualsiasi cosa.
Approccio
Tutti i diritti scrive spostato lato server e il percorso di scrittura del client è stato rimosso del tutto. Le sovvenzioni ora provengono solo dal chargily-webhook funzione dopo aver verificato l'HMAC firmato da Chargily checkout.paid evento, o da claim_promo_code()Una funzione SECURITY DEFINER che convalida, brucia e concede all'interno di un'unica transazione. I codici senza un livello esplicito vengono rifiutati a titolo definitivo.
Trade-off
Lo sblocco non è più immediato dal punto di vista del cliente; l'app deve attendere un webhook fuori banda, che ha costretto il disegno del sondaggio qui sotto.
Nel codice: src/utils/levelAccess.ts, supabase/migrations/*_payment_tables.sql

2. Riconciliare un pagamento che il telefono non vede

Problema
Lo studente paga in un browser esterno e la sovvenzione raggiunge Supabase da Chargily su un canale di cui il telefono non fa parte. L'app può tornare in primo piano prima, durante o dopo l'atterraggio del webhook e su Android può essere lanciato a freddo dal collegamento profondo.
Approccio
Tre rivelatori di rientro indipendenti convergono su una routine di verifica idempotente: un collegamento url listener per il deep link quando l’app è già aperta, getInitialURL() per un lancio a freddo e una transizione AppState per lo studente che si limita a toccare indietro. Verifica e sondaggi user_level_access ogni 1,5s per un massimo di 20s, in attesa della concessione scritta dal server piuttosto che fidarsi della parola del processore di pagamento.
Trade-off
Il sondaggio è stato scelto in tempo reale per semplicità; spreca le richieste e si spegne a 20 anni, dopo di che lo studente tocca nuovamente Verify. Il loop del sondaggio non ha alcun segnale di interruzione, quindi può sopravvivere allo schermo.
Nel codice: src/screens/PaymentScreen.tsx, src/utils/levelAccess.ts

3. Valutare la pronuncia tollerando gli errori del riconoscitore

Problema
Mettere una parola contro un bersaglio non è uguaglianza di stringhe. Il riconoscitore restituisce ipotesi concorrenti, scrive numeri come cifre, scambia omofoni e aggiunge diacritici, mentre un tentativo veramente corretto deve ancora passare e uno sbagliato deve ancora fallire.
Approccio
Una pipeline normalizzare-allora-grado: Unicode NFD decomposizione, combinando i segni spogliato, minuscolo, non-alfanumerici rimossi, quindi una mappa costruita a mano canonizzare cifre, ordinali e omofoni noti. La classificazione viene eseguita in livelli, da corrispondenze esatte o di contenimento fino a un diff di caratteri a lunghezza per singole parole. Ogni ipotesi di riconoscimento è classificata e il miglior risultato vince, piuttosto che fidarsi di quello superiore.
Trade-off
Il comparatore di parole singole è un diff di caratteri posizionali, non vero Levenshtein, quindi un carattere inserito di mezza parola disallinea la coda e può fallire un tentativo quasi corretto. La mappa dell'omofono è curata a mano e cresce manualmente.
Nel codice: src/screens/LessonDetailsScreen.tsx

4. Microfono, parlato e animazione su uno schermo

Problema
Un singolo schermo aziona un motore TTS, un riconoscimento vocale, tre animazioni a loop e diversi timer. Il microfono e l'altoparlante non devono mai funzionare insieme, i callback del riconoscimento possono arrivare dopo che il passaggio è cambiato, alcuni motori Android emettono un errore spurio subito dopo un risultato valido e RN 0.84 si è rotto Tts.removeEventListener.
Approccio
Rifs mirror all step state in modo che i callback async leggano i valori correnti invece delle chiusure stantie. L’esclusione reciproca è esplicita in entrambe le direzioni. Un fermo inghiotte lo spurio errore post-risultato, ipotesi parziali sono tenute in un rif per evitare un re-render per blocco audio, e un cane da guardia 8s arresta automaticamente una registrazione bloccata e viene cancellato su tutti e sette i percorsi di uscita.
Trade-off
Corretto sui percorsi che contano ma non esaustivo: un timer di avanzamento automatico del quiz e diversi timer di ripristino degli errori non sono ancora chiari e possono essere attivati dopo l'installazione.
Nel codice: src/screens/LessonDetailsScreen.tsx

5. Trasformare 71 documenti Word eterogenei in contenuti tipizzati

Problema
L'intero curriculum è arrivato come 71 .docx file scritti da persone diverse nel tempo, in cinque formati strutturali reciprocamente incompatibili, bilingue, con sei diversi layout di lessico-carte e soluzioni scritte in sei modi diversi. La trascrizione a mano non era praticabile e un fraintendimento silenzioso avrebbe fornito risposte sbagliate agli studenti paganti.
Approccio
Un parser Python che riduce il formato sceglie una strategia per file, si divide in lezioni e schermate e dispacci in estrattori per formato, con regexe deliberatamente tolleranti alla vera malformazione. Poiché le soluzioni dei documenti di origine sono a volte sbagliate, una tabella di override manuale contrassegnata da campi, livelli, lezioni e patch di domande ha verificato gli errori, ciascuno con un commento che registra le prove. L'output è serializzato su TypeScript tipizzato, quindi l'intero corpus viene controllato al momento della compilazione.
Trade-off
L'analisi Regex è fragile contro i nuovi formati di origine e richiede una ri-esecuzione più una ri-verifica ogni volta che i documenti cambiano. Il corpus viene compilato nel bundle, quindi la correzione di una risposta sbagliata richiede attualmente una versione completa dell'app.
Nel codice: scripts/parse_lessons.py (~1,270 lines)

6. Pedagogia bilingue codificata nell'albero dei componenti

Problema
La traduzione araba deve essere disponibile senza essere visibile, e un “nascondere tutto” a livello di lezione deve nascondere veramente le linee che lo studente ha già rivelato toccando.
Approccio
Un dedicato ArabicText componente rende una pillola di rivelazione al posto del testo e tiene traccia del proprio stato rivelato. Un override a livello di lezione persistente ad AsyncStorage può forzare tutto visibile; un effetto tipizzato su tale override collassa ogni riga rivelata individualmente quando viene disattivata.
Trade-off
L'attrito è il punto ma costa un tocco per linea per i principianti. L'app allinea correttamente l'arabo senza abilitare I18nManager RTL, quindi è testo arabo all'interno di un layout LTR piuttosto che una vera interfaccia RTL.
Nel codice: src/components/ArabicText.tsx, src/screens/LessonDetailsScreen.tsx

Flusso di pagamento.

Dal tocco allo sblocco, con il telefono escluso dalle decisioni di accesso.
1 · SceltaL’utente sceglie un livello. L’app chiede a una Edge Function di creare un checkout Chargily.
2 · PagamentoIl checkout si apre nel browser di sistema. Dahabia o carta, in dinari.
3 · WebhookChargily pubblica un HMAC-signed checkout.paid a Supabase, che registra il diritto di accesso.
4 · RitornoIl collegamento profondo, il lancio a freddo o il curriculum dell'app, qualunque cosa accada per prima, attiva una verifica idempotente.
5 · ConfermaL'app esegue il sondaggio della propria riga di diritti fino a quando non viene visualizzata la sovvenzione scritta dal server, quindi viene sbloccata.

Regole di accesso.

Cosa garantisce il database, qualunque cosa faccia l'app.
Nessuna scrittura diretta dal clientLa politica del cliente INSERT sulla tabella dei diritti è stata rimossa. L'app può leggere le proprie sovvenzioni e nient'altro.
Sicurezza a livello di rigaSelezionare e inserire sono limitati a auth.uid() = user_id, in modo che uno studente non possa mai vedere o toccare l'accesso di un altro.
Utilizzo atomico del codiceLa convalida di un codice promozionale, la masterizzazione di un uso e la concessione dell'accesso avvengono in una singola transazione, immune dalla doppia redenzione simultanea.
Nessun codice di livello vuotoUna riga promo senza un livello esplicito viene rifiutata, chiudendo il foro in cui un codice sbloccava tutto.
Il server è la fonte della veritàIl cliente non decide mai che è stato pagato. Attende la riga di concessione che il webhook scrive.
Un asse di dirittoNon vi è alcun ruolo di amministratore e nessuna colonna di ruolo. L'unica domanda di autorizzazione che il sistema chiede è quali livelli questo utente possiede.