User Service Master - Data Model¶

1. Giới thiệu¶

Tài liệu này mô tả chi tiết mô hình dữ liệu của User Service Master – một trong những thành phần cốt lõi của hệ thống dx-vas theo kiến trúc multi-tenant. Service này chịu trách nhiệm quản lý định danh toàn cục người dùng, thông tin tenant, và mẫu vai trò/quyền toàn cục (RBAC templates).

2. Phạm vi¶

User Service Master bao gồm:

Quản lý người dùng toàn hệ thống (users_global).
Quản lý danh sách tenant (tenants) và trạng thái của tenant.
Quản lý việc gán người dùng vào tenant (user_tenant_assignments).
Cung cấp mẫu vai trò (global_roles_templates) và mẫu quyền (global_permissions_templates) dùng chung cho các tenant.
Phát sự kiện tới các Sub User Services hoặc các service khác khi có thay đổi liên quan đến định danh hoặc template RBAC.

3. Không bao gồm (Out of Scope)¶

User Service Master không chịu trách nhiệm:

Quản lý người dùng nội bộ của từng tenant – việc này thuộc về Sub User Service.
Quản lý quyền cụ thể (roles, permissions, mappings) ở cấp tenant.
Xử lý xác thực đăng nhập người dùng (Google OAuth2, OTP, Local login) – thuộc về Auth Services.
Ghi log audit chi tiết từng thay đổi (nếu audit được xử lý bởi service riêng).

4. Mục tiêu¶

Trình bày cấu trúc các bảng dữ liệu cốt lõi của User Service Master.
Mô tả các ràng buộc dữ liệu (constraints), khóa chính/ngoại, chỉ mục.
Hỗ trợ cho quá trình phát triển backend, viết OpenAPI, migration, testing và bảo trì.
Làm nền tảng để đồng bộ schema với tài liệu interface-contract.md, openapi.yaml, và các ADR liên quan (như ADR-007, ADR-025).

5. Các bảng chính và phân nhóm logic¶

Dưới đây là danh sách các bảng chính trong cơ sở dữ liệu của User Service Master, được chia thành 3 nhóm logic rõ ràng:

🔹 Nhóm A – Định danh người dùng và phân quyền toàn cục¶

Tên bảng	Vai trò chính
`users_global`	Lưu trữ thông tin định danh người dùng toàn cục.
`tenants`	Lưu trữ thông tin các tenant trong hệ thống.
`user_tenant_assignments`	Mapping giữa người dùng toàn cục và các tenant, kèm trạng thái.

🔹 Nhóm B – Template RBAC dùng chung¶

Tên bảng	Vai trò chính
`global_roles_templates`	Danh sách vai trò mẫu dùng để khởi tạo RBAC trong mỗi tenant.
`global_permissions_templates`	Danh sách quyền mẫu, gắn với role templates.

🔹 Nhóm C – Hỗ trợ & Mở rộng (tuỳ chọn)¶

Tên bảng	Vai trò chính
`processed_events`	Lưu các `event_id` đã xử lý (idempotency khi nhận lại message Pub/Sub).
`audit_log_users_master`	(Tuỳ chọn) Lưu log audit các thao tác trong User Service Master.

🔍 Ghi chú: - Các bảng ở Nhóm A là bắt buộc và trung tâm của toàn bộ service. - Nhóm B hỗ trợ việc chuẩn hoá và đồng bộ RBAC giữa Master và Sub User Service. - Nhóm C phục vụ khả năng mở rộng, theo dõi và debug nếu cần.

6. Chi tiết bảng: `users_global`¶

🧾 Mục đích¶

Bảng users_global lưu trữ thông tin định danh cốt lõi của người dùng trong toàn bộ hệ thống. Đây là nơi duy nhất lưu thông tin người dùng cấp toàn cục, bất kể họ thuộc tenant nào.

📜 Câu lệnh `CREATE TABLE`¶

