Tiện ích CLI

Nền tảng VENI-AI bao gồm một công cụ giao diện dòng lệnh (CLI) mạnh mẽ để tự động hóa việc quản lý hạ tầng, khởi tạo ứng dụng và đăng ký hệ thống.

1. Cài đặt

CLI được xây dựng bằng Bun và có thể chạy trực tiếp từ thư mục gốc.

# Đăng ký lệnh veni toàn cục (tùy chọn)
bun link

---

2. Tham chiếu Lệnh

Khởi tạo Ứng dụng mới (Scaffold)

Tạo một microfrontend và satellite API mới dựa trên template chuẩn veni-service.

bun run cli/src/index.ts create app <appname>

• Tự động cấp phát cổng: Tự động chọn các cổng tiếp theo có sẵn (API: 3012+, UI: 4175+).
• Thay thế biến template: Tự động thay thế , ,...
• Khởi tạo Git: Tạo một repository mới trong apps/<appname>/.

Đăng ký Dịch vụ

Đăng ký một ứng dụng vệ tinh đang chạy với Shell API.

bun run cli/src/index.ts register <appname> \
  --api-url http://localhost:<apiPort>/api \
  --ui-url  http://localhost:<uiPort>

Biên dịch CLI

Biên dịch mã nguồn TypeScript thành tệp thực thi standalone hiệu năng cao.

cd cli && bun run build

---

3. Quy ước Nền tảng

CLI thực thi các quy ước sau trong quá trình khởi tạo:

Danh mục	Quy ước
Thư mục	Các ứng dụng vệ tinh luôn được tạo trong thư mục apps/.
Ánh xạ Cổng	Tăng dần từ 3012 (API) và 4175 (UI) để tránh xung đột.
Đặt tên	Sử dụng PascalCase cho tên class và kebab-case cho slug định danh.
Xác thực	Tự động cấu hình AuthService để trỏ tới endpoint JWKS của Shell.