Tạo tổ chức mới cho một khách hàng

Danh mục hình thái#

Danh sách trong form tạo tổ chức gồm sáu gói nền cộng ba hình thái ngành. Hình thái ngành là chính gói nền Bảng dữ liệu tổ chức cộng một lớp ngành, nên chọn nó ở form là cách duy nhất để lớp ngành bật cùng lúc với tổ chức.

Trang mở sau đăng nhập không phải một nhánh riêng cho từng hình thái: hệ thống đi qua một danh sách trang chủ theo thứ tự và mở trang đầu tiên mà tổ chức thật sự có trong menu. Một hình thái mới nhận trang chủ bằng cách được cấp mục menu, không bằng cách thêm nhánh code.

standard-commerce và standard-dashboard-pack cộng dồn được trên cùng một tổ chức; các gói còn lại từ chối áp lên một tổ chức đang chạy kết nối marketplace.

Thứ tự bắt buộc#

Bước 3 phải xong trước bước 4. Dữ liệu và trang của một gói dữ liệu ngành đều gắn với thương hiệu; tổ chức chưa có thương hiệu thì gói khai báo được lược đồ nhưng không cài được trang nào.

1. Xem trước (dry-run)#

Xem trước trả về đúng bản tóm tắt mà lần áp thật sẽ trả về, tính ra từ cùng một hàm, và không ghi một dòng nào.

Trên giao diện: /admin/orgs → mở một tổ chức → mục Gói khởi tạo → chọn gói → Xem trước. Bảng kết quả hiện số tính năng, số dashboard, lớp ngành và trạng thái từng gói dữ liệu.

Đọc ba dòng trong kết quả trước khi đi tiếp:

• domainLayersActivated — đúng lớp ngành mong đợi (["warehouse"] với warehouse-workspace; [] nghĩa là bạn đang chọn gói nền, không phải gói ngành).
• datasetPacks[].skipped — phải là null. Ba giá trị khác nghĩa là gì, xem bảng ở mục 4.
• pluginsEnabled — danh sách tính năng tổ chức sẽ có.

Đội vận hành hạ tầng có thêm một dạng lệnh chạy trong container để làm đúng việc này trên môi trường thật; dạng lệnh đó nằm trong runbook nội bộ, không thuộc trang hướng dẫn này.

2. Tạo tổ chức#

/admin/orgs → Tổ chức mới. Điền tên, slug, tên miền phụ, ngôn ngữ, tiền tệ, múi giờ, rồi chọn Gói khởi tạo ở cuối form.

Danh sách gói gồm cả các hình thái ngành (hr-workspace, finance-workspace), không chỉ các gói nền. Chọn đúng hình thái ở đây là cách duy nhất để lớp ngành được bật cùng lúc với tổ chức.

Sau khi bấm tạo, hệ thống lần lượt: ghi tổ chức → tạo bộ vai trò mặc định → tạo thương hiệu mặc định → áp gói khởi tạo.

3. Thương hiệu mặc định#

Tổ chức mới luôn có sẵn một thương hiệu, tên và slug lấy theo tổ chức. Đổi tên ở /settings/brands; thêm thương hiệu thứ hai cũng ở đó.

Một tổ chức không có thương hiệu nào thì không giữ được đơn hàng, không giữ được kết nối, không cài được trang của gói dữ liệu — nên đây không phải bước tuỳ chọn.

4. Áp gói khởi tạo cho tổ chức đã có#

Khi cần đổi hình thái hoặc cập nhật phiên bản gói: /admin/orgs → mở tổ chức → mục Gói khởi tạo → chọn gói → Xem trước → Áp dụng.

Tổ chức đang chạy một phiên bản cũ hơn bản dựng hiện tại thì cột Gói khởi tạo trong bảng tổ chức hiện thêm một nút mang đúng hai số phiên bản, dạng v2 → v3. Bấm nút đó là nâng gói — không phải cài lại: bộ dữ liệu đã lệch được định nghĩa lại theo bản mới thay vì bị bỏ qua, và thẻ dashboard nào tổ chức đã tự sửa thì được giữ nguyên. Luật giữ thẻ nằm ở Bộ dữ liệu và chỉ số.

Bảng kết quả sau khi áp hiện luôn trạng thái từng gói dữ liệu. Ba lý do bỏ qua và cách xử lý:

Áp lại cùng một key là thao tác lặp lại được: nó nâng gói lên phiên bản mới nhất và không tạo bản sao. Tạo tổ chức mới và bật lớp ngành thì luôn đi nhánh cài đặt; nâng gói là quyết định của người vận hành, không phải hệ quả kèm theo của việc cấp phát.

Dạng lệnh tương đương (scripts/onboarding/apply-blueprint.ts) dành cho đội vận hành hạ tầng và cần một tài khoản super admin làm người thực hiện: đường khai báo dữ liệu chạy dưới danh nghĩa một người dùng, thiếu người thực hiện thì gói dữ liệu bị bỏ qua với lý do "thiếu người thực hiện".

5. Lớp ngành#

Lớp ngành đi kèm gói khởi tạo, không phải một bước riêng: hr-workspace = gói nền không gian dữ liệu + lớp Nhân sự (bộ trường chuẩn, các trang, mục Bản tin sáng). Chạy lại cùng key là cách cập nhật lớp đó lên phiên bản mới nhất.

6. Tính năng bổ sung#

Chỉ dùng khi tổ chức cần thứ ngoài gói: chọn tổ chức ở thanh trên → /admin/orgs/<slug>/plugins.

Hai thứ dưới đây không phải plugin: chúng là công tắc trong ngăn của tổ chức tại /admin/orgs, và chỉ super admin bật được.

• Đăng nhập LDAP/AD — xem Đăng nhập LDAP/AD.
• White-label — trang đăng nhập riêng và tên thương hiệu trên chân trang PDF; xem White-label. Tên miền riêng của tổ chức là thứ khác và cấu hình ở một mục khác trong cùng ngăn.

Ngân sách và nhà cung cấp AI dùng chung cho cả nền tảng nằm ở /admin/ai: xem Hướng dẫn Super Admin.

7. Nối dữ liệu#

Vào tổ chức, mở /connectors, thêm nguồn. Mẫu ánh xạ khởi điểm đã được cài sẵn theo đúng họ kết nối mà gói bật, nên phần lớn trường hợp chỉ cần chọn mẫu có sẵn.

8. Kiểm tra bằng cách bấm menu#

Đăng nhập bằng một tài khoản thuộc tổ chức (không phải super admin) và bấm từng mục trên thanh điều hướng. Gõ thẳng URL không chứng minh được gì: mục menu bị ẩn vẫn mở được bằng URL, nên trang hiện ra không có nghĩa là người dùng thật nhìn thấy nó.

Cần thấy đủ:

• Mọi mục trong menu mở được, không mục nào 404.
• Trang chủ sau đăng nhập không rỗng.
• Với gói có dữ liệu ngành: các trang của gói đã có, kèm thương hiệu ở bộ lọc.
• Chưa nối dữ liệu thì các trang hiện trạng thái rỗng có hướng dẫn, không phải số 0.

Khi một hình thái khách hàng chưa có trong danh sách#

Danh sách gói ở /admin/orgs là mọi hình thái bản dựng này tạo được. Thiếu một hình thái nghĩa là thiếu khai báo, và việc cần làm là thêm một dòng vào registry gói khởi tạo hoặc registry ngành — không phải viết một script riêng cho khách hàng đó.

Liên quan#

• Hướng dẫn Super Admin
• Hướng dẫn quản trị
• Các loại tổ chức