CREATE TABLE users_global (
  user_id UUID PRIMARY KEY,                         -- 🔑 ID định danh toàn cục
  full_name TEXT NOT NULL,                          -- Họ tên người dùng
  email TEXT NOT NULL,                              -- Email (dùng cho xác thực OAuth2 hoặc liên hệ)
  phone TEXT,                                       -- Số điện thoại (nếu có)
  auth_provider TEXT NOT NULL,                      -- Hệ thống xác thực (e.g., "google", "local", "zalo")
  created_at TIMESTAMPTZ DEFAULT now() NOT NULL,    -- Thời điểm tạo
  updated_at TIMESTAMPTZ DEFAULT now() NOT NULL,    -- Thời điểm cập nhật gần nhất

  UNIQUE (email, auth_provider),                    -- 🔐 Mỗi email chỉ được dùng một lần trong cùng một hệ thống xác thực
  CHECK (auth_provider IN ('google', 'local', 'otp'))  -- 🛡️ Ràng buộc giá trị hợp lệ
);

🧩 Giải thích cột¶

Cột	Kiểu dữ liệu	Ý nghĩa
`user_id`	UUID	Khóa chính toàn cục, dùng để liên kết với tất cả bảng khác
`full_name`	TEXT	Tên đầy đủ của người dùng
`email`	TEXT	Email người dùng – duy nhất trong phạm vi `auth_provider`
`phone`	TEXT	Số điện thoại (tùy chọn)
`auth_provider`	TEXT	Hệ thống xác thực (OAuth2, OTP local...)
`created_at`	TIMESTAMPTZ	Thời điểm tạo bản ghi
`updated_at`	TIMESTAMPTZ	Thời điểm cập nhật cuối cùng

🔗 Liên kết & Chỉ số¶

✅ Unique Constraint: (email, auth_provider) giúp hỗ trợ nhiều provider nhưng vẫn đảm bảo tính duy nhất.
📌 Index khuyến nghị: tạo thêm index trên (auth_provider, email) để tối ưu tra cứu khi đăng nhập.
🧩 Mối liên hệ: user_id được tham chiếu bởi:
- user_tenant_assignments.user_id_global
- audit_log_users_master.actor_id (nếu có)
- Các bảng Sub User Service: users_in_tenant.user_id_global

7. Chi tiết bảng: `tenants`¶

🧾 Mục đích¶

Bảng tenants lưu thông tin nhận diện các tenant (trường thành viên) trong hệ thống. Mỗi tenant tương ứng với một trường hoặc tổ chức riêng biệt, có hệ thống phụ trợ riêng (Sub Services).

📜 Câu lệnh `CREATE TABLE`¶

CREATE TABLE tenants (
  tenant_id TEXT PRIMARY KEY,                          -- 🔑 Mã định danh duy nhất cho tenant (ví dụ: "va_camau")
  tenant_name TEXT NOT NULL,                           -- Tên hiển thị của tenant
  status TEXT NOT NULL DEFAULT 'active',               -- Trạng thái: active, suspended, deleted...
  logo_url TEXT,                                       -- Logo đại diện (tùy chọn)
  project_id TEXT,                                     -- GCP Project ID gắn với tenant này (nếu có)
  created_at TIMESTAMPTZ DEFAULT now() NOT NULL,
  updated_at TIMESTAMPTZ DEFAULT now() NOT NULL,

  CHECK (status IN ('active', 'suspended', 'deleted')) -- 🛡️ Trạng thái hợp lệ
);

🧩 Giải thích cột¶

