# namfite-1306/yeild-line- architecture

> Architecture diagram of the GitHub repository namfite-1306/yeild-line-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/namfite-1306/yeild-line-
- Repository: https://github.com/namfite-1306/yeild-line-

## Overview

This repository is a Vietnam–US yield-curve forecasting and research pipeline, not an interactive application. Its principal workflow assembles monthly yield and macroeconomic data, fits Nelson–Siegel factors, produces recursive forecasts and evaluation results, then extends them with robustness and serial-correlation diagnostics for research reporting. The sampled code supports the core pipeline and several analysis/reporting links; relationships for unsampled modules and the separate Vietnam macro collection are not inferred.

Main entry points: [`yield_curve_pipeline/pipeline.py`](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/pipeline.py) (Forecast pipeline), [`yield_curve_pipeline/prepare_article_summary.py`](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/prepare_article_summary.py) (Article summary), [`yield_curve_pipeline/robustness.py`](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/robustness.py) (Robustness analysis), [`yield_curve_pipeline/serial_correlation.py`](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/serial_correlation.py) (Serial diagnostics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Research inputs"]
  node_yield_inputs["Yield and macro inputs"]
  node_us_raw["US raw series"]
end

subgraph group_forecast["Forecast pipeline"]
  node_pipeline["Forecast pipeline<br/>[pipeline.py]"]
  node_masters["Monthly masters"]
  node_forecast_results["Forecast results"]
end

subgraph group_analysis["Model analysis"]
  node_robustness["Robustness analysis<br/>[robustness.py]"]
  node_robustness_results["Robustness results"]
  node_serial["Serial diagnostics"]
  node_serial_results["Serial results"]
  node_final_diagnostics["Final diagnostics"]
  node_diagnostic_results["Diagnostic results"]
end

subgraph group_reporting["Research outputs"]
  node_summary["Article summary"]
  node_workbook["Workbook export"]
  node_report["Results reporting<br/>[report_results.py]"]
  node_xlsx["Research workbook"]
end

node_researcher(("Researcher"))

node_researcher -->|"runs"| node_pipeline
node_pipeline -->|"reads"| node_yield_inputs
node_pipeline -->|"reads"| node_us_raw
node_pipeline -->|"writes"| node_masters
node_pipeline -->|"writes"| node_forecast_results
node_robustness -->|"uses models"| node_pipeline
node_robustness -->|"reads forecasts"| node_forecast_results
node_robustness -->|"writes"| node_robustness_results
node_serial -->|"uses models"| node_pipeline
node_serial -->|"uses series"| node_robustness
node_serial -->|"writes"| node_serial_results
node_final_diagnostics -->|"loads series"| node_robustness
node_final_diagnostics -->|"uses diagnostics"| node_serial
node_final_diagnostics -->|"writes"| node_diagnostic_results
node_summary -->|"reads metrics"| node_forecast_results
node_summary -->|"reads sensitivity"| node_robustness_results
node_summary -->|"reads diagnostics"| node_serial_results
node_summary -->|"reads tests"| node_diagnostic_results
node_summary -->|"provides payload"| node_workbook
node_workbook -->|"exports"| node_xlsx
node_report -->|"reads results"| node_forecast_results

click node_yield_inputs "https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/data/input"
click node_us_raw "https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/data/raw/us"
click node_pipeline "https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/pipeline.py"
click node_masters "https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/data/processed"
click node_forecast_results "https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/outputs"
click node_robustness "https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/robustness.py"
click node_robustness_results "https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/robustness_outputs"
click node_serial "https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/serial_correlation.py"
click node_serial_results "https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/serial_correlation_outputs"
click node_final_diagnostics "https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/final_diagnostics.py"
click node_diagnostic_results "https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/final_diagnostics_outputs"
click node_summary "https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/prepare_article_summary.py"
click node_workbook "https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/build_article_workbook.mjs"
click node_report "https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/report_results.py"
click node_xlsx "https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/outputs/20260930-yield-evidence"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_yield_inputs,node_us_raw toneBlue
class node_pipeline,node_masters,node_forecast_results toneAmber
class node_robustness,node_robustness_results,node_serial,node_serial_results,node_final_diagnostics,node_diagnostic_results toneMint
class node_summary,node_workbook,node_report,node_xlsx toneRose
class node_researcher toneIndigo
```

## Components

### Research inputs

- [Yield and macro inputs](https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/data/input): `yield_curve_pipeline/data/input`
- [US raw series](https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/data/raw/us): `yield_curve_pipeline/data/raw/us`

### Forecast pipeline

- [Forecast pipeline](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/pipeline.py): `yield_curve_pipeline/pipeline.py`
- [Monthly masters](https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/data/processed): `yield_curve_pipeline/data/processed`
- [Forecast results](https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/outputs): `yield_curve_pipeline/outputs`

### Model analysis

- [Robustness analysis](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/robustness.py): `yield_curve_pipeline/robustness.py`
- [Robustness results](https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/robustness_outputs): `yield_curve_pipeline/robustness_outputs`
- [Serial diagnostics](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/serial_correlation.py): `yield_curve_pipeline/serial_correlation.py`
- [Serial results](https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/serial_correlation_outputs): `yield_curve_pipeline/serial_correlation_outputs`
- [Final diagnostics](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/final_diagnostics.py): `yield_curve_pipeline/final_diagnostics.py`
- [Diagnostic results](https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/final_diagnostics_outputs): `yield_curve_pipeline/final_diagnostics_outputs`

### Research outputs

- [Article summary](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/prepare_article_summary.py): `yield_curve_pipeline/prepare_article_summary.py`
- [Workbook export](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/build_article_workbook.mjs): `yield_curve_pipeline/build_article_workbook.mjs`
- [Results reporting](https://github.com/namfite-1306/yeild-line-/blob/main/yield_curve_pipeline/report_results.py): `yield_curve_pipeline/report_results.py`
- [Research workbook](https://github.com/namfite-1306/yeild-line-/tree/main/yield_curve_pipeline/outputs/20260930-yield-evidence): `yield_curve_pipeline/outputs/20260930-yield-evidence`

### Other components

- **Researcher**

## Connections

- Researcher → Forecast pipeline: runs (evidence: `yield_curve_pipeline/pipeline.py`)
- Forecast pipeline → Yield and macro inputs: reads (evidence: `yield_curve_pipeline/pipeline.py`)
- Forecast pipeline → US raw series: reads (evidence: `yield_curve_pipeline/pipeline.py`)
- Forecast pipeline → Monthly masters: writes (evidence: `yield_curve_pipeline/pipeline.py`)
- Forecast pipeline → Forecast results: writes (evidence: `yield_curve_pipeline/pipeline.py`)
- Robustness analysis → Forecast pipeline: uses models (evidence: `yield_curve_pipeline/robustness.py`)
- Robustness analysis → Forecast results: reads forecasts (evidence: `yield_curve_pipeline/robustness.py`)
- Robustness analysis → Robustness results: writes (evidence: `yield_curve_pipeline/robustness.py`)
- Serial diagnostics → Forecast pipeline: uses models (evidence: `yield_curve_pipeline/serial_correlation.py`)
- Serial diagnostics → Robustness analysis: uses series (evidence: `yield_curve_pipeline/serial_correlation.py`)
- Serial diagnostics → Serial results: writes (evidence: `yield_curve_pipeline/serial_correlation.py`)
- Final diagnostics → Robustness analysis: loads series (evidence: `yield_curve_pipeline/final_diagnostics.py`)
- Final diagnostics → Serial diagnostics: uses diagnostics (evidence: `yield_curve_pipeline/final_diagnostics.py`)
- Final diagnostics → Diagnostic results: writes (evidence: `yield_curve_pipeline/final_diagnostics.py`)
- Article summary → Forecast results: reads metrics (evidence: `yield_curve_pipeline/prepare_article_summary.py`)
- Article summary → Robustness results: reads sensitivity (evidence: `yield_curve_pipeline/prepare_article_summary.py`)
- Article summary → Serial results: reads diagnostics (evidence: `yield_curve_pipeline/prepare_article_summary.py`)
- Article summary → Diagnostic results: reads tests (evidence: `yield_curve_pipeline/prepare_article_summary.py`)
- Article summary → Workbook export: provides payload (evidence: `yield_curve_pipeline/build_article_workbook.mjs`)
- Workbook export → Research workbook: exports (evidence: `yield_curve_pipeline/build_article_workbook.mjs`)
- Results reporting → Forecast results: reads results (evidence: `yield_curve_pipeline/report_results.py`)
