Folder đã thiết lập
Nhận nguyên folder monthly-data-hoianese, giữ nguyên cấu trúc agent, database, dashboard, guide.
Mục tiêu của bản guide
Bản này không thay thế file vận hành chi tiết. Nó là lớp trực quan để người mới hiểu nhanh thứ tự việc cần làm khi chỉ dùng Antigravity.
Antigravity làm trung tâm
Dùng Antigravity để mở workspace, đọc tài liệu, điều phối việc sửa guide, kiểm tra local và hỗ trợ xử lý dữ liệu.
Dashboard và backup
Số liệu được cập nhật trong Excel/dashboard, sau đó lưu bản backup lên Google Drive để bàn giao nội bộ.
7 bước làm việc chỉ với Antigravity
Mỗi bước có một kết quả quan sát được. Nếu chưa có kết quả đó, chưa chuyển sang bước kế tiếp.
1
Cài và đăng nhập
Tải Antigravity, đăng nhập Gmail, chọn chế độ review trước khi agent sửa file.
2
Mở workspace
Chọn folder monthly-data-hoianese làm workspace chính.
3
Đọc tài liệu
Yêu cầu agent đọc README.md, guide/guide.md, guide/workflow.md.
4
Nạp dữ liệu ngày
Đưa file nguồn vào đúng folder database/TMM_YYYY/TraiNghiem_YYYYMMDD.
5
Yêu cầu xử lý
Bảo agent chạy cập nhật ngày/tháng, sau đó build dashboard.
6
Kiểm tra số liệu
Mở dashboard, Excel và log để đối chiếu dữ liệu mới.
7
Bàn giao nội bộ
Lưu backup, ghi chú kết quả xử lý và chuyển link/folder nội bộ cho người phụ trách.
Quy trình vận hành hằng ngày
Đây là luồng thao tác dành cho người phụ trách dữ liệu. Antigravity chỉ đóng vai trò trợ lý kiểm tra và chạy lệnh khi cần.
Cuối ngày
Tải file nguồn
Tải file Booking PDF, Agoda DOCX, EZBE DOCX, bảng kê dịch vụ BK DV XLSX và các file RAR nếu có.
Đưa vào local
Đặt file đúng folder ngày
Ví dụ ngày 19/05/2026 đặt vào database/T05_2026/TraiNghiem_20260519/.
Chạy cập nhật
Dùng dashboard hoặc nhờ Antigravity chạy lệnh
Ưu tiên mở http://localhost:8765, chọn tháng, bấm Cập nhật dữ liệu, rồi bấm Build Dashboard.
Lưu backup
Copy dữ liệu đã xử lý lên Google Drive
Copy folder ngày, file TMM_YYYY_tonghop.xlsx và dashboard tháng nếu cần chia sẻ nội bộ.
Mẫu prompt dùng ngay trong Antigravity
Prompt tốt phải nói rõ bối cảnh, mục tiêu, phạm vi, dữ liệu mẫu, tiêu chí đúng và ràng buộc an toàn.
Khi muốn sửa guide
Hãy đọc README.md, guide/guide.md và guide/workflow.md để hiểu flow.
Mục tiêu: cập nhật tài liệu vận hành cho nhân sự bằng tiếng Việt rõ ràng.
Chỉ sửa file trong guide/, không sửa agent/ và không sửa database/.
Sau khi sửa, tóm tắt file đã thay đổi và các điểm cần lưu ý.
Khi muốn chạy một ngày
Hãy kiểm tra dữ liệu ngày 19-05-2026.
Trước tiên xác nhận folder database/T05_2026/TraiNghiem_20260519 có file nguồn.
Sau đó chạy xử lý ngày và build dashboard tháng 05-2026.
Báo cáo số record thêm mới, số record bị skip và flag nếu có.
Không dùng lệnh tạo file trống hoặc verify-flow nếu chưa hỏi tôi.
Khi dashboard chưa đúng
Dashboard sau khi cập nhật chưa đổi số liệu.
Hãy đọc log mới nhất trong agent/logs, kiểm tra luồng server và build dashboard.
Giải thích nguyên nhân dễ hiểu trước khi sửa.
Nếu cần sửa code, chỉ sửa phần liên quan nhỏ nhất và chạy lại kiểm tra.
Khi muốn chuẩn bị cho nhân sự khác
Hãy rà soát folder bàn giao cho nhân sự mới.
Kiểm tra README.md, guide/guide.md, guide/workflow.md và bản HTML trực quan.
Xác nhận không có dữ liệu nhạy cảm trong tài liệu hướng dẫn.
Sau khi xong, tóm tắt những file cần chuyển và các bước người nhận cần làm đầu tiên.
Kiểm tra trước khi xác nhận hoàn tất
Một lần cập nhật chỉ nên được coi là xong khi cả dữ liệu, dashboard, log và backup đều ổn.
| Hạng mục | Cách kiểm tra | Đạt khi |
|---|---|---|
| Dữ liệu ngày | Mở folder ngày trong database |
Có đủ file nguồn, không còn file tải dở |
| Excel tổng hợp | Mở TMM_YYYY_tonghop.xlsx |
Dòng mới xuất hiện đúng sheet |
| Dashboard | Mở http://localhost:8765 |
Chỉ số tháng đã cập nhật |
| Log | Xem file mới nhất trong agent/logs |
Không có lỗi parse nghiêm trọng |
| Backup | Kiểm tra Google Drive | Đã có bản copy folder ngày và Excel tháng |
Nguồn tham khảo
Giữ lại link nguồn để nhân sự kiểm tra khi cài lại máy hoặc chuyển người phụ trách.
| Công cụ | Link |
|---|---|
| Google Antigravity Codelab | codelabs.developers.google.com/getting-started-google-antigravity |
| Antigravity download | antigravity.google/download |