Cột	Kiểu dữ liệu	Ý nghĩa
`tenant_id`	TEXT	Mã định danh duy nhất cho tenant (viết thường, snake_case)
`tenant_name`	TEXT	Tên đầy đủ, thân thiện với người dùng
`status`	TEXT	Trạng thái hoạt động của tenant (`active`, `suspended`, `deleted`)
`logo_url`	TEXT	Link logo (nếu có), dùng cho hiển thị branding
`project_id`	TEXT	GCP Project ID nếu mỗi tenant có stack riêng biệt
`created_at`	TIMESTAMPTZ	Thời điểm tạo
`updated_at`	TIMESTAMPTZ	Thời điểm cập nhật cuối cùng

🔗 Liên kết & Chỉ số¶

📌 Tenant ID sẽ được tham chiếu bởi:
- user_tenant_assignments.tenant_id
- Sub services dùng để định tuyến và phân quyền
✅ Index khuyến nghị: index trên status để lọc nhanh các tenant đang hoạt động

8. Chi tiết bảng: `user_tenant_assignments`¶

🧾 Mục đích¶

Bảng user_tenant_assignments lưu thông tin người dùng nào được gán vào tenant nào. Đây là cầu nối giữa users_global và các tenant, xác định quyền truy cập của một người dùng toàn cục vào tenant cụ thể.

📜 Câu lệnh `CREATE TABLE`¶

CREATE TABLE user_tenant_assignments (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),       -- 🔑 ID duy nhất cho mỗi lần gán
  user_id_global UUID NOT NULL REFERENCES users_global(user_id), -- 🔗 Người dùng toàn cục
  tenant_id TEXT NOT NULL REFERENCES tenants(tenant_id),         -- 🔗 Tenant được gán
  assignment_status TEXT NOT NULL DEFAULT 'active',     -- Trạng thái: active, revoked
  assigned_at TIMESTAMPTZ DEFAULT now() NOT NULL,       -- ⏱️ Thời điểm gán
  updated_at TIMESTAMPTZ,                               -- ⏱️ Thời điểm hủy gán (nếu có)
  assigned_by UUID,                                     -- 🔗 Người gán (user_id_global) – thường là Superadmin
  UNIQUE (user_id_global, tenant_id),                   -- 🛡️ Không thể gán trùng người dùng vào cùng tenant
  CHECK (assignment_status IN ('active', 'revoked'))
);

🧩 Giải thích cột¶

Cột	Kiểu dữ liệu	Ý nghĩa
`id`	UUID	ID duy nhất cho bản ghi (dùng cho tra cứu, cập nhật trạng thái)
`user_id_global`	UUID	Người dùng toàn cục được gán vào tenant này
`tenant_id`	TEXT	Tenant cụ thể
`assignment_status`	TEXT	Trạng thái hiện tại: active / revoked
`assigned_at`	TIMESTAMPTZ	Thời điểm thực hiện gán
`updated_at`	TIMESTAMPTZ	Thời điểm hủy quyền truy cập (nếu có)
`assigned_by`	UUID	ID của user thực hiện thao tác gán (thường là superadmin)

🔗 Liên kết & Chỉ số¶

🔁 Dùng để xác định quyền truy cập tenant khi người dùng đăng nhập (Auth Service)
🧠 Gateway có thể cache user_id_global ↔ danh sách tenant_id để tối ưu hiệu suất
✅ Cần index trên user_id_global, tenant_id, và assignment_status cho tra cứu nhanh

📤 Sự kiện phát ra¶

tenant_user_assigned: Khi một user được gán vào tenant (assignment mới)
tenant_user_revoked: Khi quyền truy cập của user vào tenant bị hủy (status chuyển sang revoked)

9. Chi tiết bảng: `global_roles_templates`¶

🧾 Mục đích¶

Bảng global_roles_templates lưu trữ các mẫu vai trò dùng chung toàn hệ thống. Các vai trò này được thiết kế bởi superadmin để làm nền tảng gán role mặc định cho từng tenant trong hệ thống multi-tenant. Đây là phần cốt lõi của cơ chế RBAC phân tầng, giúp tiêu chuẩn hóa quản lý quyền truy cập theo từng loại người dùng (admin, teacher, parent...).

