The Alchemist Code
PDF Master: OCR en el teléfono y herramientas PDF en la web que escalan a cero
Una app de escaneo para iOS y Android ("Scan to PDF" en las tiendas) donde el documento nunca sale del teléfono, y pdfmaster.guru, un sitio en 6 idiomas que une, divide, comprime y convierte PDF sobre Cloud Run, con pagos en Stripe.
Documentos privados y servidores que cuestan aunque nadie los use
La gente escanea identificaciones, contratos y facturas. No quiere que esos documentos viajen a un servidor para leer el texto.
Y una web de herramientas PDF tiene picos y horas muertas: un servidor encendido todo el día cuesta aunque nadie lo use, y convertir un PDF grande no puede tardar una eternidad.
Decisiones técnicas, y por qué
OCR en el dispositivo
La app reconoce el texto con ML Kit en el propio teléfono. Los documentos escaneados no se suben a ningún servidor y no hace falta crear una cuenta.
Cloud Run que escala a cero
La API de la web, en FastAPI, corre en Cloud Run con cero instancias mínimas: sin visitas, no hay costo de cómputo. Firebase Hosting sirve el sitio desde su CDN.
Medir antes de pagar más
Las pruebas de carga mostraron que 1 vCPU rinde igual que 2 para estas herramientas, que trabajan en un solo hilo: mitad de costo. Activar CPU boost bajó el arranque en frío de 7.4 a 0.31 segundos.
Archivos que se borran solos
Los archivos de la web van a Cloud Storage con una regla que los borra al día siguiente, y los resultados se entregan con enlaces firmados que vencen en una hora.
Cómo se opera todos los días
- Pruebas reales automáticas
- Nuestro monitor revisa la web y la API, une dos PDF reales y abre un pago de prueba en Stripe para confirmar que el cobro funciona, sin cobrar nada.
- Pruebas en cada cambio
- GitHub Actions corre las pruebas del backend y del frontend en cada cambio, y cada versión aprobada se publica sola en Firebase y Cloud Run.
- SEO desde el código
- Cada publicación regenera canonical, hreflang, sitemap y datos estructurados en los 6 idiomas del sitio.
- Al día con las tiendas
- La app usa Play Billing 8, el que exige Google, y se quitó un permiso de fotos que Google Play había rechazado.
Con qué está hecho
- Flutter
- ML Kit (OCR)
- FastAPI · Python
- React · Vite
- LibreOffice
- Ghostscript
- Tesseract
- Cloud Run
- Firebase Hosting
- Cloud Storage
- Stripe
- GitHub Actions
¿Qué tiene que salir bien en tu proyecto?
La primera llamada y la propuesta no tienen costo. Te responde en persona quien va a dirigir tu proyecto.