GPortal – Generic Portal

Giới thiệu

Không có nền tảng nào có thể giúp giải mọi bài toán, nhưng chúng ta có thể loại bỏ các bước lặp đi lặp lại, đưa người dùng vào trung tâm phát triển, giúp việc xây dựng phần mềm quản lý chỉ còn vài ngày, thậm chí vài giờ.

GPortal được sinh ra với mục tiêu giúp doanh nghiệp xây dựng phần mềm quản lý nhanh chóng – gọn nhẹ – dễ tích hợp AI – và hầu như không cần viết code.

GPortal cũng tích hợp toàn diện với nền tảng tự động hoá N8N, giúp việc xây dựng workflow trở nên đơn giản và mạnh mẽ.

Như vậy, chúng tôi xác định giá trị mang lại:

• Xoá bỏ chi phí xây dựng MVP / Prototype.
• Xây dựng – thay đổi nhanh chóng.
• Gọn nhẹ, dễ dàng mở rộng, tích hợp AI.
• Giảm thiểu sự phụ thuộc vào đội ngũ phát triển.

No/Low-code – Chúng tôi làm điều đó như thế nào?

Hầu hết phần mềm quản lý đều xoay quanh việc tạo – sửa – xoá – tìm kiếm các đối tượng quản lý (entity) khác nhau.

Ví dụ:

• Phần mềm bán hàng: hàng hoá, đơn hàng, khách hàng...
• Phần mềm trường học: sinh viên, lớp học, thời khoá biểu...

Các đối tượng quản lý này đều có các logic khác nhau.

Ví dụ:

• Khi nhập hoá đơn, bạn chỉ cần nhập loại mặt hàng, đơn giá → phần mềm tự tính tổng giá.
• Sau khi hàng được báo xuất kho → phần mềm phải tự thông báo đến các đơn vị liên quan.

Vậy, nếu chúng ta có giao diện đầy đủ để tuỳ chỉnh (config) các đối tượng quản lý (entity), ta hoàn toàn có thể loại bỏ các bước lập trình, xây dựng database, API...

Tương ứng, chúng ta sẽ cần 4 bước để có phần mềm quản lý cho riêng bạn

1. Tạo đối tượng cần quản lý.
2. Thiết lập các thuộc tính, logic cho đối tượng cần quản lý.
3. Nhập liệu, thêm - xoá - sửa - tìm kiếm cho đối tượng cần quản lý.
4. Sử dụng N8N, với các node dành riêng cho GPortal để xây dựng workflow và làm tự động quy trình quản lý

📷 Các bước thực hiện trên GPortal:

📷 Nhập liệu, tìm kiếm đối tượng quản lý:

📷 Xây dựng workflow:

📷 (Trường hợp nâng cao) Tạo thêm trang quản lý:

📷 (Trường hợp nâng cao) Tạo thêm trang quản lý Với AI:

Từ điển

Chúng tôi không tạo ra bất kỳ kiến trúc hay design pattern mới.

Điều chúng tôi làm là giúp bạn áp dụng những cấu trúc quen thuộc một cách dễ dàng hơn, trực quan hơn.

Entity Configuration – Tạo đối tượng quản lý không cần sửa database hay API

Entity Configuration là nơi dùng để tuỳ chỉnh các đối tượng, bao gồm:

• Thêm / xoá đối tượng quản lý
• Các thuộc tính (field)
• Các logic đi kèm cho các thuộc tính này (computation & validation)
• Đối tượng có được lưu dưới dạng vector embedding để tìm kiếm bằng AI hay không

📷 Entity config overview:

Ví dụ: Tạo entity teamMember

Giả sử bạn muốn quản lý thông tin thành viên nhóm (teamMember) với 3 thuộc tính:

• name – string
• email – string
• birthDay – date

Bạn chỉ cần mở trang Config Entity và khai báo các field.

📹 Video tạo teamMember:

