Hướng dẫn đóng gói và nộp module (plugin)

Tài liệu này hướng dẫn lập trình viên — nội bộ FoxAI hoặc đối tác — đóng gói một module để nộp lên nền tảng native-platform: cấu trúc gói, cách viết module.yaml, cách ký gói, cách nộp qua API, và những gì SDK runtime hiện có hỗ trợ.

Khái niệm

Nền tảng mở rộng tính năng qua module — gói mã đã build, nộp lên module-registry, được Platform Team kiểm và duyệt trước khi tenant cài được (quyết định Q-04 của nền tảng). "Module" ở đây chính là khái niệm "plugin" trong các tài liệu khác của dự án — không có hai hệ song song.

Vòng đời một gói, tóm tắt

Nộp gói (VENDOR) → kiểm tự động → DRAFT/IN_REVIEW
                 → Platform Team duyệt → PUBLISHED/REJECTED → tenant cài

Căn cứ: ADR-0045 (nhận và kiểm gói), ADR-0046 (duyệt và lịch sử phiên bản). Tài liệu này không chép lại toàn văn hai ADR đó — đọc trực tiếp khi cần chi tiết triển khai phía backend.

Theo dõi kết quả

Sau khi nộp, theo dõi trạng thái qua màn Quản lý module ở cổng nền tảng (web/admin, mục *Quản trị nền tảng → Quản lý module). Màn đó hiện danh sách phiên bản đã nộp, trạng thái, lý do từ chối (nếu có), và nút Duyệt/Từ chối cho PLATFORM_ADMIN`.