🚀 NetBoost Pro

Optimizador Inteligente de Conectividad 4G/5G

Fuerza tu red, optimiza tu conexión, controla tus datos.

---

📱 Descripción

NetBoost Pro es una aplicación móvil desarrollada en Flutter que combina tres funcionalidades esenciales para usuarios que buscan optimizar su conexión a internet móvil:

1. Force LTE/5G - Fija tu red en 4G o 5G para máxima estabilidad
2. VPN Integrado - Conexión segura con servidores optimizados para Cuba y Latinoamérica
3. Control de Datos - Monitorea y limita el consumo por aplicación

Diseñada para el mercado cubano y latinoaméricano, con interfaz moderna en español y publicación en Apklis.

---

🎯 Funcionalidades

Force LTE/5G

• Selección de modo de red (Solo LTE, Auto, 5G)
• Apertura directa de ajustes del sistema Android
• Acceso al menú de pruebas oculto (*#*#4636#*#*)
• Modo estable para zonas con fluctuaciones de señal
• Soporte root para forzado directo (Phase 2)

VPN Integrado

• Selector de servidores (Miami, Madrid, Ciudad de México)
• Perfiles de conexión: Seguridad Máxima, Velocidad Máxima, Equilibrado
• Estadísticas en tiempo real (datos recibidos/enviados, duración)
• Protocolo OpenVPN (openvpn_flutter)
• Diseño para integración con Outline SDK (Phase 2)

Control de Datos

• Dashboard visual con gráficos de consumo (fl_chart)
• Límites diarios y mensuales configurables
• Alertas inteligentes al exceder límites
• Consumo por aplicación en tiempo real
• Modo "Ahorro Extremo" para bloquear imágenes/videos

Velocidad de Red

• Monitor de velocidad en tiempo real (subida/bajada)
• Indicadores visuales con gradientes

---

🏗️ Arquitectura

Clean Architecture

lib/
├── core/                    # Capa fundamental
│   ├── theme/              # Tema visual Glassmorphism
│   │   ├── app_colors.dart    # Paleta de colores
│   │   └── app_theme.dart     # Tema Material 3 dark
│   ├── constants/          # Constantes de la app
│   │   ├── app_constants.dart # Configuración general
│   │   └── app_strings.dart   # Textos en español
│   ├── utils/              # Utilidades
│   │   └── formatters.dart    # Formateo de datos
│   └── widgets/            # Widgets reutilizables
│       └── glass_widgets.dart # GlassCard, GlassButton, NeumorphicCard
│
├── data/                    # Capa de datos
│   ├── models/             # Modelos de datos
│   │   ├── app_data_usage.dart
│   │   ├── network_info.dart
│   │   ├── vpn_config.dart
│   │   ├── data_limit.dart
│   │   └── speed_test_result.dart
│   └── services/           # Servicios
│       ├── connectivity_service.dart
│       ├── speed_monitor_service.dart
│       ├── data_usage_service.dart
│       └── storage_service.dart
│
├── domain/                  # Capa de dominio
│   └── entities/           # Entidades del negocio
│       ├── dashboard_data.dart
│       └── vpn_state.dart
│
└── presentation/            # Capa de presentación
    ├── screens/            # Pantallas
    │   ├── home/
    │   ├── force_lte/
    │   ├── vpn/
    │   ├── data_control/
    │   └── settings/
    └── providers/          # State Management (Riverpod)
        ├── connectivity_provider.dart
        ├── data_usage_provider.dart
        └── vpn_provider.dart

---

🛠️ Stack Tecnológico

Componente	Tecnología	Versión
Framework	Flutter	3.44
Lenguaje	Dart	3.12
State Management	Riverpod	2.6.1
Gráficos	fl_chart	0.70.2
VPN	openvpn_flutter	1.3.4
Conectividad	connectivity_plus	6.1.5
Red	network_info_plus	6.1.4
Datos Uso	usage_stats	1.3.1
Intents Android	android_intent_plus	5.3.1
Permisos	permission_handler	11.4.0
Notificaciones	flutter_local_notifications	18.0.1
Storage	shared_preferences	2.5.5
UI Theme	Glassmorphism	3.0.0

---

📋 Permisos Android

<!-- Red -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>

<!-- VPN -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
<uses-permission android:name="android.permission.BIND_VPN_SERVICE"/>

<!-- Datos -->
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS"/>

<!-- Notificaciones -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

---

🚀 Instalación

Requisitos

• Flutter SDK 3.44+
• Dart 3.12+
• Android SDK (API 21+)
• Developer Mode habilitado en Windows

Pasos

# 1. Clonar el repositorio
git clone https://github.com/TU_USUARIO/netboost_pro.git
cd netboost_pro

# 2. Instalar dependencias (usar mirror chino si hay problemas con pub.dev)
set PUB_HOSTED_URL=https://pub.flutter-io.cn
flutter pub get

# 3. Compilar APK debug
flutter build apk --debug

# 4. Instalar en dispositivo
flutter install

---

📱 Pantallas

Inicio

• Estado de conexión actual
• Velocidad de red (descarga/subida)
• Consumo de datos diario/mensual
• Accesos rápidos a funcionalidades

Forzar Red

• Selector de modo de red (LTE Auto, Solo LTE, 5G)
• Botón para abrir ajustes del sistema
• Botón para abrir menú de pruebas
• Modo estable (evita cambios de red)

VPN

• Botón grande de conexión/desconexión
• Selector de servidor con latencia
• Perfiles de seguridad
• Estadísticas de conexión

Control de Datos

• Vista general con porcentajes
• Gráfico de consumo semanal
• Límites configurables con sliders
• Lista de apps por consumo

Ajustes

• Configuración general
• Accesos directos a funcionalidades
• Información de la app

---

🗺️ Roadmap

Phase 1: MVP (Actual)

• Force LTE via ajustes del sistema
• UI Glassmorphism completa
• Dashboard de datos con fl_chart
• VPN UI con selector de servidores
• Límites de consumo configurables
• Navegación bottom bar
• Persistencia con SharedPreferences

Phase 2: Beta

• Platform Channel para VPN nativa (Kotlin)
• Platform Channel para tráfico de red real
• Force LTE con root (su + settings)
• Notificaciones de alerta de consumo
• Integración con Outline SDK
• Compresión de datos HTTP (gzip)
• Gamificación (medallas, logros)

Phase 3: Versión Final

• Turbo Streaming (pre-carga de video)
• Optimización para juegos online
• Modo comunitario (estadísticas anónimas)
• Integración con Apklis
• Pago único ($20-30 CUP)
• Multiidioma (i18n)

---

🔧 Decisión Técnica: VPN

Opción Elegida: openvpn_flutter

• Wrapper de OpenVPN para Flutter
• Soporta Android e iOS
• Perfiles .ovpn estándar
• Comunidad activa

Opción Alternativa: Outline SDK

• Proxy local de Google/Jigsaw
• Better para censura
• Requiere compilación de Go
• Planeado para Phase 2

---

🔧 Decisión Técnica: Force LTE

Sin Root (MVP)

• Abre android.settings.NETWORK_OPERATOR_SETTINGS
• Abre marcador con *#*#4636#*#*
• Usuario cambia manualmente

Con Root (Phase 3)

Runtime.getRuntime().exec("su")
// settings put global preferred_network_mode 11 (LTE only)

---

📦 Dependencias

Producción

Paquete	Propósito
flutter_riverpod	State Management
fl_chart	Gráficos de consumo
openvpn_flutter	Conexión VPN
connectivity_plus	Detección de red
network_info_plus	Info de red
usage_stats	Consumo por app
android_intent_plus	Intents de Android
shared_preferences	Almacenamiento local
permission_handler	Gestión de permisos
flutter_local_notifications	Alertas
glassmorphism	UI Glassmorphism

---

🤝 Contribuir

1. Fork el proyecto
2. Crear branch (git checkout -b feature/nueva-funcionalidad)
3. Commit (git commit -m 'Add nueva funcionalidad')
4. Push (git origin push feature/nueva-funcionalidad)
5. Abrir Pull Request

---

📄 Licencia

MIT License - Ver LICENSE

---

👨‍💻 Desarrollado por

NetBoost Team

Para el mercado cubano y latinoaméricano 🇨🇺

---

¡Descarga NetBoost Pro y domina tu conexión!