consultoria-as
5d9cbd4812
- Stack completo con Mattermost, NocoDB y Sales Bot - Procesamiento OCR de tickets con Tesseract - Sistema de comisiones por tubos de tinte - Comandos slash /metas y /ranking - Documentación completa del proyecto Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
3.0 KiB
3.0 KiB
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
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 |
| 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
curl -H "xc-token: <TOKEN>" http://192.168.10.204:8080/api/v2/...
Listar registros
curl -H "xc-token: <TOKEN>" \
"http://192.168.10.204:8080/api/v2/tables/<TABLE_ID>/records"
Crear registro
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
volumes:
- nocodb_data:/usr/app/data
- postgres_data:/var/lib/postgresql/data
Mantenimiento
Ver logs
docker compose logs -f nocodb
Backup de datos
docker compose exec postgres pg_dump -U consultoria-as nocodb > backup.sql
Health Check
curl http://192.168.10.204:8080/api/v2/health