# NocoDB - Base de Datos Visual

Stack de NocoDB para gestión de datos de ventas.

## Componentes

- **NocoDB** - Interfaz visual de base de datos
- **PostgreSQL** - Base de datos

## Puertos

| Servicio | Puerto |
|----------|--------|
| NocoDB | 8080 |
| PostgreSQL | 5432 (interno) |

## Despliegue

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

## Acceso

- **URL:** http://192.168.10.204:8080
- **Autenticación:** JWT Token

## Tablas

### Vendedores
Información de los vendedores del equipo.

| Campo | Tipo | Descripción |
|-------|------|-------------|
| Id | Auto | ID único |
| username | Text | Usuario de Mattermost |
| nombre_completo | Text | Nombre completo |
| email | Email | Correo electrónico |
| meta_diaria_tubos | Number | Meta diaria (default: 3) |
| activo | Checkbox | Estado activo |
| fecha_registro | DateTime | Fecha de registro |

### Ventas
Registro de todas las ventas.

| Campo | Tipo | Descripción |
|-------|------|-------------|
| Id | Auto | ID único |
| vendedor_username | Text | Usuario del vendedor |
| monto | Currency | Monto de la venta |
| cliente | Text | Nombre del cliente |
| fecha_venta | DateTime | Fecha y hora |
| estado | SingleSelect | pendiente/completada/cancelada |
| canal | Text | Canal de Mattermost |
| mensaje_id | Text | ID del mensaje |
| imagen_ticket | Attachment | Imagen del ticket |
| descripcion | LongText | Notas adicionales |

### Ventas Detalle
Productos de cada venta.

| Campo | Tipo | Descripción |
|-------|------|-------------|
| Id | Auto | ID único |
| venta_id | Number | ID de la venta |
| producto | Text | Nombre del producto |
| marca | Text | Marca del producto |
| cantidad | Number | Cantidad |
| precio_unitario | Currency | Precio por unidad |
| importe | Currency | Total del producto |

### Metas
Seguimiento de metas por vendedor.

| Campo | Tipo | Descripción |
|-------|------|-------------|
| Id | Auto | ID único |
| vendedor_username | Text | Usuario del vendedor |
| mes | Text | Mes (YYYY-MM) |
| tubos_vendidos | Number | Total de tubos vendidos |
| comision | Currency | Comisión acumulada |
| meta_diaria | Number | Meta diaria de tubos |
| porcentaje_completado | Percent | % de meta cumplida |
| total_vendido | Currency | Total vendido en el mes |

## API

### Autenticación
```bash
curl -H "xc-token: <TOKEN>" http://192.168.10.204:8080/api/v2/...
```

### Listar registros
```bash
curl -H "xc-token: <TOKEN>" \
  "http://192.168.10.204:8080/api/v2/tables/<TABLE_ID>/records"
```

### Crear registro
```bash
curl -X POST -H "xc-token: <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"campo": "valor"}' \
  "http://192.168.10.204:8080/api/v2/tables/<TABLE_ID>/records"
```

## Volúmenes

```yaml
volumes:
  - nocodb_data:/usr/app/data
  - postgres_data:/var/lib/postgresql/data
```

## Mantenimiento

### Ver logs
```bash
docker compose logs -f nocodb
```

### Backup de datos
```bash
docker compose exec postgres pg_dump -U consultoria-as nocodb > backup.sql
```

### Health Check
```bash
curl http://192.168.10.204:8080/api/v2/health
```