Sử dụng & quản lý dữ liệu (Manage Entity)

Sau khi cấu hình, bạn có thể:

• Hiển thị hoặc ẩn entity
• Thực hiện đầy đủ thao tác nhập liệu: thêm – xoá – chỉnh sửa – tìm kiếm

📹 Video nhập liệu:

Cấu hình thuộc tính (Field Configuration)

Mỗi đối tượng (entity) đều chứa một tập thuộc tính (field), và với mỗi thuộc tính, bạn có thể thiết lập:

📷 Ảnh giao diện:

📹 Validation – Hàm được thực thi để xác định giá trị có hợp lệ hay không:

📹 Computation – Hàm được thực thi để tính toán ra giá trị:

Kiểu dữ liệu cho thuộc tính (Field Types)

Mỗi thuộc tính đều có thể tuỳ chỉnh kiểu dữ liệu, đảm bảo tính chặt chẽ và tối ưu trong quản lý dữ liệu.

Kiểu dữ liệu cơ bản

📹 Field types supported:

Kiểu dữ liệu nâng cao

Tương tự lập trình, GPortal hỗ trợ các kiểu dữ liệu sau:

Ví dụ kiểu dữ liệu nâng cao

Enum

Dùng để chứa một tập hằng số.

Enum gồm: key – name – color.

Giả sử cần tạo thuộc tính role để xác định vai trò của thành viên: junior, senior, leader.

Cách thiết lập:

1. Field type: chọn enum
2. Nhập key cho enum
3. Nhập name và color cho từng giá trị

📹 Demo:

Reference

Dùng để chứa key trỏ đến một entity khác.

Ví dụ: cần thêm thuộc tính team để biết thành viên thuộc team nào.

Cách thiết lập:

1. Field type: Reference
2. Entity referenced: chọn entity team

📹 Demo:

Array Reference

Dùng để chứa một tập key, trỏ đến nhiều entity khác.

Ví dụ: tạo thuộc tính projects để biết thành viên tham gia các dự án nào.

Cách thiết lập:

1. Field type: Array Reference
2. Entity referenced: team (hoặc entity phù hợp)

📹 Demo:

Embedded Document

Dùng để lưu object.

Ví dụ: thuộc tính address gồm street và city.

Cách thiết lập:

1. Field type: Embedded Document
2. Entity referenced: Address

📹 Demo:

Array Embedded Documents

Dùng để lưu danh sách object.

Ví dụ: thuộc tính workHistory để lưu quá trình làm việc.

Cách thiết lập:

1. Field type: Array Embedded Document
2. Entity referenced: workHistory

📹 Demo:

(updating)

Business Rules – Custom Validation & Computation

Hệ thống cho phép khai báo hàm kiểm tra và tính toán tự động khi dữ liệu thay đổi.

Ví dụ

• Kiểm tra email hợp lệ
• Tạo mã teamMember dựa trên name + birthDay

Custom validation

Custom validation là hàm chạy mỗi khi dữ liệu thay đổi.

Hàm phải trả về:

• true – hợp lệ
• false – không hợp lệ

Ví dụ: kiểm tra email có chứa ký tự @.

Cách dùng:

1. Chọn Use Validation
2. Viết hàm validation
3. Nhập thông báo lỗi tại Validation Message On Failure

📹 Demo:

Custom Computation

Computation chạy khi giá trị của các thuộc tính phụ thuộc (dependencies) thay đổi.

Ví dụ: tạo thuộc tính code = name + birthDay.

Cách dùng:

1. Field type: Computation
2. Viết hàm computation
3. Chọn dependencies: name và birthDay

📹 Demo:

📦 Cách chúng tôi lưu trữ entity

Mỗi entity khi lưu trữ sẽ được bao bọc trong một cấu trúc chuẩn, gồm:

{
  "name": "Tên entity, ví dụ: teamMember",
  "version": "Phiên bản schema của entity, mặc định là 0",
  "value": "Object chứa toàn bộ dữ liệu (các thuộc tính) của entity"
}

