# OneDrive Engine

Sistema automatizado para la renovación de Microsoft E5 usando Docker, compuesto por dos servicios principales que trabajan en conjunto.

## 📋 Descripción

Este proyecto implementa un sistema de dos contenedores Docker:

- **odengin**: Motor principal que gestiona la renovación automática de Microsoft E5
- **odcron**: Servicio de tareas programadas que se comunica con el motor principal

## 🏗️ Arquitectura

```
┌─────────────────┐         ┌─────────────────┐
│    odcron       │────────>│    odengin      │
│  (Scheduler)    │  HTTP   │    (Engine)     │
│   Port: N/A     │         │   Port: 8080    │
└─────────────────┘         └─────────────────┘
```

Los servicios se comunican a través de una red Docker privada (`odeng-net`).

## 🚀 Inicio Rápido

### Prerrequisitos

- Docker
- Docker Compose
- Credenciales de Microsoft E5:
  - Client ID
  - Client Secret
  - Refresh Token

### Instalación

1. Clona el repositorio:

```bash
git clone <tu-repositorio>
cd onedrive
```

2. Configura las variables de entorno en `docker-compose.yml`:

```yaml
E5_CLIENT_ID=tu_client_id
E5_CLIENT_SECRET=tu_client_secret
E5_REFRESH_TOKEN=tu_refresh_token
WEB_APP_PASSWORD=tu_password_segura
```

3. Inicia los servicios:

```bash
docker-compose up -d
```

4. Verifica el estado:

```bash
docker-compose ps
docker-compose logs -f
```

## ⚙️ Configuración

### Variables de Entorno

#### Servicio `odengin`

| Variable              | Descripción                     | Requerida |
| --------------------- | ------------------------------- | --------- |
| `E5_CLIENT_ID`        | Client ID de Microsoft Azure    | ✅        |
| `E5_CLIENT_SECRET`    | Client Secret de Azure          | ✅        |
| `E5_REFRESH_TOKEN`    | Token de renovación             | ✅        |
| `WEB_APP_PASSWORD`    | Contraseña de la aplicación web | ✅        |
| `E5_WEB_APP_PASSWORD` | Contraseña adicional E5         | ✅        |

#### Servicio `odcron`

| Variable        | Descripción                                  | Requerida |
| --------------- | -------------------------------------------- | --------- |
| `IP`            | Dirección del motor (formato: `host:puerto`) | ✅        |
| `PASSWORD`      | Contraseña de autenticación                  | ✅        |
| `REFRESH_TOKEN` | Token de renovación                          | ✅        |

### Puertos

- **8089**: Puerto expuesto del servicio odengin (mapea al 8080 interno)

## 📁 Estructura del Proyecto

```
onedrive/
├── docker-compose.yml      # Orquestación de servicios
├── README.md              # Este archivo
├── cron/                  # Servicio de tareas programadas
│   ├── Dockerfile
│   ├── docker-compose.yml
│   ├── requirements.txt
│   ├── script.py
│   └── README.md
└── engine/                # Motor principal
    ├── Dockerfile
    ├── docker-compose.yml
    └── README.md
```

## 🔧 Comandos Útiles

### Gestión de Contenedores

```bash
# Iniciar servicios
docker-compose up -d

# Detener servicios
docker-compose down

# Ver logs en tiempo real
docker-compose logs -f

# Ver logs de un servicio específico
docker-compose logs -f odengin
docker-compose logs -f odcron

# Reiniciar servicios
docker-compose restart

# Reconstruir imágenes
docker-compose build --no-cache
docker-compose up -d
```

### Monitoreo

```bash
# Estado de los contenedores
docker-compose ps

# Inspeccionar un contenedor
docker inspect odengin

# Acceder al shell de un contenedor
docker exec -it odengin /bin/bash
docker exec -it odcron /bin/bash
```

## 🔍 Troubleshooting

### El servicio odengin no inicia

- Verifica que las credenciales de E5 sean correctas
- Revisa los logs: `docker-compose logs odengin`
- Asegúrate de que el puerto 8089 no esté en uso

### El servicio odcron no se conecta

- Verifica que odengin esté corriendo: `docker-compose ps`
- Confirma que la variable `IP` apunte a `odengin:8080`
- Revisa la configuración de la red: `docker network inspect onedrive_odeng-net`

### Problemas de red entre contenedores

```bash
# Verificar conectividad
docker exec -it odcron ping odengin
```

## 🛡️ Seguridad

> ⚠️ **Importante**:
>
> - Nunca subas credenciales al repositorio
> - Usa variables de entorno o archivos `.env`
> - Cambia las contraseñas por defecto
> - Mantén las imágenes actualizadas

## 📝 Notas

- Los contenedores se reinician automáticamente (`restart: unless-stopped`)
- La comunicación entre servicios usa la red interna `odeng-net`