Universidad de Guayaquil

Facultad de Ciencia Matemáticas y Física

León Carrera José Manuel

Iñiga Alvarado Steven Josue
Gonzalez Solís Adrián Alexander
Sánchez Vera Nexar Allam
Ruiz Veliz Mathew Alexis

Curso: Soft_ma_3-9

Docente: Ing. Eleanor Varela Tapia, Msc.

Guayaquil, agosto de 2023

Contenido
Menú principal.............................................................................................................................4
Ventana “Ventas”.........................................................................................................................4
1. Introducción.............................................................................................................................4
2. Requisitos del Sistema..............................................................................................................4
3. Descripción de la Interfaz de Usuario.......................................................................................4
3.1. Elementos de la Interfaz....................................................................................................4
4. Funcionalidad...........................................................................................................................5
4.1. Inicialización......................................................................................................................5
4.2. Ingresar Cantidad..............................................................................................................5
4.3. Generar Factura.................................................................................................................5
4.4. Limpiar Datos....................................................................................................................5
4.5. Regresar al Menú Principal................................................................................................5
5. Ejecución y Uso........................................................................................................................5
7. Conclusión................................................................................................................................6
Manual Técnico: Clase DatosCompras..........................................................................................6
Descripción...............................................................................................................................6
Atributos..................................................................................................................................6
Constructores...........................................................................................................................7
Métodos...................................................................................................................................7
Uso...........................................................................................................................................7
Manual Técnico: Clase ArregloFacturas........................................................................................8
Descripción...............................................................................................................................8
Atributos..................................................................................................................................8
Uso...........................................................................................................................................9
Método btnIngresarActionPerformed:.......................................................................................11
Uso de Variables Importantes:...............................................................................................11
Ejecución de la Aplicación:.....................................................................................................11
Manual de Usuario: Aplicación de Ventas..................................................................................12
1. Calculadora de Ventas........................................................................................................12
2. Registrar Venta...................................................................................................................12
3. Navegación.........................................................................................................................13
4. Ingresar Detalles del Cliente...............................................................................................13
5. Limpieza de Campos...........................................................................................................13
Manual Técnico: Sistema de Gestión de Stock de Productos......................................................14
Objetivo:.................................................................................................................................14
 Componentes:........................................................................................................................14
Variables:............................................................................................................................14
Validación de Entrada:........................................................................................................14
Actualización de Stock:.......................................................................................................14
Actualización de la Interfaz:................................................................................................15
Manual de Usuario: Sistema de Gestión de Stock de Productos................................................16
Objetivo:.................................................................................................................................16
Instrucciones de Uso:.............................................................................................................16
Inicio del Programa:............................................................................................................16
Actualización de Stock:...........................................................................................................17
Gestión de Otros Productos:..................................................................................................17
Menú principal
 Abre la Ventana “Ventas”.
 Abre la Ventana “Consultar precio”.

Ventana “Ventas”
El código que has proporcionado parece ser una implementación de una interfaz gráfica
de usuario (GUI) en Java utilizando la biblioteca Swing. La interfaz permite registrar
ventas de productos y generar facturas. Aquí hay un manual técnico detallado que
describe el funcionamiento y las características de la aplicación:
Manual Técnico - Sistema de Registro de Ventas y Generación de Facturas

1. Introducción
Este manual describe la funcionalidad y el funcionamiento del sistema de registro de
ventas y generación de facturas. El sistema está diseñado para ayudar a los usuarios a
registrar ventas de productos y generar facturas de manera eficiente.

2. Requisitos del Sistema

- Java Development Kit (JDK) instalado en el sistema.
- Entorno de desarrollo compatible con Java (por ejemplo, Eclipse, NetBeans,
IntelliJ).

3. Descripción de la Interfaz de Usuario

El sistema consta de una interfaz gráfica de usuario (GUI) que permite a los
usuarios ingresar detalles de ventas y generar facturas.

3.1. Elementos de la Interfaz

