AP-POS — Aplicación de Punto de Venta (v0.3)

Esta es una aplicación de punto de venta (POS) diseñada para ser simple y robusta. Permite registrar clientes, gestionar movimientos (pagos, anticipos) e imprimir recibos.

La versión actual (v0.3) se enfoca en mejorar la experiencia de usuario (UX) y la interfaz (UI) para hacerla más intuitiva y agradable de usar.

---

Arquitectura y Tecnologías

• Frontend: Single-Page Application (SPA) con HTML5, CSS3 y JavaScript (Vanilla).
• Backend: Servidor ligero con Node.js y Express.js que provee una API REST.
• Base de Datos: SQLite (ap-pos.db), que hace la aplicación portable y fácil de respaldar.

Novedades en la Versión 0.3

Se han implementado las siguientes mejoras en la interfaz y experiencia de usuario:

• Diseño de Formularios Mejorado:
  • El formulario de Clientes ahora utiliza un diseño de dos columnas, haciendo que la información sea más fácil de leer y rellenar.
  • El formulario de Configuración agrupa los campos de dirección (Colonia y C.P.) para mayor claridad y se han añadido textos de ejemplo (placeholders).
• Estilo de Botones Consistente:
  • Se ha añadido más espacio y márgenes a los botones de acción.
  • Los botones de "Limpiar" o "Cancelar" ahora son de color rojo para distinguirlos claramente de las acciones principales.
• Flujo de Trabajo Optimizado:
  • Después de generar un recibo, el cursor se posiciona automáticamente en el campo "Cliente", agilizando la creación de un nuevo movimiento.
• Títulos Clarificados:
  • Se han mejorado los títulos de algunas secciones para que sean más descriptivos (e.g., "Movimientos Recientes").

Características Principales

• Gestión de Clientes (Crear, Editar, Eliminar).
• Registro de Movimientos (Pagos, Anticipos).
• Generación de Folios automáticos e incrementales.
• Impresión de Recibos en formato de 58mm.
• Exportación de todos los movimientos a un archivo CSV.
• Configuración de los datos del negocio para personalizar los recibos.

Requisitos del Sistema

• Node.js: Necesario para ejecutar el servidor backend. Descárgalo desde nodejs.org.
• Navegador Web: Un navegador moderno como Google Chrome, Firefox, o Edge.

Instalación y Ejecución

1. Navega al directorio del proyecto:

   cd ap-pos
   

2. Instala las dependencias:

   npm install
   

3. Inicia el servidor:

   npm start
   

   El servidor se ejecutará en http://localhost:3000.

4. Abre la aplicación: Abre el archivo index.html en tu navegador.

Estructura de Archivos

ap-pos/
├─ index.html           # Interfaz de usuario principal.
├─ styles.css           # Estilos para la aplicación y la impresión.
├─ app.js               # Lógica del frontend (eventos, renderizado, UI).
├─ storage.js           # Módulo del frontend para comunicarse con la API.
├─ print.js             # Lógica para generar el recibo.
│
├─ server.js            # Servidor backend (Node.js/Express).
├─ package.json         # Dependencias y scripts del proyecto.
├─ ap-pos.db            # Archivo de la base de datos SQLite.
│
└─ src/
   └─ logo.png          # Logo del negocio.

Consideraciones

• Portabilidad: Para mover la aplicación, copia la carpeta ap-pos completa.
• Respaldo: Para respaldar tus datos, simplemente haz una copia del archivo ap-pos.db.