🔍 Giải thích nhanh

• name: Tên loại entity.
• version: Dùng để quản lý thay đổi schema theo thời gian.
• value: Object chứa dữ liệu thực tế.

📘 Ví dụ

Giả sử entity teamMember có dữ liệu:

name: "Nguyen Van A"
email: "nguyenVanA@gmail.com"
role: "leader"

Thì khi lưu trữ, hệ thống sẽ ghi:

{
  "name": "teamMember",
  "version": 0,
  "value": {
    "name": "Nguyen Van A",
    "email": "nguyenVanA@gmail.com",
    "role": "leader"
  }
}

Workflow – Tự động hoá công việc

Phần mềm quản lý hiện đại không chỉ CRUD.

Quan trọng hơn là tự động hoá vận hành.

Các nhu cầu phổ biến:

• Tự động kiểm tra dữ liệu
• Gửi thông báo/email
• Tạo công việc kế tiếp
• Đồng bộ dữ liệu giữa phòng ban
• Tự động hoá luồng phê duyệt

Ví dụ thực tế về quy trình

Doanh nghiệp bán hàng

• Kiểm tra tồn kho
• Đủ hàng → tạo hoá đơn
• Thiếu hàng → tạo phiếu nhập
• Hoàn tất → gửi email cảm ơn

Doanh nghiệp dịch vụ

• Khách đặt lịch
• Kiểm tra lịch rảnh
• Tự động gán nhân sự
• Nhắc lịch 24h trước buổi hẹn

Công ty đào tạo

• Học viên đăng ký
• Gửi hợp đồng
• Thanh toán → gửi tài liệu
• Trước khai giảng → nhắc lịch
• Kết thúc → gửi khảo sát

Bộ node N8N dành cho GPortal

Chúng tôi cung cấp đầy đủ node N8N để tương tác với dữ liệu GPortal.

Bộ API Node

Hỗ trợ đầy đủ CRUD, gọi API để thao tác entity.

Create a new entity Node

Được sử dụng để tạo đối tượng quản lý (entity), có thể sử dụng như tool Agent.

📄 Bảng dữ liệu mô tả đối số

📘 Request payload tương ứng

{
  "entityName": "Support*",
  "entityData": {
    "category": { "$eq": "guide" },
    "status": { "$in": ["active", "published"] }
  }
}

demo:

Update an entity

Được sử dụng để chỉnh sửa đối tượng quản lý (entity), có thể sử dụng như tool Agent.

📄 Bảng mô tả đối số

📘 Request payload tương ứng

{
  "entityId": { "$in": ["101", "102", "103"] },
  "entityData": {
    "status": "active",
    "updatedAt": "2025-01-10T10:00:00Z"
  }
}

demo

Delete an entity

Được sử dụng để xoá đối tượng quản lý (entity), có thể sử dụng như tool Agent.

📄 Bảng mô tả đối số

📘 Request payload tương ứng

{
  "entityId": { "$in": ["A01", "A02", "A03"] }
}

demo

Get many entities

Được sử dụng để tìm kiếm thông tin nhiều đối tượng quản lý, có thể sử dụng như API tool.

📄 Bảng mô tả đối số Search API

📘 Request Payload tương ứng

{
  "searchParameters": {
    "status": { "$eq": "active" },
    "category": { "$in": ["guide", "support"] }
  },
  "limit": 10,
  "entityName": "SupportArticle"
}

demo

Bộ điều khiển UI Nodes

Nhận tín hiệu điều khiển UI từ workflow.

Demo:

Query Embedding Vector Node

Truy vấn vector embedding phục vụ AI chatbot và semantic search.

Mỗi đối tượng, khi được tạo với lựa chọn sử dụng vector embedding, sẽ được lưu cùng với vector embedding và hỗ trợ việc semantic search (tìm kiếm theo ngữ nghĩa).

Demo: