🚀 English Discoveries (ED) Automated Tool v3.0.0

Hệ thống tự động hóa quản lý học tập, giải bài Test 100% điểm và hoàn thành 100% tiến trình bài tập trên nền tảng English Discoveries (ED). Được thiết kế theo mô hình Headless Architecture với giao diện Terminal tương tác trực quan, đa năng và cực kỳ an toàn.

---

🌟 Các tính năng nổi bật ở phiên bản v3.0.0

• 🎯 Real Test Solver Engine (Bóc tách đáp án CDN): Tự động tải và phân tích cấu trúc bài học từ CDN, giải bài Test với số điểm tối đa 100% Average Test Score.
• 📘 Full Practice Progress Engine: Đồng bộ trạng thái bài tập đưa chỉ số Course Completion lên 100%.
• 🖥️ Giao diện Terminal Tương tác (Interactive CLI):
  • Tự động nhập/lưu tài khoản trực tiếp nếu chưa có file accounts.json.
  • Menu lựa chọn Khóa học linh hoạt (Intermediate 1, Intermediate 2, Intermediate 3, Tất cả khóa hoặc Tên khóa học tùy chỉnh).
  • Menu lựa chọn Phạm vi Unit (Tất cả Units, Unit 1 đến Unit 5, hoặc nhập khoảng tùy chọn 1-4, 1,3,5).
  • Menu lựa chọn Chế độ thực thi (Full: Test 100% + Practice 100%, Test Only, Practice Only).
  • Menu lựa chọn Tốc độ xử lý (Cân bằng, Nhanh, An toàn).
• 🛡️ An toàn & Bảo mật tuyệt đối:
  • Chỉ giao tiếp với các Endpoint API chính thức dành riêng cho học viên (https://edwebservices2.engdis.com/api/).
  • Tuyệt đối không can thiệp hay ảnh hưởng tới phía máy chủ hay giao diện quản trị của giáo viên.
  • Tự động hủy phiên làm việc an toàn (Auth/Logout) sau khi nộp bài.
• 🔄 Khả năng chống chịu lỗi mạng (Network Resilience): Tự động thử lại (Retry 3 lần) khi gặp sự cố mạng chập chờn hoặc timeout.

---

📁 Cấu trúc thư mục dự án

ToolED/
├── ed_auto.js            # Mã nguồn chính (Engine v3.0.0 + CLI Terminal Menu)
├── config.json           # Tệp cấu hình các thông số hệ thống
├── accounts.json         # Tệp danh sách tài khoản học viên (Username, Password) — PRIVATE
├── accounts.example.json # Tệp mẫu hướng dẫn cấu hình tài khoản
├── run.bat               # Script khởi chạy nhanh trên Windows
├── report.txt            # Tệp báo cáo tổng hợp kết quả chi tiết sau khi chạy
├── package.json          # Quản lý dependencies (Node.js)
├── package-lock.json     # Tệp khóa phiên bản dependencies
├── LICENSE               # Bản quyền dự án
└── README.md             # Hướng dẫn sử dụng & Nhật ký cập nhật

---

⚙️ 1. Cấu hình hệ thống mặc định (config.json)

Tệp config.json định hình các tùy chọn mặc định ban đầu:

{
  "target_courses": [
    "Intermediate 2",
    "Intermediate 3"
  ],
  "target_units": "all",
  "max_tasks_per_unit": "all",
  "speed_mode": "balanced",
  "auto_logout": true,
  "report_file": "./report.txt",
  "accounts_file": "./accounts.json"
}

---

👤 2. Cấu hình tài khoản (accounts.json)

Bạn có thể tạo tệp accounts.json theo mẫu accounts.example.json hoặc nhập trực tiếp trên Terminal khi khởi chạy tool:

[
  {
    "username": "STUDENT_USERNAME_HERE",
    "password": "STUDENT_PASSWORD_HERE"
  }
]

⚠️ File accounts.json đã được tự động bảo vệ trong .gitignore để tránh rò rỉ thông tin cá nhân.

---

🚀 3. Hướng dẫn khởi chạy ứng dụng

Cách 1: Dùng run.bat (Windows)

Nhấp đôi chuột vào tệp run.bat để mở giao diện Terminal tương tác.

Cách 2: Dùng Terminal / Command Prompt

node ed_auto.js

hoặc:

npm start

---

📊 4. Nhật ký thay đổi & Diễn biến nâng cấp (Changelog)

Version 3.0.0 (Hiện tại)

• Nâng cấp Real Test Solver Engine: Bóc tách đáp án câu hỏi từ CDN để đạt 100% điểm bài Test (finalMark: 100).
• Thêm Menu tương tác CLI: Cho phép người dùng tùy chọn khóa học, phạm vi unit, chế độ thực thi và nhập tài khoản/mật khẩu trực tiếp.
• Tối ưu hóa khả năng ổn định: Thêm cơ chế tự động kết nối lại (Retry) khi gặp lỗi mạng (ENOTFOUND, Timeout).
• Cập nhật giao diện Terminal: Banner ANSI sắc nét, khung bảng tổng hợp chi tiết theo từng Unit và ProgressBar sống động.

Version 1.1.0 & Earlier

• Xây dựng kiến trúc Headless Architecture cơ bản.
• Hỗ trợ cập nhật tiến trình bài tập Practice.
• Khung hiển thị bảng tổng hợp kết quả và bộ bắt lỗi toàn cục.

---

📩 Bản quyền & Tác giả

Dự án được thiết kế và phát triển bởi Đào Công Đạt.
Mọi đóng góp hoặc thắc mắc về dự án vui lòng liên hệ qua GitHub repository maintainer.