Ứng dụng

Phần này hướng dẫn các phần chạy trong ứng dụng quản trị Enfyra (cổng 3000): giao diện, tiện ích mở rộng, biểu mẫu, quyền và cách ứng dụng giao tiếp với backend.

Đây là một API client: ứng dụng không bao giờ kết nối trực tiếp với cơ sở dữ liệu. Mọi dữ liệu đều đến từ Máy chủ Enfyra (cổng 1105) qua HTTP API.

Mới sử dụng Enfyra? Bắt đầu với Hướng dẫn cài đặt để thiết lập không gian làm việc cho ứng dụng và máy chủ của bạn.

Điều hướng nhanh

• Tích hợp API

• Tích hợp API – Gọi API backend bằng fetch tới appUrl/api/ (ví dụ: http://localhost:3000/api/enfyra_user)

• Tiện ích mở rộng & Widget

• Hệ thống tiện ích mở rộng – Tạo trang, widget tùy chỉnh và tiện ích mở rộng shell toàn cục bằng component Vue

• Hành động tiêu đề – Đưa các nút tùy chỉnh vào tiêu đề ứng dụng và tiêu đề phụ

• Biểu mẫu & nhập dữ liệu

• Hệ thống biểu mẫu – Biểu mẫu tạo tự động, validation, relation và theo dõi thay đổi
• Bộ chọn relation – Chọn bản ghi liên quan trong biểu mẫu

• Hệ thống lọc – Bộ lọc nâng cao cho bảng và bộ chọn

• Quyền và khả năng hiển thị

• Trình dựng quyền – Tạo quy tắc phân quyền trực quan

• Thành phần quyền – Component PermissionGate và composable usePermissions

• Xác thực

• Quy tắc cột – Đính kèm các ràng buộc tối thiểu/tối đa, độ dài, mẫu, định dạng vào các cột; các quy tắc được thực thi phía máy chủ trên POST/PATCH

• Điều hướng & Bố cục

• Quản lý menu – Cấu hình thanh bên và menu
• Quản lý phương thức – Bản ghi HTTP method và màu badge dùng trong biểu mẫu route

• Tiêu đề trang – Tiêu đề trang có số liệu và nền chuyển sắc

• Móc, Trình xử lý & Gói (phía giao diện người dùng)

• Hooks – Quản lý hook từ giao diện người dùng ứng dụng
• Trình xử lý tùy chỉnh – Quản lý trình xử lý tùy chỉnh từ giao diện người dùng ứng dụng

• Quản lý package – Cài package NPM cho hook và handler

• Bộ nhớ & Tệp

• Quản lý lưu trữ – Tải lên tệp, thư mục và cấu hình lưu trữ

• Hoạt động

• Nhật ký máy chủ – Đọc và theo dõi log backend từ ứng dụng quản trị
• Theo dõi runtime – Theo dõi tiến trình, database, queue, websocket và Redis

Lộ trình học cho Enfyra App

Nếu bạn đang xây dựng trên giao diện người dùng ứng dụng Enfyra, thì đây là thứ tự được đề xuất:

1. Hiểu kiến trúc
2. Tổng quan về kiến trúc – Cách giao diện người dùng và phụ trợ phối hợp với nhau

3. Tổng quan về máy chủ – Các khái niệm và API phía máy chủ

4. Làm việc với dữ liệu từ ứng dụng

5. Hệ thống biểu mẫu – Cách tạo biểu mẫu từ bảng
6. Hệ thống lọc – Lọc dữ liệu trong bảng và bộ chọn relation

7. Tích hợp API – Gọi API từ trang, tiện ích mở rộng và widget

8. Xây dựng giao diện người dùng và quy trình làm việc tùy chỉnh

9. Hệ thống tiện ích mở rộng – Tạo trang, widget và tiện ích mở rộng shell dùng chung
10. Hành động tiêu đề – Thêm hành động tùy chỉnh vào tiêu đề

11. Quản lý menu – Kết nối tiện ích mở rộng với menu

12. Bảo mật và kiểm soát giao diện người dùng

13. Trình dựng quyền – Xác định quy tắc phân quyền
14. Thành phần quyền – Ẩn hoặc hiện giao diện theo quyền

15. Trình dựng quyền – Đánh giá quyền backend (xem tài liệu này để biết chi tiết)

16. Đi sâu hơn vào tùy chỉnh phụ trợ (từ giao diện người dùng ứng dụng)

17. Hooks – Định cấu hình các hook chạy trên máy chủ
18. Trình xử lý tùy chỉnh – Ghi đè hành vi CRUD mặc định
19. Quản lý package – Cài package NPM cho hook/handler
20. Hook và handler phía máy chủ – Hành vi đầy đủ ở backend

Điều này liên quan như thế nào đến Tài liệu máy chủ

• Tài liệu máy chủ (../server/README.md) mô tả những API tồn tại và cách chúng hoạt động.
• Tài liệu ứng dụng (thư mục này) mô tả cách ứng dụng quản trị viên sử dụng các API đó thông qua biểu mẫu, bảng, tiện ích mở rộng và quyền.

Khi nghi ngờ:

• Nếu bạn hỏi “Tôi có thể sử dụng điểm cuối/trường/bộ lọc nào?” – hãy truy cập tài liệu máy chủ.
• Nếu bạn hỏi “Làm cách nào để hiển thị thông tin này trong giao diện người dùng / tiện ích mở rộng?” – hãy ở trong tài liệu ứng dụng.