Conceptos Básicos del Sistema
Antes de comenzar a cargar datos en neoSystima, es importante entender cómo el sistema organiza la información y qué significan las etiquetas que encontrarás en las pantallas.
1. Convenciones Visuales
En todos nuestros manuales y formularios, utilizamos etiquetas de colores para que sepas exactamente qué tipo de dato debes ingresar y qué restricciones tiene.
- Texto Letras, números y símbolos. Generalmente tiene un límite de capacidad (Ej: Máximo 50 caracteres).
- Número Decimal Valores numéricos con decimales (ej:
1500.50). Usado en precios, pesos o porcentajes. - Número Entero Números sin decimales (ej:
2,10). Usado para cantidades o prioridades de orden. - Booleano (Sí/No) Un interruptor lógico. Solo puede tener dos valores: Activado (Sí) o Desactivado (No).
- Fecha Solo el día, mes y año (ej:
19/04/2026). - Hora Solo el tiempo en formato 24hs (ej:
14:30). - Fecha y Hora Combinación de día y hora local.
- Fecha y Hora (Z) Fecha y hora en formato internacional (UTC/Zulu). Es la estampa de tiempo exacta que usa el servidor para procesos globales.
- Obligatorio Regla estricta: El campo no puede quedar vacío bajo ninguna circunstancia.
2. La Jerarquía del Catálogo (Los 4 Niveles)
Para que tu carta digital sea clara y fácil de navegar, neoSystima organiza los productos en una estructura jerárquica de cuatro niveles. Entender esta relación es vital para una configuración exitosa:
- Secciones (Nivel 1): Es el grupo raíz (Ej: Cocina, Barra, Cafetería).
- Grupos (Nivel 2): Categorías dentro de una sección (Ej: Entradas, Platos Principales, Postres).
- Estilos (Nivel 3): Agrupadores específicos para facilitar la elección (Ej: Pizzas de 8 porciones, Ensaladas Veganas).
- Artículos (Nivel 4): El producto final que el cliente compra (Ej: Pizza Napolitana, Ensalada Caesar).
3. El Ciclo de Vida de los Datos (Estados)
Casi todas las entidades en el sistema (productos, usuarios, planes) poseen un Estado. El estado determina si el dato es visible o utilizable en tiempo real:
| Estado | Comportamiento |
|---|---|
| Activo | El registro es plenamente operativo y visible para los clientes/usuarios. |
| Inactivo | El registro está guardado pero "apagado". No se muestra en la carta ni permite operaciones. |
| Suspendido | Generalmente aplicado a usuarios o suscripciones con acceso restringido temporalmente. |
4. Ayuda Contextual y Reglas
En cada sección de este manual (ver Diccionario de Entidades), encontrarás un apartado llamado "Reglas de Uso". Estas reglas nacen directamente de la configuración del sistema para garantizar que tu información sea consistente:
- Capacidad: Te indica cuántas letras o números puedes escribir como máximo.
- Regla de Validación: Te avisa si un dato debe ser único (como un Email) o si debe tener un formato especial.
- Ejemplos: Verás bloques de "Ejemplo de uso" para que sepas qué valor se espera habitualmente en ese campo.
Si eres un perfil técnico o desarrollador, recuerda que puedes consultar la Bóveda Técnica donde encontrarás los nombres reales de los campos para integraciones vía API.