Sistema Integral de Gestión de Producción y Comercialización¶
Figura 1. Flujo funcional: los 6 módulos del ERP interno, con el Portal Web como entrada única
flowchart TB
Compras["1. COMPRAS<br/>proveedores, cotizaciones,<br/>órdenes de compra"]
Inventario["2. INVENTARIO<br/>recepción (pesaje, calidad, lotes),<br/>almacenes y existencias,<br/>despacho (picking, entrega)"]
Produccion["3. PRODUCCIÓN<br/>fórmulas, órdenes,<br/>consumo, rendimiento"]
Ventas["4. VENTAS<br/>clientes, cotizaciones,<br/>pedidos, precios"]
Cliente(["CLIENTE"])
Portal(["PORTAL WEB<br/>· anónimo: catálogo + contacto<br/>· con sesión: login + menú por rol"])
Compras -->|"orden de compra<br/>(recepción)"| Inventario
Inventario --> Produccion
Produccion -->|"productos terminados,<br/>subproductos, mermas"| Inventario
Inventario -->|"disponibilidad"| Ventas
Ventas -->|"pedido aprobado<br/>(despacho)"| Inventario
Inventario --> Cliente
Portal -->|"solicitud de<br/>contacto/pedido"| Ventas
Finanzas["5. FINANZAS<br/>cuentas por pagar (Compras),<br/>cuentas por cobrar (Ventas), caja"]
Administracion["6. ADMINISTRACIÓN<br/>usuarios, roles, permisos,<br/>catálogos compartidos, auditoría"]
Compras -->|"cuenta por pagar"| Finanzas
Ventas -->|"cuenta por cobrar"| Finanzas
Esta figura es el flujo funcional: qué módulos existen y en qué orden pasa la operación de negocio, sin entrar en cómo se despliega técnicamente cada uno (eso son las Figuras 2 y 3, más abajo — contexto, actores, procesos, base de datos, sistemas externos). Por eso todas las flechas se dibujan igual aquí: la diferencia entre "mismo proceso" y "HTTP a otro despliegue" no es información de negocio, es arquitectura.
Inventario concentra tres operaciones sobre el mismo almacén — recepción (lo que entra desde Compras), existencias (almacenes, ubicaciones, lotes, entradas/salidas) y despacho (lo que sale hacia el Cliente por un pedido de Ventas) — en vez de ser tres módulos separados. Es el mismo criterio que usa Odoo, el ERP de código abierto más usado: purchase y sale son apps separadas porque negocian con dos contrapartes distintas (proveedor y cliente), pero recibir y despachar son dos tipos de operación (stock.picking) dentro de una sola app, stock — no apps aparte, porque ambas son la misma naturaleza de trabajo: mover físicamente el almacén.
Administración no aparece conectada a ningún módulo en este diagrama porque no participa del flujo secuencial: sostiene a los demás de forma transversal (roles, catálogos, parametrización — ver su descripción más abajo), no en un punto fijo de la cadena.
Trazabilidad, Costos, Calidad y Reportes no son módulos ni despliegues — son capacidades que se apoyan en los datos de los seis módulos de arriba, por eso no tienen caja propia en el diagrama (se describen en "Calidad, costos, trazabilidad y reportes", más abajo).
El Portal Web tampoco es un módulo del ERP: vive fuera de la red interna, en su propio despliegue (ver "Arquitectura", más abajo). Se incluye en el diagrama porque es la puerta de entrada de todo lo demás. Ningún usuario entra directo al ERP: todos —visitante anónimo, comprador, personal de almacén, operario de planta, vendedor, cajero— pasan primero por el Portal. Lo que cambia es qué ve cada uno adentro: el visitante anónimo, catálogo y contacto; el usuario con sesión iniciada, el menú de los módulos que su rol le permite (definidos en Administración).
Qué hace cada módulo¶
El sistema se organiza en seis módulos internos, cada uno con responsabilidades y límites explícitos — ningún módulo asume una función que le corresponde a otro, aunque el flujo de negocio los recorra en secuencia (Figura 1) —, más un componente adicional que mira hacia afuera: el Portal Web.
1. Compras. Gestiona proveedores, solicitudes de cotización, cotizaciones, órdenes de compra, precios, cantidades y condiciones de compra de materias primas, insumos de producción, materiales de empaque y demás artículos que la empresa necesita. Su alcance termina en la emisión y el seguimiento de la orden de compra — la recepción física es responsabilidad de Inventario, nunca de este módulo: Compras decide qué y cuánto comprar, no si lo que llegó cumple. Proveedor es un rol sobre Persona (natural o jurídica, dato que vive en Administración) — Compras no guarda su propia ficha de identidad ni de contacto.
2. Inventario. Ejecuta los movimientos físicos de existencias — materias primas, insumos, materiales de empaque, productos en proceso, productos terminados, subproductos y materiales auxiliares —, con tres operaciones sobre el mismo almacén:
- Recepción: registra la llegada física de lo que
Comprasordenó — relación con la orden de compra, proveedor, procedencia, fecha y condiciones de llegada. Para materias primas como el maíz, además del pesaje (bruto, tara, neto) aplica los controles de calidad que la empresa defina (humedad, impurezas, entre otros). Decide aceptar, observar, rechazar o devolver al proveedor — solo lo aceptado genera lote y entra a existencias. - Existencias: almacenes, ubicaciones, lotes, entradas, salidas, transferencias, ajustes y bajas. No decide nada por sí mismo (ver aclaraciones, más abajo): solo refleja el movimiento que cada operación le informa, y responde con exactitud cuánto hay disponible cuando se le pregunta.
- Despacho: convierte el pedido aprobado por
Ventasen una entrega física — picking, selección de lotes, carga, transportista, vehículo, ruta y confirmación de entrega. También es el punto de entrada de las devoluciones del cliente — decide si el producto devuelto reingresa, queda observado, se reprocesa o se da de baja.
3. Producción. Transforma lo que Inventario tiene disponible en purina y otros derivados, siguiendo fórmulas o recetas. Administra órdenes de producción, cantidades planificadas frente a reales, el lote de materia prima consumido, y lo que resulta de ejecutar la orden: productos terminados, subproductos, mermas, desperdicios y reprocesos. Es también la fuente de la información necesaria para calcular el costo de producción — sin Producción, Costos no tiene de dónde partir.
4. Ventas. Gestiona clientes, cotizaciones, pedidos, listas de precios, descuentos y condiciones comerciales, tanto mayoristas como minoristas. Antes de comprometer un pedido, consulta a Inventario la disponibilidad real — nunca vende sobre una cifra que no verificó — y entrega el pedido aprobado a Inventario para su despacho. Igual que Proveedor en Compras, Cliente es un rol sobre Persona — la misma persona podría ser cliente de un almacén y, a la vez, proveedor de otro insumo, sin duplicar su documento de identidad en dos módulos.
5. Finanzas. Traduce a términos económicos lo que Compras y Ventas generan: cuentas por pagar (de las compras), cuentas por cobrar (de las ventas), facturación, pagos, anticipos, cobranzas y caja. Es, junto a Producción, el módulo con un agregado real que proteger (ver más abajo): el saldo de cada cuenta, con la garantía de que nunca se le aplica más pago o cobranza del que le corresponde.
6. Administración. No participa en el flujo de negocio (Figura 1) — lo sostiene desde abajo:
- Institucional (configuración de la empresa) — equivalente al dominio 1 del ejemplo académico: datos de la empresa, sucursales, almacenes y tiendas — la jerarquía física del negocio que los demás módulos referencian (
Inventarioregistra un movimiento en un almacén ya configurado aquí;Ventasasocia un pedido a una tienda o sucursal), pero queAdministraciónes quien crea y mantiene (detalle en "Configuración de la empresa", más abajo). - Personas — equivalente al dominio 2 del ejemplo académico: registro único de persona natural o jurídica — documento de identidad o RUC, nombres o razón social, teléfonos, direcciones, correos —, del que
Proveedor(enCompras),Cliente(enVentas) y elUsuarioque inicia sesión son roles que una misma persona puede tener, no tres fichas independientes. Evita duplicar el mismo documento de identidad en tres módulos, y resuelve en un solo lugar el caso real de que un cliente frecuente sea también la persona de contacto de un proveedor. - Plataforma transversal — seguridad, roles, permisos, SSO, auditoría, parametrización, APIs: usuarios, roles, permisos, y el menú de módulos que cada rol ve en el
Portal Web— el rol vive aquí, el menú del Portal solo lo refleja. Aquí es donde se traza la línea con Keycloak, si se integra: Keycloak resuelve la autenticación (confirmar que el usuario es quien dice ser, con su login y contraseña, y emitir un token) — es un producto genérico, no sabe qué esComprasniVentas.Administraciónresuelve la autorización de negocio: qué rol tiene ese usuario ya autenticado y qué módulos le da ese rol — una regla específica de este sistema que ningún Identity Provider conoce por sí solo. Delegar la autenticación a Keycloak no vacía aAdministración: solo deja de guardar la contraseña, sigue siendo dueña del rol y de a qué da acceso. De ahí también vienen los catálogos compartidos (unidades de medida, categorías, presentaciones, motivos de devolución o de merma) y el registro de auditoría de lo que los usuarios hacen en el resto de módulos.
Portal Web. Es la única puerta de entrada — nadie accede a los otros seis módulos por otra vía. Para un visitante anónimo, es un sitio de promoción: catálogo de productos (ficha, descripción, imágenes) y un formulario de contacto para pedir información o un pedido. Cada envío llega a Ventas como una solicitud de contacto, que un vendedor revisa y decide si convierte en cotización o pedido real — no vende en línea, no hay carrito, checkout ni pago todavía. Para un usuario con sesión iniciada (comprador, personal de almacén, operario de planta, vendedor, cajero), el Portal muestra un menú con los módulos a los que su rol le da acceso — el mismo rol que administra Administración — y ahí adentro navega el módulo correspondiente (Compras, Inventario, Producción, etc.). La empresa ya anticipó una v2 con ventas en línea (carrito, pago); esta v1 se construye de manera que esa evolución no obligue a rehacerlo (ver "Arquitectura", más abajo).
Tipos de artículos¶
El sistema distingue explícitamente entre lo que fluye por cada etapa, porque el mismo artículo cambia de naturaleza según en qué módulo está:
Tabla 1. Tipos de artículo gestionados por el sistema
| Tipo | Ejemplos | Dónde nace / dónde se consume |
|---|---|---|
| Materia prima | Maíz y otras materias primas de producción | Nace en Inventario (recepción), se consume en Producción |
| Insumo de producción | Vitaminas, minerales, aditivos y otros componentes | Nace en Inventario (recepción)/Compras, se consume en Producción |
| Material de empaque | Sacos, bolsas, envases, etiquetas | Nace en Inventario (recepción)/Compras, se consume en Producción |
| Producto en proceso | Intermedio de una orden de producción todavía no cerrada | Nace y se consume dentro de Producción |
| Producto terminado | Purina y otros derivados | Nace en Producción, se consume en Ventas/Inventario (despacho) |
| Subproducto | Resultado secundario de la transformación | Nace en Producción |
| Material auxiliar o consumible | Insumo de soporte que no forma parte del producto final | Se consume donde la operación lo requiera |
Configuración de la empresa¶
Antes de que cualquier módulo registre un movimiento, Administración necesita tener configurada la jerarquía física del negocio — de dónde sale cada almacén y cada tienda:
Tabla 2. Jerarquía de configuración de la empresa
| Nivel | Qué es | Ejemplo |
|---|---|---|
| Empresa | La organización dueña del sistema | "Molinos XYZ S.A.C." |
| Sucursal | Una ubicación física de negocio de la empresa | Planta de producción, oficina administrativa |
| Almacén | Espacio físico de existencias dentro de una sucursal — lo que Inventario referencia en cada movimiento |
Almacén de materia prima, almacén de producto terminado |
| Tienda | Punto de venta al público dentro de una sucursal, para la venta minorista presencial | Tienda de fábrica |
Hoy el sistema opera para una sola empresa (mono-tenant): una fila en Empresa, con sus sucursales, almacenes y tiendas colgando de ella. Si más adelante el negocio se ofrece como SaaS a varias empresas, Empresa es la entidad que se convierte en raíz de aislamiento (tenant): cada sucursal, almacén y tienda —y en cascada, cada movimiento de los otros cinco módulos— queda asociado a su empresa_id. Construir Empresa como entidad explícita desde ahora, aunque hoy exista una sola fila, evita rediseñar el modelo de datos cuando llegue ese momento — mismo criterio que ya se aplicó al Portal Web para la v2 de ventas en línea: la migración a SaaS no se construye hoy, pero tampoco se bloquea con un diseño que la ignore.
Calidad, costos, trazabilidad y reportes: capacidades, no módulos aparte¶
Cuatro capacidades atraviesan los seis módulos sin ser un despliegue propio (ya adelantado en la Figura 1):
- Calidad vive donde ocurre el control real: en
Inventario(durante la operación de recepción: parámetros, resultados y aceptación/rechazo de lo que llega) y enProducción(parámetros y resultados del proceso y del producto obtenido). No hay un módulo de "Calidad" separado porque el control siempre pertenece a quien genera el dato, no a un tercero que lo audita después. - Costos se arma con lo que
Compras,Inventario,ProducciónyFinanzasya registran — materia prima, insumos, empaque, mermas y demás costos atribuibles — para llegar a costo de producción, costo unitario, márgenes y rentabilidad. No es una fuente de datos propia, es un cálculo sobre las demás. - Trazabilidad es la capacidad de recorrer la cadena completa — proveedor, compra, recepción, lote de materia prima, movimiento de inventario, orden de producción, insumos usados, lote de producto terminado, venta y cliente — en ambos sentidos: hacia adelante (de un lote de materia prima a los clientes que recibieron algo hecho con él) y hacia atrás (de un producto terminado a los proveedores y lotes que lo originaron).
- Reportes los entrega cada módulo sobre su propio ámbito — adquisiciones y proveedores (
Compras), existencias y movimientos, incluidas la recepción y el despacho (Inventario), consumo y rendimiento (Producción), operaciones comerciales (Ventas), operaciones económicas (Finanzas), usuarios y auditoría (Administración) — sin un módulo de reportería centralizado que dependa de todos los demás.
Arquitectura: monolito modular, organizado por capas — y el Portal Web aparte¶
Las figuras de esta sección siguen el modelo C4 (Context, Containers, Components, Code) de Simon Brown — cada nivel hace zoom sobre el anterior, sin saltarse ninguno (c4model.com).
Vista de contexto (C1)¶
La vista de contexto muestra el sistema completo como una sola caja negra: quién lo usa y con qué otros sistemas conversa — sin tecnología, y sin distinguir todavía entre Portal Web y ERP interno (esa distinción aparece recién en C2, la Figura 3). Mismo patrón que usa c4model.com/diagrams/system-context:
Figura 2. Vista de contexto (C1)
flowchart LR
Proveedor(["Proveedor"])
Personal(["Personal interno<br/>(compras, almacén, planta,<br/>ventas, caja)"])
Visitante(["Visitante / Cliente"])
Sistema["Sistema Integral de Gestión de<br/>Producción y Comercialización"]
Sunat["SUNAT/OSE<br/>facturación electrónica (gobierno)"]
Keycloak["Identity Provider<br/>(externo, ej. Keycloak)"]
Proveedor -->|"entrega materia prima,<br/>insumos y materiales de empaque"| Sistema
Personal -->|"opera compras, inventario<br/>(recepción y despacho),<br/>producción, ventas y finanzas"| Sistema
Visitante -->|"consulta catálogo,<br/>solicita contacto o pedido"| Sistema
Sistema -->|"emite comprobantes electrónicos<br/>(opcional, si se integra)"| Sunat
Sistema -->|"valida identidad e inicia sesión<br/>(opcional, si se integra)"| Keycloak
classDef system fill:#eef6ff,stroke:#2b6cb0,stroke-width:2px,color:#111;
classDef external fill:#fff3cd,stroke:#b7791f,stroke-width:2px,color:#5f370e;
classDef gov fill:#fde2e2,stroke:#b71c1c,stroke-width:2px,color:#5f1616;
class Sistema system;
class Keycloak external;
class Sunat gov;
Ningún nombre de tecnología aparece aquí (nada de "Spring Boot", "Mermaid" ni "Oracle") — a este nivel eso no importa todavía, solo quién usa el sistema y con qué otros sistemas conversa. Facturación electrónica e Identity Provider se dibujan aunque hoy sean integraciones opcionales, sin construir, por la misma razón que en el ejemplo académico: C1 responde "con qué conversará el sistema", no "qué ya está construido" — eso se aclara en la etiqueta de cada flecha, no omitiendo la caja.
Vista de contenedores (C2)¶
El ERP interno tiene usuarios acotados (compradores, personal de almacén, operarios de planta, vendedores, cajeros) y un cuello de botella real en la planta física — la báscula, el laboratorio de calidad, la línea de producción —, no en el tráfico digital. Sin un argumento de escala o de sistema externo que lo justifique, sus seis módulos se construyen como un solo desplegable: corren en el mismo proceso, se llaman entre sí con una llamada Java directa (verificada en tiempo de compilación, p. ej. ApplicationModules.verify() de Spring Modulith) y comparten una única base de datos con schemas separados por módulo.
Por dentro, los seis módulos se organizan por capas (Controller → Service → Repository): es la opción más simple y rápida de construir, y ninguno acumula hoy un caso de uso lo bastante complejo — ni siquiera Producción o Finanzas — como para pagar el costo extra de aislar el dominio (hexagonal/Clean, ADS S04 2.4-2.5). Inventario tampoco lo necesita solo por concentrar tres operaciones: cada una (recepción, existencias, despacho) sigue siendo simple por separado. Si eso cambia más adelante, se evalúa entonces, con el código real delante, no antes.
El Portal Web es la única excepción real del sistema. A diferencia de los seis módulos anteriores, aquí sí hay un argumento concreto de separación — el mismo criterio de ADS S04 (2.7, "servicios con necesidades de escala muy distintas entre sí") que ya usa el ejemplo académico para Matrícula y Pagos en línea:
- Perímetro de seguridad distinto. El Portal es lo único expuesto a internet — el ERP interno nunca debe quedar accesible directamente ni de casualidad. Para el visitante anónimo, el Portal solo conoce una vista de catálogo curada (nombre, descripción, imagen — no costos, no stock exacto, no datos de proveedor) y un único endpoint de escritura pública: recibir la solicitud de contacto. Para el usuario con sesión iniciada, el Portal valida sus credenciales y su rol contra
Administraciónantes de dejarlo entrar a cualquier módulo — nunca asume el rol por su cuenta. - Tráfico con un patrón distinto. Una campaña de marketing puede disparar visitas al catálogo sin ninguna relación con la carga del ERP interno (que depende de cuántos empleados están trabajando, no de cuánta gente ve un anuncio) — aunque ambos flujos (público y con sesión) entren por el mismo Portal.
- Ya se sabe que va a crecer. La empresa anticipó una v2 con ventas en línea (carrito, checkout, pasarela de pago) — ese es justo el tipo de crecimiento que conviene no tener acoplado al ERP interno desde el principio, para no separarlo después bajo presión.
Por eso el Portal Web se construye desde el día uno como su propio desplegable — la única capa de presentación de todo el sistema, tanto para el público como para el personal interno —, no como un séptimo módulo del monolito. Se organiza también por capas (mostrar catálogo, guardar un formulario, o pedirle a Administración el menú del usuario y redirigir al módulo autorizado — nada de eso exige aislar un dominio), pero como proceso aparte que le habla al ERP interno solo por su API, nunca a su base de datos directamente.
Figura 3. Vista de contenedores (C2): el Portal Web como entrada única de todo el sistema
flowchart TB
Visitante(["Visitante / Cliente<br/>(anónimo, internet)"])
Usuario(["Usuario interno<br/>(Compras, Almacén, Planta,<br/>Ventas, Caja)"])
Proveedor(["Proveedor<br/>(sin cuenta propia)"])
subgraph PORTAL["Portal Web (despliegue propio, por capas)"]
PortalPublico["Catálogo público<br/>+ formulario de contacto"]
PortalMenu["Login + menú de módulos<br/>según el rol"]
end
subgraph APP["ERP interno (1 despliegue, 1 proceso, por capas)"]
Administracion["6. Administración"]
Compras["1. Compras"]
Inventario["2. Inventario<br/>(recepción, existencias, despacho)"]
Produccion["3. Producción"]
Ventas["4. Ventas"]
Finanzas["5. Finanzas"]
Compras -->|"llamada Java directa"| Inventario
Produccion -->|"llamada Java directa"| Inventario
Inventario -->|"llamada Java directa"| Produccion
Ventas -->|"llamada Java directa"| Inventario
Compras -->|"llamada Java directa"| Finanzas
Ventas -->|"llamada Java directa"| Finanzas
Compras --> Administracion
Inventario --> Administracion
Produccion --> Administracion
Ventas --> Administracion
Finanzas --> Administracion
end
DB[("Base de datos<br/>schemas separados por módulo")]
Visitante --> PortalPublico
Usuario --> PortalMenu
Proveedor -->|"sin login — lo registra"| Compras
PortalPublico -.->|"HTTP: catálogo (lectura)<br/>+ solicitud de contacto (escritura)"| Ventas
PortalMenu -.->|"HTTP: login y permisos"| Administracion
PortalMenu -.->|"HTTP: solo el módulo autorizado"| APP
Administracion --> DB
Compras --> DB
Inventario --> DB
Produccion --> DB
Ventas --> DB
Finanzas --> DB
Finanzas -.->|"opcional, si se integra"| SUNAT["Facturación electrónica<br/>(externo, ej. SUNAT/OSE)"]
Administracion -.->|"delega solo autenticación<br/>(opcional, si se integra)"| Keycloak["Identity Provider<br/>(externo, ej. Keycloak)"]
Figura 4. Por capas: la misma organización interna, en los dos despliegues
flowchart TB
subgraph MOD["cualquiera de los 6 módulos del ERP, o el Portal Web"]
direction TB
CTRL["Controller"] --> SERV["Service"] --> REPO["Repository"]
end
Cómo leer el diagrama: flecha sólida = llamada Java directa, mismo proceso — dentro del ERP interno, porque sus seis módulos viven en el mismo monolito modular; también Proveedor → Compras, porque el proveedor no tiene cuenta propia, quien registra el dato es el personal de Compras. Flecha punteada = HTTP, proceso distinto — el Portal Web hablándole al ERP por su API (tanto la pública de catálogo/contacto como la protegida de cada módulo), y las dos integraciones externas opcionales (Facturación electrónica, Identity Provider), que hoy no están construidas: se agregan el día que el negocio realmente las necesite.
Tabla 3. Por qué cada componente va donde va
| Componente(s) | Despliegue | Por qué |
|---|---|---|
Administración |
ERP interno, por capas | Institucional + Personas + Plataforma transversal (dominios 1, 2 y 22 del ejemplo académico, juntos aquí por ser un sistema de 6 módulos) — configuración de la empresa, persona natural/jurídica, usuarios, roles, catálogos compartidos. Es también quien decide qué módulos ve cada usuario en el menú del Portal. |
Compras |
ERP interno, por capas | CRUD con validaciones — cotizar y ordenar no tiene hoy un caso más complejo que "la orden existe". |
Inventario |
ERP interno, por capas | Concentra recepción, existencias y despacho — es la base operativa que los demás módulos leen y escriben constantemente; ninguna de sus tres operaciones tiene hoy una regla más compleja que "el lote quedó aceptado/rechazado" o "la salida quedó confirmada". |
Producción |
ERP interno, por capas | El módulo con más reglas de negocio del sistema (fórmulas, consumo real vs. planificado, mermas) — pero todavía CRUD con validaciones sobre esas reglas, no un caso que hoy exija aislarse del framework. |
Ventas |
ERP interno, por capas | Cotizar y tomar pedidos es gestión de registros con reglas simples de disponibilidad y condiciones comerciales. |
Finanzas |
ERP interno, por capas | Cuentas por cobrar/pagar con un saldo que cuidar — que la suma de pagos no supere el monto se resuelve con una validación de servicio simple, sin necesitar aislar el dominio todavía. |
Portal Web |
Despliegue propio, por capas | Es la única presentación de todo el sistema (público y con sesión) — tráfico público/anónimo que no debe tocar el ERP interno directamente; escala distinta (campañas de marketing); va a crecer a ventas en línea en v2. Separarlo ahora evita rehacerlo bajo presión después. |
| Trazabilidad, Costos, Calidad, Reportes | No son despliegues | Se apoyan en los datos que ya generan los 6 módulos del ERP. |
Decisión, en una frase: el ERP interno es un monolito modular organizado por capas, sin excepciones entre sus seis módulos; el Portal Web es la única excepción del sistema completo — su propio despliegue, también por capas, porque a diferencia de los seis módulos internos sí tiene un argumento real de perímetro público y de escala distinta.
Quién es quién:
Administración: junta Institucional, Personas y Plataforma transversal (dominios 1, 2 y 22 del ejemplo académico) — configuración de la empresa, persona natural/jurídica, usuarios, roles, permisos, catálogos compartidos. La consulta todo lo demás, incluido elPortal Webpara saber qué módulos le muestra a cada usuario. Puede delegar la autenticación a un Identity Provider externo (Keycloak) el día que el negocio lo pida, sin dejar de ser dueña de los catálogos, los roles y la parametrización propios.Compras: negocia y ordena — proveedores, cotizaciones, órdenes de compra.Inventario: concentra tres operaciones sobre el almacén — recibe lo queComprasordenó (pesaje, calidad, lotes), mantiene el núcleo de existencias que todo lo demás lee y escribe, y despacha lo queVentasaprobó (picking, transporte, confirmación de entrega).Producción: el módulo con más reglas de negocio del sistema — orden de producción, fórmula, consumo, rendimiento, mermas.Ventas: negocia con el cliente — clientes, cotizaciones, pedidos, precios; entrega el pedido aprobado aInventariopara su despacho.Finanzas: cuentas por cobrar (de Ventas) y por pagar (de Compras), con su propio saldo.Portal Web: la entrada única del sistema, en su propio despliegue. Al visitante anónimo le muestra catálogo y contacto, y le entrega las solicitudes aVentassin convertirlas en pedido por sí mismo; al usuario con sesión le muestra el menú de módulos que su rol autoriza y lo deja operar ahí — nunca decide permisos por su cuenta, siempre se los pregunta aAdministración.Facturación electrónica/Identity Provider: sistemas externos opcionales — se integran, no se construyen, el día que aparezcan (cumplimiento tributario, SSO corporativo).
El flujo, de punta a punta:
- Un visitante anónimo entra al
Portal Web, revisa el catálogo de productos y llena el formulario de contacto. El Portal envía esa solicitud al ERP interno; un vendedor la recibe enVentas, se comunica con el interesado y, si prospera, la convierte manualmente en una cotización o un pedido — el Portal nunca genera un pedido por sí mismo (todavía no hay carrito ni pago; eso es v2). Ese mismo vendedor, para hacer esto, primero inició sesión en elPortal Webcon su usuario: el Portal le pidió el rol aAdministración, confirmó que tiene acceso aVentas, y recién ahí le mostró la pantalla — el mismo camino que sigue cualquier otro empleado (comprador, personal de almacén, operario de planta, cajero) para entrar a su propio módulo. Comprasgenera una orden de compra a unProveedor(maíz u otro insumo/material de empaque), y de paso informa aFinanzasel compromiso de pago (cuenta por pagar programada, aún no exigible).- El proveedor entrega físicamente la mercadería e
Inventariola registra (operación de recepción): pesaje (bruto, tara, neto para el maíz), controles de calidad (humedad, impurezas) y la decisión de aceptar, observar o rechazar. Lo aceptado genera lotes y su correspondiente entrada en existencias. - Cuando
Inventarioconfirma la recepción, la cuenta por pagar deFinanzaspasa de "programada" a "exigible" según los términos pactados con el proveedor. Produccióntoma una fórmula/receta, planifica una orden de producción y consulta aInventariola disponibilidad real de materias primas, insumos y materiales de empaque antes de iniciar — no reserva de forma optimista.- Al ejecutar la orden,
Producciónregistra el consumo real (que puede diferir del planificado), el rendimiento, las mermas y los subproductos, y entrega aInventariolos lotes de producto terminado resultantes (purina u otros derivados). Ventascotiza y toma pedidos contra la disponibilidad que le reportaInventario(el mismo módulo del paso 2, con productos terminados en vez de materia prima), y al confirmar un pedido informa aFinanzasla cuenta por cobrar correspondiente alCliente.Inventarioprepara el pedido aprobado porVentas(operación de despacho: picking, selección de lotes, transporte) y confirma la entrega. Una devolución del cliente reingresa a existencias (o queda observada/dada de baja) y ajusta la cuenta por cobrar enFinanzassi corresponde.Administraciónno genera ningún documento del flujo de negocio — pero sí aparece en cada paso, de forma implícita: es a quien elPortal Weble pregunta el rol antes de dejar entrar aCompras,Inventario,Producción,VentasoFinanzasen los pasos 1-7. Sostiene a los cinco módulos operativos desde el inicio (usuarios, roles, catálogos, auditoría), igual quePersonas/Institucionalen el ejemplo académico.
Siete aclaraciones que vale la pena dejar explícitas:
Inventariono decide nada, solo ejecuta. No decide cuánto comprar, cuánto producir ni si vender — esas decisiones son deCompras,ProducciónyVentas.Inventarioúnicamente ejecuta el movimiento (recepción, entrada, salida, despacho) que cada módulo le informa y responde "cuánto hay disponible" cuando se le pregunta.- Recepción y despacho no son módulos aparte, y no es un atajo. Ambos son la misma naturaleza de trabajo — mover físicamente el almacén — sin importar si el origen es una compra o el destino es una venta; por eso viven dentro de
Inventario, igual que hace Odoo con su módulostockfrente apurchaseysale. Producciónno reserva stock de forma optimista. Antes de iniciar una orden, confirma conInventariola disponibilidad real de insumos — si no alcanza, la orden queda en espera o se ejecuta parcial, nunca se descuenta un consumo que la planta no puede cubrir.Finanzasno conoce plan de cuentas contable ni centro de costo. Cada cuenta por pagar o por cobrar lleva proveedor/cliente, concepto y referencia comercial (orden de compra, pedido) — lenguaje del negocio, no de contabilidad formal. Traducir eso a cuenta contable es trabajo de un sistema contable externo, el día que exista esa integración — nunca antes, mismo criterio queERP Administrativoen el ejemplo académico.- El
Portal Webno decide permisos, solo los aplica. Que un usuario veaComprasoFinanzasen su menú lo decide el rol que le asignóAdministración, no el Portal — si mañana cambia el rol de alguien, el menú cambia solo porqueAdministracióncambió, sin tocar una línea del Portal. - La separación autenticación/autorización no depende de monolito modular vs. microservicios. Es un eje aparte (ADS S04, 2.7): en microservicios, Keycloak seguiría resolviendo solo identidad, cada servicio se registraría como su propio client con sus propios roles, y el menú agregado por rol lo seguiría armando la aplicación (un Backend for Frontend, o la versión distribuida de
Administración) — nunca el Identity Provider por sí solo, tenga el sistema 1 proceso o 10. - El
Portal Webya tiene sesión, pero no vende en línea todavía. El login y el menú por rol (para el personal interno) se construyen en esta v1; lo que falta es el lado del cliente: carrito, checkout y pago. Eso es alcance de v2, y en ese momento se evalúa si el Portal necesita su propia base de datos o una integración con una pasarela de pago; nada de eso se construye ahora solo porque "ya se sabe que viene".
La Figura 3 dibuja los 6 módulos del ERP interno como un monolito modular, más el Portal Web como su única excepción — separado desde el día uno por perímetro público y por lo que se anticipa en v2, no por volumen de tráfico actual. A diferencia del ejemplo académico (22 dominios, con varios candidatos reales a microservicio), aquí el ERP interno no tiene ninguno: el Portal Web es el único componente del sistema completo que se construye fuera del monolito.