Resource OS

Dùng sớm

Lớp điều phối nguồn lực live commerce, từ nhu cầu và lịch làm việc đến phiên thương mại, quyết toán và dữ liệu công suất.

1. Resource OS là gì?

Resource OS là lớp điều phối nguồn lực của PORO, giúp kết nối nhu cầu thương mại với nhà sáng tạo, studio và đội ngũ vận hành.

Nhu cầu
   ↓
Nguồn lực
   ↓
Ghép nối
   ↓
Đặt lịch
   ↓
Phiên
   ↓
Quyết toán
   ↓
Công suất

Resource OS không phải ứng dụng phát sóng. PORO không thay thế TikTok Live Studio, OBS, Shopee Live, Seller Center hoặc các kênh bán hàng hiện có.

Nhà sáng tạo / Nhà bán hàng
             ↓
TikTok Live Studio / OBS / Shopee Live / công cụ hiện có
             ↓
Lớp vận hành thương mại PORO
             ↓
Thương mại / Tồn kho / Quyết toán / Phân tích

PORO điều phối quy trình thương mại và vận hành xung quanh phiên live; công cụ phát sóng tiếp tục đảm nhiệm phần media.

2. Khái niệm cốt lõi

Khái niệm	Định nghĩa
Nguồn lực	Nhà sáng tạo, studio, đội ngũ vận hành hoặc thương hiệu có năng lực và lịch làm việc được đăng ký.
Nhu cầu	Yêu cầu thương mại do thương hiệu hoặc nhà bán hàng tạo.
Chiến dịch	Nhu cầu có cấu trúc, có thể gồm SKU, lịch, yêu cầu nguồn lực, địa điểm, ngân sách và thời lượng.
Đặt lịch	Phân bổ công suất nguồn lực ở trạng thái đề xuất, giữ tạm hoặc đã xác nhận.
Phiên	Hoạt động vận hành và thương mại gắn với một lịch đã xác nhận.

Phiên Resource OS không đồng nghĩa với luồng phát media. Phiên mô tả việc thực hiện thương mại và vận hành; luồng phát mô tả hạ tầng truyền tải hình ảnh, âm thanh.

3. Vòng đời và trạng thái

Nguồn lực
Nháp → Chờ xác minh → Đang hoạt động → Tạm ngưng

Đặt lịch
Đề xuất → Giữ tạm → Đã xác nhận → Hoàn tất
     └──────────────→ Đã hủy

Phiên
Đã lên lịch → Đang diễn ra → Hoàn tất
      └────────────→ Đã hủy

Mọi lệnh ghi trong Resource OS bắt buộc gửi header Idempotency-Key. Gọi lại cùng khoá trả về kết quả trước đó thay vì tạo giao dịch trùng.

4. Bản đồ API

Resource OS API đang ở trạng thái Dùng sớm có kiểm soát. Các đường dẫn dưới đây đã được phát hành trong namespace /api/public/v1 và yêu cầu khoá API hợp lệ.

Phương thức	Đường dẫn	Mục đích
GET, POST	/ros/resources	Liệt kê hoặc đăng ký nguồn lực
POST	/ros/resources/verify	Xác minh nguồn lực
POST	/ros/resources/suspend	Tạm ngưng nguồn lực
POST	/ros/availability	Khai báo lịch rảnh hoặc thời gian bị chặn
GET, POST	/ros/campaigns	Liệt kê hoặc tạo chiến dịch
POST	/ros/campaigns/match	Ghép nguồn lực cho chiến dịch
GET, POST	/ros/bookings	Liệt kê hoặc giữ lịch tạm thời
POST	/ros/bookings/confirm	Xác nhận đặt lịch
POST	/ros/bookings/cancel	Hủy đặt lịch
GET	/ros/sessions	Liệt kê phiên
POST	/ros/sessions/participants	Thêm nguồn lực tham gia
POST	/ros/sessions/start	Bắt đầu phiên
POST	/ros/sessions/complete	Hoàn tất phiên và kích hoạt quyết toán
GET	/ros/capacity	Truy vấn chỉ số công suất

Contract hiện tại truyền resource_id, campaign_id, booking_id và session_id qua body hoặc query. Không sử dụng đường dẫn /{id}. Trình thử API hiện hỗ trợ Gateway chung; dùng OpenAPI hoặc cURL để đối chiếu trực tiếp nhóm Resource OS.

