Aplicación Android para la gestión de cabinas en cibers / locutorios de videojuegos.
Permite controlar en tiempo real el estado de cada PC, manejar distintos modos de cobro, registrar ventas y configurar el negocio desde el propio dispositivo.
Cyber Control es un sistema de punto de venta (POS) diseñado específicamente para dueños de cibercafés o salas de videojuegos que alquilan equipos por tiempo. Con una interfaz moderna basada en Material Design 3 y Jetpack Compose, el propietario puede:
- Ver el estado de todas las cabinas de un vistazo.
- Iniciar, pausar y cerrar sesiones con un solo toque.
- Cobrar por minuto transcurrido o con duraciones prepagadas fijas.
- Agregar consumibles (gaseosas, galletas, etc.) durante la sesión.
- Registrar el historial de ventas agrupado por fecha.
- Configurar zonas de precio, productos y horario de cierre.
- Soporte de 1 a 10+ cabinas (numeración configurable).
- Estados visuales: Libre, Ocupado, Pausado y Tiempo agotado.
- Indicador de progreso circular animado que muestra el tiempo restante en sesiones prepagadas.
- Visualización del tiempo transcurrido, la hora de inicio y la hora estimada de fin.
- Cálculo automático del costo en tiempo real.
| Modo | Descripción |
|---|---|
| Libre | Se cobra por el tiempo exacto utilizado (por minuto). |
| Prepago | El cliente paga por adelantado una duración fija (15 min, 30 min, 1 hora o personalizado). |
- Permite crear distintas zonas de precio (ej.: cabinas VIP, estándar).
- Cada zona tiene su propia tarifa por hora y sus presets de duración.
- Zona base "Básico" como respaldo predeterminado.
- Agrega productos al total de la sesión en cualquier momento.
- Productos predefinidos o artículos personalizados con nombre y precio manual.
- Resumen final con detalle de extras antes de cobrar.
- Métodos de pago: Efectivo o Yape (pago móvil).
- Al confirmar, la venta queda registrada automáticamente.
- Historial agrupado por fecha (las más recientes primero).
- Las ventas de hoy se destacan visualmente.
- Desglose por método de pago: efectivo vs. Yape.
- Muestra el rango horario de cada sesión.
- Opción para borrar el historial.
- Número de cabinas y esquema de numeración (0–9 ó 1–10).
- Hora de cierre: aviso automático cuando quedan menos de 60 minutos.
- Crear, editar y eliminar grupos de precio.
- Gestionar los presets de duración de cada grupo.
- Administrar el catálogo de productos disponibles.
- Notificación push de alta prioridad cuando el tiempo prepago de una cabina se agota.
| Categoría | Tecnología | Versión |
|---|---|---|
| Lenguaje | Kotlin | 2.0.21 |
| UI | Jetpack Compose + Material 3 | BOM 2024.09.00 |
| Temas | Material You (color dinámico Android 12+) | — |
| Almacenamiento | SharedPreferences + JSON | — |
| Notificaciones | AndroidX NotificationCompat | — |
| Build | Gradle | 8.13 |
| SDK mínimo | Android 11 (API 30) | — |
| SDK objetivo | API 36 | — |
| Java bytecode | Java 11 | — |
- Android 11 o superior (API nivel 30+).
- Permiso
POST_NOTIFICATIONSpara recibir alertas de tiempo agotado.
- Clona el repositorio:
git clone https://github.com/LeninAsto/Cyber-Control.git
- Ábrelo en Android Studio (versión compatible con Kotlin 2.0 y Compose).
- Deja que Gradle sincronice las dependencias.
- Conecta un dispositivo con Android 12+ o usa un emulador con la misma API.
- Pulsa Run ▶ para instalar y ejecutar la aplicación.
Nota: el archivo
local.propertiescon la ruta del SDK se genera automáticamente por Android Studio y no está incluido en el repositorio.
El workflow Build Android APKs compila la app en GitHub Actions con JDK 17 y Android SDK API 36. En cada push o pull_request ejecuta pruebas unitarias release y genera un APK release universal.
Para descargar el APK:
- Entra al repositorio en GitHub.
- Abre la pestaña Actions.
- Selecciona la ejecución más reciente de Build Android APKs.
- Baja el artifact
app-universal-releasepara instalarlo sin elegir ABI manualmente.
Cyber-Control/
├── app/
│ ├── src/
│ │ ├── main/
│ │ │ ├── java/com/leninasto/cybercontrol/
│ │ │ │ ├── MainActivity.kt # Lógica principal y toda la UI (Compose)
│ │ │ │ └── ui/theme/
│ │ │ │ ├── Color.kt # Paleta de colores Material 3
│ │ │ │ ├── Theme.kt # Tema dinámico (Android 12+)
│ │ │ │ └── Type.kt # Tipografía
│ │ │ ├── res/ # Recursos (iconos, strings, temas)
│ │ │ └── AndroidManifest.xml
│ │ ├── test/ # Pruebas unitarias
│ │ └── androidTest/ # Pruebas de instrumentación
│ └── build.gradle.kts
├── gradle/
│ └── libs.versions.toml # Catálogo centralizado de dependencias
├── build.gradle.kts
├── settings.gradle.kts
└── LICENSE # Apache License 2.0
Este proyecto está licenciado bajo la Apache License 2.0.
Consulta el archivo LICENSE para más detalles.
Desarrollado por LeninAsto 🚀