Skip to content

README.md

Latest commit

 

History

History
179 lines (120 loc) · 6.57 KB

README.md

File metadata and controls

179 lines (120 loc) · 6.57 KB

FarmaNaccio (Logotipo)

Python CustomTkinter

MySQL

Dependencias externas

Síntesis

Sistema informático programado en Python para utilizarse en el contexto de una farmacia.
FarmaNaccio integra gestión de usuarios, clientes, stock e inventario, y ventas, con una interfaz moderna desarrollada con CustomTkinter.

Este proyecto se ha realizado aplicando la metodología ágil "Programación Extrema" (XP) utilizando Trello.

Participantes

  • Alumnos (Programadores):

    • Matías Daniel Chiacchio
    • Luis Ariel Espinoza
    • Fabrizio Manuel Mansilla

  • Profesores:

    • Cristian Fernando Cerquand
    • Johanna Motta

Manual de Usuario

1. Inicio Rápido

  1. Inicie XAMPP:
    Antes de ejecutar el programa, abra XAMPP (o asegúrese de que el servicio MySQL esté activo).

  2. Ejecute la Aplicación:
    Ejecute principal.py desde el directorio raíz del proyecto.
    En la primera ejecución, se crean la base de datos y las tablas necesarias, y se realiza la migración del vademécum.

2. Pantalla de Login

La Pantalla de Login es la puerta de entrada a FarmaNaccio:

  • Campos de Usuario y Contraseña:
    Ingrese sus credenciales. Si se dejan campos vacíos, aparecerá una advertencia.

  • Botón "Ingresar":
    Valida las credenciales consultando la base de datos.

  • Botón de Salida ("×"):
    Ubicado en la esquina superior (ahora posicionado en la parte superior derecha conforme a los ajustes de estilo), permite cerrar la aplicación.

3. Ventana Principal

Tras un inicio de sesión exitoso se desplegará la Ventana Principal, la cual centraliza el acceso a los módulos del sistema:

  • Menú de Usuario:

    • Muestra el usuario activo.
    • Al hacer clic se despliega un menú con las opciones de agregar/administrar usuarios y cerrar sesión.
    • El módulo de administración permite filtrar entre usuarios activos/inactivos y actualizar el rol al restaurar usuarios inactivos.

  • Acceso a Módulos:
    En el área central se encuentran botones para:

    • Control de Stock
    • Gestión de Ventas
    • Gestión de Clientes

4. Gestión de Usuarios

Permite administrar los usuarios del sistema:

Agregar Usuario

  • Seleccione "(+) Agregar usuario" desde el menú.
  • Complete el formulario (Nombre de Usuario, Contraseña –con opción de mostrar/ocultar– y Rol).
  • Pulse "Guardar".
    Se valida que la contraseña tenga al menos 5 caracteres y que los campos obligatorios estén completos.

Administrar Usuarios

  • Seleccione "Administrar usuarios" para ver la lista de usuarios en una tabla.
  • Funciones adicionales:
    • Filtrado por Estado: permite cambiar entre usuarios activos e inactivos.
    • Modificar y Eliminar: Realice cambios en usuarios activos.
    • Restaurar Usuario: Desde el listado de usuarios inactivos se puede restaurar a un usuario, actualizando también el rol según lo seleccionado en el combobox.

5. Gestión de Clientes

El módulo de clientes permite gestionar los datos de sus clientes.

Registro y Consulta

  • Acceda a través del botón "Gestión de Clientes".
  • La pantalla muestra:
    • Un campo de búsqueda para filtrar clientes por Nombre, Apellido o CUIL.
    • Una tabla con clientes registrados (ID, Nombre, Apellido, CUIL, Teléfono, Email y Dirección).

Edición y Eliminación

  • Seleccione un cliente para cargar sus datos.
  • Use las opciones Modificar o Eliminar (previa confirmación) para actualizar los registros.

6. Control de Stock

Permite el control y actualización del inventario:

Consulta y Búsqueda

  • Abra la Ventana de Stock.
  • Se muestra una tabla con productos, incluyendo ID, Nombre, Precio y Stock.
  • Un campo de búsqueda permite filtrar productos.

Alta y Actualización

  • Para Agregar un producto, complete el formulario con Nombre, Precio y Stock.
  • Si el producto existe, se suma la nueva cantidad al stock actual y se actualiza el precio (con diálogo de conflicto, si es necesario).

Eliminación

  • Seleccione un producto y, tras una confirmación, elimínelo del inventario.

7. Gestión de Ventas

Este módulo abarca el proceso de venta completo, de la selección de productos a la generación de documentos.

Creación y Gestión del Carrito

  • Desde el Panel de Productos, seleccione el producto deseado y ajuste la cantidad.
  • Pulse "Agregar al Carrito" para incluirlo en la compra.
  • En el Panel del Carrito se detalla el listado de productos (ID, Producto, Precio Unitario, Cantidad y Subtotal).
  • Se ofrecen controles para modificar o eliminar productos del carrito, incluyendo la aplicación de descuentos.

Confirmación de Venta

  • Al pulsar "Confirmar Venta", el sistema valida stock y actualiza la base de datos, descontando unidades de los lotes.
  • Se genera una factura utilizando una plantilla DOCX (convertida a PDF para su descarga).
  • Opcionalmente, si se configura la generación de remito, se genera y asocia a un cliente.

Requisitos Adicionales para Facturación y Remitos

Importante:
Para la generación de facturas y remitos se requiere que el usuario tenga instalado Microsoft Word y que este se haya abierto recientemente, ya que la conversión de DOCX a PDF depende de la funcionalidad de Word.

Instalación y Ejecución

  1. Base de Datos:
    Asegúrese de que MySQL (o XAMPP) esté en funcionamiento.

  2. Inicialización:
    Ejecute principal.py desde el directorio raíz del proyecto.
    En la primera ejecución se crearán la base de datos y las tablas, y se migrarán los registros del vademécum.

  3. Inicio de Sesión:
    Inicie sesión con sus credenciales.
    Los administradores tienen acceso a funcionalidades ampliadas (gestión de usuarios).