- ComboBoxes (cBox, cBox1, cBox2, cBox3): Permiten al usuario
seleccionar el tipo de producto para cada venta.
- Campos de cantidad (can1, can2, can3, can4): Permiten al usuario
ingresar la cantidad de cada producto vendido.
- Botones (btnCantidad, btnRegistrar, btnLimpiar, btnFactura3):
- btnCantidad: Abre cuadros de diálogo para ingresar cantidades de
productos.
- btnRegistrar: Registra las ventas y genera una factura.
- btnLimpiar: Limpia los campos de cantidad y reinicia las cantidades a
cero.
 - btnFactura3: Regresa al menú principal.

4. Funcionalidad
4.1. Inicialización
- La clase `Ventas` es la clase principal que extiende `javax.swing.JFrame`.
- En el constructor `Ventas()`, se inicializan los elementos de la GUI, como
ComboBoxes y botones.
- Los ComboBoxes permiten al usuario seleccionar diferentes tipos de productos
para cada venta.

4.2. Ingresar Cantidad

- El botón `btnCantidad` permite al usuario ingresar la cantidad de cada producto
vendido a través de cuadros de diálogo.
- Se validan los valores ingresados y se manejan las excepciones de formato.

4.3. Generar Factura

- El botón `btnRegistrar` registra las ventas y genera una factura.
- Los detalles de la venta, incluidos los productos y las cantidades, se recopilan.
- Se crea una instancia de la clase `Factura` y se le pasan los detalles de la venta
para su visualización.

4.4. Limpiar Datos

- El botón `btnLimpiar` restablece todos los campos de cantidad a cero y vacía
los campos de texto.

4.5. Regresar al Menú Principal

- El botón `btnFactura3` permite al usuario regresar al menú principal.

5. Ejecución y Uso
1. Abra su entorno de desarrollo Java y cree un nuevo proyecto.
2. Cree una nueva clase llamada `Ventas` e inserte el código proporcionado en la
descripción en la clase.
3. Ejecute la aplicación.
4. La interfaz gráfica se abrirá, y podrá usar los ComboBoxes para seleccionar
productos, ingresar cantidades y realizar ventas.
 5. Haga clic en el botón "Generar Factura" para ver la factura generada.

6. Mejoras y Extensiones
Este sistema básico puede mejorarse y ampliarse de varias maneras, como:
- Agregar una funcionalidad de almacenamiento y recuperación de datos
para mantener un registro de ventas.
- Mejorar la validación de datos para manejar más escenarios de error.
- Proporcionar la capacidad de imprimir facturas en lugar de simplemente
mostrarlas en una nueva ventana.
- Agregar autenticación de usuario y control de acceso para garantizar la
seguridad.

7. Conclusión
El sistema de registro de ventas y generación de facturas proporciona una interfaz
intuitiva para registrar ventas y generar facturas. Este manual técnico proporciona una
descripción detallada de la interfaz y la funcionalidad del sistema, lo que permite a los
usuarios aprovechar al máximo sus características y capacidades.

Manual Técnico: Clase DatosCompras

Descripción
La clase DatosCompras es una representación de los detalles de una compra
realizada por un usuario. Contiene información sobre el usuario, la factura y los
productos comprados. Los datos almacenados en esta clase son esenciales para
realizar un seguimiento de las compras y generar informes.

Atributos
 nombres (String): Almacena el nombre del usuario que realizó la compra.
 apellidos (String): Almacena los apellidos del usuario que realizó la
compra.
 fechas (String): Almacena la fecha en que se realizó la compra.
 cedula (int): Almacena el número de cédula del usuario.
 numerodeFactura (int): Almacena el número de factura asociado a la
compra.
 valorTotal (double): Almacena el valor total de la compra.
 producto1 (String): Almacena el nombre del primer producto comprado.
  producto2 (String): Almacena el nombre del segundo producto
comprado.
 producto3 (String): Almacena el nombre del tercer producto comprado.
 producto4 (String): Almacena el nombre del cuarto producto comprado.
Constructores
 DatosCompras(): Constructor por defecto que no recibe parámetros. No
