Contexto
BorderBytes es un estudio de desarrollo de software a medida cuya propuesta comercial —“Software empresarial a medida” y “Evoluciona tu negocio 10x más rápido”— se respalda con producto propio en producción. La cara pública es una landing de captación construida con Astro y Tailwind, pensada para presentar los servicios (CRM, sistemas de control en tiempo real, paneles de KPIs y landing pages) y convertir visitas en clientes.
Detrás de esa landing, BorderBytes opera su propia plataforma de telecomunicaciones: un Operador Móvil Virtual (MVNO) que se apoya en la red mayorista de Altan Redes. Ese producto —G Móvil— es el corazón técnico del proyecto y demuestra la capacidad del estudio para construir sistemas empresariales complejos de extremo a extremo.
El reto
Montar un MVNO implica administrar el ciclo de vida completo de miles de líneas: activar SIMs, asignar planes, procesar recargas, controlar saldo e inventario, atender soporte y, sobre todo, mantener la información sincronizada con el operador de red mayorista. Altan no expone todo en tiempo real: parte de la operación (recargas, altas, portabilidad, estados de línea, CDR) se entrega como reportes diarios que hay que descargar, parsear y conciliar.
El reto fue diseñar una arquitectura capaz de orquestar dos mundos: la operación interna (panel administrativo multi-rol y app de cliente) y la integración con la red mayorista (API transaccional y archivos batch), manteniendo la base de datos como fuente de verdad consistente.
Arquitectura
La plataforma se estructura en varias piezas que conviven en un mismo dominio de producto:
- Landing de captación (repo
BorderBytes---Main-Landing-Page): sitio estático en Astro 5 + Tailwind 4, con sitemap, SEO, modal promocional, banner de consentimiento de cookies y carga condicional de Google Analytics. - API REST en PHP (repo
gmovil): organizada por acciones (activar,actualizar,buscar,insertar,eliminar,desactivar) y entidades. Toda la lógica de datos se delega a stored procedures y functions de MySQL, invocadas mediante un helper único (ejecutarConsulta/ejecutarAccion). La autenticación es por token con fecha de caducidad validada en cada endpoint. - App de cliente: front en Astro servido desde la propia plataforma (login, inicio, planes, recargas, perfil, soporte, portal cautivo y estado de pago), que consume la API REST.
- Panel administrativo multi-rol: gestiona usuarios por área (distribuidores, subdistribuidores, coordinadores, tiendas, vendedores, contact center, logística, operaciones, contabilidad, saldos e inventarios), además de catálogos (país, estado, ciudad, productos, ofertas, IMEI).
- Procesos batch (cron + SFTP): jobs programados que se conectan por SFTP al servidor de CDR de Altan, descargan los reportes del día (recargas, altas, ciclo de vida, estado de unidad funcional, portabilidad), los leen con PhpSpreadsheet y los concilian contra la base de datos.
- Integración transaccional con Altan: funciones dedicadas (
ejecucionAltan) que obtienen un token OAuth vía Apigee y ejecutan operaciones como la compra de offerings sobre un MSISDN.
La actualización de datos operativos combina así dos mecanismos: llamadas a la API de Altan para acciones inmediatas y la ingesta diaria de archivos para conciliación masiva, todo reflejado en los paneles y reportes del sistema.
Funcionalidades clave
- Monitor y gestión de SIMs / líneas telefónicas: alta, búsqueda y detalle de líneas por MSISDN, estado de la línea, cambio de SIM, solicitudes de SIMs y filtros de activación.
- Recargas y planes: consulta de paquetes y ofertas por producto/coordinador, alta de recargas y compra de paquetes integrada con la API de Altan.
- Saldo e inventario: usuarios de saldos/inventarios, registro de saldo y compra de saldo.
- Reportes operativos: altas, recargas, reportes de cliente y reportes de fallos, con conciliación desde los CDR descargados por SFTP.
- Soporte y dispositivos: tickets de soporte, comentarios, gestión de token de dispositivo y actualización de ubicación.
- Administración multi-rol con catálogos completos y carga masiva de datos.
Decisiones técnicas y retos
Centralizar la lógica de datos en stored procedures y functions de MySQL mantiene los controladores PHP delgados y predecibles: cada endpoint valida el token, resuelve permisos y delega la consulta. Esto facilita auditar y reutilizar la lógica de negocio desde distintas vistas (app de cliente y panel admin).
La integración con Altan obligó a manejar dos paradigmas. Para lo transaccional se construyó un cliente cURL con manejo de OAuth contra Apigee; para lo masivo, jobs por cron que navegan la estructura de directorios remota por fecha, descargan el CSV correspondiente y lo procesan con PhpSpreadsheet, guardando en configuración la última fecha conciliada para no reprocesar.
El sistema de autenticación por token con expiración y la resolución de identidad/rol en cada petición permiten una jerarquía de usuarios amplia sin acoplar la app pública al panel interno. El front de cliente en Astro aporta una experiencia ligera y rápida sobre la misma API.
En la landing, las decisiones fueron de producto y rendimiento: Astro para un sitio estático veloz, Tailwind 4 para iterar rápido en UI, y detalles de cumplimiento como el consentimiento de cookies previo a cargar analítica.
Resultado
BorderBytes combina una presencia comercial cuidada con un producto técnico real en producción. La plataforma G Móvil cubre el ciclo completo de un MVNO —SIMs, líneas, recargas, saldo, soporte y reportería— integrada con la red mayorista de Altan tanto en tiempo de operación como por conciliación diaria. El proyecto evidencia la capacidad del estudio para diseñar, integrar y operar sistemas empresariales complejos, y respalda con hechos la promesa de la landing de entregar software a medida que escala con el negocio.