Diego Barros Docs

Fecha: Octubre 2025
Versión: 1.0
Estado: Completo y Listo para Despliegue

Objetivo del Proyecto

Desarrollar un sistema backend serverless completo para la gestión de inventario de productos y bodegas, implementando una arquitectura orientada a eventos en la nube de Azure.

Componentes Implementados

1. Backend Serverless (Azure Functions)

APIs REST - Operaciones CRUD Completas

API GraphQL - Queries y Mutations

# Queries
query {
  productos { id nombre descripcion precio cantidadEnStock }
  producto(id: Int!) { id nombre descripcion precio }
  bodegas { id nombre ubicacion capacidad }
  bodega(id: Int!) { id nombre ubicacion capacidad }
}

# Mutations
mutation {
  crearProducto(input: ProductoInput!): Producto
  actualizarProducto(id: Int!, input: ProductoInput!): Producto
  eliminarProducto(id: Int!): Boolean
}

2. Arquitectura Orientada a Eventos (Azure Event Grid)

Event Grid Topic

Tipos de Eventos Implementados

Event Handlers (Consumers)

Evento	Tipo	Trigger
ProductoCreado	`Agranelos.Inventario.ProductoCreado`	POST /api/productos
ProductoActualizado	`Agranelos.Inventario.ProductoActualizado`	PUT /api/productos/{id}
ProductoEliminado	`Agranelos.Inventario.ProductoEliminado`	DELETE /api/productos/{id}
BodegaCreada	`Agranelos.Inventario.BodegaCreada`	POST /api/bodegas
BodegaActualizada	`Agranelos.Inventario.BodegaActualizada`	PUT /api/bodegas/{id}
BodegaEliminada	`Agranelos.Inventario.BodegaEliminada`	DELETE /api/bodegas/{id}

3. Base de Datos PostgreSQL

Esquema Normalizado

PRODUCTO
├── ID (PK)
├── Nombre
├── Descripcion
├── Precio
├── CantidadEnStock
├── FechaCreacion
└── FechaActualizacion

BODEGA
├── ID (PK)
├── Nombre
├── Ubicacion
├── Capacidad
├── FechaCreacion
└── FechaActualizacion

INVENTARIO
├── ID (PK)
├── IDProducto (FK)
├── IDBodega (FK)
├── Cantidad
└── FechaActualizacion

MOVIMIENTO
├── ID (PK)
├── IDProducto (FK)
├── IDBodega (FK)
├── Tipo (ENTRADA/SALIDA/TRANSFERENCIA/AJUSTE)
├── Cantidad
├── Fecha
├── Comentario
└── UsuarioResponsable

Características

4. Infraestructura como Código

ARM Templates

Scripts de Despliegue

5. CI/CD con GitHub Actions

Workflows Implementados

6. Documentación Completa

Documentos Creados

Diagramas Incluidos

Arquitectura de la Solución

Documento	Descripción	Ubicación
README.md	Documentación principal	`/README.md`
ARQUITECTURA.md	Arquitectura detallada del sistema	`/docs/ARQUITECTURA.md`
DEPLOY.md	Guía completa de despliegue	`/docs/DEPLOY.md`
CI/CD README	Explicación de workflows	`/.github/workflows/README.md`
ARM Template	Infraestructura como código	`/azure-deploy.json`

┌─────────────────────────────────────────────────────────┐
│                    CLIENTES                             │
│        Web Apps │ Mobile Apps │ API Clients             │
└────────────────────────┬────────────────────────────────┘
                         │ HTTPS
                         ▼
┌─────────────────────────────────────────────────────────┐
│               AZURE FUNCTIONS                           │
│  ┌──────────────┐              ┌──────────────┐        │
│  │   REST API   │              │  GraphQL API │        │
│  │   12 funcs   │              │              │        │
│  └──────┬───────┘              └──────┬───────┘        │
│         │                             │                 │
│         └─────────────┬───────────────┘                 │
│                       │                                 │
│                       │ Publish Events                  │
│                       ▼                                 │
│         ┌──────────────────────────┐                   │
│         │   AZURE EVENT GRID       │                   │
│         │  6 Event Types           │                   │
│         └────────┬─────────────────┘                   │
│                  │                                      │
│                  │ Distribute Events                    │
│                  ▼                                      │
│         ┌──────────────────────────┐                   │
│         │  EVENT HANDLERS          │                   │
│         │  6 Consumer Functions    │                   │
│         └──────────────────────────┘                   │
└────────────────────┬────────────────────────────────────┘
                     │ JDBC (Pooled)
                     ▼
┌─────────────────────────────────────────────────────────┐
│           POSTGRESQL DATABASE (AWS EC2)                 │
│   4 Tables: PRODUCTO, BODEGA, INVENTARIO, MOVIMIENTO   │
└─────────────────────────────────────────────────────────┘

Dependencias y Tecnologías

Backend

Azure Services

Librerías Java

Opciones de Despliegue

Opción 1: Script Automatizado (Recomendado)

./scripts/deploy-azure.sh

Opción 2: ARM Template

az deployment group create \
  --resource-group agranelos-inventario-rg \
  --template-file azure-deploy.json \
  --parameters azure-deploy.parameters.json

Opción 3: CI/CD Automático

💰 Estimación de Costos Azure

Casos de Uso de Event Grid

Recurso	Costo Mensual
Azure Functions (Consumption)	$5 - $20
Event Grid Topic	$0.60 por millón eventos
Storage Account	$1 - $5
Application Insights	$2.30 por GB
Total Estimado	$10 - $50/mes

1. Auditoría Automática

2. Notificaciones en Tiempo Real

3. Sincronización con Sistemas Externos

4. Analítica y Reportes

Checklist de Completitud

Desarrollo

Event-Driven Architecture

Infraestructura

CI/CD

Documentación

🎓 Próximos Pasos Recomendados

Fase 2 (Opcional)

📞 Información de Contacto

Repositorio: github.com/DiegoBarrosA/agranelos-functions-crud
Desarrollador: Diego Barros
Fecha de Finalización: Octubre 2025

Conclusión

El Sistema de Inventario Agranelos está 100% completo y listo para producción, incluyendo:

Backend completo con todas las operaciones CRUD
Arquitectura orientada a eventos con Azure Event Grid
Infraestructura como código totalmente automatizada
CI/CD implementado con GitHub Actions
Documentación completa y profesional
Listo para escalar en la nube de Azure

El sistema puede desplegarse en Azure en menos de 20 minutos usando los scripts proporcionados.

Este documento proporciona una visión completa del proyecto implementado. Para detalles técnicos específicos, consultar la documentación en /docs.

Resumen Ejecutivo del Proyecto

Sistema de Inventario Agranelos - Solución Cloud Completa