MedStock
Un sistema de inventario y pedidos para el sector salud con asignación de lotes FEFO, un libro de movimientos de solo agregar y actualizaciones en tiempo real.
v1.2.0
16 nov. 2026
Capturas de pantalla

Resumen en modo oscuro: indicadores, gráfico de movimientos y actividad en vivo.
En un teléfono (390 px de ancho)
Resumen en un teléfono.
Inventario en un teléfono.
Detalle de pedido en un teléfono, modo claro.
Gestión de productos en un teléfono.El problema
Los centros de distribución de insumos médicos deben despachar primero los lotes que vencen antes, nunca dejar que el stock sea negativo, mantener los productos de cadena de frío en sedes con cadena de frío, y ver el stock bajo y los lotes por vencer antes de que sean un problema.
Para quién es
Gerentes de bodega, alistadores, personal de compras y administradores en varios centros de distribución. MedStock es una demo de portafolio: todos los productos, empresas y personas son ficticios.
Funciones principales
Resumen con actividad en vivo
Indicadores (valor del inventario, SKU con stock bajo, lotes que vencen en 30/60/90 días, órdenes de compra abiertas, tasa de cumplimiento, pedidos abiertos), gráficos de movimientos y valor de stock, productos principales y un feed de actividad en vivo.
Inventario y lotes
Paginación, orden y filtros en el servidor (búsqueda, ubicación, categoría, stock bajo, por vencer, cadena de frío) con detalle de lotes, y una página de producto con stock por ubicación y línea de tiempo de movimientos.
Gestión de datos maestros
Productos, bodegas, proveedores y clientes tienen cada uno una tabla con búsqueda y diálogos de crear y editar con validación. Un registro al que hacen referencia stock, lotes, pedidos, órdenes de compra o movimientos no se puede eliminar, así que el diálogo ofrece desactivar y reactivar.
Pedidos con asignación FEFO
Crea pedidos con validación de formulario, asigna primero-en-vencer-primero-en-salir entre lotes, y luego alista y despacha. Mientras un pedido está Pendiente o Asignado se pueden agregar, quitar o cambiar sus líneas y el pedido se libera por completo y se reasigna en una sola transacción; cancelar pide confirmación.
Órdenes de compra
Sugerencias de reabastecimiento según mínimos y máximos (contando lo que ya está pedido), órdenes de compra manuales (proveedor, bodega, líneas), edición de cantidades (nunca por debajo de lo recibido), cancelación antes de cualquier recepción y recepción total o parcial que registra nuevos lotes.
Traslados y reversión
Mueve stock entre ubicaciones; el stock reservado no se puede mover y los productos de cadena de frío solo van a sedes con cadena de frío. Un traslado se puede revertir con movimientos compensatorios, sin tocar las filas originales del libro.
Alertas
Stock bajo, lotes por vencer y vencidos, y excursiones de temperatura en la cadena de frío.
Permisos por rol
Roles Admin, Warehouse Manager, Picker y Viewer. Los servicios reciben al usuario que actúa y aplican los permisos ellos mismos, así que una llamada denegada devuelve un error y no cambia nada; se mantiene el restablecimiento de datos solo para administradores.
Aspectos destacados de la arquitectura
Asignación FEFO
Un FefoAllocator puro en la biblioteca de dominio elige los lotes por fecha de vencimiento más cercana, omite los vencidos y respeta lo disponible.
Libro de movimientos de solo agregar
Cada cambio es un movimiento del libro y las filas nunca se editan ni se borran (una reversión es un movimiento compensatorio, como TRF-xxxxx-REV en un traslado). Los saldos por bodega y lote nunca pueden ser negativos, y un endpoint de verificación reproduce el libro para comprobarlo.
Tiempo real con SignalR
Las escrituras se serializan, se guardan y se anuncian en un bus de eventos con temas; cada circuito de Blazor conectado solo recarga los componentes cuyo tema se disparó, así que paneles, tablas y el feed se actualizan en vivo.
Simulador en segundo plano
Un BackgroundService crea pedidos, los despacha, recibe órdenes de compra, traslada stock y genera alertas cada pocos segundos (10 s por defecto), así la demo siempre tiene actividad. Ignora productos, bodegas y clientes inactivos y no toca los pedidos ni las órdenes de compra creados por usuarios. Se puede apagar desde la barra superior o en la configuración.
Reinicio por versión de esquema
La versión del esquema se guarda en PRAGMA user_version de SQLite; una base de datos más antigua se elimina, se recrea y se vuelve a poblar al arrancar con un mensaje claro en el registro, así una base existente en el servidor se actualiza sin problemas.
Biblioteca de dominio aislada
Las reglas de negocio (FEFO, reabastecimiento, vencimiento, libro de movimientos, recepción de OC, flujo de pedidos) viven en MedStock.Domain sin dependencias de EF Core ni ASP.NET y tienen pruebas unitarias propias.
Tecnologías y versiones
Versiones exactas tomadas de los archivos del proyecto.
| Tecnología | Versión | Se usa para |
|---|---|---|
| net11.0 (.NET 11)Marco de destino y SDK usado para compilar (sin global.json) | SDK 11.0.100 |
Marco de destino y SDK usado para compilar (sin global.json) |
| Blazor Web App (Interactive Server)Interfaz renderizada en el servidor con un circuito en vivo | ASP.NET Core 11.0 |
Interfaz renderizada en el servidor con un circuito en vivo |
| SignalRIncluido en el framework; transporta el circuito de Blazor y las actualizaciones en vivo | ASP.NET Core 11.0 |
Incluido en el framework; transporta el circuito de Blazor y las actualizaciones en vivo |
| MudBlazorComponentes de UI, tema oscuro y claro, y gráficos | 9.13.0 |
Componentes de UI, tema oscuro y claro, y gráficos |
| Microsoft.EntityFrameworkCore.SqliteAcceso a datos con SQLite | 11.0.0 |
Acceso a datos con SQLite |
| Microsoft.AspNetCore.Identity.EntityFrameworkCoreAutenticación por cookies y roles | 11.0.0 |
Autenticación por cookies y roles |
| xunitFramework de pruebas | 2.9.3 |
Framework de pruebas |
| xunit.runner.visualstudioEjecutor de pruebas | 3.1.4 |
Ejecutor de pruebas |
| Microsoft.NET.Test.SdkHost de pruebas | 17.14.1 |
Host de pruebas |
| Microsoft.AspNetCore.Mvc.TestingWebApplicationFactory para pruebas de integración (archivo SQLite desechable) | 11.0.0 |
WebApplicationFactory para pruebas de integración (archivo SQLite desechable) |
| GitHub ActionsCI/CD: compila, prueba y despliega por FTPS | - |
CI/CD: compila, prueba y despliega por FTPS |
137 pruebas xUnit en dos proyectos (78 de dominio, 59 web): pruebas unitarias del dominio (FEFO, reabastecimiento, vencimiento, libro de movimientos, recepción de OC, flujo de pedidos, reglas de dominio) y pruebas de servicio e integración contra la app real (autenticación, roles y rechazos en cada operación de escritura, rutas de crear, editar, eliminar y desactivar, reasignación de pedidos, órdenes de compra manuales y editadas, reversión de traslados e integridad del libro, simulador con datos inactivos y creados por usuarios).
Cuentas de demostración
Todo en la demo es sintético y las credenciales son públicas a propósito. Cada cuenta tiene un rol distinto, así puedes ver cómo los permisos cambian lo que se puede hacer.
Contraseña: MedStock-Demo-2026!