Cloud-Conversion/docs/DATA_DICTIONARY.md

Diccionario de Datos

Este documento resume los archivos principales que consume y genera Cloud Conversion. Los formatos no se cambian desde la documentacion; se describen para que otros arquitectos puedan preparar inventarios y leer resultados.

Inventarios de entrada

Formatos soportados:

• CSV
• XLS
• XLSX

Ubicaciones:

Ruta	Uso
input/	Inventarios disponibles para CLI y GUI.
input/gui_uploads/	Inventarios subidos desde Streamlit.
input/done/	Inventarios archivados manualmente en GUI o automaticamente por CLI.

Columnas locales esperadas cuando existen:

Campo normalizado	Columna local	Descripcion
quantity	Cantidad	Cantidad de servidores o instancias equivalentes.
cpu	vCPU	vCPU por servidor.
memory_gb	Memoria	Memoria por servidor en GB.
storage_gb	Block Storage	Storage por servidor en GB.
os	Nombre	Sistema operativo o plataforma.
environment	Ambiente	Ambiente: PRD, QA, DEV, UAT, DR, etc.
notes	Tipo	Tipo, rol, workload o descripcion.

El proyecto tambien tiene fallback para nombres comunes como VM, CPUs, RAM, storage, OS according to the VMware Tools, environment, hostname y equivalentes.

Inventario normalizado

Los matchers transforman cada fila a campos comunes:

Columna	Descripcion
server_name	Nombre de servidor, VM o grupo.
quantity	Cantidad final usada para multiplicar costos.
source_cpu	CPU/vCPU por unidad.
source_memory_gb	Memoria por unidad en GB.
source_storage_gb	Storage por unidad en GB.
source_total_cpu	CPU total para AWS.
source_total_vcpu	vCPU total para OCI output.
source_ocpu	OCPU calculado para OCI.
source_total_ocpu	OCPU total para OCI.
source_total_memory_gb	Memoria total.
source_total_storage_gb	Storage total.
os	OS detectado o mapeado.
environment	Ambiente.
notes	Notas o rol del workload.

Catalogo AWS

Ruta:

data/catalog/aws/aws_ec2_catalog.csv

Origen:

data/raw/aws/index.json

Columnas actuales:

Columna	Descripcion
sku	SKU AWS Pricing.
regionCode	Codigo de region AWS.
location	Nombre de ubicacion.
instanceType	Tipo de instancia, por ejemplo m7a.xlarge.
instanceFamily	Familia comercial.
vcpu	vCPU del shape.
memory	Memoria textual del offer.
currentGeneration	Si es generacion actual.
processorArchitecture	Arquitectura de CPU.
networkPerformance	Descripcion de red.
operatingSystem	OS del precio.
tenancy	Tenancy, por ejemplo Shared.
preInstalledSw	Software preinstalado.
capacitystatus	Estado de capacidad, normalmente Used.
unit	Unidad de precio, normalmente Hrs.
price_usd	Precio USD por hora.
description	Descripcion AWS.

Salida AWS Match

Ruta:

data/match/aws/MATCH-AWS-<inventario>.csv

Columnas principales:

Columna	Descripcion
server_name	Servidor o grupo origen.
quantity	Cantidad origen.
source_cpu	CPU origen por unidad.
source_memory_gb	Memoria origen por unidad.
source_storage_gb	Storage origen por unidad.
workload_type	Clasificacion de workload usada para ranking.
aws_sku	SKU recomendado.
aws_region_code	Region AWS seleccionada.
aws_location	Ubicacion AWS.
aws_instance_type	Shape recomendado.
aws_instance_family	Familia del shape recomendado.
aws_vcpu	vCPU del shape recomendado.
aws_memory_gb	Memoria del shape recomendado.
aws_price_usd_per_hr	Precio unitario por hora.
aws_total_instances	Instancias recomendadas.
aws_total_price_usd_per_hr	Costo total por hora.
aws_monthly_price_usd_730h	Costo mensual usando 730 horas.
aws_operating_system	OS del precio usado.
aws_match_status	MATCH, NO_MATCH o status de error de datos.
aws_candidate_group_selected	Grupo de candidatos usado para ranking.
aws_recommendation_reason	Explicacion de seleccion.
aws_preferred_m_family	Familia M preferida configurada.
aws_m_max_cpu_ratio	Ratio CPU maximo configurado.
aws_preferred_m_rejection_reason	Razon de rechazo si la M preferida no aplica.

Catalogo OCI

Ruta:

data/catalog/oci/oci_price_list.csv

Origen:

data/raw/oci/products.json

Columnas:

Columna	Descripcion
partNumber	SKU o parte OCI.
displayName	Nombre comercial.
serviceCategory	Categoria de servicio.
metricName	Metrica de precio.
currencyCode	Moneda, normalmente USD.
prices_model	Modelo de precio.
prices_value	Valor del precio.

Salida OCI Match

Ruta:

data/match/oci/MATCH-OCI-<inventario>.csv

Columnas:

Columna	Descripcion
row_type	DETAIL, BOM o SUMMARY.
server_name	Servidor o grupo origen.
quantity	Cantidad origen.
source_cpu	vCPU origen.
source_ocpu	OCPU origen calculado.
source_memory_gb	Memoria por unidad.
source_storage_gb	Storage por unidad.
source_total_vcpu	vCPU total.
source_total_ocpu	OCPU total.
source_total_memory_gb	Memoria total.
source_total_storage_gb	Storage total.
os	OS origen.
environment	Ambiente origen.
notes	Notas origen.
oci_pricing_profile	Perfil de precio OCI, por ejemplo Linux o Windows.
oci_line_item	Linea BOM o resumen.
oci_sku	SKU OCI.
oci_display_name	Nombre OCI.
oci_service_category	Categoria OCI.
oci_metric_name	Metrica OCI.
oci_currency_code	Moneda.
oci_prices_model	Modelo de precio.
oci_quantity	Cantidad cotizada.
oci_unit_price_usd_per_hr	Precio unitario por hora.
oci_hours_per_month	Horas mensuales usadas.
oci_monthly_price_usd	Precio mensual calculado.
oci_match_status	Status de matching.
oci_recommendation_reason	Explicacion de BOM.
oci_compute_generation	Generacion compute seleccionada.

Dashboard

La GUI lee los ultimos MATCH-AWS-*.csv y MATCH-OCI-*.csv por fecha de modificacion.

Metricas:

Metrica	Calculo
AWS mensual	Suma de aws_monthly_price_usd_730h para filas aws_match_status == MATCH.
OCI mensual	Fila SUMMARY de grand total, o suma de filas BOM.
Ahorro	(AWS - OCI) / AWS * 100.
Cobertura	Filas AWS con MATCH sobre total de filas AWS.

Logs

Ruta:

logs/log_cloud_conversion_YYYYMMDD.txt

Cada linea incluye timestamp, prefijo de script y mensaje. Prefijos comunes:

Prefijo	Origen
>> AWS_fetch_offer>>	Descarga AWS.
>> AWS_eda>>	EDA AWS.
>> AWS_match>>	Matching AWS.
>> OCI_fetch_offer>>	Descarga OCI.
>> OCI_match>>	Matching OCI.
>> cloud_chat>>	Cloud Chat CLI.
>> cloud_chat_runtime>>	Runtime WhatsApp/Cloud Chat.
>> whatsapp_chatbot>>	Webhook WhatsApp.

Los logs estan ignorados por Git y no deben compartirse sin revision.