AG-PYMEs es una aplicación móvil multiplataforma desarrollada con React Native y Expo, diseñada específicamente para la gestión integral de pequeñas y medianas empresas. La aplicación proporciona herramientas completas para administrar ventas, inventario, empleados, finanzas, planificación y mucho más.
- Despliegue y Pruebas - Guía completa de instalación, configuración y pruebas funcionales
- Diseño del Sistema - Arquitectura y diseño técnico
- Casos de Uso - Especificaciones funcionales
- Documentación Técnica - Detalles de implementación
scripts/verify_system.ps1- Verificación de prerrequisitosscripts/start_all.ps1- Inicio automático del sistemascripts/run_tests.ps1- Ejecución de pruebas básicas
tests/casos_prueba_detallados.md- Casos de prueba exhaustivos- 80 casos de prueba ejecutados con 100% de éxito
- Pruebas de caja negra en múltiples plataformas
- Panel de control con métricas en tiempo real
- Tarjetas de resumen financiero (ingresos, gastos, beneficios)
- Análisis de inventario y stock crítico
- Rankings de productos más vendidos
- Indicadores de rentabilidad y márgenes
- Sistema de alertas automáticas
-
Ventas rápidas y eficientes
- Selección de productos y servicios
- Escáner de códigos de barras integrado
- Gestión de clientes con historial
- Múltiples métodos de pago
- Generación de facturas, presupuestos y abonos
-
Impresión térmica
- Conectividad Bluetooth con impresoras térmicas
- Tickets personalizables
- Recibos automáticos
-
Control de productos
- Catálogo completo de productos
- Gestión de stock y alertas de inventario bajo
- Categorización y filtrado avanzado
- Precios y costos por producto
-
Gestión de pedidos
- Seguimiento de pedidos a proveedores
- Estados de pedidos (pendiente, recibido, cancelado)
- Historial completo de transacciones
-
Empleados
- Base de datos completa de empleados
- Información de contacto y roles
- Gestión de documentos y archivos
-
Planificación de turnos
- Calendario de turnos por empleado
- Vista diaria y semanal
- Exportación de horarios a CSV
- Envío de horarios por email
- Copia automática de semanas anteriores
- Gestión de citas
- Calendario interactivo para servicios
- Asignación de empleados a citas
- Estados de citas (confirmada, cancelada, completada)
- Verificación de disponibilidad automática
- Catálogo de servicios
- Servicios con múltiples niveles de calidad
- Precios diferenciados por nivel
- Categorización y estados activo/inactivo
- Base de datos de clientes
- Información completa de contacto
- Historial de compras y servicios
- Comunicación directa (llamadas, emails)
- Ingresos y gastos
- Registro detallado de transacciones
- Categorización de ingresos y gastos
- Análisis de flujo de caja
- Reportes financieros
-
Configuración empresarial
- Datos de la empresa (nombre, dirección, teléfono)
- Logo personalizable
- Horarios de apertura y cierre
- Configuración del backend
-
Temas y apariencia
- Tema claro y oscuro
- Interfaz adaptativa para móvil y web
- Diseño responsive
- Alertas de stock bajo
- Notificaciones de citas próximas
- Recordatorios de tareas pendientes
- Estado del sistema
- React Native 0.79.2 - Framework principal
- Expo 53.0.0 - Plataforma de desarrollo
- React Navigation 7.x - Navegación entre pantallas
- React Native Paper 5.13.1 - Componentes UI Material Design
- React Native Reanimated 3.17.4 - Animaciones avanzadas
- Axios 1.8.2 - Cliente HTTP para API
- AsyncStorage - Almacenamiento local
- Expo Camera - Funcionalidad de cámara y scanner
- React Native Gifted Charts - Gráficos y visualizaciones
- Node.js - Entorno de ejecución
- Express.js - Framework web
- PostgreSQL - Base de datos principal
- JWT - Autenticación y autorización
- Multer - Subida de archivos
- CORS - Configuración de acceso cruzado
- ESLint - Linting de código
- Babel - Transpilación de JavaScript
- Metro - Bundler de React Native
- TypeScript - Tipado estático (parcial)
- iOS (iPhone y iPad)
- Android (Teléfonos y tablets)
- Web (Navegadores modernos)
- Node.js 18+ LTS
- PostgreSQL 12+
- Expo CLI
- Git
git clone <repository-url>
cd AppGestionPYMEscd backend
npm install
# Configurar base de datos PostgreSQL
# Editar archivo .env con las credenciales de la base de datoscd AG-PYMEs
npm install
# Configurar archivo .env con la URL del backendEl proyecto incluye scripts PowerShell para facilitar el desarrollo:
# Iniciar todo el sistema
.\scripts\start_all.ps1
# Iniciar solo el backend
.\scripts\start_backend.ps1
# Iniciar solo el frontend
.\scripts\start_frontend.ps1
# Detener servicios
.\scripts\stop_backend.ps1
.\scripts\stop_frontend.ps1- Registro/Login: Crea una cuenta o inicia sesión
- Configuración inicial: Configura los datos de tu empresa
- Importar datos: Añade productos, servicios y empleados
- Personalización: Ajusta el tema y configuraciones
- Ventas: Utiliza el punto de venta para transacciones
- Inventario: Revisa stock y gestiona pedidos
- Citas: Programa y gestiona servicios
- Turnos: Asigna horarios a empleados
AG-PYMEs/
├── 📱 Frontend (React Native + Expo)
│ ├── 🧩 components/ # Componentes reutilizables
│ ├── 📺 screens/ # Pantallas de la aplicación
│ ├── 🔄 navigation/ # Configuración de navegación
│ ├── 🎨 context/ # Gestión de estado global
│ ├── 🔧 hooks/ # Hooks personalizados
│ ├── 🌐 api/ # Servicios y comunicación API
│ └── 🛠️ utils/ # Utilidades y helpers
├── 🖥️ Backend (Node.js + Express)
│ ├── 🎯 controllers/ # Lógica de negocio
│ ├── 🛣️ routes/ # Definición de rutas API
│ ├── 🔒 middleware/ # Middleware de autenticación
│ ├── 📊 models/ # Modelos de base de datos
│ └── 🔧 utils/ # Utilidades del servidor
└── 📚 docs/ # Documentación del proyecto
Frontend (.env)
BACKEND_HOST=http://localhost:3000
NGROK_HOST=https://your-ngrok-url.ngrok.ioBackend (.env)
PORT=3000
DB_HOST=localhost
DB_USER=your_username
DB_PASSWORD=your_password
DB_NAME=ag_pymes_db
JWT_SECRET=your_jwt_secretLa aplicación utiliza PostgreSQL con las siguientes tablas principales:
usuarios- Gestión de usuariosempleados- Información de empleadosproductos- Catálogo de productosservicios- Catálogo de serviciosclientes- Base de datos de clientesventas- Registro de ventascitas- Sistema de citasturnos- Planificación de horarios
# Ejecutar tests del frontend
cd AG-PYMEs
npm test
# Ejecutar tests del backend
cd backend
npm test
# Análisis de código muerto
npm run detect-dead-code- Carga inicial: < 3 segundos
- Navegación: Transiciones fluidas con animaciones
- Sincronización: Actualizaciones en tiempo real
- Offline: Funcionalidad básica sin conexión
- Fork del proyecto
- Crear rama feature (
git checkout -b feature/nueva-funcionalidad) - Commit cambios (
git commit -m 'Añadir nueva funcionalidad') - Push a la rama (
git push origin feature/nueva-funcionalidad) - Crear Pull Request
Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.
Proyecto de Fin de Grado - Ilerna
- Desarrollo completo de aplicación móvil multiplataforma
- Sistema de gestión integral para PYMEs
- Implementación de arquitectura escalable
Para soporte técnico o consultas:
- 📧 Email: soporte@ag-pymes.com
- 📱 Teléfono: +34 XXX XXX XXX
- 💬 Chat: Disponible en la aplicación
⭐ Si este proyecto te ha sido útil, ¡no olvides darle una estrella!
