Ferred es una aplicación de punto de venta (POS) diseñada para ferreterías con múltiples sucursales. Opera completamente sin internet usando SQLite local por sucursal, y sincroniza automáticamente con Supabase (PostgreSQL) cuando detecta conexión. Incluye facturación electrónica DTE conforme al Ministerio de Hacienda de El Salvador.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Carlos-Gnd/FERRED-Inventario-y-Ventas/llms.txt
Use this file to discover all available pages before exploring further.
Inicio rápido
Accede al sistema y realiza tu primera venta en minutos.
Arquitectura
Entiende el diseño hexagonal offline-first y la sincronización con Supabase.
Módulos del sistema
POS, inventario, DTE, proveedores y reportes — todo en un solo lugar.
API Reference
Documentación completa de todos los endpoints REST del backend.
Funcionalidades principales
POS sin internet
Opera 100% offline con SQLite local. Las ventas se registran aunque no haya conexión.
Inventario multisucursal
Control de stock separado por sucursal con alertas de nivel crítico y transferencias entre tiendas.
Facturación DTE
Emisión de facturas electrónicas tipo 01 conformes al Ministerio de Hacienda de El Salvador.
Sincronización automática
Al recuperar conexión, los cambios offline se sincronizan automáticamente con Supabase.
Roles y permisos
Tres roles diferenciados: Administrador, Cajero y Bodeguero, con accesos específicos.
Aplicación de escritorio
Empaquetado con ElectronJS para operar como app nativa en Windows, macOS y Linux.
Primeros pasos
Accede al sistema
Entra a ferred.netlify.app o abre la aplicación de escritorio. Inicia sesión con tu correo y contraseña según tu rol asignado.
Configura tus productos
El Administrador crea el catálogo de productos con precios, categorías y stock inicial. Los productos están disponibles inmediatamente en el POS.
Registra ventas en el POS
El Cajero agrega productos al carrito, selecciona el tipo de pago y confirma la venta. El sistema descuenta el stock y genera el DTE automáticamente.
Roles de acceso
| Rol | Acceso |
|---|---|
| Administrador | Acceso total: usuarios, productos, inventario, reportes, transferencias |
| Cajero | Registro de ventas, consulta de stock, reimpresión de tickets |
| Bodeguero | Gestión de inventario, recepción de mercancía, ajuste de stock |
El sistema funciona offline en todas sus operaciones principales. Al recuperar la conexión a internet, los cambios se sincronizan automáticamente con la nube sin intervención del usuario.