realiza ninguna operación.

 DatosCompras(nombres, apellidos, fechas, cedula, numerodeFactura,

valorTotal, producto1, producto2, producto3, producto4): Constructor
que recibe todos los atributos de la compra como parámetros y los asigna
a los correspondientes atributos de la clase.

Métodos
 getAtributos(): Devuelve una cadena formateada con todos los atributos
de la instancia de DatosCompras.

 Métodos de acceso (get y set) para todos los atributos:

 getNombres() y setNombres(String nombres)

 getApellidos() y setApellidos(String apellidos)
 getFechas() y setFechas(String fechas)
 getCedula() y setCedula(int cedula)
 getNumerodeFactura() y setNumerodeFactura(int numerodeFactura)
 getValorTotal() y setValorTotal(double valorTotal)
 getProducto1() y setProducto1(String producto1)
 getProducto2() y setProducto2(String producto2)
 getProducto3() y setProducto3(String producto3)
 getProducto4() y setProducto4(String producto4)
Uso
La clase DatosCompras puede ser utilizada para almacenar y gestionar
información sobre compras realizadas por usuarios. Puede crear instancias de
esta clase para representar diferentes compras y acceder a sus atributos y
métodos para obtener y modificar los detalles de las compras.

Ejemplo de creación de una instancia y acceso a sus atributos:

java
 Copy code
DatosCompras compra1 = new DatosCompras("Juan", "Pérez", "2023-08-15",
123456789, 1001, 150.75, "Producto A", "Producto B", "", "");
System.out.println(compra1.getNombres()); // Salida: Juan
System.out.println(compra1.getValorTotal()); // Salida: 150.75
Notas
Es importante asegurarse de que los datos proporcionados a los constructores
sean válidos y coherentes para evitar resultados inesperados.
Este manual técnico proporciona información sobre cómo utilizar la clase
DatosCompras, sus atributos y métodos. Puede ser útil como referencia al desarrollar
aplicaciones que requieran el seguimiento de las compras de los usuarios.

Manual Técnico: Clase ArregloFacturas

Descripción
La clase ArregloFacturas es una representación de un conjunto de facturas de
compras almacenadas en un arreglo dinámico. Esta clase permite agregar,
obtener y verificar el tamaño de las facturas en el arreglo. Está diseñada para
trabajar en conjunto con la clase DatosCompras, que almacena los detalles de
cada factura.

Atributos
 arreglo (ArrayList<DatosCompras>): Almacena un arreglo dinámico de
instancias de la clase DatosCompras, que representan las facturas de
compras.
 Constructor
 ArregloFacturas(): Constructor por defecto que inicializa el atributo
arreglo como un nuevo arreglo dinámico (ArrayList) de instancias de la
clase DatosCompras.
 Métodos
 adicionar(DatosCompras dc): Agrega una instancia de la clase
DatosCompras al arreglo de facturas.

 obtener(int posicion): Obtiene la instancia de la clase DatosCompras

almacenada en la posición especificada del arreglo.

 tamaño(): Devuelve el número de facturas almacenadas en el arreglo.

 Uso
La clase ArregloFacturas puede ser utilizada para almacenar y gestionar un
conjunto de facturas de compras. Puedes crear instancias de esta clase para
representar una colección de facturas y utilizar sus métodos para agregar,
obtener y verificar el tamaño de las facturas.

Ejemplo de uso:

java
Copy code
// Crear una instancia de ArregloFacturas
ArregloFacturas arregloFacturas = new ArregloFacturas();

// Crear instancias de DatosCompras y agregarlas al arreglo

