En desarrolloDesarrollado por Gibmyx Gomez

ERP & eCommerce

Plataforma Modular Multiempresa y Tienda en Línea

Sistema ERP de nivel empresarial estructurado en módulos desacoplados por dominio de negocio (catálogo, inventario multi-almacén, compras, ventas y logística), integrado con una tienda en línea eCommerce. Construido con Laravel 12, Inertia.js 2 y React 19 sobre un entorno hermético en Docker.

Ver repositorio en GitHub eCommerce Storefront

Tecnologías clave

Laravel 12
Inertia.js 2
React 19
PostgreSQL 16
Docker
Vite
TypeScript
Tailwind CSS
PHP 8.3

Ingeniería & Diseño

Arquitectura del Sistema

Arquitectura modular por dominios de negocio (app/Modules/*) en Laravel 12 con PostgreSQL 16. La interfaz interactiva opera como SPA mediante Inertia.js 2 y React 19 sin la fricción de endpoints REST separados, todo orquestado en Docker Compose.

Diagrama de flujo & topologíaerp-ecommerce.architecture

  ┌─ FRONTEND SPA (Inertia.js 2 + React 19 + TypeScript) ──────────────────┐
  │   Experiencia fluida de SPA reactiva con validación y navegación rica  │
  └───────────────────────────────────┬────────────────────────────────────┘
                                      │ Inertia Protocol (JSON payloads)
                                      ▼
  ┌─ BACKEND LARAVEL 12 (Arquitectura Modular por Dominio) ────────────────┐
  │   app/Modules/                                                         │
  │     ├── Company/   (Tenancy multiempresa y configuración)              │
  │     ├── User/Role/ (RBAC, permisos granulares y auditoría)             │
  │     ├── Catalog/   (Productos, atributos, variantes y categorías)      │
  │     ├── Inventory/ (Multi-almacén, existencias y movimientos)          │
  │     ├── Purchase/  (Órdenes de compra, recepción y proveedores)        │
  │     ├── Sale/      (Presupuestos, pedidos y facturación)               │
  │     └── Logistics/ (Despacho, empaque y seguimiento de envíos)         │
  └───────────────────────────────────┬────────────────────────────────────┘
                                      │ Eloquent ORM + Soft Deletes
                                      ▼
  ┌─ INFRAESTRUCTURA CONTENERIZADA (Docker Compose + Makefile) ────────────┐
  │   - erp_app: PHP-FPM 8.3 + Node.js                                     │
  │   - erp_nginx: Servidor web y reverse proxy                            │
  │   - erp_postgres: PostgreSQL 16 con índices relacionales               │
  │   - vite_dev: Servidor HMR en puerto dedicado para desarrollo rápido   │
  └────────────────────────────────────────────────────────────────────────┘

Puntos clave de la arquitectura

Modularidad por dominio (DDD): Cada módulo en 'app/Modules/<Dominio>' encapsula sus modelos, controladores, migraciones y vistas, permitiendo escalabilidad limpia.
Productividad Fullstack con Inertia.js 2: Toda la potencia del backend Laravel conectada de forma directa con componentes React 19 sin duplicar lógica de API.
Soporte Multiempresa y RBAC estricto: Aislamiento por empresa en cada sesión con control de roles y permisos granulares a nivel de función.
Inmutabilidad y política de no borrado: Uso exhaustivo de soft-deletes en operaciones transaccionales para garantizar auditoría fiscal continua.
Entorno Dockerizado y Makefile: Todo el ciclo de desarrollo se orquesta con Docker Compose y Make ('make dev', 'make watch', 'make assets').

Ecosistema

Stack Tecnológico Detallado

Backend Framework

Laravel 12 + PHP 8.3

Arquitectura modular por dominios, ORM Eloquent, migraciones y seguridad.

Frontend / SPA

Inertia.js 2 + React 19 + TypeScript

SPA reactiva con tipado seguro y componentes modernos sin API REST redundante.

Base de Datos

PostgreSQL 16

Motor relacional ACID con soporte para JSONB e índices optimizados.

Contenedores & DevOps

Docker + Docker Compose + Makefile

Entorno reproducible con PHP-FPM, Nginx, Postgres y Vite.

Herramientas de Build

Vite + Tailwind CSS

Compilación de assets con recarga rápida (HMR).

Capacidades

Características Principales

Catálogo avanzado con atributos dinámicos, variantes de producto y categorías jerárquicas.

Gestión de inventario en tiempo real con trazabilidad por almacén y movimientos de stock.

Flujo integral de compras: cotizaciones a proveedores, órdenes de compra y recepción.

Ventas y pedidos: presupuestos, confirmación de ventas y facturación.

Módulo de logística: preparación de pedidos (picking/packing) y control de despachos.

Sincronización nativa con el catálogo y pedidos del repositorio de tienda online.

Decisiones de Ingeniería

¿Cómo se creó este proyecto?

Concebido como un ERP moderno y accesible para sustituir sistemas legados costosos y rígidos.

La arquitectura modular permite que una empresa habilite progresivamente únicamente los módulos que requiere, facilitando además la integración directa con eCommerce.

¿Quieres revisar el código fuente completo?

El repositorio público contiene el historial de commits, pruebas e instrucciones de ejecución.

Explorar en GitHub