📜 Câu lệnh `CREATE TABLE`¶

CREATE TABLE global_roles_templates (
  role_template_id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  template_key TEXT NOT NULL UNIQUE,
  template_name TEXT NOT NULL,
  description TEXT,
  is_system BOOLEAN NOT NULL DEFAULT FALSE,
  created_by UUID NOT NULL REFERENCES users_global(user_id),
  updated_by UUID REFERENCES users_global(user_id),
  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
  updated_at TIMESTAMPTZ
);

🧩 Giải thích cột¶

Cột	Kiểu dữ liệu	Ý nghĩa
`role_template_id`	`UUID`	Mã định danh duy nhất cho template
`template_key`	`TEXT`	Khóa kỹ thuật duy nhất (e.g., `teacher_default`, `admin_basic`)
`template_name`	`TEXT`	Tên hiển thị của template
`description`	`TEXT`	Mô tả chức năng của role này
`is_system`	`BOOLEAN`	Đánh dấu vai trò hệ thống (không cho xóa)
`created_by`	`UUID`	ID người dùng toàn cục tạo template (superadmin)
`updated_by`	`UUID`	ID người dùng toàn cục cập nhật gần nhất
`created_at`	`TIMESTAMPTZ`	Thời điểm tạo template
`updated_at`	`TIMESTAMPTZ`	Thời điểm cập nhật gần nhất

🔗 Liên kết & Sử dụng¶

Liên kết 1-n với: global_permissions_templates thông qua bảng phụ global_role_permissions_templates
Được dùng khi:
Giao diện quản trị tạo hoặc sửa mẫu role
Gán vai trò mặc định khi khởi tạo tenant mới
Đồng bộ RBAC từ master → sub

📤 Sự kiện phát ra¶

role_template.created: Khi superadmin tạo mẫu vai trò mới
role_template.updated: Khi cập nhật nội dung role hoặc quyền liên quan
Các sự kiện này được phát qua Pub/Sub để đồng bộ xuống user-service/sub theo từng tenant nếu có yêu cầu áp dụng mẫu.

10. Chi tiết bảng: `global_permissions_templates`¶

🧾 Mục đích¶

Bảng global_permissions_templates định nghĩa tập các quyền (permission) dùng chung trên toàn hệ thống, đóng vai trò là mẫu nền tảng cho cơ chế RBAC phân tầng. Các quyền này sẽ được liên kết với global_roles_templates để tạo thành cấu trúc role-permission mặc định cho mỗi tenant. Chúng đảm bảo sự thống nhất, an toàn và dễ mở rộng trong quản lý phân quyền hệ thống.

📜 Câu lệnh `CREATE TABLE`¶

CREATE TABLE global_permissions_templates (
  permission_template_id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  permission_key TEXT NOT NULL UNIQUE,
  permission_name TEXT NOT NULL,
  description TEXT,
  service_scope TEXT NOT NULL,
  created_by UUID NOT NULL REFERENCES users_global(user_id),
  updated_by UUID REFERENCES users_global(user_id),
  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
  updated_at TIMESTAMPTZ
);

🧩 Giải thích cột¶

Cột	Kiểu dữ liệu	Ý nghĩa
`permission_template_id`	`UUID`	Mã định danh của mẫu quyền
`permission_key`	`TEXT`	Khóa kỹ thuật, định danh duy nhất (e.g., `user.read:any`, `tenant.update`)
`permission_name`	`TEXT`	Tên hiển thị thân thiện của quyền
`description`	`TEXT`	Mô tả chức năng quyền
`service_scope`	`TEXT`	Tên service liên quan (e.g., `user-service`, `tenant-service`)
`created_by`	`UUID`	ID người dùng toàn cục tạo quyền
`updated_by`	`UUID`	ID người dùng toàn cục cập nhật gần nhất
`created_at`	`TIMESTAMPTZ`	Thời điểm tạo mẫu quyền
`updated_at`	`TIMESTAMPTZ`	Thời điểm cập nhật gần nhất

