PagoMovilOCR
Open Source / npm-Paketnpm-Bibliothek, die venezolanische Pago-Móvil-Belege per OCR extrahiert, normalisiert und validiert.
Problem
In Venezuela bedeutet die Bestätigung einer Pago-Móvil-Zahlung meist, den Kunden um einen Screenshot zu bitten und Betrag, Referenz, Datum und Bank von Hand abzulesen — langsam, fehleranfällig und für ein Geschäft mit vielen täglichen Zahlungen nicht skalierbar.
Lösung
PagoMovilOCR automatisiert genau das: Es nimmt ein Bild des Belegs entgegen und liefert strukturierte Daten samt einer Reihe von Konsistenzprüfungen — ganz ohne eigenes Backend und ohne das Bild jemals an einen Server zu senden.
Engineering
- Pipeline mit 4 unabhängig testbaren Stufen entworfen: OCR → Normalisierung → Parsing → Validierung.
- Austauschbare OCR-Engine implementiert (standardmäßig Tesseract.js, läuft zu 100 % clientseitig/lokal via WebAssembly).
- Registrierbares Bankprofil-System (`registerBankProfile`) gebaut, um das Format jeder Bank zu erkennen und, wenn sicher möglich, zu parsen.
- USD/VES-Konvertierungsmodul mit offiziellem BCV-Kurs (über pydolarve.org) entwickelt, mit konfigurierbarem In-Memory-Cache und explizitem `stale`-Handling.
- Gesamte Logik mit Unit- und Integrationstests in Vitest abgedeckt: Normalisierung, Parser, einzelne Validatoren, das Währungsmodul mit simulierten Providern und `verifyPayment` end-to-end mit simuliertem OCR.
