Skip to main content
Version: 1.0.2

Giới thiệu sPhoton ERP CLI

erp là một công cụ dòng lệnh (CLI/TUI) tương tác, đa nền tảng được thiết kế để khởi tạo, cấu hình, kiểm tra và chạy các môi trường phát triển cũng như vận hành ERPNext.

Công cụ sử dụng trình biên dịch Go tiêu chuẩn kết hợp với Docker Compose để tự động hóa việc cấp phát các Frappe bench cục bộ, cấu hình dịch vụ (MariaDB, Redis, Nginx) và tích hợp các ứng dụng tùy chỉnh.

Các Tính Năng Nổi Bật​

  • Interactive Setup Wizard: Giao diện wizard trực quan, tự động gợi ý giá trị mặc định, kiểm tra tính hợp lệ của dữ liệu ngay trong terminal.
  • Wizard Điều Hướng Hai Chiều: Di chuyển tiến bằng phím Tab / Enter và lùi lại bằng phím Shift+Tab / KeyUp / KeyLeft để chỉnh sửa các lựa chọn trước đó.
  • Cấu Hình Volume Bền Vững (Persisted): Tự động cấu hình các volume Docker Compose (sites, logs, db-data, redis-data) để lưu trữ dữ liệu an toàn.
  • Tích Hợp Ứng Dụng Tùy Chỉnh: Dễ dàng lựa chọn các ứng dụng chuẩn hoặc cấu hình URL repository Git (công khai/riêng tư) để tự động cài đặt ứng dụng tùy chỉnh.
  • Tự Động Build Image Khi Thiếu: Tự động phát hiện lỗi thiếu image erpnext:latest cục bộ và nhắc nhở người dùng tự động build lại thông qua context repository erpdocker.
  • Hệ Thống Kiểm Tra (Verification Engine): So sánh tệp cấu hình cục bộ (erp-config) với tệp cấu hình compose.yml đang hoạt động để kiểm tra cổng kết nối, cơ sở dữ liệu và các ứng dụng.

Bắt Đầu Ngay​

Để tìm hiểu chi tiết cách cài đặt và sử dụng công cụ, vui lòng đọc các hướng dẫn tiếp theo:

  1. Hướng dẫn sử dụng CLI: Hướng dẫn chi tiết các câu lệnh erp new, erp run, erp verify và erp version.
  2. Phát triển Ứng dụng Tùy chỉnh: Hướng dẫn cách tạo và phát triển các Frappe App tùy chỉnh bằng CLI.
  3. Xử lý sự cố (Troubleshooting): Tổng hợp các lỗi thường gặp về Docker daemon, phân quyền, build lỗi và cách khắc phục.