🔗 Liên kết & Sử dụng¶

Liên kết 1-n với: global_roles_templates qua bảng trung gian global_role_permissions_templates
Được sử dụng khi:
Khởi tạo hệ thống phân quyền tenant mới
Hiển thị danh sách quyền cho UI quản trị hệ thống
Phân quyền mặc định trong các service sử dụng RBAC (Auth, User, Token…)

📤 Sự kiện phát ra¶

permission_template.created: Khi superadmin tạo quyền mới
permission_template.updated: Khi cập nhật mô tả hoặc phạm vi quyền
Các sự kiện này được publish qua Pub/Sub để phục vụ audit logging và/hoặc đồng bộ định nghĩa quyền tới các hệ thống phụ trợ nếu cần.

11. Chi tiết bảng: `global_role_permissions_templates`¶

🧾 Mục đích¶

Bảng global_role_permissions_templates định nghĩa quan hệ nhiều-nhiều giữa các vai trò mẫu (global_roles_templates) và các quyền mẫu (global_permissions_templates). Đây là bảng trung gian quan trọng giúp ánh xạ cấu trúc phân quyền mặc định cho từng loại người dùng, đóng vai trò làm nền cho quá trình khởi tạo RBAC cho từng tenant mới trong hệ thống multi-tenant.

📜 Câu lệnh `CREATE TABLE`¶

CREATE TABLE global_role_permissions_templates (
  role_template_id UUID NOT NULL REFERENCES global_roles_templates(role_template_id) ON DELETE CASCADE,
  permission_template_id UUID NOT NULL REFERENCES global_permissions_templates(permission_template_id) ON DELETE CASCADE,
  PRIMARY KEY (role_template_id, permission_template_id)
);

🧩 Giải thích cột¶

Cột	Kiểu dữ liệu	Ý nghĩa
`role_template_id`	`UUID`	Khóa ngoại đến bảng mẫu vai trò
`permission_template_id`	`UUID`	Khóa ngoại đến bảng mẫu quyền
PRIMARY KEY	`(role_template_id, permission_template_id)`	Đảm bảo duy nhất mỗi cặp role-permission

ON DELETE CASCADE đảm bảo nếu role hoặc permission bị xóa, các ánh xạ liên quan cũng bị xóa theo → tránh orphan records.

🔗 Liên kết & Sử dụng¶

Liên kết 1-n từ:
global_roles_templates.role_template_id
global_permissions_templates.permission_template_id
Được sử dụng khi:
Tạo mới hoặc chỉnh sửa mẫu vai trò trong UI quản trị hệ thống
Khởi tạo dữ liệu RBAC mặc định cho tenant mới (phân phối role → permission)
Đồng bộ dữ liệu RBAC từ master → sub khi có cập nhật quyền hệ thống

📤 Sự kiện phát ra¶

Không phát sinh sự kiện riêng từ bảng này.
Tuy nhiên, khi cập nhật mapping này (thêm/xóa permission trong role), các service cần phát role_template.updated từ logic nghiệp vụ ở tầng ứng dụng.

12. Các bảng phụ trợ & phụ lục¶

🔄 Bảng: `processed_events`¶

📌 Mục đích¶

Ghi lại các sự kiện đã xử lý để đảm bảo tính idempotent trong hệ thống Event-Driven (ví dụ: khi nhận lại cùng một sự kiện từ Pub/Sub).

CREATE TABLE processed_events (
  event_id UUID PRIMARY KEY,              -- 🔑 ID duy nhất của sự kiện
  service_name TEXT NOT NULL,             -- 🧭 Tên service xử lý sự kiện
  processed_at TIMESTAMPTZ DEFAULT now()  -- ⏱️ Thời điểm xử lý
);

📋 Giải thích¶

