SimplePOS
Sistema de Punto de Venta Open Source
Sistema web de gestión de ventas, compras e inventario para negocios minoristas con soporte multi-sucursal.
Capturas de pantalla
Dashboard
Panel de control con métricas en tiempo real: ventas del día, semana y mes, mejores clientes y productos más vendidos.

Registro de ventas
Flujo completo de venta: búsqueda de productos, aplicación de descuentos por ítem y selección de múltiples métodos de pago.

Inventario
Listado de artículos por sucursal con indicadores visuales de bajo stock (≤ 10 unidades).

Ticket de venta (PDF)
Comprobante generado automáticamente al cerrar una venta, listo para imprimir o compartir.
Características
- Ventas: Registro con múltiples productos, descuentos por ítem y múltiples métodos de pago por transacción.
- Compras: Órdenes de compra a proveedores con actualización automática de stock.
- Inventario: Control de stock por sucursal con alertas de bajo stock (≤ 10 unidades).
- Traspasos: Transferencia de stock entre sucursales.
- Clientes y Proveedores: Administración unificada de personas.
- Usuarios y Permisos: Roles con control de acceso por módulo.
- Reportes PDF: Ventas por rango de fechas, inventario y tickets de venta.
- Escritorio analítico: Métricas en tiempo real (ventas del día/semana/mes, mejores clientes, productos más vendidos).
- Seguridad reforzada: Sesión endurecida, validación CSRF en operaciones de escritura, controles por permiso en endpoints AJAX y escape de salida en respuestas HTML/JSON.
Tecnologías
| Componente |
Tecnología |
| Backend |
PHP 7+ (MySQLi) |
| Base de datos |
MySQL / MariaDB |
| Frontend |
Bootstrap 3.3.7 + AdminLTE |
| JavaScript |
jQuery 3, DataTables, Chart.js |
| Reportes PDF |
FPDF 1.81 |
| Servidor |
Apache (XAMPP / LAMPP) |
Requisitos
- XAMPP / LAMPP con PHP y MySQL habilitados
- PHP 7.4 o superior
- MySQL 5.7 o superior
Instalación
1. Clonar el repositorio
git clone https://github.com/WorkTeam01/SimplePOS.git /opt/lampp/htdocs/SimplePOS
2. Importar la base de datos
mysql -u root -p -e "CREATE DATABASE simplepos CHARACTER SET utf8 COLLATE utf8_general_ci;"
mysql -u root -p simplepos < simplepos.sql
3. Configurar la conexión
Copiar el archivo de ejemplo y ajustar los valores según tu entorno:
DB_HOST=localhost
DB_NAME=simplepos
DB_USERNAME=root
DB_PASSWORD=
PRO_TIMEZONE=UTC
4. Iniciar el servidor
sudo /opt/lampp/lampp start
5. Acceder al sistema
http://localhost/SimplePOS/
Credenciales por defecto:
| Campo |
Valor |
| Usuario (N° documento) |
admin |
| Contraseña |
admin123 |
⚠️ Cambia la contraseña del admin después del primer inicio de sesión.
Solución de problemas
La página no carga
Verifica que LAMPP esté activo: sudo /opt/lampp/lampp status. Si Apache o MySQL están detenidos, reinicia con sudo /opt/lampp/lampp restart.
Error de conexión a la base de datos
Confirma que la base de datos simplepos fue importada correctamente y que las credenciales en el archivo .env coinciden con tu entorno.
Imágenes de productos no se muestran
Verifica que las carpetas files/productos/ y files/usuarios/ tengan permisos de escritura: chmod -R 755 files/.
Seguridad implementada
1. Sesión y autenticación
- La sesión se inicia mediante
iniciarSesionSegura() (config/auth.php) con cookies HttpOnly, SameSite=Lax y Secure cuando aplica HTTPS.
- Todos los endpoints
ajax/*.php protegidos requieren sesión activa con requireAuth()/requiereAutenticacion().
- Después del login se regenera el ID de sesión (
regenerarSesion()) para mitigar fijación de sesión.
2. CSRF para operaciones de escritura
- Se genera un token por sesión con
csrfToken().
- El frontend lo adjunta automáticamente en peticiones AJAX (
vistas/footer.php) mediante cabecera X-CSRF-TOKEN.
- Las operaciones que crean/editan/anulan/activan/desactivan validan token con
verificarCsrf().
3. Control de acceso por módulo
- Los handlers AJAX usan
requerirPermiso() o requerirAlgunPermiso() según el caso (almacen, compras, ventas, acceso, consultac, consultav, configuracion).
- Si el usuario no tiene permiso, la API responde
403 Forbidden.
4. Contraseñas y migración de hashes
- Nuevas contraseñas y cambios de clave usan
password_hash() (bcrypt/argon2 según PHP).
- Login usa
verifyPassword() y acepta hash legacy SHA-256 solo para migración transparente.
- Cuando un usuario inicia sesión con hash legacy válido, se re-hashea automáticamente a formato moderno.
- Nunca se expone el hash de contraseña en respuestas JSON de usuario/login.
5. Endurecimiento de entrada/salida
- IDs de entrada en rutas críticas se normalizan a entero antes de consultas.
- Salidas en HTML/JSON sensibles se escapan con
htmlspecialchars() en controladores y vistas.
- La conexión a BD no expone detalles técnicos al cliente; los errores se registran en el log del servidor.
Estructura del proyecto
SimplePOS/
├── config/ # Configuración de BD, autenticación y helpers
├── modelos/ # Clases de modelo (lógica de negocio y consultas SQL)
├── ajax/ # Controladores AJAX (punto de entrada de peticiones)
├── vistas/ # Plantillas HTML/PHP
│ └── scripts/ # JavaScript por módulo
├── reportes/ # Generación de reportes PDF (FPDF)
├── fpdf181/ # Librería FPDF
├── public/ # Assets estáticos (CSS, JS, imágenes, plugins)
└── files/ # Archivos subidos por el usuario
├── productos/ # Imágenes de productos
└── usuarios/ # Fotos de perfil
Módulos
| Módulo |
Descripción |
| Escritorio |
Panel de control con métricas y analíticas |
| Artículos |
Gestión de productos e inventario |
| Categorías |
Clasificación de productos |
| Ventas |
Registro y anulación de ventas |
| Compras |
Órdenes de compra a proveedores |
| Traspasos |
Transferencia de stock entre sucursales |
| Clientes |
Administración de clientes |
| Proveedores |
Administración de proveedores |
| Usuarios |
Gestión de cuentas del sistema |
| Perfiles y Permisos |
Control de acceso por rol |
| Empresa y Sucursales |
Configuración del negocio |
Contribuir
Las contribuciones son bienvenidas. Para cambios significativos, abre un issue primero para discutir qué te gustaría modificar.
- Haz fork del repositorio
- Crea una rama para tu feature (
git checkout -b feature/nueva-funcionalidad)
- Haz commit de tus cambios (
git commit -m 'feat: agregar nueva funcionalidad')
- Haz push a la rama (
git push origin feature/nueva-funcionalidad)
- Abre un Pull Request
Colaboradores
Licencia