233 lines
8.8 KiB
YAML
233 lines
8.8 KiB
YAML
# =============================================================================
|
|
# TRAZABILIDAD: MAI-004 - COMPRAS E INVENTARIOS
|
|
# =============================================================================
|
|
# Modulo: MAI-004 Compras e Inventarios
|
|
# Fecha: 2025-11-25
|
|
# Version: 1.0.0
|
|
# Reutilizacion ERP Generico: 80%
|
|
# =============================================================================
|
|
|
|
metadata:
|
|
modulo: MAI-004
|
|
nombre: Compras e Inventarios
|
|
descripcion: Proveedores, requisiciones, ordenes de compra, almacenes e inventarios
|
|
fecha_actualizacion: 2025-11-25
|
|
responsable: Architecture-Analyst
|
|
mapeo_generico: MGN-005 + MGN-006
|
|
porcentaje_reutilizacion: 80
|
|
|
|
# =============================================================================
|
|
# REQUERIMIENTOS FUNCIONALES
|
|
# =============================================================================
|
|
requerimientos:
|
|
- id: RF-PURCH-001
|
|
nombre: Catalogo de Proveedores
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/requerimientos/RF-PURCH-001-catalogo-proveedores.md
|
|
prioridad: P0
|
|
estado: documentado
|
|
descripcion: Gestion de proveedores con evaluacion y especialidades
|
|
especificaciones:
|
|
- id: ET-PURCH-001
|
|
nombre: Implementacion Proveedores
|
|
tipo: backend
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/especificaciones/ET-PURCH-001-implementacion-proveedores.md
|
|
estado: documentado
|
|
tablas_bd:
|
|
- purchase.suppliers # GENERICO
|
|
- purchase.supplier_construction # EXTENSION
|
|
endpoints_api:
|
|
- GET /api/v1/suppliers
|
|
- POST /api/v1/suppliers
|
|
- GET /api/v1/suppliers/{id}
|
|
- PATCH /api/v1/suppliers/{id}
|
|
- POST /api/v1/suppliers/{id}/evaluate
|
|
componentes_frontend:
|
|
- SupplierList
|
|
- SupplierForm
|
|
- SupplierEvaluation
|
|
- SupplierRatingStars
|
|
|
|
- id: RF-PURCH-002
|
|
nombre: Requisiciones y Ordenes de Compra
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/requerimientos/RF-PURCH-002-requisiciones-ordenes-compra.md
|
|
prioridad: P0
|
|
estado: documentado
|
|
descripcion: Flujo de requisicion desde obra hasta orden de compra
|
|
especificaciones:
|
|
- id: ET-PURCH-002
|
|
nombre: Implementacion Requisiciones y OC
|
|
tipo: backend
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/especificaciones/ET-PURCH-002-implementacion-requisiciones-ordenes.md
|
|
estado: documentado
|
|
tablas_bd:
|
|
- inventory.requisiciones_obra # EXTENSION
|
|
- inventory.requisicion_lineas # EXTENSION
|
|
- purchase.purchase_orders # GENERICO
|
|
- purchase.purchase_order_lines # GENERICO
|
|
- purchase.purchase_order_construction # EXTENSION
|
|
- purchase.comparativo_cotizaciones # EXTENSION
|
|
- purchase.comparativo_proveedores # EXTENSION
|
|
- purchase.comparativo_productos # EXTENSION
|
|
endpoints_api:
|
|
- GET /api/v1/requisiciones
|
|
- POST /api/v1/requisiciones
|
|
- GET /api/v1/requisiciones/{id}
|
|
- POST /api/v1/requisiciones/{id}/approve
|
|
- POST /api/v1/requisiciones/{id}/generate-oc
|
|
- GET /api/v1/purchase-orders
|
|
- POST /api/v1/purchase-orders
|
|
- POST /api/v1/purchase-orders/{id}/approve
|
|
- GET /api/v1/comparativos
|
|
- POST /api/v1/comparativos
|
|
componentes_frontend:
|
|
- RequisicionList
|
|
- RequisicionForm
|
|
- RequisicionApproval
|
|
- PurchaseOrderList
|
|
- PurchaseOrderForm
|
|
- ComparativoGrid
|
|
- ComparativoWizard
|
|
|
|
- id: RF-PURCH-003
|
|
nombre: Almacenes e Inventarios
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/requerimientos/RF-PURCH-003-almacenes-inventarios.md
|
|
prioridad: P0
|
|
estado: documentado
|
|
descripcion: Gestion de almacenes por proyecto y control de stock
|
|
especificaciones:
|
|
- id: ET-PURCH-003
|
|
nombre: Implementacion Almacenes
|
|
tipo: backend
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/especificaciones/ET-PURCH-003-implementacion-almacenes.md
|
|
estado: documentado
|
|
tablas_bd:
|
|
- inventory.warehouses # GENERICO
|
|
- inventory.almacenes_proyecto # EXTENSION
|
|
- inventory.products # GENERICO
|
|
- inventory.stock_quants # GENERICO
|
|
- inventory.stock_moves # GENERICO
|
|
endpoints_api:
|
|
- GET /api/v1/warehouses
|
|
- POST /api/v1/warehouses
|
|
- GET /api/v1/warehouses/{id}/stock
|
|
- GET /api/v1/products
|
|
- POST /api/v1/products
|
|
- GET /api/v1/stock-moves
|
|
- POST /api/v1/stock-moves
|
|
componentes_frontend:
|
|
- WarehouseList
|
|
- WarehouseForm
|
|
- WarehouseByProject
|
|
- ProductList
|
|
- ProductForm
|
|
- StockGrid
|
|
- StockMoveForm
|
|
|
|
- id: RF-PURCH-004
|
|
nombre: Kardex y Alertas
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/requerimientos/RF-PURCH-004-kardex-alertas.md
|
|
prioridad: P1
|
|
estado: documentado
|
|
descripcion: Kardex de movimientos y alertas de stock minimo
|
|
especificaciones:
|
|
- id: ET-PURCH-004
|
|
nombre: Implementacion Kardex y Alertas
|
|
tipo: backend
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/especificaciones/ET-PURCH-004-implementacion-kardex-alertas.md
|
|
estado: documentado
|
|
tablas_bd:
|
|
- inventory.stock_moves # GENERICO
|
|
- inventory.consumos_obra # EXTENSION
|
|
endpoints_api:
|
|
- GET /api/v1/kardex/{product_id}
|
|
- GET /api/v1/kardex/{product_id}/by-warehouse
|
|
- GET /api/v1/alerts/low-stock
|
|
- GET /api/v1/consumos-obra
|
|
- POST /api/v1/consumos-obra
|
|
componentes_frontend:
|
|
- KardexView
|
|
- KardexReport
|
|
- LowStockAlert
|
|
- ConsumoObraForm
|
|
- ConsumosPorLote
|
|
|
|
# =============================================================================
|
|
# HISTORIAS DE USUARIO
|
|
# =============================================================================
|
|
historias_usuario:
|
|
- id: US-PURCH-001
|
|
nombre: Registro de Proveedor
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/historias-usuario/US-PURCH-001-registro-proveedor.md
|
|
requerimientos: [RF-PURCH-001]
|
|
|
|
- id: US-PURCH-002
|
|
nombre: Solicitud de Cotizaciones
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/historias-usuario/US-PURCH-002-solicitud-cotizaciones.md
|
|
requerimientos: [RF-PURCH-002]
|
|
|
|
- id: US-PURCH-003
|
|
nombre: Crear Requisicion de Obra
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/historias-usuario/US-PURCH-003-crear-requisicion-obra.md
|
|
requerimientos: [RF-PURCH-002]
|
|
|
|
- id: US-PURCH-004
|
|
nombre: Aprobar y Generar Orden de Compra
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/historias-usuario/US-PURCH-004-aprobar-generar-orden-compra.md
|
|
requerimientos: [RF-PURCH-002]
|
|
|
|
- id: US-PURCH-005
|
|
nombre: Recibir Material en Almacen
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/historias-usuario/US-PURCH-005-recibir-material-almacen.md
|
|
requerimientos: [RF-PURCH-003]
|
|
|
|
- id: US-PURCH-006
|
|
nombre: Control de Almacenes y Movimientos
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/historias-usuario/US-PURCH-006-control-almacenes-movimientos.md
|
|
requerimientos: [RF-PURCH-003]
|
|
|
|
- id: US-PURCH-007
|
|
nombre: Kardex y Analisis de Consumo
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/historias-usuario/US-PURCH-007-kardex-analisis-consumo.md
|
|
requerimientos: [RF-PURCH-004]
|
|
|
|
- id: US-PURCH-008
|
|
nombre: Dashboard de Inventarios y Alertas
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/historias-usuario/US-PURCH-008-dashboard-inventarios-alertas.md
|
|
requerimientos: [RF-PURCH-004]
|
|
|
|
# =============================================================================
|
|
# ARCHIVOS SQL/RLS
|
|
# =============================================================================
|
|
archivos_implementacion:
|
|
- tipo: rls_policies
|
|
archivo: 01-fase-alcance-inicial/MAI-004-compras-inventarios/implementacion/ET-PURCH-rls-policies.sql
|
|
|
|
# =============================================================================
|
|
# DEPENDENCIAS
|
|
# =============================================================================
|
|
dependencias:
|
|
modulos_requeridos:
|
|
- MAI-001 # Autenticacion
|
|
- MAI-002 # Proyectos (almacen por proyecto)
|
|
- MAI-003 # Conceptos (consumos por concepto)
|
|
modulos_dependientes:
|
|
- MAI-005 # Avances registran consumos
|
|
- MAI-008 # Estimaciones
|
|
|
|
# =============================================================================
|
|
# METRICAS DE COBERTURA
|
|
# =============================================================================
|
|
metricas:
|
|
total_rf: 4
|
|
total_et: 4
|
|
total_us: 8
|
|
total_tablas: 14
|
|
tablas_genericas: 7
|
|
tablas_extension: 7
|
|
cobertura_documentacion: 100%
|
|
cobertura_implementacion: 0%
|
|
|
|
# =============================================================================
|
|
# FIN DEL ARCHIVO
|
|
# =============================================================================
|