# VÖLIÁ SYSTEMS — Panel interno

Réplica funcional del panel interno de Atlas Energy adaptada a la marca **Völiá**
(dorado/negro, modo oscuro y claro), en **PHP puro + JS + HTML + CSS** (sin frameworks).

## 1. Instalación

1. Sube la carpeta `volia/` a tu hosting (Apache/Nginx + PHP 8.1+).
2. Crea la base de datos importando `sql/schema.sql`:
   ```
   mysql -u root -p < sql/schema.sql
   ```
3. Edita `config/db.php` con tus credenciales reales de MySQL.
4. Edita `config/config.php` y añade tu clave de **Mistral AI** en `MISTRAL_API_KEY`
   (o defínela como variable de entorno `MISTRAL_API_KEY`).
5. Crea el primer usuario CEO ejecutando una vez:
   ```
   php setup_ceo.php
   ```
   Esto crea `ceo@volia.com` / `Cambiar123!` — cámbialo tras el primer login.
6. Da permisos de escritura a `uploads/facturas/`.
7. Accede a `login.php`.

## 2. Qué incluye esta primera fase

- ✅ Autenticación por cuenta individual (departamento_id + rol_id, NO cuentas compartidas)
- ✅ Layout con sidebar dinámico según el departamento del empleado
- ✅ Modo oscuro / claro, persistente por usuario
- ✅ Dashboard con KPIs y gráfica (Chart.js vía CDN)
- ✅ Fichajes: inicio de jornada, pausa (descanso), fin de jornada, con cronómetro en vivo
- ✅ Agenda: tareas individuales + comunicaciones generales (por toda la empresa o por depto.)
- ✅ Contabilidad: al crear/subir una factura (emitida o recibida) se genera
  automáticamente el asiento contable en partida doble
- ✅ CEO: gestión de usuarios (crear / pausar / eliminar) y supervisión de departamentos
  (entra en la vista de cualquier departamento sin perder su sesión de CEO)
- ✅ Integración con Mistral AI lista para usar (`includes/mistral.php`, `api/asistente.php`)

## 3. Pendiente para siguientes fases (dímelo y seguimos)

- Noticias (CRUD completo), Proyectos, Pipeline, Clientes/Contactos, Repositorio, Reuniones
- Vistas específicas de cada departamento (compras, ventas, RRHH, IT, marketing,
  atención al cliente, logística...) — ahora mismo el menú ya cambia según el
  departamento pero faltan las páginas de detalle de varias de ellas
- Widget del asistente IA visible en pantalla (el backend ya está listo)
- Informe de fichajes por equipo para RRHH/CEO (horas trabajadas, exportar a Excel/PDF)
- Roles más finos (permisos por acción, no solo por departamento)

## 4. Estructura

```
volia/
├── api/                 endpoints AJAX (fichaje, tema, asistente IA)
├── assets/css/style.css estilos + variables modo oscuro/claro
├── assets/js/           theme.js, fichaje.js
├── config/               db.php, config.php
├── includes/            auth.php, menus.php, layout, contabilidad.php, mistral.php
├── modules/             cada sección (agenda, contabilidad/, usuarios, departamentos...)
├── sql/schema.sql       esquema completo de BD
├── uploads/facturas/    PDFs/imágenes de facturas subidas
├── login.php / logout.php / dashboard.php / setup_ceo.php
```