Tenant Operations Guide (Beta-5)

Vận hành Tenant qua ops CLI — không SQL thủ công. Mọi thao tác có audit. Không chứa secret.
Nguồn sự thật: src/ops/cli.ts. Vòng đời: ../platform/TENANT-LIFECYCLE.md.
Partner ops (Beta-4): PARTNER-OPERATIONS.md.

Chạy CLI

cd packages/platform-infrastructure
npm run ops -- <command> [flags] [--json]

Lệnh terminal (archive-tenant) bắt buộc --confirm; thiếu → exit 2.

Bảng lệnh Tenant

Quy trình chuẩn

1. Tạo tenant + gắn partner

# Cần Partner đã tồn tại (Beta-4): create-partner + activate-partner
npm run ops -- provision-tenant --partner <partnerId> --tenant t_acme --name "Acme" --json
# → { partner, tenantId, status:"provisioned" }

Tenant ở provisioned — booking chưa chạy.

2. Provision inventory

npm run ops -- seed-inventory --tenant t_acme --json
# nạp listing/unit/price/availability mẫu ⇒ Availability trả dữ liệu thật

3. Kích hoạt

npm run ops -- activate-tenant --tenant t_acme --json   # provisioned → active

Từ đây booking chạy (với Partner active + API key hợp lệ).

4. Suspend

npm run ops -- suspend-tenant --tenant t_acme --reason nonpayment

Hiệu lực tức thì: availability/booking → 403 TENANT_INACTIVE. Inventory/key/reservation KHÔNG bị xoá (thuận nghịch).

5. Re-activate

npm run ops -- reactivate-tenant --tenant t_acme

Booking chạy lại — cùng inventory + cùng API key, không cấp lại.

6. Archive (đóng vĩnh viễn)

npm run ops -- archive-tenant --tenant t_acme --reason offboarding --confirm

Terminal: booking bị chặn vĩnh viễn (403). Không hoàn tác.

7. Kiểm tra tenant health

npm run ops -- tenant-health --tenant t_acme --json
# → { tenantId, status, partnerId, listings, units, reservations }

Chỉ đọc, không secret. Dùng để xác nhận trạng thái + đếm inventory/booking trước/sau thao tác.

Quan hệ với Partner (Beta-4)

• Một request qua hai cổng: Partner active (auth) và Tenant active (booking). Cả hai phải active.
• Suspend Partner → 401 (auth). Suspend Tenant → 403 (TENANT_INACTIVE). Phân biệt để chẩn đoán đúng lớp.
• Muốn ngưng một khách trọn vẹn: suspend Partner (chặn mọi key) hoặc suspend Tenant (chặn booking) — tuỳ mục đích.

An toàn

• Không lệnh Tenant nào in secret. tenant-health/show-audit chỉ metadata an toàn.
• Thao tác Tenant chạy qua ProvisioningService (role ops/maintenance) — cập nhật tenants (bảng RLS) hợp lệ ngoài request path.