Bỏ qua

E-003 — Đóng gói và định giá

Nguồn: PRD prd-openapi-platform-2026-09-04 §5 (F12, F13) · spine architecture-openapi-platform-2026-09-04 (AD-3, AD-21) · story chi tiết + AC ở _bmad-output/planning-artifacts/epics.md (mục Epic E-003). PO duyệt cấu trúc epic + ô parity: 05/09/2026 — duyệt cả danh sách epic và bảng story.

Đóng API thành Sản phẩm phân phối được, bán theo Gói có hạn mức và tần suất.

Vì sao làm — BRD tầng epic

Mục tiêu. Đóng API thành Sản phẩm phân phối được, bán theo Gói có hạn mức và tần suất.

Nhóm yêu cầu trong PRD — F12, F13

F12 — Sản phẩm API

  • FR-075 Sản phẩm API đóng gói nhiều API để phân phối tới bên thứ ba: tên, mã, phiên bản, mô tả, Domain, trạng thái (Bản nháp / Đã xuất bản).
  • FR-076 Tạo và sửa qua quy trình ba bước: Thông tin chung → Chọn API → Gói cước và hạn mức.
  • FR-077 Sản phẩm ở trạng thái Bản nháp không cấp phát được; chỉ Đã xuất bản mới xuất hiện cho bên thứ ba đăng ký.
  • FR-078Nhóm TT64 của sản phẩm suy từ tập API nó chứa (FR-070), không khai tay. Sản phẩm chứa bất kỳ API nào thuộc PIS hoặc EWLTS thì cả sản phẩm mang ràng buộc đó. Nhóm hiển thị cho người quản trị thấy trước khi xuất bản.
  • FR-079 Thêm một API thuộc nhóm hạn chế vào sản phẩm đã xuất bản phải cảnh báo: các bên thứ ba đang dùng sản phẩm có thể không còn đủ điều kiện theo khoản 3 Điều 5.
  • FR-080 Phiên bản hoá sản phẩm: sửa sản phẩm đã có bên thứ ba đăng ký không được đổi ngầm phạm vi họ đã được duyệt.
  • FR-081 Danh sách hiển thị số lượng API trong mỗi sản phẩm.

F13 — Gói đăng ký API

  • FR-082 Gói đăng ký gắn với một Sản phẩm API: tên gói, giá, hạn mức, tần suất, trạng thái.
  • FR-083 Một sản phẩm có nhiều gói (ví dụ theo mức sử dụng).
  • FR-084 Hạn mức và tần suất trong gói là điều khoản thương mại. Chúng cùng tồn tại với trần pháp lý ở FR-031, và giá trị nhỏ hơn thắng.
  • FR-085 Đổi hạn mức của gói đang có bên thứ ba dùng phải qua phê duyệt và có hiệu lực công bố được — không đổi lặng lẽ.
  • FR-086 Giá là thông tin hiển thị, không kéo theo chức năng thanh toán ở giai đoạn 1. [ASSUMPTION] Chưa rõ có tích hợp thu phí không.
  • FR-087 Danh sách gói có tìm kiếm và phân trang.

Bảng story → change

Story Service Thứ tự bắt buộc Ghi chú Chặn bởi
E-003/1.1 Schema và API Sản phẩm admin-be 1 cap/api-product-plan · nhóm TT64 TÍNH RA từ tập API, không lưu M:E-002/1.3
E-003/1.2 Quy trình ba bước tạo sản phẩm admin-fe 2 cap/admin-console-ui · WizardSteps từ E-001/5.1 M:E-003/1.1 · M:E-001/5.1
E-003/1.3 Schema và API Gói đăng ký admin-be 3 cap/api-product-plan · hạn mức thương mại, nhỏ hơn thắng M:E-003/1.1
E-003/1.4 Màn Gói đăng ký admin-fe 4 cap/admin-console-ui M:E-003/1.3 · M:E-001/5.5
E-003/1.5 Chặn thêm API nhóm hạn chế vào sản phẩm đã xuất bản admin-be 5 cap/api-product-plan · ⛔ AD-21 lớp 3, đường lách rõ nhất M:E-003/1.1 · M:E-002/1.6

1.5 không phải việc phụ. Ba lớp còn lại của AD-21 đều kiểm ở thời điểm cấp quyền, nên không lớp nào bắt được đường: xuất bản sản phẩm sạch → để đăng ký → nhét API thanh toán vào sau.

⚠️ THIẾU VẬT MANG — hàng 6 và 8 của ma trận AD-20 chưa có chủ (đo 08/09/2026). portal_app cần SELECT trên API_PRODUCT/PLAN (chỉ bản đã xuất bản) và trên bảng cấu hình hạn mứcAD-8 đặt portal-be làm điểm thi hành hạn mức. Không story nào mang hai câu GRANT ấy. ⛔ Đề nghị S2S6 đang chờ PO duyệt, xem docs/ra-soat-kien-truc-2026-09-08.md.

⚠️ BL-08 chưa rõ có nhà. Backlog tuân thủ đòi «chừa chỗ ngay» = cột trần pháp lý tách khỏi hạn mức thương mại; 1.3 mới nói hai thứ cùng tồn tại, nhỏ hơn thắng. Nếu không khai cột ngay ở lượt này thì sau phải bóc ngược — cần PO xác nhận.


Các nhóm việc (feature)

Hệ Admin