Bức tranh hiện tại
Quy trình thủ công đang gặp vấn đề gì?
Mỗi tháng vào ngày 03, nhân sự lặp đi lặp lại cùng thao tác cho từng cửa hàng, tốn thời gian và dễ nhầm lẫn.
Tốn nhiều giờ
Đăng nhập từng tài khoản, chờ tải trang, chép số, nhập Excel, lưu ảnh... lặp lại cho mỗi cửa hàng. Dễ chiếm cả buổi sáng.
Thao tác lặp lại
Mở link → đăng nhập → chép số → nhập Excel → lưu ảnh. Không thay đổi từ tháng này qua tháng khác.
Dễ nhầm lẫn
Sai tháng, sai cột, nhầm cửa hàng, ghi đè công thức tự tính. Một sai sót nhỏ → báo cáo sai cả tháng.
Không nhất quán
Mỗi người lưu bằng chứng theo cách riêng. Không có chuẩn đặt tên file, không có backup tự động.
⏱ So sánh thời gian thực tế (toàn bộ cửa hàng)
💡 Giải pháp: Antigravity Agent đảm nhận toàn bộ phần lặp lại. Bạn chỉ cần thiết lập một lần và ra lệnh mỗi tháng. Xem hướng dẫn chi tiết ở tab Thiết Lập & Chạy Lần Đầu →
Hướng dẫn onboarding
Thiết lập lần đầu và chạy thử
Thực hiện đầy đủ một lần. Sau đó mỗi tháng chỉ mất 10–15 phút với tab Chạy nhanh.
Giai đoạn A — Tài khoản và quyền truy cập
A1
Nhận bàn giao file Excel chính
Làm 1 lần
Liên hệ người bàn giao để nhận file Thông tin điện evn các chi nhánh.xlsx và thư mục evn-data/. Đặt file vào đúng vị trí trong hệ thống workspace.
⚠️ File này chứa thông tin đăng nhập EVN của tất cả cửa hàng. Không chia sẻ qua email, Zalo, hoặc lưu trên cloud cá nhân.
Kiểm tra file có đủ 2 sheet quan trọng không:
| Sheet | Mục đích | Cột quan trọng |
|---|---|---|
| Tài khoản xem điện | Danh sách tài khoản đăng nhập EVN từng cửa hàng | C (Mã KH), D (ID), E (PW), F (Link) |
| Theo dõi điện | Nơi nhập dữ liệu hóa đơn hàng tháng | Block theo cửa hàng, cột theo tháng |
A2
Hiểu cấu trúc thư mục làm việc
Làm 1 lần
Toàn bộ tài liệu và công cụ nằm trong thư mục evn-data/. Cấu trúc chuẩn:
evn-data/
├── Thông tin điện evn các chi nhánh.xlsx ← FILE CHÍNH
├── 00_quy-trinh/ ← SOP và sơ đồ dữ liệu
├── 01_mau-thao-tac/ ← Checklist và hướng dẫn nhập liệu
├── 02_nhat-ky-thang/ ← Nhật ký tự tạo mỗi tháng
│ └── YYYY-MM_nhat-ky-lay-hoa-don.csv
├── 03_bang-chung/ ← Bằng chứng hóa đơn lưu theo tháng
│ └── YYYY-MM/
├── 04_loi-can-xu-ly/ ← Ghi lỗi cần xử lý thêm
└── 06_automation/
└── skills/evn-bill-entry/scripts/
└── evn_workflow.py ← Script tự động hoá
├── Thông tin điện evn các chi nhánh.xlsx ← FILE CHÍNH
├── 00_quy-trinh/ ← SOP và sơ đồ dữ liệu
├── 01_mau-thao-tac/ ← Checklist và hướng dẫn nhập liệu
├── 02_nhat-ky-thang/ ← Nhật ký tự tạo mỗi tháng
│ └── YYYY-MM_nhat-ky-lay-hoa-don.csv
├── 03_bang-chung/ ← Bằng chứng hóa đơn lưu theo tháng
│ └── YYYY-MM/
├── 04_loi-can-xu-ly/ ← Ghi lỗi cần xử lý thêm
└── 06_automation/
└── skills/evn-bill-entry/scripts/
└── evn_workflow.py ← Script tự động hoá
📌 Thư mục
02_nhat-ky-thang/ và 03_bang-chung/ sẽ tự tạo file mới mỗi tháng khi chạy lệnh. Bạn không cần tạo tay.A3
Kiểm tra danh sách cửa hàng và tài khoản
Làm 1 lần
Mở sheet Tài khoản xem điện, đọc qua từng dòng và xác nhận:
- Cột B là tên cửa hàng, đọc qua để làm quen, không cần nhớ hết.
- Cột C là mã KH, tức mã định danh duy nhất của từng cửa hàng tại EVN.
- Cột D và E là ID và mật khẩu đăng nhập, không copy ra nơi khác.
- Cột F là đường link trang xem điện của cửa hàng, bấm thử 1–2 link xem có mở được không.
- Cột G là ghi chú, đọc xem có cửa hàng nào đặc biệt (tự đo, đang lỗi...) không.
⚠️ Nếu có dòng nào thiếu link hoặc thiếu ID/PW, ghi chú ngay vào cột G và báo người quản lý để bổ sung trước khi chạy.
Giai đoạn B — Cài đặt công cụ
B1
Cài đặt Antigravity IDE
Làm 1 lần
Antigravity là công cụ AI Agent bạn sẽ dùng để ra lệnh cho hệ thống tự động chạy workflow. Nhận link cài đặt từ Bửu Trung.
Sau khi cài xong, mở Antigravity và mở đúng workspace thư mục evn-data/.
💡 Nếu bạn đang đọc tài liệu này trong Antigravity IDE thì bước này đã hoàn thành.
B2
Cài đặt Python
Làm 1 lần
Python là ngôn ngữ mà script tự động sử dụng. Bạn không cần biết lập trình, chỉ cần cài như cài ứng dụng bình thường.
Bước 1: Tải Python tại python.org/downloads, chọn phiên bản mới nhất và cài bình thường (Next, Next, Install).
Bước 2: Mở Terminal (Mac: Spotlight, gõ "Terminal") và kiểm tra:
TERMINAL — kiểm tra Python
python3 --version# Nếu thấy "Python 3.x.x" → OK
⚠️ Nếu không thấy Python, hãy đóng Terminal, mở lại và thử lại. Nếu vẫn không được thì liên hệ Bửu Trung để được hỗ trợ.
B3
Cài thư viện cần thiết
Làm 1 lần
Chạy lệnh sau trong Terminal. Chờ khoảng 1–2 phút để cài xong:
TERMINAL
pip3 install openpyxl requests
✅ Thành công nếu cuối cùng thấy: Successfully installed openpyxl... requests...
Giai đoạn C — Chạy thử lần đầu với Antigravity
C1
Kiểm tra workbook
⚡ Tự động
Chạy lệnh này để xác nhận script đọc được file Excel và thấy 2 sheet cần thiết. Đây là lệnh kiểm tra an toàn, không thay đổi gì trong file.
TERMINAL — chạy từ thư mục gốc workspace
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py inspect \--workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx"
✅ Sheet "Tài khoản xem điện": tìm thấy, N dòng
✅ Sheet "Theo dõi điện": tìm thấy
✅ Sheet "Theo dõi điện": tìm thấy
⚠️ Nếu thấy lỗi "File not found", kiểm tra bạn đang đứng đúng thư mục workspace chưa. Hỏi Bửu Trung nếu cần.
C2
Tạo nhật ký tháng đầu tiên
⚡ Tự động
Lệnh này tạo file CSV danh sách tất cả cửa hàng và tạo thư mục bằng chứng cho tháng. Thay 2026-06 bằng tháng đang làm.
TERMINAL
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py init-month \--workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx" \
--month 2026-06
✅ Tạo: evn-data/02_nhat-ky-thang/2026-06_nhat-ky-lay-hoa-don.csv
✅ Tạo thư mục: evn-data/03_bang-chung/2026-06/
✅ Tạo thư mục: evn-data/03_bang-chung/2026-06/
Mở file CSV vừa tạo để xem danh sách cửa hàng. Cột trang_thai của tất cả dòng phải là Chua lam.
C3
Thử đăng nhập (probe-login)
🔍 Kiểm tra
Bước này thử đăng nhập từng tài khoản để phát hiện trước những cửa hàng bị lỗi mật khẩu hoặc tài khoản hết hạn. Chạy trước để biết cần xử lý gì thủ công.
TERMINAL
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py probe-login \--workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx" \
--journal "evn-data/02_nhat-ky-thang/2026-06_nhat-ky-lay-hoa-don.csv"
Đọc kết quả: dòng nào Lỗi, ghi vào cột Ghi chú của nhật ký CSV để xử lý tay sau.
C4
Tự động lấy hóa đơn EVNHCMC
⚡ Tự động
Agent tự đăng nhập từng tài khoản EVNHCMC, tìm hóa đơn tháng cần lấy, ghi lại số tiền, kWh, kỳ ghi nhận và lưu bằng chứng. Bạn chỉ cần chờ.
TERMINAL
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py collect-evnhcmc-bills \--workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx" \
--journal "evn-data/02_nhat-ky-thang/2026-06_nhat-ky-lay-hoa-don.csv" \
--month 2026-06
✅ Đăng nhập và lấy dữ liệu tự động
✅ Lưu bằng chứng vào evn-data/03_bang-chung/2026-06/
✅ Không in mật khẩu ra log
✅ Lưu bằng chứng vào evn-data/03_bang-chung/2026-06/
✅ Không in mật khẩu ra log
📌 Lưu ý: nếu cổng EVN yêu cầu OTP hoặc CAPTCHA, agent sẽ dừng lại và thông báo để bạn xử lý bước đó theo cách thủ công.
C5
Kiểm tra nhật ký trước khi nhập Excel
🔍 Kiểm tra
Bước này báo cáo những dòng sẵn sàng nhập và những dòng cần xử lý tay. Không bỏ qua bước này vì đây là bước kiểm tra an toàn cuối cùng trước khi ghi vào Excel.
TERMINAL
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py validate-journal \--journal "evn-data/02_nhat-ky-thang/2026-06_nhat-ky-lay-hoa-don.csv"
Ý nghĩa các trạng thái:
Da lay
Da nhap
Chua co hoa don
Loi dang nhap
Khong tim thay ma KH
Can doi chieu
Chỉ dòng Da lay mới được nhập vào Excel ở bước tiếp theo. Dòng lỗi, xem Tab Xử lý lỗi.
C6
Nhập dữ liệu vào Excel (apply)
⚡ Tự động
Lệnh này chỉ nhập các dòng đã có đủ số tiền và kWh. Hệ thống tự tạo backup file Excel trước khi ghi, vì vậy bạn có thể phục hồi bất cứ lúc nào nếu có sự cố.
TERMINAL
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py apply-journal \--workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx" \
--journal "evn-data/02_nhat-ky-thang/2026-06_nhat-ky-lay-hoa-don.csv" \
--month 2026-06
✅ Nhập thành công vào sheet "Theo dõi điện"
✅ Backup tự động tạo: xlsx.bak-YYYYMMDD-HHMMSS
✅ Backup tự động tạo: xlsx.bak-YYYYMMDD-HHMMSS
C7
Kiểm tra kết quả trong Excel
🔍 Kiểm tra
Mở file Excel, vào sheet Theo dõi điện, tìm các cửa hàng vừa nhập và kiểm tra:
- Dòng KWh điện sử dụng đã có số chưa?
- Dòng Tổng hoá đơn đã có số chưa?
- Dòng Số ngày ghi nhận tự tính ra 20–31 ngày là đúng.
- Dòng Trung bình tiền/ngày và Trung bình điện/ngày có số hợp lý không?
- Dòng Check số Max không có cảnh báo bất thường.
- Thư mục 03_bang-chung/YYYY-MM/ có đủ file bằng chứng cho mỗi cửa hàng không?
Hoặc dùng một lệnh chat duy nhất
💬 Gõ thẳng vào Antigravity Chat, không cần Terminal
Dùng skill evn-bill-entry trong workspace này.
Tháng: 2026-06
Workbook: evn-data/Thông tin điện evn các chi nhánh.xlsx
Chạy toàn bộ workflow EVN hằng tháng:
1. Kiểm tra workbook, xác nhận 2 sheet
2. Tạo nhật ký tháng 2026-06
3. Thử đăng nhập tất cả tài khoản
4. Lấy hóa đơn EVNHCMC: số tiền, kWh, kỳ ghi nhận
5. Lưu bằng chứng vào 03_bang-chung/2026-06/
6. Kiểm tra nhật ký
7. Nhập dữ liệu hoàn tất vào sheet Theo dõi điện
8. Báo cáo: dòng xong, dòng cần xử lý tay, đường dẫn backup
Không in mật khẩu trong báo cáo.
Tháng: 2026-06
Workbook: evn-data/Thông tin điện evn các chi nhánh.xlsx
Chạy toàn bộ workflow EVN hằng tháng:
1. Kiểm tra workbook, xác nhận 2 sheet
2. Tạo nhật ký tháng 2026-06
3. Thử đăng nhập tất cả tài khoản
4. Lấy hóa đơn EVNHCMC: số tiền, kWh, kỳ ghi nhận
5. Lưu bằng chứng vào 03_bang-chung/2026-06/
6. Kiểm tra nhật ký
7. Nhập dữ liệu hoàn tất vào sheet Theo dõi điện
8. Báo cáo: dòng xong, dòng cần xử lý tay, đường dẫn backup
Không in mật khẩu trong báo cáo.
Từ tháng thứ 2 trở đi
Chạy nhanh hàng tháng
Đã thiết lập xong. Mỗi tháng chỉ cần làm 3 việc theo thứ tự này.
1
Cập nhật tháng
Đổi YYYY-MM thành tháng hiện tại trong tất cả lệnh bên dưới.
Ví dụ tháng 7/2026 → đổi thành 2026-07
2
Chạy 5 lệnh theo thứ tự
Lần lượt: init-month → probe-login → collect-evnhcmc-bills → validate-journal → apply-journal
3
Kiểm tra & xử lý lỗi
Đọc kết quả validate, xử lý tay các dòng lỗi, mở Excel kiểm tra dữ liệu đã vào đúng chưa.
Copy & chạy
5 Lệnh Copy Sẵn
Thay YYYY-MM → tháng đang làm rồi chạy lần lượt trong Terminal.
①
Tạo nhật ký tháng mới
⚡ Tự động
~10 giây
copy và chạy, đổi YYYY-MM trước
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py init-month --workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx" --month YYYY-MM
②
Thử đăng nhập tất cả tài khoản
🔍 Kiểm tra
~2–3 phút
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py probe-login --workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx" --journal "evn-data/02_nhat-ky-thang/YYYY-MM_nhat-ky-lay-hoa-don.csv"
③
Lấy hóa đơn EVNHCMC tự động
⚡ Tự động
~10–20 phút
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py collect-evnhcmc-bills --workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx" --journal "evn-data/02_nhat-ky-thang/YYYY-MM_nhat-ky-lay-hoa-don.csv" --month YYYY-MM
④
Kiểm tra nhật ký
🔍 Kiểm tra
~5 giây
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py validate-journal --journal "evn-data/02_nhat-ky-thang/YYYY-MM_nhat-ky-lay-hoa-don.csv"
Đọc kết quả, xử lý tay các dòng lỗi nếu có (xem tab Xử lý lỗi). Khi không còn dòng cần xử lý thì chạy lệnh ⑤.
⑤
Nhập vào Excel & hoàn thành
⚡ Tự động
~1 phút
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py apply-journal --workbook "evn-data/Thông tin điện evn các chi nhánh.xlsx" --journal "evn-data/02_nhat-ky-thang/YYYY-MM_nhat-ky-lay-hoa-don.csv" --month YYYY-MM
✅ Nhập xong → Mở Excel kiểm tra sheet Theo dõi điện → Lưu file → Xong!
Cách nhanh nhất
Một lệnh chat, không cần Terminal
Gõ đoạn dưới đây vào chat Antigravity. Agent sẽ tự chạy tất cả 5 bước trên.
💬 Antigravity Chat, copy và đổi tháng rồi gửi
Dùng skill evn-bill-entry.
Tháng: YYYY-MM
Workbook: evn-data/Thông tin điện evn các chi nhánh.xlsx
Chạy full workflow: init-month → probe-login → collect-evnhcmc-bills → validate-journal → apply-journal. Báo cáo kết quả. Không in mật khẩu.
Tháng: YYYY-MM
Workbook: evn-data/Thông tin điện evn các chi nhánh.xlsx
Chạy full workflow: init-month → probe-login → collect-evnhcmc-bills → validate-journal → apply-journal. Báo cáo kết quả. Không in mật khẩu.
Tình huống ngoài dự kiến
Xử lý khi có lỗi
Agent sẽ dừng và báo khi gặp tình huống cần người xử lý. Dưới đây là cách giải quyết từng loại.
| Trạng thái lỗi | Nguyên nhân thường gặp | Cách xử lý |
|---|---|---|
| Loi dang nhap | Mật khẩu hết hạn, tài khoản bị khóa sau nhiều lần sai, hoặc cổng EVN yêu cầu OTP | Thử đăng nhập thủ công bằng ID/PW trong file Excel để xác nhận lỗi. Cập nhật mật khẩu mới vào cột E nếu đã đổi. Ghi vào 04_loi-can-xu-ly/. |
| Khong tim thay ma KH | Tên cửa hàng trong "Tài khoản xem điện" khác tên block trong "Theo dõi điện", hoặc block cửa hàng chưa được tạo | Đối chiếu bằng Mã KH (cột C) thay vì tên. Nếu block chưa có → báo Admin tạo thêm trong sheet "Theo dõi điện". Ghi vào 04_loi-can-xu-ly/. |
| Chua co hoa don | EVN chưa phát hành hóa đơn tháng này (thường xảy ra đầu tháng) | Để trống ô trong Excel, không nhập số 0. Quay lại kiểm tra sau 3–5 ngày rồi chạy lại từ bước collect. |
| Can doi chieu | Số tiền hoặc kWh bất thường so với các tháng trước (quá cao/thấp) | Nhập đúng số liệu trên hóa đơn (không tự điều chỉnh). Ghi chú "Cần kiểm tra" và báo trưởng nhóm xem lại hóa đơn gốc. |
| CAPTCHA / OTP | Cổng EVN yêu cầu xác minh người dùng thực, agent không thể thực hiện thay | Agent dừng lại và thông báo. Bạn mở trình duyệt, đăng nhập thủ công, hoàn thành xác minh. Sau đó ghi kết quả vào nhật ký bằng lệnh record-result. |
Nhập tay 1 cửa hàng
Cập Nhật Nhật Ký Sau Khi Xử Lý Tay
Sau khi tự lấy hóa đơn thủ công, dùng lệnh này để ghi kết quả vào nhật ký rồi mới chạy apply-journal.
Thay --stt bằng số thứ tự cửa hàng trong nhật ký CSV:
TERMINAL, ví dụ cửa hàng STT 5
python3 evn-data/06_automation/skills/evn-bill-entry/scripts/evn_workflow.py record-result \--journal "evn-data/02_nhat-ky-thang/YYYY-MM_nhat-ky-lay-hoa-don.csv" \
--stt 5 \
--status "Da lay" \
--amount 15000000 \
--kwh 3500 \
--start-date YYYY-MM-01 \
--end-date YYYY-MM-30 \
--evidence "evn-data/03_bang-chung/YYYY-MM/YYYY-MM_005_TenCuaHang_MaKH.pdf"
FAQ
Câu Hỏi Thường Gặp
Tôi không biết dùng Terminal, có làm được không?
+
Hoàn toàn được. Dùng cách "Một lệnh chat" ở tab Chạy nhanh, chỉ cần copy đoạn text, đổi tháng và gửi vào chat Antigravity. Agent sẽ tự mở Terminal và chạy thay bạn.
Agent có lưu hoặc tiết lộ mật khẩu không?
+
Không. Mật khẩu chỉ được đọc từ workbook trong lúc chạy, không in ra log, không lưu vào bất kỳ file nào khác, không xuất hiện trong báo cáo. Đây là quy tắc cứng của skill evn-bill-entry.
Nếu Agent nhập sai vào Excel thì làm thế nào?
+
Trước khi ghi vào Excel, lệnh apply-journal tự tạo file backup (đặt tên theo ngày giờ chạy). Tìm file có đuôi .bak trong thư mục evn-data/, đổi tên bỏ .bak để phục hồi. Liên hệ Bửu Trung nếu cần hỗ trợ.
Có dùng được cho cổng điện khác ngoài EVNHCMC không?
+
Hiện tại lệnh collect-evnhcmc-bills chỉ hỗ trợ tự động cho EVNHCMC. Các cổng khác (EVNSPC, EVNHANOI, CPC, NPC) cần xử lý thủ công và ghi kết quả bằng lệnh record-result.
Ngày 03 rơi vào cuối tuần, làm ngày nào?
+
Làm vào ngày làm việc gần nhất (ngày 04 hoặc ngày 02). Quan trọng là nhập đúng tháng cần báo cáo, không phải ngày thực hiện. Kiểm tra EVN đã có hóa đơn tháng đó chưa trước khi chạy.
Nhật ký tháng cũ lưu ở đâu và bao lâu?
+
Nhật ký lưu tại evn-data/02_nhat-ky-thang/ với tên YYYY-MM_nhat-ky-lay-hoa-don.csv. Bằng chứng lưu tại evn-data/03_bang-chung/YYYY-MM/. Sau khi hoàn thành có thể chuyển sang evn-data/05_luu-tru-da-xong/ để lưu trữ.