@ejsc/ma-cli 🚀

The Professional Orchestration Tool for 365 Mini App Development.

ejsc-ma-cli không chỉ là một công cụ khởi tạo, nó là trái tim của hệ sinh thái 365 Mini App. Được thiết kế để tối ưu hóa hiệu suất lập trình viên, CLI cung cấp trải nghiệm phát triển đồng bộ từ lúc tạo dự án, debug Real-time cho đến khi triển khai Production.

📑 Mục lục

• Yêu cầu hệ thống
• Cài đặt nhanh
• Hướng dẫn sử dụng
  • ejsc create
  • ejsc dev
  • ejsc build
• Tính năng nâng cao
• Cấu trúc dự án
• Liên hệ

💻 Yêu cầu hệ thống

• Node.js: Phiên bản 20.14.0 hoặc cao hơn (Khuyên dùng LTS).
• Package Manager: pnpm (khuyên dùng để tối ưu tốc độ và dung lượng) hoặc npm/yarn.

🚀 Cài đặt nhanh

# Cài đặt toàn cục qua pnpm
pnpm add -g ejsc-ma-cli

# Kiểm tra cài đặt thành công
ejsc --version

📖 Hướng dẫn sử dụng

1. ejsc create - Khởi tạo dự án

Bắt đầu một dự án mới với cấu hình chuẩn doanh nghiệp chỉ trong vài giây.

ejsc create [project-name]

[!TIP] Lệnh này sẽ tự động thiết lập:

• Naming Convention: Chuẩn hóa tên gói và App ID.
• Smart Dependencies: Tự động cài đặt các thư viện lõi ejsc-ma-api, ejsc-ma-component.
• TailwindCSS V4: Cấu hình sẵn hệ thống styling hiện đại nhất.

2. ejsc dev - Phát triển Real-time

Khởi chạy môi trường lập trình tương tác cao với khả năng kết nối thiết bị thật.

ejsc dev [options]

Các tùy chọn (Options):

• -p, --port <number>: Chỉ định cổng chạy dev server (Mặc định: 6060).
• --network: Mở rộng quyền truy cập server ra mạng nội bộ (Dùng để test trên điện thoại thật).

3. ejsc build - Đóng gói tối ưu

Tạo bản build Production đạt chuẩn Performance của 365 Super App.

ejsc build

Quy trình build bao gồm:

1. Type Checking: Đảm bảo an toàn dữ liệu với TypeScript.
2. Asset Optimization: Minify CSS/JS và nén ảnh.
3. Bundle Analysis: Đảm bảo kích thước gói tin Mini App luôn ở mức tối thiểu.

🏗️ Tính năng nâng cao

🔗 Integrated Bridge Simulator

CLI tích hợp sẵn một Simulator Browser giúp bạn test các API Native (Location, Camera, Biometrics, Storage) mà không cần deploy lên thiết bị thật.

📡 Live Log Relay

Tính năng độc quyền cho phép đẩy Logs từ WebView trên điện thoại về Terminal của máy tính thông qua WebSocket. Bạn sẽ không còn phải vất vả dùng Chrome Inspect khi debug trên thiết bị.

🧩 Plugin Architecture

Hệ thống cho phép mở rộng các tính năng của CLI thông qua cấu hình ejsc.config.ts trong tương lai.

📂 Cấu trúc dự án mẫu

Một dự án được tạo ra bởi CLI tuân thủ nghiêm ngặt mô hình Atomic Design tinh giản:

src/
├── bridge/      # Logic cầu nối Native & Mock data
├── components/  # Các UI Primitives (Button, Input, Card...)
├── constants/   # Quản lý API Endpoints và Config
├── layouts/     # Vỏ bọc ứng dụng (Header, BottomNav)
├── screens/     # Business Logic của từng trang
└── utils/       # Helpers và formatters

© 2026 EJSC Technology. All rights reserved.