Volver a proyectos Proyectos

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.

Demo de portafolio
Datos sintéticos
Código abierto (MIT)
Tiempo real
.NET 11
Código fuente
Próximamente
Versión de la app

v1.2.0

Última actualización

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 de MedStock en un teléfono de 390 píxeles de ancho en modo oscuro Resumen en un teléfono.
Inventario de MedStock en un teléfono con una tarjeta compacta por producto Inventario en un teléfono.
Detalle de un pedido de MedStock en un teléfono en modo claro Detalle de pedido en un teléfono, modo claro.
Gestión de productos de MedStock en un teléfono en modo oscuro con botón Nuevo producto y una tarjeta por producto 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íaVersiónSe 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.

admin@medstock.demo
manager@medstock.demo
picker@medstock.demo
viewer@medstock.demo

Contraseña: MedStock-Demo-2026!

© 2026 Miguel Alonso. Todos los derechos reservados. v2.5.2

Se ha producido un error no controlado. Recargar 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.