Cách hoạt động

Tóm tắt một dòng

Mỗi tuần, routine ghé WinMart (và Bách Hóa Xanh khi có thể), lấy giá của 40 mặt hàng cố định, tính ra một chỉ số giá (mốc 100 ở tuần đầu), rồi dựng lại trang này bằng dữ liệu thật.

5 bước mỗi tuần

• 1. Thu thập giá — Lấy giá qua API nội bộ của siêu thị (nhanh, dễ đọc). Lấy cả giá niêm yết và giá khuyến mãi, rồi quy về đơn giá chuẩn (đ/kg, đ/lít, đ/quả) để so sánh công bằng.
• 2. Kiểm tra — Soát lỗi: giá nhảy quá 50% so với tuần trước bị nghi là lỗi và loại; hàng hết được giữ giá cũ tối đa 2 tuần. Mọi quyết định đều ghi log.
• 3. Tính chỉ số — Trung bình có trọng số của tỷ lệ giá tuần này / giá tuần đầu (Laspeyres đơn giản). Tính riêng BHX, WinMart và chỉ số chung.
• 4. Dựng trang — Ghi thẳng số liệu thật vào trang (thẻ chỉ số, rổ hàng, biểu đồ, nhận xét). Không gọi dữ liệu động ở trình duyệt — trang là HTML tĩnh đã có sẵn số.
• 5. Xuất bản — Commit lên GitHub, GitHub Pages tự deploy.

Vì sao dùng agent thay vì script cứng?

Khi một mặt hàng biến mất hoặc đổi đường dẫn, agent có thể tìm sản phẩm thay thế cùng nhóm, cùng quy cách, cập nhật rổ hàng kèm ghi chú, và nối chuỗi giá để chỉ số không bị nhảy bậc. Script thường chỉ báo lỗi rồi dừng.

Minh bạch

Toàn bộ mã nguồn, rổ hàng, log thu thập và lịch sử chỉ số đều công khai trên GitHub. Trang Phương pháp luận giải thích rổ hàng, trọng số và công thức chi tiết.