Minh bạch & E-E-A-T
📚Phương pháp & nguồn dữ liệu
Trang này mô tả cách gia.congcutaichinh.org thu thập, kiểm tra và hiển thị giá. Mục tiêu là giúp bạn đánh giá độ tin cậy trước khi dùng số liệu cho quyết định cá nhân.
Lịch cập nhật
Worker tự động chạy qua GitHub Actions theo lịch UTC 0 4,10,22 * * * (= 05:00, 11:00 và 17:00 giờ Việt Nam trên giấy tờ). Free tier GitHub thường trễ 30–90 phút, nên Discord/log thực tế có thể lệch so với giờ lý thuyết. Snapshot vẫn gắn phiên hiển thị 06:00, 12:00 và 18:00 hằng ngày (giờ Việt Nam). Mỗi lần chạy:
- Gọi song song 5 nhóm fetcher (forex, crypto, gold, chứng khoán, xăng dầu).
- Ghi snapshot vào PostgreSQL với
captured_atlàm tròn phiên 06:00 / 12:00 / 18:00 ICT. - Ghi nhật ký vào bảng
fetch_logs(thành công / partial / failed). - Kích hoạt làm mới trang tĩnh (ISR) trên Vercel.
Xem log gần nhất tại Cập nhật dữ liệu.
Bảng nguồn theo nhóm
| Nhóm | Mã | Nguồn | Kiểm tra |
|---|---|---|---|
| Tỷ giá ngoại tệ | USD, EUR, JPY, AUD, SGD, GBP, CNY | Vietcombank — API exchangerates REST JSON theo ngày (`?date=YYYY-MM-DD`). Cron gọi giá ngày hiện tại. | Bỏ qua dòng thiếu giá; so khớp 7 mã chuẩn. |
| Tiền mã hóa | BTC, ETH, USDT, BNB, SOL, XRP, DOGE, ADA | CoinGecko — simple/price REST JSON quy đổi VND + % thay đổi 24h. | Giá VND phải > 0 và hợp lệ số học. |
| Giá vàng | SJC_9999, DOJI_HN, PNJ_HN | giavang.now API; fallback scrape BTMC (SJC) JSON giá hiện tại; SJC fallback HTML nếu thiếu. | 80–250 triệu VND/lượng; ngoài khoảng → không ghi. |
| Chỉ số chứng khoán | VNINDEX, VN30, HNXINDEX, HNX30, UPCOM | CafeF — banggia index JSON snapshot chỉ số sàn (`stockhandler.ashx?index=true`). | Điểm chỉ số trong khoảng hợp lý theo từng mã. |
| Xăng dầu | RON95, RON92, DIESEL | giavang.net — bài giá xăng dầu Scrape regex từ HTML bài viết. | 10.000–35.000 VND/lít. |
Xử lý lỗi & partial
Mỗi nguồn chạy độc lập. Một nguồn lỗi không chặn nguồn khác. Trạng thái partial nghĩa là chỉ lấy được một phần mã (thường gặp ở lãi suất khi website ngân hàng đổi HTML hoặc chặn bot). Khi đó bảng vẫn hiển thị mã thành công; mã thiếu giữ giá snapshot cũ hoặc trống.
Hệ thống gửi cảnh báo Discord (nếu cấu hình) khi có failed/partial. Chúng tôi rà soát định kỳ các nguồn scrape vì đây là rủi ro vận hành lớn nhất.
Lịch sử & backfill
Chart đọc từ bảng price_snapshots. Dữ liệu tích lũy theo cron hằng ngày. Có thể bổ sung quá khứ bằng script backfill (tỷ giá, crypto, vàng 30 ngày) hoặc import CSV thủ công — xem tài liệu kỹ thuật trong repository.
API công khai
Endpoint /api/* chỉ phục vụ website (middleware kiểm tra Origin). Không dành cho tích hợp bên thứ ba. Người dùng cuối nên đọc giá qua trang HTML đã render.