# ProyectoGlobal: Aplicaciones Multi-Funcionales

## Indice

- [Descripción del Proyecto](#descripción-del-proyecto)
- [Requisitos e Instalación](#requisitos-e-instalación)
- [Funcionalidades Implementadas](#funcionalidades-implementadas)
  - [T1. Multiprocesos](#t1-multiprocesos)
  - [T2. Multihilos (Concurrencia)](#t2-multihilos-concurrencia)
  - [T3. Sockets (Comunicación de Red Básica)](#t3-sockets-comunicación-de-red-básica)
  - [T4. Servicios en Red (Aplicaciones Avanzadas)](#t4-servicios-en-red-aplicaciones-avanzadas)

---

## Descripción del Proyecto

**ProyectoGlobal** es una aplicación de escritorio desarrollada en Python que integra diversas funcionalidades relacionadas con el **multiproceso**, la **concurrencia (multihilo)**, la **comunicación en red mediante sockets** y los **servicios de red**.

La aplicación sirve como un panel de control que permite al usuario gestionar procesos, visualizar recursos del sistema, ejecutar tareas de automatización, chatear en red local, gestionar correos electrónicos, y acceder a mini-juegos, scraping y reproducción multimedia.

---

## Requisitos e Instalación

Necesitas tener **Python 3** y **VLC** instalados en el sistema.

```bash
# Dependencia del sistema (Linux)
sudo apt install python3-tk vlc
```

### Clonar el repositorio

```bash
git clone https://github.com/BYolivia/PSP-proyecto-global.git
cd PSP-proyecto-global
```

### Crear el entorno virtual e instalar dependencias

```bash
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```

### Ejecutar la aplicación

```bash
python -m ProyectoGlobal
```

### Salir del entorno virtual

```bash
deactivate
```

> [!NOTE]
> La próxima vez que abras el proyecto solo necesitas activar el entorno (`source venv/bin/activate`) y ejecutarlo.

---

## Funcionalidades Implementadas

### T1. Multiprocesos

[Video de la demostración](https://youtu.be/37-wJIXNZAg)

| **Estado** | **Característica**                                                                                               |
|------------|------------------------------------------------------------------------------------------------------------------|
| **Done**   | Lanzamiento de **aplicaciones externas** con parámetros (ej. navegadores con URL).                               |
| **Done**   | Implementación de **Copias de seguridad** mediante la ejecución de scripts Powershell (`.ps1`).                  |
| **Done**   | Visualización de **recursos del sistema** (memoria, procesador, hilos) usando gráficas `matplotlib`.             |
| **Done**   | **Editor de texto** básico (estilo Notepad).                                                                     |
| **Done**   | Hilo concurrente para contar el **tráfico de red** (entrada/salida en KB) utilizando `psutil.net_io_counters()`. |
| **Done**   | Apertura directa de **VS Code** desde la interfaz del programa.                                                  |

### T2. Multihilos (Concurrencia)

| **Estado** | **Característica**                                                                                                    |
|------------|-----------------------------------------------------------------------------------------------------------------------|
| **Done**   | Visualización de **Fecha y Hora** del sistema.                                                                        |
| **Done**   | Obtención y visualización de la **Temperatura local**.                                                                |
| **Done**   | Sistema de **Alarma** programable (aviso visual y sonoro).                                                            |
| **Done**   | Funcionalidad de **Scraping** para extracción de datos web.                                                           |
| **Done**   | **Mini-juego** (Carrera de camellos / Buscaminas) aplicando resolución de sincronización (para evitar interbloqueos). |
| **Done**   | **Música de fondo** (reproducción de mp3 o midi) utilizando `python-vlc`.                                             |

### T3. Sockets (Comunicación de Red Básica)

| **Estado** | **Característica**                                                                                                                  |
|------------|-------------------------------------------------------------------------------------------------------------------------------------|
| **Done**   | **Chat TCP** multijugador: el servidor acepta múltiples clientes simultáneos y retransmite los mensajes a todos (broadcast interno). |
| **Done**   | **Servidor TCP** con autenticación mediante clave generada aleatoriamente (puerto + contraseña alfabética).                          |
| **Done**   | **Descubrimiento automático por UDP**: el servidor emite broadcasts UDP para que los clientes encuentren la sesión sin configuración manual. |
| **Done**   | **Gestión de streams**: recepción y envío de datos en bloques vía `recv`/`sendall` en hilos dedicados por cliente.                  |
| **Done**   | **Interfaz gráfica del chat** con selector de rol (servidor / cliente), lista de servidores descubiertos y campo de mensajes.        |

### T4. Servicios en Red (Aplicaciones Avanzadas)

| **Estado** | **Característica**                                                                                                         |
|------------|----------------------------------------------------------------------------------------------------------------------------|
| **Done**   | **Cliente de Correo IMAP** con lectura de bandeja de entrada (últimos 100 correos), soporte de flags de leído/no leído.    |
| **Done**   | **Cliente SMTP** para envío de correos, compatible con los modos **SSL**, **STARTTLS** y sin cifrado.                      |
| **Done**   | Soporte completo de **SSL/TLS** en las conexiones IMAP y SMTP.                                                             |
| **Done**   | **Persistencia de credenciales** en archivo `.env` (servidor, puertos IMAP/SMTP, usuario, contraseña y modo de seguridad). |
| **Done**   | **Interfaz estilo Gmail**: lista de correos, vista de detalle, botón de respuesta y navegación hacia atrás.                |
| **Done**   | **Servidor de radio online** con reproducción de streams mediante `python-vlc`.                                            |

---
## Enlace
[Segundo video](https://youtu.be/m9vBk6HciCM)