DatosCompras compra1 = new DatosCompras("Juan", "Pérez", "2023-08-15",
123456789, 1001, 150.75, "Producto A", "Producto B", "", "");
DatosCompras compra2 = new DatosCompras("María", "Gómez", "2023-08-
16", 987654321, 1002, 200.50, "Producto C", "", "", "");
arregloFacturas.adicionar(compra1);
arregloFacturas.adicionar(compra2);

// Obtener una factura del arreglo

DatosCompras facturaObtenida = arregloFacturas.obtener(0);
System.out.println(facturaObtenida.getNombres()); // Salida: Juan

// Verificar el tamaño del arreglo

int tamañoArreglo = arregloFacturas.tamaño();
System.out.println(tamañoArreglo); // Salida: 2
Nota:
Es importante asegurarse de que los datos proporcionados al agregar una factura al
arreglo sean instancias válidas de la clase DatosCompras.
La clase ArregloFacturas brinda una forma eficiente de organizar y manipular un
conjunto de facturas de compras, lo que puede ser útil en aplicaciones que requieran un
seguimiento de las transacciones.
Manual Técnico: Aplicación de Ventas
Descripción General:
La aplicación de ventas es una interfaz gráfica de usuario que permite a los usuarios
ingresar detalles de productos, realizar cálculos de precios, calcular totales y registrar
ventas. La aplicación también permite ver y administrar información de ventas
anteriores.

Componentes Principales:
Interfaz Gráfica de Usuario (GUI):

La interfaz consta de varios campos de texto, etiquetas y botones que permiten al

usuario interactuar con la aplicación.
Los campos de texto se utilizan para ingresar nombres, apellidos, cédula, fechas,
detalles de productos y cantidades.
Las etiquetas proporcionan información y guían al usuario en la entrada de datos.
Los botones permiten realizar acciones como calcular, registrar ventas, regresar al menú
principal, etc.
Método btnCalcularActionPerformed:

Calcula los valores totales de productos multiplicando las cantidades por los valores
unitarios.
Calcula el subtotal y el total, aplicando un impuesto del 12%.
Actualiza los campos de texto correspondientes con los resultados calculados.
Método btnRegresarActionPerformed:

Abre la ventana de ventas y cierra la ventana actual.

Método btnMenuActionPerformed:

Abre la ventana principal y cierra la ventana actual.

Método btnComprarActionPerformed:

Registra una venta con los detalles ingresados en una estructura de datos.
Actualiza una tabla de facturas con los datos de ventas registrados.
Método btnIngresarActionPerformed:

Permite al usuario ingresar detalles como nombre, apellido, cédula y fecha.

Valida los datos ingresados y muestra mensajes de error en caso de entrada
incorrecta.
Uso de Variables Importantes:
valorP1, valorP2, valorP3, valorP4: Almacenan los valores unitarios de los
productos.
subtotal: Almacena el subtotal de la venta.
total1, total2: Almacenan los valores totales de la venta después de aplicar el
impuesto.
codNum: Número de factura o identificador de venta.
bandera1, bandera2, bandera3: Variables booleanas utilizadas para controlar
bucles y validaciones.
nombres, apellidos, cedula, dia, mes, amo: Almacenan detalles del cliente y la
fecha.
nombres1, apellidos1, cedula2, fecha: Almacenan detalles del cliente para
registrar la venta.
tabla: Modelo de tabla para mostrar datos de ventas en la interfaz.
af: Estructura de datos que almacena detalles de ventas anteriores.
Requisitos del Sistema:
Java Development Kit (JDK) instalado en el sistema.
Bibliotecas de interfaz gráfica de usuario de Java, como Swing, para la creación
de la GUI.

Ejecución de la Aplicación:
Compilar y ejecutar el código utilizando un IDE de Java o una línea de
comandos con el comando javac y java.
La aplicación se abrirá y mostrará la GUI.
El usuario puede ingresar los detalles requeridos, realizar cálculos y registrar
ventas según sea necesario.
Consideraciones Finales:
El código proporcionado se centra en la lógica de la interfaz gráfica y la
manipulación de datos de ventas. Es importante validar y manejar errores en la
entrada del usuario para garantizar la funcionalidad y la experiencia del usuario.
 Se recomienda realizar pruebas exhaustivas para asegurarse de que la aplicación
funcione como se espera en diferentes escenarios y condiciones.

Manual de Usuario: Aplicación de Ventas

Bienvenido al Manual de Usuario de la Aplicación de Ventas. Este manual le
proporcionará instrucciones sobre cómo utilizar la aplicación para realizar
cálculos de ventas, registrar ventas y administrar la información relacionada con
las transacciones. Siga los pasos a continuación para aprovechar al máximo la
funcionalidad de la aplicación.

1. Calculadora de Ventas
La sección "Calculadora de Ventas" le permite calcular los precios totales de los
productos y determinar el subtotal y el total de una venta. Siga estos pasos para
utilizar esta funcionalidad:

Ingrese los valores unitarios de los productos en los campos etiquetados como
"Valor Unitario".
Ingrese la cantidad de cada producto en los campos etiquetados como
"Cantidad".
Haga clic en el botón "Calcular" para ver los resultados.
La aplicación calculará automáticamente los precios totales de cada producto y
mostrará el subtotal de la venta. Además, se aplicará un impuesto del 12% sobre
el subtotal para calcular el total final de la venta.

2. Registrar Venta
La sección "Registrar Venta" le permite guardar los detalles de una venta
realizada. Siga estos pasos para registrar una venta:

Complete los campos de información del cliente, incluidos el nombre, apellido,

cédula y fecha de la venta.
Ingrese los detalles de los productos vendidos, como nombres y cantidades, en
los campos correspondientes.
Haga clic en el botón "Comprar" para registrar la venta.
La aplicación guardará la información de la venta y actualizará la tabla de
facturas con los detalles de todas las ventas realizadas. También se mostrará un
mensaje de confirmación después de registrar exitosamente la venta.
3. Navegación
La aplicación proporciona opciones para navegar entre las diferentes secciones:

Para regresar a la ventana de ventas, haga clic en el botón "Regresar".

Para acceder al menú principal, haga clic en el botón "Menú".
4. Ingresar Detalles del Cliente
La sección "Ingresar Detalles del Cliente" permite ingresar información personal
del cliente antes de registrar una venta. Siga estos pasos:

Ingrese el nombre y el apellido del cliente en los campos correspondientes.

Ingrese la cédula del cliente en el campo etiquetado como "Cédula".
Ingrese la fecha de la venta en los campos etiquetados como "Día", "Mes" y
"Año".
La aplicación valida automáticamente los datos ingresados y muestra mensajes
de error en caso de entrada incorrecta.

5. Limpieza de Campos
Para una nueva venta, puede limpiar los campos para ingresar detalles utilizando
el botón "Limpiar Campos". Esto borrará todos los valores ingresados
previamente y le permitirá comenzar con una nueva entrada.

Notas Adicionales:
Los valores calculados y los datos ingresados se muestran en los campos de
texto correspondientes.
Asegúrese de ingresar datos válidos y completos para garantizar la precisión de
los cálculos y el registro de ventas.
¡Felicidades! Ahora está listo para usar la Aplicación de Ventas y aprovechar
todas sus características. Si necesita asistencia adicional o tiene alguna pregunta,
no dude en buscar ayuda en la sección de soporte o ponerse en contacto con el
equipo de desarrollo. ¡Disfrute de su experiencia de ventas con la aplicación!
Manual Técnico: Sistema de Gestión de Stock de Productos

Objetivo:
Este programa tiene como objetivo gestionar la cantidad de productos en stock y
mostrar información sobre los productos disponibles.

Componentes:

Variables:

int product1, int product2, int product3, int product4: Variables para
almacenar el número de producto seleccionado.
boolean bandera, boolean bandera2, boolean bandera3: Variables
booleanas para controlar bucles y validaciones.
int cantidades1, int cantidades2, int cantidades3, int cantidades4:
Variables para almacenar la cantidad de productos seleccionados.
Entrada y Selección de Producto:

Se muestra un cuadro de diálogo de entrada utilizando JOptionPane para

que el usuario seleccione un producto numéricamente.
Según la opción seleccionada por el usuario (product1), se muestra
información sobre el producto y se solicita la cantidad deseada utilizando
otro cuadro de diálogo.
Validación de Entrada:

Se utiliza un bucle do-while para asegurarse de que el usuario ingrese

una cantidad válida (entero).
Si el usuario ingresa un dato incorrecto, se muestra un cuadro de diálogo
de error y la variable bandera se establece en true para que el bucle
continue.
La cantidad ingresada se almacena en la variable can1.
Actualización de Stock:

Dependiendo del producto seleccionado y la cantidad ingresada, el stock

del producto se reduce.
Si la cantidad ingresada es mayor que el stock disponible, se muestra un
mensaje de error y la cantidad se establece en 0.
 Actualización de la Interfaz:

La información sobre el producto seleccionado y el stock actualizado se

muestra en un área de texto (tblDatos) y en un campo de texto
(cantidad1).
Casos por Producto:

Cada caso del switch maneja un producto específico (nevera, lavadora,

celular, etc.).
Se actualiza la información según el producto seleccionado y se realiza la
validación de la cantidad ingresada.
Caso por defecto:

Si el usuario ingresa un número que no corresponde a un producto válido,

se muestra un cuadro de diálogo de error.

Notas:

El código está escrito en lenguaje Java y utiliza componentes de GUI de

JOptionPane para interactuar con el usuario.
Se asume que existen variables y constantes definidas anteriormente en el
código, como nevera, productoA, stockNevera, etc.
El código se repite para diferentes productos, lo que puede llevar a redundancias
y dificultar el mantenimiento.
Para mejorar la estructura y el mantenimiento del código, se podrían considerar
funciones y estructuras de datos más adecuadas.
Recuerda que este manual técnico es una interpretación basada en el fragmento
de código proporcionado. Si necesitas más información o tienes preguntas
específicas, no dudes en preguntar.
Manual de Usuario: Sistema de Gestión de Stock de Productos

Objetivo:
El Sistema de Gestión de Stock de Productos es una herramienta diseñada para
ayudarte a gestionar la cantidad de productos en stock y proporcionar
información sobre los productos disponibles. Te permitirá seleccionar un
producto, ingresar la cantidad deseada y ver detalles sobre el producto y su stock
actualizado.

Instrucciones de Uso:

Inicio del Programa:

Ejecuta el programa para iniciar la aplicación de gestión de stock de

productos.
Selección de Producto:

Se mostrará una ventana de diálogo con una lista de productos

numerados del 1 al 8.
Ingresa el número correspondiente al producto que deseas gestionar y haz
clic en "Aceptar".
Información del Producto:

Una vez que hayas seleccionado un producto, se mostrará información

sobre el mismo, incluido su nombre y precio unitario.
Ingreso de Cantidad:

Se te pedirá ingresar la cantidad deseada de ese producto.

Asegúrate de ingresar un número entero válido y luego haz clic en
"Aceptar".
Validación de Cantidad:

Si ingresas una cantidad no válida (por ejemplo, letras o números

decimales), aparecerá un mensaje de error.
Corrige la cantidad ingresada siguiendo las instrucciones y haz clic en
"Aceptar".
Actualización de Stock:

El sistema verificará si la cantidad ingresada está disponible en el stock

actual.
Si la cantidad es mayor que el stock disponible, se mostrará un mensaje
de error y la cantidad se establecerá en cero.
Visualización del Stock Actualizado:

Después de completar la gestión del producto, se mostrará el stock

actualizado del mismo en un área de texto.
Además, la cantidad ingresada se mostrará en un campo de texto
correspondiente al producto.
Gestión de Otros Productos:

Puedes repetir el proceso de selección de producto, ingreso de cantidad y gestión

de stock para otros productos.
Casos no Válidos:

Si ingresas un número que no corresponde a un producto válido, aparecerá un

mensaje de error. Verifica el número ingresado e intenta nuevamente.
Notas Importantes:

Este programa está desarrollado en el lenguaje de programación Java y utiliza

cuadros de diálogo de JOptionPane para interactuar contigo.
Se asume que el programa tiene acceso a variables y constantes definidas
previamente, como nevera, productoA, stockNevera, etc.
Cada producto tiene su propio caso en el programa, lo que puede resultar en
código repetitivo. En futuras versiones, se podría considerar una estructura más
eficiente.
Si tienes preguntas o necesitas ayuda adicional, no dudes en contactar al soporte
técnico.