Configuración Inicial

Después de completar la instalación, necesita configurar el sistema con una cuenta de administrador, departamentos iniciales, tasas de impuesto y productos. Esta página le guía a través de los pasos esenciales de configuración inicial.

Crear el Usuario Administrador

El primer usuario debe crearse desde la línea de comandos. Ejecute el siguiente comando desde el directorio del servidor HQ:

cd apps/hq-server
cargo run -- create-admin --name "Admin" --pin 1234

Esto crea un usuario con el rol SuperAdmin, que tiene acceso sin restricciones a todas las funciones del sistema. El PIN es lo que usará para iniciar sesión en la interfaz web del Gerente HQ. Elija un PIN seguro -- se admiten de cuatro a ocho dígitos. Puede cambiarlo posteriormente desde la aplicación.

Configurar el Servidor HQ

El servidor HQ lee su configuración desde variables de entorno o un archivo .env en el directorio apps/hq-server. Las configuraciones clave a revisar son:

DATABASE_URL=postgres://pos:pos@localhost:5432/pos_hq
REDIS_URL=redis://localhost:6379
HQ_SERVER_PORT=3000
JWT_SECRET=cambie-esto-a-una-cadena-aleatoria
SYNC_LISTEN_PORT=3001

El JWT_SECRET debe ser una cadena aleatoria fuerte en producción. El SYNC_LISTEN_PORT es el puerto WebSocket al que las tiendas se conectarán para la sincronización de datos. Asegúrese de que ambos puertos sean accesibles desde la red de sus tiendas.

Iniciar Sesión en el Gerente HQ

Inicie el servidor HQ y el frontend del Gerente HQ, luego abra su navegador en http://localhost:5173/hq. Ingrese su PIN de administrador en la pantalla de inicio de sesión. Una vez autenticado, verá el panel del Gerente HQ con navegación a todas las secciones de gestión.

Configurar Departamentos

Los departamentos organizan sus productos en categorías lógicas (por ejemplo, "Abarrotes", "Lácteos", "Bebidas"). Navegue a Gerente HQ > Departamentos y cree primero sus departamentos de nivel superior. Puede anidar departamentos para crear una jerarquía -- por ejemplo, "Bebidas > Refrescos" y "Bebidas > Jugos". Cada producto debe pertenecer a exactamente un departamento, así que planifique su estructura antes de agregar productos.

Configurar Tasas de Impuesto

Navegue a Gerente HQ > Tasas de Impuesto para definir las tasas de impuesto aplicables a su negocio. Las tasas se expresan en puntos base: por ejemplo, una tasa de 825 representa 8.25%. Esto evita errores de redondeo de punto flotante en cálculos financieros. Cree todas las tasas que necesite (por ejemplo, "IVA General" a 1600, "Tasa Reducida" a 400, "Exento" a 0). Asignará estas tasas a productos individuales.

Agregar Sus Primeros Productos

Vaya a Gerente HQ > Productos y haga clic en "Agregar Producto". Cada producto requiere un SKU (identificador único), un código de barras (para búsqueda por escáner), un nombre, un precio de venta, un precio de costo, un departamento y una tasa de impuesto. Puede ingresar productos uno a uno mediante el formulario, o usar la función de importación masiva para subir un archivo CSV con su catálogo de productos. Una vez guardados, los productos se ponen en cola para sincronización a todas las tiendas conectadas.

Después de completar estos pasos, su HQ está configurado y listo. El siguiente paso es provisionar su primera tienda.