# Analítica Núcleo Data Studio

Panel de administración y monitoreo empresarial para Núcleo Río Frío, construido con Nuxt 4, Vue 3 y Nuxt UI.

## Características Principales

- 🎨 **Sistema de Temas Personalizable** - Personaliza todos los colores de la interfaz
- 🔐 **Autenticación con Authentik** - SSO seguro con Authentik Proxy Outpost
- 📊 **Dashboards Interactivos** - Visualizaciones de datos con filtros dinámicos
- 🌙 **Dark Mode Optimizado** - Tema oscuro pensado para uso prolongado
- 🚀 **Performance** - Construido con Nuxt 4 y Vue 3 Composition API
- 📱 **Responsive** - Optimizado para desktop, tablet y móvil

## Sistema de Temas

Analítica Núcleo cuenta con un **sistema de temas completamente personalizable** que permite ajustar los colores de la interfaz según tus preferencias.

### Para Usuarios

- Accede a **Configuración** (`/settings`) para personalizar el tema
- Elige entre 4 temas predefinidos: Café, Azul, Verde, Carbón
- O personaliza cada color individualmente con el selector visual
- Exporta/importa temas para compartir o hacer backup

📖 **Documentación completa:** [THEME_CUSTOMIZATION.md](./docs/THEME_CUSTOMIZATION.md)

### Para Desarrolladores

- Usa siempre variables CSS (`--brand-*`) en lugar de colores hardcoded
- Aprovecha las clases utilitarias (`.brand-card`, `.brand-shell`, etc.)
- Utiliza el composable `useTheme()` para manipular temas programáticamente

📖 **Guía de desarrollo:** [DEVELOPER_GUIDE.md](./docs/DEVELOPER_GUIDE.md)

Look at the [Nuxt documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.

## Setup

Make sure to install dependencies:

```bash
# npm
npm install

# pnpm
pnpm install

# yarn
yarn install

# bun
bun install
```

## Development Server

Start the development server on `http://localhost:3000`:

```bash
# npm
npm run dev

# pnpm
pnpm dev

# yarn
yarn dev

# bun
bun run dev
```

## Production

Build the application for production:

```bash
# npm
npm run build

# pnpm
pnpm build

# yarn
yarn build

# bun
bun run build
```

Locally preview production build:

```bash
# npm
npm run preview

# pnpm
pnpm preview

# yarn
yarn preview

# bun
bun run preview
```

Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.