AppControlStock-V2.5

Sistema de Gestión Integrado para Comercios (POS/ERP)

Sistema de escritorio desarrollado en Python con Tkinter para la gestión integral de inventario, ventas, clientes y reportes. Diseñado para ser una solución robusta y fácil de usar para pequeñas y medianas empresas.

📜 Descripción

Este proyecto es una aplicación de escritorio multifuncional que centraliza las operaciones clave de un negocio. Permite llevar un control detallado del stock, gestionar una base de datos de clientes (incluyendo cuentas corrientes), realizar ventas a través de una interfaz de Punto de Venta (POS) y analizar el rendimiento del negocio mediante un dashboard y reportes detallados.

La aplicación utiliza una base de datos local SQLite, lo que la hace portable y fácil de instalar sin necesidad de un servidor de base de datos externo.

---

✨ Características Principales

• 👤 Gestión de Usuarios:

  • Sistema de inicio de sesión seguro (contraseñas hasheadas).
  • Roles de usuario (Administrador, Vendedor) con distintos niveles de acceso.

• 📦 Gestión de Inventario (Stock):

  • Creación, actualización y eliminación de productos y categorías.
  • Control de stock, precio de costo, precio de venta y stock mínimo.
  • Búsqueda y filtrado avanzado de productos.
  • Importación y exportación masiva de productos mediante archivos CSV.
  • Generación e impresión de etiquetas con códigos de barras.

• 🛒 Punto de Venta (POS):

  • Interfaz rápida para escanear productos y registrar ventas.
  • Selección de clientes y métodos de pago (Contado, Crédito).
  • Generación de tickets de venta en formato PDF.

• 👥 Gestión de Clientes:

  • Base de datos de clientes con información de contacto.
  • Manejo de cuentas corrientes y saldos deudores.
  • Registro de pagos y historial de transacciones por cliente.

• 🚚 Proveedores y Compras:

  • Gestión de proveedores.
  • Creación y seguimiento de órdenes de compra para reponer stock.

• 📊 Dashboard y Reportes:

  • Dashboard visual con métricas clave (ingresos, ganancias, producto más vendido, etc.).
  • Gráficos de ventas por período de tiempo.
  • Generación de reportes de ventas filtrados por fecha y categoría.
  • Exportación de reportes a CSV.

• ⚙️ Administración:

  • Sistema de copia de seguridad (backup) y restauración de la base de datos.
  • Personalización del logo de la empresa.
  • Panel de alertas para productos con bajo stock.

---

🛠️ Tecnologías Utilizadas

• Lenguaje: Python 3
• Interfaz Gráfica: Tkinter (biblioteca estándar de Python)
• Base de Datos: SQLite 3
• Reportes y Gráficos:
  • Matplotlib para la visualización de datos.
  • FPDF para la generación de documentos PDF.
• Códigos de Barras:
  • python-barcode para la creación de códigos de barras.
  • Pillow (PIL) para el manejo de imágenes.

---

🚀 Puesta en Marcha

Sigue estos pasos para ejecutar el proyecto en tu máquina local.

Prerrequisitos

Asegúrate de tener Python 3 instalado en tu sistema.

Instalación

1. Clona el repositorio:

   git clone [https://github.com/Floree1/AppControlStock-V2.5.git](https://github.com/Floree1/AppControlStock-V2.5.git)
   cd AppControlStock-V2.5

2. Crea un entorno virtual (recomendado):

   python -m venv venv
   source venv/bin/activate  # En Windows: venv\Scripts\activate

3. Instala las dependencias: El proyecto utiliza varias librerías externas. Puedes instalarlas todas con el siguiente comando:

   pip install -r requirements.txt

   (Puedes crear un archivo requirements.txt con el siguiente contenido):

   matplotlib
   fpdf
   python-barcode
   Pillow
   

Ejecución

Una vez instaladas las dependencias, ejecuta el archivo principal para iniciar la aplicación:

python main.py

La primera vez que se inicie, se creará automáticamente el archivo de base de datos AppControlStock.db.

Credenciales de Administrador por defecto:

• Usuario: admin
• Contraseña: admin

---

🖼️ Capturas de Pantalla

(Aquí puedes agregar capturas de pantalla de tu aplicación para hacer el repositorio más atractivo)

Login	Módulo de Stock
(Tu captura de la ventana de login)	(Tu captura de la pestaña de stock)

Punto de Venta (POS)	Dashboard
(Tu captura de la pestaña de facturación)	(Tu captura del dashboard con gráficos)