mirror of
https://github.com/marcogll/ap_pos.git
synced 2026-01-13 13:15:16 +00:00
7594d96fa4
- 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.
71 lines
2.8 KiB
Markdown
71 lines
2.8 KiB
Markdown
# 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](https://nodejs.org/) (versión 18 o superior)
|
|
- [npm](https://www.npmjs.com/) (generalmente se instala con Node.js)
|
|
|
|
### Pasos para la Ejecución
|
|
|
|
1. **Clonar el Repositorio:**
|
|
```bash
|
|
git clone https://github.com/marcogll/ap_pos.git
|
|
cd ap_pos/ap-pos
|
|
```
|
|
|
|
2. **Instalar Dependencias:**
|
|
Navega a la carpeta `ap-pos` y ejecuta el siguiente comando para instalar los paquetes necesarios:
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
3. **Iniciar el Servidor:**
|
|
Una vez instaladas las dependencias, inicia el servidor con:
|
|
```bash
|
|
npm start
|
|
```
|
|
El servidor se ejecutará en `http://localhost:3000`.
|
|
|
|
4. **Acceder a la Aplicación:**
|
|
Abre tu navegador web y ve a `http://localhost:3000`.
|
|
|
|
5. **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
|
|
|
|
1. **Construir la Imagen de Docker:**
|
|
Desde la carpeta `ap-pos`, ejecuta:
|
|
```bash
|
|
docker build -t ap-pos-app .
|
|
```
|
|
|
|
2. **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.
|
|
```bash
|
|
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.** |