Contrato de datos

Este archivo documenta el contrato de datos mínimos para ejecutar el proceso de valoración.

1) Entrada preliminar obligatoria

Archivo canónico: data/preliminary-data/WALMART_FM/wmt_prelim_financials_fy2015_2025.csv
Convención recomendada para nuevos límites: wmt_prelim_financials_<cutoff>.csv
Tipo: exportación de estados financieros en formato tipo Bloomberg (tabla sin procesar).
Validación automática: Rscript Code/00_Validate_Inputs.R

Compatibilidad:

La canalización también reconoce el nombre heredado Raw-Tabla 1.csv.

El validador requiere, como mínimo:

Cobertura anual (mínimo 5 años)
Presencia de etiquetas financieras clave:
- Total revenues
- Operating income
- Consolidated net income attributable to Walmart
- Cash and cash equivalents
- Total current assets
- Total current liabilities
- Total assets
- Total Walmart shareholders' equity
- Net cash provided by operating activities
- Payments for property and equipment
- Dividends paid

2) Supuestos (opcional, recomendado)

Plantilla versionada: config/assumptions.example.csv
Anulación local (no versionada): config/assumptions.csv
Última configuración de corte: config/latest_period_basis.csv (opcional)
- latest_period_mode: auto, ltm o fy_actual
- target_fiscal_year: año fiscal objetivo para forzar la transición (por ejemplo, 2026)

Si config/assumptions.csv no existe, se utilizan valores predeterminados conservadores.

3) Salidas `data/processed`

Validador:

validation_report.txt

Modelos:

preliminary_master_financials.csv
preliminary_data_basis.csv
preliminary_dcf_summary.csv
preliminary_dcf_forecast.csv
preliminary_rim_summary.csv
preliminary_rim_forecast.csv
preliminary_valuation_metrics_by_year.csv
preliminary_valuation_snapshot.csv
preliminary_multiples_summary.csv
preliminary_peer_comp_set_used.csv
preliminary_sotp_summary.csv
preliminary_sotp_breakdown.csv
preliminary_ddm_summary.csv
preliminary_ddm_forecast.csv
preliminary_bsm_summary.csv
preliminary_football_field_values.csv
preliminary_football_field.pdf
preliminary_valuation_charts.pdf

4) Flujo recomendado

Desde la raíz del repositorio:

make all

Para una depuración paso a paso:

make validate
make valuation
make charts
make tables
make moi