Sistema Integral de Gestión de Clientes, Servicios y Reservas

Descripción

Proyecto académico desarrollado como parte del curso de Programación, que implementa un sistema integral orientado a objetos para la empresa Software FJ. La aplicación permite gestionar clientes, servicios (reserva de salas, alquiler de equipos y asesorías especializadas) y reservas, aplicando principios de abstracción, encapsulación, herencia, polimorfismo y manejo avanzado de excepciones. El sistema opera completamente en memoria, sin uso de bases de datos, y registra eventos y errores en un archivo de logs.

Colaboradores

Nombre	Rol en el proyecto
Andrés Felipe Maya Ortega	Clase abstracta raíz y gestión de clientes
Jaider Leonel Pantoja Goyes	Sistema de logs y simulación
Johan Steven Perez Molano	Clase Reserva y ciclo de vida
Sebastián Victoria González	Módulo de cálculo de costos

Estructura del proyecto

El proyecto fue estructurado de manera modular, respetando las buenas practicas de programacion, esto con el fin de desarrollar, revisar y mantener cada modulo de manera separada, y siendo importados por cada modulo que lo requiera. La estructura de archivos y carpetas es la siguiente:

software_fj/
├── app/                    
│   ├── __init__.py
│   ├── entidades_base.py
│   ├── servicios.py
│   ├── calculos.py
│   ├── reservas.py
│   ├── logs.py
│   └── interfaz.py
├── logs/
├── main.py
└── README.md

Instrucciones de ejecución

1. Clonar o descargar el repositorio

git clone https://github.com/UNAD-G231-Programacion/fase-04-compractico-app.git

También puede descargar el proyecto como archivo ZIP y descomprimirlo.

2. Abrir la terminal en la carpeta del proyecto

En Windows:

• Método 1: Presionar las teclas Windows + R, escribir cmd y pulsar Enter.
• Método 2: Abrir el menú Inicio, escribe Símbolo del sistema y ábrelo.

Navega hasta la carpeta software_fj arrastrándola desde el explorador hasta la ventana de la terminal, o usando el comando cd seguido de la ruta:

cd C:\Users\TuUsuario\Desktop\software_fj

Tambien es posible ejecutarlo haciendo uso del boton Ejecutar desde el editor de codigo, como VS Code.

3. Ejecutar la aplicación

python main.py

IMPORTANTE: main.py es el archivo que se debe ejecutar para iniciar el programa. Es el punto de entrada de la aplicacion que conecta la interfaz con cada uno de los modulos.

4. Usar el sistema

La interfaz gráfica se abrirá con pestañas para:

• Clientes: registrar y buscar clientes.
• Servicios: agregar servicios de salas, equipos o asesorías.
• Reservas: crear reservas y gestionar su ciclo de vida (confirmar, procesar, cancelar).
• Simulación: ejecutar una prueba integral de 10 operaciones válidas e inválidas.
• Logs: visualizar los eventos del sistema en tiempo real, recargar desde archivo, limpiar ventana y exportar.

Todos los eventos y errores quedan registrados automáticamente en logs/sistema.log.

Proyecto Colaborativo - Curso Programacion UNAD 2026