Skip to main content
Version: 1.1.0

Nhật ký thay đổi (Changelog)

Toàn bộ các thay đổi nổi bật của công cụ dòng lệnh erp sẽ được ghi nhận chi tiết tại đây. Dự án tuân thủ chặt chẽ nguyên tắc định danh phiên bản Semantic Versioning.

[1.1.0] - 2026-06-01​

Thêm mới (Added)​

  • Cấu hình tự động kiểm tra phiên bản (Auto-check Update):
    • Thêm thuộc tính AutoCheckVersion vào cấu hình dự án erp-config.yaml (mặc định tắt).
    • Tích hợp Step 11 vào TUI Wizard erp new hỗ trợ người dùng bật/tắt trực tiếp thông qua giao diện terminal.
    • Bổ sung cờ --auto-check-version vào CLI erp new cho phép thiết lập tự động (non-interactive).
    • Hỗ trợ cờ môi trường ERP_SKIP_AUTO_CHECK_STEP: "1" để bỏ qua bước 11 của Wizard, đảm bảo tương thích ngược cho bộ tests cũ.

Thay đổi (Changed)​

  • Quản lý bật/tắt (khôi phục/patch) tính năng check update mặc định của Frappe:
    • Khi tắt tự động check phiên bản (mặc định): CLI tự động patch file hooks.py và desk.js của Frappe Core để comment out sự kiện background checking frappe.utils.change_log.check_for_update và tắt hiển thị popup update trong Web UI Desk, sau đó tự động biên dịch lại Desk assets (bench build).
    • Khi bật tự động check phiên bản: CLI sẽ khôi phục lại nguyên bản (uncomment) các đoạn code gốc của Frappe để trả lại cơ chế mặc định ban đầu, hoàn toàn không tự viết thêm logic CLI để check GitHub remote tags.
    • Tối ưu hóa việc gọi build frontend asset (bench build) chỉ khi có sự thay đổi thực sự ở file desk.js.
    • Toàn bộ quá trình patch mã nguồn đều chạy độc lập trên host/container, không can thiệp hay sửa đổi gì đến custom app theme_base.

[1.0.2] - 2026-05-29​

Thêm mới (Added)​

  • Thực thi lệnh trực tiếp trong Container:
    • Thêm lệnh con erp exec [command] chạy bất kỳ lệnh tùy ý nào trong container backend Docker.
    • Tự động kiểm tra tính hợp lệ của tệp cấu hình erp-config.yaml và kiểm tra lệnh docker trong đường dẫn hệ thống (PATH).
    • Xây dựng bộ test E2E đầy đủ (cli/test/e2e/exec_test.go) để xác thực các trường hợp lệnh dạng chuỗi có/không có dấu nháy và các tình huống lỗi.

Thay đổi (Changed)​

  • Cải tiến Giao diện Dashboard HUD (TUI):
    • Tách giao diện dashboard làm việc thành bố cục 2 cột nằm ngang trực quan.
    • Cột phải hiển thị Logo nghệ thuật ASCII sPhoton, kèm theo siêu dữ liệu của dự án được chọn (slogan, website, maintainer, bản quyền, phiên bản 1.0.2).
    • Bổ sung khung hướng dẫn nhanh "Quick Help" hiển thị các phím tắt điều hướng nhanh gọn.

[1.0.1] - 2026-05-27​

Thêm mới (Added)​

  • Tích hợp SSH Key & Mount Container:
    • Thêm lệnh erp ssh-key import --path <path> để liên kết khóa SSH private của máy host (mặc định tìm tại ~/.ssh).
    • Ánh xạ tự động thư mục .ssh của máy host vào container backend ở chế độ Read-Only (/home/frappe/.ssh) giúp việc clone/pull code các repository custom private diễn ra tự động mà không cần token.
  • Tích hợp GitHub & Tự động đổi URL thông minh:
    • Thêm lệnh erp github login --token <token> lưu mã Personal Access Token (PAT).
    • Áp dụng cơ chế mã hóa đối xứng XOR khóa dựa trên phần cứng hệ điều hành (COMPUTERNAME/USERNAME) để lưu trữ token an toàn tại ~/.erp_github_token (Không lưu clear-text).
    • Tự động phân tích quyền của token đối với repository private và triển khai cơ chế kiểm tra 2 lần khi cài đặt app:
      • Lần 1: Thử clone qua Git SSH / HTTPS thông thường.
      • Lần 2 (dự phòng): Nếu thất bại, tự động chuyển đổi URL Git thành dạng tokenized OAuth2 (https://oauth2:<token>@github.com/...) để vượt qua xác thực.
  • Đóng băng định dạng cấu hình YAML:
    • Lược bỏ cấu hình lựa chọn định dạng JSON/TXT và gộp các bước cài đặt Setup Wizard để mặc định sử dụng duy nhất tệp cấu hình erp-config.yaml.
  • Lệnh dịch thuật nâng cao (export:lang & import:lang):
    • Hỗ trợ xuất/nhập tệp dịch thuật của tất cả các app ra định dạng CSV để dễ biên tập, tự động biên dịch sang .mo và làm sạch cache Desk của site.
  • Mặc định cấu hình thông minh cho Việt Nam (Vietnamese Presets):
    • Tự động cấu hình múi giờ Asia/Ho_Chi_Minh, ngôn ngữ vi, quốc gia Vietnam, tiền tệ VND và định dạng ngày/giờ chuẩn Việt Nam.
    • Tự động vô hiệu hóa các ngôn ngữ khác để tối ưu hóa tốc độ tải trang ban đầu của Desk.

[1.0.0] - 2026-05-24​

Thêm mới (Added)​

  • Interactive TUI Setup Wizard (erp new):
    • Trình cấu hình wizard từng bước trên Terminal.
  • Docker Compose Orchestration (erp run / erp stop):
    • Quản lý vòng đời cụm container, cài đặt bench và thiết lập site tự động.
  • Development Support Tools (erp dev):
    • Hỗ trợ lệnh xem thay đổi watch, khởi động lại máy chủ reload, tương tác nhanh console và tạo app mới create-app.
  • Validation Engine (erp verify):
    • Kiểm tra điều kiện cổng kết nối, quyền thư mục và biến môi trường.
  • Backup & Restore (erp backup / erp restore):
    • Sao lưu và phục hồi cơ sở dữ liệu Frappe.