Initial commit

ReadME.MD

@@ -0,0 +1,84 @@
+# 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](https://nodejs.org/).
+*   **Navegador Web**: Un navegador moderno como Google Chrome, Firefox, o Edge.
+
+## Instalación y Ejecución
+
+1.  **Navega al directorio del proyecto**:
+    ```bash
+    cd ap-pos
+    ```
+2.  **Instala las dependencias**:
+    ```bash
+    npm install
+    ```
+3.  **Inicia el servidor**:
+    ```bash
+    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`.