Instrucciones de uso para Tiendicount

1. Introducción a Tiendicount

Bienvenido a Tiendicount, la solución intuitiva y potente diseñada para simplificar la gestión de tu tienda. Tiendicount es una aplicación de escritorio desarrollada con Python y PyQt6, que te permite llevar un control preciso de tu inventario, ventas, proveedores y usuarios, todo desde una interfaz gráfica amigable.

Este instructivo te guiará paso a paso a través de las funcionalidades clave de Tiendicount, desde la configuración inicial hasta el uso avanzado de sus herramientas. ¡Prepárate para optimizar la operación de tu negocio!

2. Primeros Pasos

2.1. Ejecución de la Aplicación

Tiendicount es una aplicación de escritorio. Para iniciarla, debes ejecutar el script principal de Python (main_app.py) en tu entorno local.

Requisitos del sistema: Python 3.x instalado, las bibliotecas PyQt6, Pillow (PIL), requests, reportlab y pyperclip (aunque la copia al portapapeles usa `QApplication.clipboard` directamente en el código proporcionado, `pyperclip` es una alternativa común para sistemas que no son PyQt).

Asegúrate de tener todos los archivos del programa (main_app.py, auth.py, inventario.py, exportar.py, utilidades.py, dialogs.py, basededatos.py) en el mismo directorio.

2.2. Creación de Cuenta y Primer Inicio de Sesión

Al iniciar la aplicación por primera vez, serás dirigido a la pantalla de inicio de sesión. Si no tienes una cuenta, puedes crear una:

Pantalla de Inicio de Sesión de Tiendicount

Haz clic en "¿Deseas crear una cuenta?".
Podrás proporcionar opcionalmente un número de teléfono, correo electrónico y una URL o ruta local para tu imagen de perfil.
Haz clic en "Generar y Crear Cuenta". La aplicación generará automáticamente un nombre de usuario y una contraseña segura para ti.
Guarda estas credenciales inmediatamente. La aplicación te las mostrará y te permitirá copiarlas al portapapeles. Una vez que cierres esta ventana, no podrás recuperarlas.
Usa las credenciales generadas para iniciar sesión.

2.3. Configuración de la Base de Datos

La aplicación utiliza una base de datos SQLite (TiendiCount.db) que se crea y se inicializa automáticamente con las tablas necesarias (usuarios, productos, proveedores, ventas) la primera vez que ejecutas la aplicación. No se requiere configuración manual de la base de datos.

3. Funcionalidades Principales

3.1. Gestión de Inventario

Mantén un control exhaustivo de tus productos.

Añadir Productos: Ingresa nombre, marca (opcional), URL o ruta local de imagen (opcional), cantidad, peso (opcional), unidad de peso (opcional) y precio unitario.
Editar Productos: Modifica los detalles de un producto existente.
Eliminar Productos: Borra productos de tu inventario.
Alertas de Stock Bajo: Los productos con cantidad baja se resaltarán visualmente en la tabla.
Visualizador de Imagen: Haz clic en la celda de "Imagen URL" para ver la imagen del producto en un visor con zoom.

Botones de Acción en Gestión de Inventario

3.2. Gestión de Proveedores

Administra la información de tus proveedores.

Añadir Proveedores: Registra el nombre, dirección web (opcional), dirección física (opcional), teléfono (opcional) y correo electrónico (opcional) de tus proveedores.
Editar Proveedores: Actualiza los datos de un proveedor.
Eliminar Proveedores: Remueve proveedores de tu lista.

3.3. Gestión de Ventas

Registra y gestiona las ventas de tus productos.

Registrar Nueva Venta: Selecciona un producto y la cantidad vendida. El precio total se calcula automáticamente. El stock del producto se actualiza al registrar la venta.
Editar Venta: Modifica los detalles de una venta existente, ajustando el stock de los productos involucrados.
Eliminar Venta: Borra una venta, y el stock del producto vendido se revertirá automáticamente.
Integración con Inventario: El stock de los productos se ajusta automáticamente con cada venta y devolución/eliminación de venta.

3.4. Configuración de Cuenta de Usuario

Gestiona tu perfil de usuario dentro de la aplicación.

Actualizar Datos: Cambia tu nombre de usuario, contraseña, teléfono, correo electrónico e imagen de perfil.
Cerrar Sesión: Vuelve a la pantalla de inicio de sesión.

3.5. Reportes y Exportación de Datos

Obtén una visión clara del rendimiento de tu negocio y exporta tus datos.

Exportar Inventario: Exporta tu lista de productos a formatos CSV, JSON, PDF o como una imagen PNG de la tabla.
Exportar Ventas: Exporta tu historial de ventas a formatos CSV, JSON, PDF o como una imagen PNG de la tabla.

3.6. Búsqueda Global y Temas

La aplicación incluye funcionalidades adicionales para mejorar tu experiencia:

Búsqueda Global: Utiliza la barra de búsqueda en la parte superior para filtrar productos, proveedores o ventas según la pestaña activa.
Temas: Cambia entre un tema oscuro y un tema claro desde el menú superior "Tema" para personalizar la apariencia de la aplicación.

4. Preguntas Frecuentes (FAQ)

¿Necesito conexión a internet para usar Tiendicount?

No, Tiendicount es una aplicación de escritorio y funciona de forma local en tu computadora. Solo necesitarás internet si utilizas URLs para las imágenes de productos o perfil.

¿Qué hago si olvido mi contraseña?

Actualmente, la aplicación no tiene una función de recuperación de contraseña. Es crucial que guardes las credenciales generadas al crear tu cuenta. Si las olvidas, deberás crear una nueva cuenta.

¿Cómo actualizo la aplicación?

Para actualizar Tiendicount, deberás reemplazar los archivos de tu versión actual con los nuevos archivos del programa que recibas.