mirror of
https://github.com/marcogll/ap_pos.git
synced 2026-01-13 13:15:16 +00:00
bbcd85eff7
- Update version to 1.3.1 in package.json and docker-compose.yml - Optimize Dockerfile with proper data directory structure for production - Add comprehensive Docker documentation (DOCKER.md) - Include deployment and backup scripts (deploy.sh, backup.sh) - Add .env.example for environment configuration - Improve README with detailed deployment instructions - Fix database path handling for Docker production environment - Add health checks and proper Docker Compose configuration - Remove development task documentation - Update .gitignore to exclude backup directories 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
Sistema de Punto de Venta de Master · Ale Ponce
Este es un sistema de Punto de Venta (POS) simple y eficiente, diseñado para gestionar las operaciones de un negocio de belleza. La aplicación permite administrar clientes, ventas, productos, y citas de forma centralizada.
Características Principales
- Dashboard (Solo Admin): Visualización rápida de estadísticas clave como ingresos totales, número de servicios y gráficos de rendimiento.
- Gestión de Ventas: Creación de nuevos movimientos (ventas), generación de recibos para impresión y exportación de historial de ventas a formato CSV.
- Gestión de Clientes: Registro y consulta de clientes, con la posibilidad de ver su expediente completo, incluyendo historial de servicios y cursos.
- Gestión de Productos: Permite añadir, editar y eliminar tanto servicios como cursos ofrecidos por el negocio.
- Configuración (Solo Admin):
- Ajuste de los datos del negocio para los recibos.
- Gestión de credenciales de usuario.
- Administración de múltiples usuarios (crear, editar, eliminar).
- Autenticación: Sistema de inicio de sesión seguro para proteger el acceso a la información.
- Roles de Usuario: Perfiles de Administrador (acceso total) y Usuario (acceso limitado a ventas y clientes).
Despliegue con Docker
El sistema está diseñado para ser desplegado fácilmente utilizando Docker y Docker Compose, asegurando un entorno consistente y aislado.
Prerrequisitos
- Tener instalado Docker
- Tener instalado Docker Compose
Pasos para el despliegue
-
Clona o descarga este repositorio en tu máquina local.
-
Configura las variables de entorno:
cp .env.example .env # Edita el archivo .env con una clave secreta segura -
Construye y levanta el contenedor:
docker-compose up -d --build -
Verifica que esté funcionando:
docker-compose ps docker-compose logs ap-pos -
Accede a la aplicación:
- URL:
http://localhost:3111 - En la primera ejecución serás redirigido a
/setup.htmlpara crear el usuario administrador
- URL:
Persistencia de datos
- La base de datos SQLite se almacena en un volumen Docker persistente
- Los datos se mantienen entre reinicios y actualizaciones del contenedor
- Para más información sobre Docker, consulta DOCKER.md