mirror of https://github.com/marcogll/ap_pos.git synced 2026-01-13 21:25:16 +00:00

Files

Marco Gallegos 7594d96fa4 feat: add client history and subtypes

- Added subtypes for services (Service/Retouch).
- Implemented expandable client rows to show service history.
- Added a search bar to filter clients by name.
- Added 'Oncological' status column to the client list.
- Created a new API endpoint for client history.

fix(db): ensure database persistence in Docker
- The database path is now configurable via the DB_PATH environment variable.
- The Dockerfile has been updated to create a persistent volume for data.
- The README now contains the correct 'docker run' command for data persistence.

2025-08-13 09:31:31 -06:00

2.8 KiB

Raw Blame History

Ale Ponce | AlMa - Sistema de Punto de Venta

Este es un sistema de punto de venta (POS) simple y moderno basado en la web, diseñado para gestionar clientes, ventas y recibos de forma eficiente.

Características Principales

Gestión de Ventas: Crea nuevos movimientos (ventas, pagos) y genera recibos imprimibles.
Base de Datos de Clientes: Administra una lista de clientes con su información de contacto.
Sistema de Roles:
- Administrador: Tiene acceso a todas las funciones, incluyendo un dashboard de estadísticas, la configuración del negocio y la gestión de usuarios.
- Usuario: Rol de vendedor con acceso limitado a la creación de ventas y gestión de clientes.
Dashboard (Solo Admin): Visualiza estadísticas clave como ingresos totales, número de servicios y un gráfico de ingresos por tipo de servicio.
Exportación de Datos: Exporta todos los movimientos a un archivo CSV.
Persistencia de Datos: Toda la información se guarda en una base de datos SQLite (ap-pos.db).
Listo para Docker: Incluye un Dockerfile para una fácil contenerización y despliegue.

Cómo Ejecutar la Aplicación

Prerrequisitos

Node.js (versión 18 o superior)
npm (generalmente se instala con Node.js)

Pasos para la Ejecución

Clonar el Repositorio:

git clone https://github.com/marcogll/ap_pos.git
cd ap_pos/ap-pos

Instalar Dependencias: Navega a la carpeta ap-pos y ejecuta el siguiente comando para instalar los paquetes necesarios:
```
npm install
```
Iniciar el Servidor: Una vez instaladas las dependencias, inicia el servidor con:
```
npm start
```
El servidor se ejecutará en http://localhost:3000.
Acceder a la Aplicación: Abre tu navegador web y ve a http://localhost:3000.
Credenciales por Defecto:
- Usuario: admin
- Contraseña: password
¡Importante! Se recomienda cambiar la contraseña del administrador en la pestaña de "Configuración" después del primer inicio de sesión.

Cómo Usar con Docker

Construir la Imagen de Docker: Desde la carpeta ap-pos, ejecuta:
```
docker build -t ap-pos-app .
```
Ejecutar el Contenedor: Para ejecutar la aplicación en un contenedor, usa el siguiente comando. Esto mapeará el puerto 3000 y montará un volumen para que la base de datos persista fuera del contenedor, en una nueva carpeta data que se creará en tu directorio actual.
```
docker run -p 3000:3000 -v $(pwd)/data:/usr/src/app/data ap-pos-app
```
Nota: La primera vez que ejecutes esto, se creará un directorio data en tu carpeta actual para almacenar ap-pos.db.

Autores

Gemini
Marco G.

2.8 KiB Raw Blame History