Sự kiện liên quan gồm booking.*, session.completed và payout.*; phạm vi sự kiện thực tế phụ thuộc cấu hình webhook của tổ chức.

Đặc tả OpenAPI →Trình thử API →Bắt đầu nhanh →

5. Mô hình kinh tế

Chiến dịch → Đặt lịch → Hoàn tất phiên → Quyết toán → Sổ cái → Ví / Chi trả

Một phiên hoàn tất có thể tạo sự kiện quyết toán cho các nguồn lực tham gia và doanh thu nền tảng theo quy tắc của từng tổ chức.

Thương hiệu / Bên thanh toán
            ↓
      Phiên thương mại
            ↓
Nhà sáng tạo / Studio / Đội ngũ vận hành
            ↓
     Hoa hồng / Quyết toán
            ↓
       Phí nền tảng PORO

Quy tắc và tỷ lệ có thể thay đổi theo tổ chức, chiến dịch và thỏa thuận thương mại; tài liệu này không công bố một tỷ lệ hoa hồng cố định.

6. Chỉ số công suất

available_hours — tổng số giờ nguồn lực khai báo có thể làm việc
booked_hours — số giờ đã được xác nhận
held_hours — số giờ đang được giữ tạm
idle_hours — số giờ còn khả dụng sau khi trừ lịch đặt, lịch giữ và thời gian bị chặn
utilization_rate — tỷ lệ giờ đã đặt trên tổng giờ khả dụng
monetizable_idle_hours — phần công suất còn trống có thể đưa vào ghép nối thương mại

idle_hours = available_hours - booked_hours - held_hours - blocked_hours
utilization_rate = booked_hours / available_hours

GET /ros/capacity hỗ trợ resource_id, from và to. Dữ liệu công suất có thể hỗ trợ hoạch định vận hành, định giá nguồn lực và ghép nhu cầu trong tương lai; đây không phải bằng chứng về độ phủ địa lý.

7. Phạm vi hiện tại và giới hạn

Nền tảng hiện cung cấp quyền truy cập API, xác thực, mô hình tổ chức và nhiều khách hàng, phân quyền, Commerce API, webhook và sự kiện, nền tảng đo mức dùng và tính phí, Console và không gian làm việc.

Resource OS được phát triển và triển khai dần theo từng giai đoạn. Khả năng cung ứng thực tế phụ thuộc vào người tham gia đã xác minh, đối tác vận hành, lộ trình địa lý và quá trình tiếp nhận thương mại.

Roadmap kỹ thuật và khung đo lường

PORO định hướng đánh giá mô hình công suất phân tán tại TP.HCM và các tỉnh vệ tinh theo từng giai đoạn. Đây là hướng nghiên cứu triển khai, không phải thông báo một pilot đang vận hành.

Nguồn lực đăng ký và đã xác minh
Lịch rảnh, giờ đã đặt và mức sử dụng
Tỷ lệ ghép nối và chuyển đổi thành đặt lịch
Mức hoàn tất phiên
Giá trị giao dịch và quyết toán
Công suất có thể thương mại hóa

Các chỉ số trên là khung PORO dự kiến đo khi có triển khai phù hợp; không phải số liệu vận hành, bằng chứng độ phủ hoặc cam kết kết quả hiện tại.

Supply thực tế, đối tác địa phương và độ phủ cụm địa lý không nằm trong cam kết của bản tài liệu này.

Không cam kết số lượng nhà sáng tạo hoặc studio cụ thể.
Không cam kết độ phủ nguồn lực toàn quốc hoặc khả năng sẵn sàng tại một khu vực cụ thể.
Không cam kết tích hợp partner API production của TikTok hoặc Shopee thông qua Resource OS.
Không công bố GMV hoặc kết quả kinh doanh của chương trình thử nghiệm khi chưa được xác minh độc lập.

8. Bắt đầu nhanh

Tạo hoặc nhận khoá API
          ↓
Đăng ký nguồn lực
          ↓
Khai báo lịch rảnh
          ↓
Tạo chiến dịch
          ↓
Ghép nguồn lực
          ↓
Giữ lịch tạm thời
          ↓
Xác nhận đặt lịch
          ↓
Bắt đầu phiên
          ↓
Hoàn tất phiên
          ↓
Quyết toán
          ↓
Cập nhật chỉ số công suất

Xác thực →Webhooks →Sự kiện →Hạn mức →Tính phí →