Administración

Esta sección es para quien administra la cuenta de la empresa (propietario o administrador) y para quien integra Agapanto con otros sistemas (desarrolladores, bots, impresoras). Aquí no se explica cómo vender o facturar, sino cómo decidir quién puede hacer qué, qué módulos están encendidos, cómo se paga el servicio y cómo se conecta Agapanto con el exterior.

Todo lo que se describe aquí vive en Menú → Configuración (ruta /app/config) o en páginas de cuenta fuera de la aplicación (/util/…, /account/…).

Permiso

Para casi todo necesitas ACCESO_CONFIGURACION. Gestionar el equipo pide además GESTIONAR_EQUIPO; las credenciales de integraciones, CONFIG_CREDENCIALES.

Cómo encajan las piezas

flowchart LR
    P[Plan de suscripción] -->|habilita capacidades| E[Empresa]
    E -->|feature flags| M[Módulos visibles en el menú]
    U[Usuario] -->|un rol por empresa| R[Rol con permisos]
    R --> M
    R -->|JWT| API[/API /api/v1/]
    E -->|MCPConfiguration| B[Bots e IA]
    E -->|token de cliente| I[Cliente de impresión]

Una entrada del menú aparece solo si la empresa tiene el flag del módulo y tu rol tiene el permiso. El plan decide límites (usuarios, productos, facturas) y capacidades como roles y permisos, API o impresión térmica.

Páginas de esta sección

Página	Para qué
Planes y límites	Los tres planes, la prueba gratis de 30 días, qué pasa al vencer y cómo se cobra.
Roles y permisos	Cómo funcionan los roles, la tabla completa de permisos y las siete plantillas.
Módulos y feature flags	Qué flag y qué permiso necesita cada entrada del menú, y cómo pedir que activen un módulo.
API	Autenticación por rol con JWT en /api/v1, routers disponibles y ejemplos curl.
Bots e IA	El servidor MCP: herramientas para bots de Telegram y agentes de IA, roles y seguridad.
Cliente de impresión	Instalar y conectar el programa que imprime tirillas en la impresora térmica.
Seguridad	2FA, sesiones, acceso solo desde la red del POS, invitaciones, datos personales y lo que Agapanto no hace sin tu configuración.

Permisos que intervienen

Permiso	Dónde se usa
ACCESO_CONFIGURACION	Abrir Configuración.
GESTIONAR_EQUIPO	Pestaña Equipo: invitar, editar roles, revocar.
CONFIG_CREDENCIALES	Credenciales de Wompi, DIAN y scraping. Solo la plantilla Propietario lo trae.
ACCESO_SOLO_RED_POS	Permiso restrictivo: limita al rol a la red local del punto de venta.

Siguiente: Planes y límites.