Cột	Kiểu dữ liệu	Ý nghĩa
`event_id`	UUID	ID sự kiện (thường đến từ metadata của Pub/Sub)
`service_name`	TEXT	Tên service đã xử lý sự kiện này
`processed_at`	TIMESTAMPTZ	Thời điểm xử lý

📘 Phụ lục A – Các Index quan trọng¶

Bảng	Cột	Loại Index
`users_global`	`(email, auth_provider)`	UNIQUE INDEX
`user_tenant_assignments`	`(user_id_global, tenant_id)`	UNIQUE INDEX
`tenants`	`tenant_id`	PRIMARY KEY
`global_roles_templates`	`template_code`	UNIQUE INDEX
`global_permissions_templates`	`permission_code`	UNIQUE INDEX

📘 Phụ lục B – Ràng buộc đặc biệt¶

users_global.email chỉ là UNIQUE trong phạm vi auth_provider (nếu muốn hỗ trợ nhiều provider).
user_tenant_assignments có thể được mở rộng để lưu cả trạng thái invited, active, revoked.

📘 Phụ lục C – Các sự kiện phát ra từ User Service Master¶

Sự kiện	Trigger	Mục đích
`user_global_created`	Khi tạo user mới	Cho phép các service khác khởi tạo liên kết
`tenant_created`	Khi tạo tenant	Cho phép Sub Service tạo môi trường dữ liệu
`tenant_user_assigned`	Khi gán user vào tenant	Đồng bộ RBAC và tạo user cục bộ ở Sub Service
`rbac_template_updated`	Khi cập nhật role/permission templates	Thông báo Sub Service cập nhật cấu hình RBAC

📘 Phụ lục D – Enum và giá trị đặc biệt¶

auth_provider:
google
local
otp
user_tenant_assignments.status (nếu có mở rộng):
active
revoked
invited

📘 Phụ lục E – Chiến lược kiểm thử liên quan đến mô hình dữ liệu¶

🔍 1. Kiểm thử mức cơ sở dữ liệu (Database-level)¶

Loại kiểm thử	Mô tả
✅ Ràng buộc PK/FK	Đảm bảo không thể insert/update dữ liệu sai liên kết giữa các bảng
✅ Ràng buộc UNIQUE	Kiểm thử các cột `email`, `template_code`, `permission_code` không bị trùng
✅ Enum/Constraint logic	Kiểm thử giá trị hợp lệ của `auth_provider`, `status`, v.v.
✅ Trigger (nếu có)	Nếu sử dụng trigger (ví dụ: audit log, cascading update), cần test kỹ

🔄 2. Kiểm thử tính toàn vẹn dữ liệu xuyên suốt (Integration Data Consistency)¶

Tình huống kiểm thử	Mong đợi
Tạo user mới → Gán vào tenant	Ghi đúng `users_global`, `user_tenant_assignments`, phát đúng event
Cập nhật template RBAC	Ghi đúng bảng template, phát sự kiện `rbac_template_updated`
Gỡ user khỏi tenant	Không còn entry trong `user_tenant_assignments`, phát sự kiện nếu cần
Xử lý lại event trùng (`processed_events`)	Event không bị xử lý lại nhiều lần

⚙️ 3. Kiểm thử với dữ liệu mẫu¶

Tên tập dữ liệu	Mô tả
`test_user_1.json`	Một user Google, đã gán vào 2 tenants
`test_templates.yaml`	Role template với nhiều permission có `default_condition` phức tạp
`test_event.json`	Sự kiện giả lập `tenant_user_assigned` để test idempotency

🛡️ 4. Kiểm thử bảo mật dữ liệu (Security-focused DB tests)¶

Loại kiểm thử	Mô tả
Truy cập trái phép dữ liệu tenant khác	Đảm bảo query luôn có điều kiện `tenant_id`, không rò rỉ dữ liệu
SQL Injection / Escaping	Kiểm thử các cột dạng TEXT để đảm bảo escaping đúng (qua ORM)

User Service Master - Data Model¶

1. Giới thiệu¶

2. Phạm vi¶

3. Không bao gồm (Out of Scope)¶

4. Mục tiêu¶

5. Các bảng chính và phân nhóm logic¶

🔹 Nhóm A – Định danh người dùng và phân quyền toàn cục¶

🔹 Nhóm B – Template RBAC dùng chung¶

🔹 Nhóm C – Hỗ trợ & Mở rộng (tuỳ chọn)¶

6. Chi tiết bảng: users_global¶

🧾 Mục đích¶

📜 Câu lệnh CREATE TABLE¶

🧩 Giải thích cột¶

🔗 Liên kết & Chỉ số¶

7. Chi tiết bảng: tenants¶

🧾 Mục đích¶

📜 Câu lệnh CREATE TABLE¶

🧩 Giải thích cột¶

🔗 Liên kết & Chỉ số¶

8. Chi tiết bảng: user_tenant_assignments¶

🧾 Mục đích¶

📜 Câu lệnh CREATE TABLE¶

🧩 Giải thích cột¶

🔗 Liên kết & Chỉ số¶

📤 Sự kiện phát ra¶

9. Chi tiết bảng: global_roles_templates¶

🧾 Mục đích¶

📜 Câu lệnh CREATE TABLE¶

🧩 Giải thích cột¶

🔗 Liên kết & Sử dụng¶

📤 Sự kiện phát ra¶

10. Chi tiết bảng: global_permissions_templates¶

🧾 Mục đích¶

📜 Câu lệnh CREATE TABLE¶

🧩 Giải thích cột¶

🔗 Liên kết & Sử dụng¶

📤 Sự kiện phát ra¶

11. Chi tiết bảng: global_role_permissions_templates¶

🧾 Mục đích¶

📜 Câu lệnh CREATE TABLE¶

🧩 Giải thích cột¶

🔗 Liên kết & Sử dụng¶

📤 Sự kiện phát ra¶

12. Các bảng phụ trợ & phụ lục¶

🔄 Bảng: processed_events¶

📌 Mục đích¶

📋 Giải thích¶

📘 Phụ lục A – Các Index quan trọng¶

📘 Phụ lục B – Ràng buộc đặc biệt¶

📘 Phụ lục C – Các sự kiện phát ra từ User Service Master¶

📘 Phụ lục D – Enum và giá trị đặc biệt¶

📘 Phụ lục E – Chiến lược kiểm thử liên quan đến mô hình dữ liệu¶

🔍 1. Kiểm thử mức cơ sở dữ liệu (Database-level)¶

🔄 2. Kiểm thử tính toàn vẹn dữ liệu xuyên suốt (Integration Data Consistency)¶

⚙️ 3. Kiểm thử với dữ liệu mẫu¶

🛡️ 4. Kiểm thử bảo mật dữ liệu (Security-focused DB tests)¶

📂 5. Gợi ý công cụ hỗ trợ¶

📘 Tham chiếu chéo¶

📘 Phụ lục F – Liên kết tài liệu¶

6. Chi tiết bảng: `users_global`¶

📜 Câu lệnh `CREATE TABLE`¶

7. Chi tiết bảng: `tenants`¶

📜 Câu lệnh `CREATE TABLE`¶

8. Chi tiết bảng: `user_tenant_assignments`¶

📜 Câu lệnh `CREATE TABLE`¶

9. Chi tiết bảng: `global_roles_templates`¶

📜 Câu lệnh `CREATE TABLE`¶

10. Chi tiết bảng: `global_permissions_templates`¶

📜 Câu lệnh `CREATE TABLE`¶

11. Chi tiết bảng: `global_role_permissions_templates`¶

📜 Câu lệnh `CREATE TABLE`¶

🔄 Bảng: `processed_events`¶