prd-to-gherkin

PRD to Gherkin Feature File Writer

Convert Lean PRD thành Gherkin .feature files. Mỗi scenario bắt buộc nằm trong Rule: block — không có scenario nào được phép đứng độc lập.

Ngôn ngữ

• Gherkin syntax (Feature, Rule, Scenario, Given, When, Then, And, But, Background, Scenario Outline, Examples) → tiếng Anh
• Nội dung steps, Rule description, Feature description → tiếng Việt
• Tag names → tiếng Anh (lowercase, kebab-case)

Ví dụ:

Feature: Xuất hóa đơn điện tử
  As a chủ cửa hàng
  I want xuất hóa đơn trực tiếp từ POS
  So that tránh nhập lại dữ liệu thủ công

  Rule: Chỉ merchant có gói trả phí active mới được xuất hóa đơn

    @api @smoke
    Scenario: Merchant gói trả phí xuất hóa đơn thành công
      Given Minh có gói trả phí đang active
      And Minh có đơn hàng đã hoàn thành
      When Minh yêu cầu xuất hóa đơn cho đơn hàng
      Then hóa đơn được tạo với trạng thái "Nháp"

---

Core Mental Model: PRD → Example Mapping → Feature File

PRD Section              →  Gherkin Construct
─────────────────────────────────────────────
Feature Name             →  Feature: <tên>
Bối cảnh                 →  Feature description (narrative)
User Stories (As a...)   →  Persona context trong Background hoặc step names
Business Rule Must Have  →  Rule: <business rule> → Scenarios
Business Rule Should Have →  Rule: <business rule> → Scenarios (tag @p2)
Business Rule Won't Have →  Không generate scenario
Open Questions           →  # TODO: comment trong feature file

Rule: keyword là bắt buộc — nó nhóm scenarios theo business rule, tạo traceability ngược về PRD.

Quy tắc tuyệt đối: Scenario PHẢI nằm trong Rule

# ✅ ĐÚNG — scenario nằm trong Rule
Rule: Mã số thuế phải đúng format 10 hoặc 13 chữ số

  Scenario: Merchant nhập mã số thuế 10 chữ số hợp lệ
    ...

  Scenario: Hệ thống từ chối mã số thuế sai format
    ...

# ❌ SAI — scenario không nằm trong Rule, KHÔNG BAO GIỜ LÀM ĐIỀU NÀY
Scenario: Merchant nhập mã số thuế
  ...