Sobre este proyecto
it-programming / e-commerce
Abierto
El Ecosistema Folk es una solución arquitectónica centralizada diseñada para la gestión comercial y administrativa de alto nivel. Se divide en dos frentes tecnológicos que operan sobre una única fuente de verdad: un backend robusto y una base de datos relacional de alta integridad.
I. Arquitectura y Entornos Digitales
El sistema se fundamenta en la separación de responsabilidades a través de dos interfaces:
1. Folk On-Line (Canal Comercial): Aplicación web optimizada exclusivamente para dispositivos móviles. Actúa como el punto de contacto para ventas y experiencia de usuario. Su acceso es híbrido: navegación pública para el catálogo, pero estrictamente autenticada mediante tokens JWT para acciones transaccionales (compras, historial, datos personales). Implementa un sistema RBAC (Control de Acceso Basado en Roles) que transforma la interfaz dinámicamente si el usuario es un Cliente Final o un Comisionista.
2. FolkManagement (Núcleo Operativo): Entorno administrativo accesible solo vía escritorio (monitores). Funciona como un ERP central donde reside la lógica crítica. Es el "cerebro" que procesa inventarios, finanzas, auditorías y métricas estratégicas.
II. Módulos Operativos y Funcionales
• Gestión de Pedidos (Eje Transaccional): Ningún pedido es automático. Al generarse en Folk On-Line, entra en estado de validación. El sistema ejecuta dos filtros: primero, el bloqueo temporal de stock para evitar sobreventa; segundo, la validación del pago (vía pasarela automática o revisión manual de comprobantes). Solo bajo estas dos condiciones (pago + stock) se aprueba desde FolkManagement, activando el descuento definitivo del inventario y el cálculo de comisiones.
• Gestión de Inventario: Control estricto por producto y variaciones (talla, color, etc.). Incluye trazabilidad completa en colones costarricenses (con IVA). El inventario se basa en existencias reales; no permite ventas sin stock. La eliminación de productos es lógica (desactivación), nunca física, para mantener el histórico de datos.
• BancaFolk (Ledger Financiero): Un libro contable interno inmutable. Cada movimiento monetario genera un número único de transacción, fecha, monto (positivo para ingresos, negativo para egresos) y comprobante digital visible en modal. Prohibición de borrado: los errores se corrigen con movimientos compensatorios (anulaciones), garantizando una auditoría permanente.
• Red de Comisionistas: Módulo para la creación de perfiles, asignación de metas mensuales fijas y monitoreo de rendimiento en tiempo real. Incluye un dashboard para el agente con su avance de metas, ventas acumuladas y acceso a un módulo documental con catálogos y materiales promocionales actualizados.
III. Capa de Seguridad y Estándares Técnicos
La seguridad no es una capa externa, sino el cimiento del código:
• Autenticación y Tránsito: Implementación de cifrado https/tls. Las contraseñas se almacenan mediante algoritmos de hash robustos (bcrypt o Argon2) con salt individual. El acceso administrativo en FolkManagement requiere Autenticación de Dos Factores (2FA).
• Integridad de Datos: Uso de claves foráneas y transacciones atómicas. Si un proceso falla (ej. Se descuenta stock pero falla la generación de factura), el sistema revierte toda la operación (rollback) para evitar estados corruptos.
• Trazabilidad y Auditoría: Registro de logs inmutable que captura: usuario, acción, fecha, hora e IP. Ningún registro financiero o de auditoría puede ser eliminado, ni siquiera por el administrador principal.
• Antifraude: Las comisiones solo se generan si se cumplen las tres condiciones: Pedido aprobado + Pago confirmado + Estado no cancelado. Ante reembolsos, el sistema revierte automáticamente los créditos generados.
IV. Infraestructura y Continuidad
• Backend y API: Estructura cliente-servidor donde la lógica crítica nunca reside en el móvil. El frontend consume una API protegida mediante tokens de expiración controlada.
• Respaldo y Recuperación (DRP): Base de datos con disponibilidad continua. Esquema de backup incremental diario y completo semanal, cifrados y almacenados en la nube con una copia adicional en una unidad física externa como resguardo secundario.
• Escalabilidad: Arquitectura modular diseñada para permitir el crecimiento horizontal y la transición a microservicios si el volumen de transacciones lo requiere, además de integración con pasarelas de pago y facturación electrónica local.
Categoría Programación y Tecnología
Subcategoría Tiendas Online (e-commerce)
¿Cuál es el alcance del proyecto? Crear una tienda nueva
Plazo de Entrega: No definido
Habilidades necesarias