Kiến Trúc

Request Pipeline → Transform Pipeline → Output (Array of Objects)

API Call
  │
  ▼
┌──────────┐
│  Fetch   │  ← HTTP client (axios), GET/POST/GraphQL
└────┬─────┘
     ▼
┌──────────┐
│  Retry   │  ← 2 lần retry, exponential backoff (5xx, timeout)
└────┬─────┘
     ▼
Raw Response

Raw Response
  │
  ▼
┌──────────┐
│ 1. Parse │  ← Xử lý JSON, edge cases (empty, malformed)
└────┬─────┘
     ▼
┌──────────┐
│ 2. Clean │  ← Loại bỏ null/undefined, fields thừa
└────┬─────┘
     ▼
┌──────────┐
│ 3.Rename │  ← Map field names → camelCase tiếng Anh
└────┬─────┘
     ▼
┌───────────┐
│ 4.Normalize│ ← Chuẩn hóa nghiệp vụ VN
│  (VN Biz) │    - Giá ÷ 1000 (đơn vị: nghìn VND)
│           │    - Timestamp → "2024-01-15"
│           │    - Percentage → decimal (0.15)
└────┬──────┘
     ▼
┌──────────┐
│ 5. Shape │  ← Chuyển thành Array of Objects
└────┬─────┘
     ▼
QuoteHistory[] | PriceBoardItem[] | ...

src/
├── core/               # Business logic
│   ├── stock/          # Quote, Trading, Company, Financial, Listing, Screening
│   ├── commodity/      # Gold, Exchange rates
│   └── realtime.ts     # WebSocket
├── indicators/         # SMA, EMA, RSI (pure functions)
├── pipeline/           # Request + Transform pipeline
│   ├── fetch.ts        # HTTP client with retry
│   ├── transform.ts    # applyTransform()
│   └── transform/configs/  # Per-module transform rules
├── models/             # TypeScript interfaces
├── shared/             # Constants, utilities
├── simple.ts           # Simplified API wrapper
├── runtime.ts          # Vnstock class
└── index.ts            # Main exports