@longph2102/v-flow 1.5.0

package/skills/specify/ba-doc-generator/references/template-partner.md

@@ -0,0 +1,167 @@
+# Template: Integration Specification
+> Dành cho: External Partner / Đối tác tích hợp / Third-party
+> Mục đích: Tài liệu kỹ thuật tích hợp hệ thống
+
+---
+
+## Nguyên tắc viết cho Partner/Integration
+- Ngôn ngữ chính thức, rõ ràng, không ambiguous
+- API contract phải đầy đủ: endpoint, method, header, request, response, error codes
+- Có SLA và contact point rõ ràng
+- Bao gồm security requirements (auth method, encryption)
+- Có môi trường test để partner tích hợp trước khi production
+
+---
+
+## CẤU TRÚC TÀI LIỆU
+
+```
+# Integration Specification: [Tên tích hợp]
+**Ngày**: [Date] | **Phiên bản**: [v1.0]
+**Bên cung cấp**: [Tên công ty / hệ thống của bạn]
+**Bên tiếp nhận**: [Tên đối tác]
+**Phân loại**: [Confidential / Internal]
+
+---
+
+## 1. Tổng quan tích hợp
+- **Mục đích**: [Tích hợp này dùng để làm gì]
+- **Loại tích hợp**: REST API / SOAP / File-based / Message Queue
+- **Chiều dữ liệu**: [A → B] / [A ↔ B] / [B → A]
+- **Tần suất**: Real-time / Batch [X lần/ngày] / Event-driven
+
+---
+
+## 2. Môi trường
+
+| Môi trường | Base URL | Mục đích |
+|-----------|----------|----------|
+| Development | https://dev-api.[domain].com | Phát triển & unit test |
+| Staging | https://staging-api.[domain].com | Integration test |
+| Production | https://api.[domain].com | Live |
+
+---
+
+## 3. Authentication & Security
+
+- **Phương thức xác thực**: [API Key / OAuth 2.0 / JWT / Basic Auth]
+- **Truyền credential**: Header `Authorization: Bearer {token}`
+- **HTTPS**: Bắt buộc cho tất cả môi trường
+- **IP Whitelist**: [Danh sách IP nếu có]
+- **Cách lấy credential**:
+  1. [Bước 1]
+  2. [Bước 2]
+
+---
+
+## 4. API Endpoints
+
+### 4.1 [Tên API 1 — ví dụ: Tạo đơn hàng]
+
+| | |
+|--|--|
+| **Endpoint** | `POST /api/v1/orders` |
+| **Content-Type** | `application/json` |
+| **Timeout** | 30 giây |
+
+**Request Headers:**
+```
+Authorization: Bearer {access_token}
+Content-Type: application/json
+X-Request-ID: {unique_request_id}
+```
+
+**Request Body:**
+```json
+{
+  "order_code": "string (required, max 50 chars)",
+  "customer_id": "string (required)",
+  "amount": "number (required, > 0)",
+  "currency": "string (required, ISO 4217: VND/USD)",
+  "items": [
+    {
+      "product_id": "string",
+      "quantity": "integer",
+      "unit_price": "number"
+    }
+  ],
+  "metadata": {
+    "reference_id": "string (optional)"
+  }
+}
+```
+
+**Response 200 — Success:**
+```json
+{
+  "success": true,
+  "data": {
+    "order_id": "string",
+    "status": "PENDING",
+    "created_at": "ISO8601 timestamp"
+  },
+  "request_id": "string"
+}
+```
+
+**Error Responses:**
+| HTTP Code | Error Code | Mô tả | Cách xử lý |
+|-----------|-----------|-------|-----------|
+| 400 | INVALID_INPUT | Dữ liệu đầu vào không hợp lệ | Kiểm tra lại request body |
+| 401 | UNAUTHORIZED | Token không hợp lệ / hết hạn | Refresh token |
+| 409 | DUPLICATE_ORDER | order_code đã tồn tại | Dùng order_code khác |
+| 429 | RATE_LIMIT | Vượt giới hạn request | Retry sau X giây |
+| 500 | INTERNAL_ERROR | Lỗi hệ thống | Liên hệ support |
+
+---
+
+### 4.2 [Tên API 2]
+...
+
+---
+
+## 5. Data Dictionary
+| Field | Type | Format | Mô tả | Ví dụ |
+|-------|------|--------|-------|-------|
+| order_code | String | Alphanumeric, max 50 | Mã đơn hàng duy nhất | "ORD-2024-001" |
+| amount | Decimal | 15,2 | Số tiền, không âm | 150000.00 |
+| currency | String | ISO 4217 | Mã tiền tệ | "VND" |
+
+---
+
+## 6. SLA & Giới hạn
+
+| Chỉ số | Giá trị |
+|--------|---------|
+| Uptime cam kết | 99.5% |
+| Response time (p95) | < 2 giây |
+| Rate limit | 100 requests/phút |
+| Batch size tối đa | 1000 records/request |
+| File size tối đa | 10MB |
+
+---
+
+## 7. Xử lý lỗi & Retry
+
+- **Idempotency**: Dùng `X-Request-ID` để tránh duplicate khi retry
+- **Retry policy**: Retry tối đa 3 lần, exponential backoff (1s → 2s → 4s)
+- **Không retry**: HTTP 400, 401, 403, 409 (lỗi client)
+- **Có thể retry**: HTTP 429, 500, 502, 503, 504
+
+---
+
+## 8. Changelog & Versioning
+| Phiên bản | Ngày | Thay đổi |
+|-----------|------|---------|
+| v1.0 | [Date] | Initial release |
+
+---
+
+## 9. Contact & Support
+| Vai trò | Họ tên | Email | Hotline |
+|---------|--------|-------|---------|
+| BA / Solution Owner | [Tên] | [Email] | |
+| Technical Support | [Tên] | [Email] | [Phone] |
+| Escalation | [Tên] | [Email] | |
+| Giờ hỗ trợ | | | [Thứ 2-6, 8h-17h30] |
+```

package/skills/specify/ba-doc-generator/references/template-pm.md

@@ -0,0 +1,92 @@
+# Template: Product Brief
+> Dành cho: Product Owner / Project Manager
+> Mục đích: Quản lý scope, timeline, dependency, risk
+
+---
+
+## Nguyên tắc viết cho PM/PO
+- Cân bằng business + technical context
+- Focus vào: Scope rõ ràng, dependency, risk, decision log
+- Cần đủ chi tiết để PM/PO breakdown task và estimate
+- Highlight assumption và open question
+- Có phần thay đổi so với version trước (nếu là update)
+
+---
+
+## CẤU TRÚC TÀI LIỆU
+
+```
+# [Tên tính năng / Epic / Change Request]
+**Ngày**: [Date] | **BA**: [Name] | **PO/PM**: [Name] | **Phiên bản**: [v0.1]
+**Trạng thái**: Draft / In Review / Approved
+
+---
+
+## 1. Mục tiêu
+- Business goal: [Tại sao làm tính năng này?]
+- Success metric: [Đo thành công bằng gì?]
+- Liên kết OKR/KPI: [Nếu có]
+
+---
+
+## 2. Scope
+
+### Trong scope
+- [Tính năng / Use case 1]
+- [Tính năng / Use case 2]
+
+### Ngoài scope
+- [Điều này sẽ KHÔNG được thực hiện trong iteration này]
+
+### Giả định (Assumptions)
+- [Assumption 1 — cần confirm với ai?]
+- [Assumption 2]
+
+---
+
+## 3. User Stories / Use Cases tổng quan
+| # | User Story | Priority | Estimate |
+|---|-----------|----------|----------|
+| US-01 | Là [role], tôi muốn [action] để [benefit] | Must/Should/Could | [SP/ngày] |
+| US-02 | ... | | |
+
+---
+
+## 4. Dependency & Tích hợp
+| Dependency | Loại | Team/Hệ thống | Trạng thái |
+|-----------|------|---------------|-----------|
+| [API từ hệ thống X] | Kỹ thuật | [Team A] | Confirmed / TBD |
+| [Phê duyệt từ phòng Y] | Nghiệp vụ | [Phòng Y] | Pending |
+
+---
+
+## 5. Rủi ro & Biện pháp
+| Rủi ro | Xác suất | Impact | Biện pháp |
+|--------|----------|--------|-----------|
+| [Rủi ro 1] | Cao/TB/Thấp | Cao/TB/Thấp | [Mitigation] |
+
+---
+
+## 6. Timeline đề xuất
+| Giai đoạn | Nội dung | Bắt đầu | Kết thúc | Owner |
+|-----------|----------|---------|---------|-------|
+| Analysis | Hoàn thiện requirement | [Date] | [Date] | BA |
+| Design | UI/UX + Technical design | [Date] | [Date] | Dev/Design |
+| Development | Implement | [Date] | [Date] | Dev |
+| Testing | UAT + QA | [Date] | [Date] | QA/PO |
+| Release | Deploy production | [Date] | [Date] | DevOps |
+
+---
+
+## 7. Open Questions & Decision Log
+| # | Câu hỏi | Người quyết định | Hạn | Quyết định |
+|---|---------|-----------------|-----|------------|
+| Q1 | [Câu hỏi còn mở] | [Tên] | [Date] | [Pending/Đã quyết định] |
+
+---
+
+## 8. Lịch sử thay đổi
+| Phiên bản | Ngày | Thay đổi | Người thực hiện |
+|-----------|------|---------|----------------|
+| v0.1 | [Date] | Tạo mới | [BA Name] |
+```

package/skills/specify/ba-doc-generator/references/template-review.md

@@ -0,0 +1,114 @@
+# Template: Review & Approval Package
+> Dành cho: Stakeholder Review (Business + Technical)
+> Mục đích: Xin review chính thức, thu thập phản hồi, phê duyệt
+
+---
+
+## Nguyên tắc viết cho Review Package
+- Đủ thông tin để reviewer hiểu mà không cần hỏi thêm
+- Có phần comment rõ ràng để reviewer ghi ý kiến
+- Highlight những điểm cần quyết định / xác nhận
+- Nêu rõ deadline review và hành động tiếp theo
+
+---
+
+## CẤU TRÚC TÀI LIỆU
+
+```
+# Review Package: [Tên tính năng / Dự án]
+**Ngày gửi**: [Date] | **Deadline review**: [Date]
+**BA**: [Name] | **Phiên bản**: [v0.1]
+**Trạng thái**: Chờ review
+
+---
+
+## Hướng dẫn review
+Vui lòng đọc tài liệu và phản hồi trước **[Deadline]** bằng cách:
+1. Ghi ý kiến vào cột "Comment" của từng mục
+2. Xác nhận trạng thái: ✅ Đồng ý / ❌ Không đồng ý / 💬 Cần thảo luận
+3. Gửi lại cho: [Email BA]
+
+---
+
+## 1. Tóm tắt nội dung
+[2-3 câu mô tả tổng quan: đây là gì, tại sao cần review, quyết định nào cần đưa ra]
+
+---
+
+## 2. Nội dung cần review
+
+### 2.1 Phạm vi (Scope)
+| Trong scope | Ngoài scope |
+|-------------|-------------|
+| [Tính năng 1] | [Tính năng X — sẽ làm sau] |
+| [Tính năng 2] | [Tính năng Y — ngoài phạm vi] |
+
+**Reviewer comment:**
+> _[Để trống cho reviewer điền]_
+**Trạng thái:** ⬜ Chưa review
+
+---
+
+### 2.2 Yêu cầu chức năng
+| # | Yêu cầu | Mức độ ưu tiên | Reviewer comment | Trạng thái |
+|---|---------|---------------|-----------------|-----------|
+| REQ-01 | [Mô tả yêu cầu] | Must/Should/Could | | ⬜ |
+| REQ-02 | | | | ⬜ |
+
+---
+
+### 2.3 Quy trình nghiệp vụ
+[Mô tả luồng quy trình hoặc đính kèm diagram]
+
+**Reviewer comment:**
+> _[Để trống]_
+**Trạng thái:** ⬜ Chưa review
+
+---
+
+### 2.4 Quy tắc nghiệp vụ (Business Rules)
+| BR# | Quy tắc | Reviewer comment | Trạng thái |
+|-----|---------|-----------------|-----------|
+| BR-01 | [Quy tắc 1] | | ⬜ |
+| BR-02 | [Quy tắc 2] | | ⬜ |
+
+---
+
+### 2.5 Assumption & Constraint
+| Loại | Nội dung | Cần confirm? |
+|------|---------|-------------|
+| Assumption | [Giả định BA đang dựa vào] | ✅ Cần confirm |
+| Constraint | [Ràng buộc kỹ thuật / nghiệp vụ] | |
+
+**Reviewer comment:**
+> _[Để trống]_
+
+---
+
+## 3. Điểm cần quyết định
+| # | Câu hỏi / Vấn đề | Option A | Option B | Quyết định | Owner |
+|---|-----------------|----------|----------|------------|-------|
+| D-01 | [Vấn đề cần chọn] | [Phương án A] | [Phương án B] | _[Để trống]_ | [Tên] |
+
+---
+
+## 4. Open Issues
+| # | Vấn đề | Mức độ | Người xử lý | Deadline |
+|---|--------|--------|------------|----------|
+| I-01 | [Vấn đề còn mở] | Blocker / Major / Minor | [Tên] | [Date] |
+
+---
+
+## 5. Kết quả review tổng hợp *(BA điền sau khi nhận feedback)*
+| Reviewer | Ngày | Trạng thái | Ghi chú |
+|---------|------|-----------|---------|
+| [Tên 1] | | ✅ Approved / ❌ Rejected / 💬 Approved with comments | |
+| [Tên 2] | | | |
+
+---
+
+## 6. Các thay đổi sau review
+| # | Nội dung thay đổi | Lý do | Phiên bản |
+|---|-----------------|-------|-----------|
+| 1 | [Thay đổi gì] | [Feedback từ ai] | v0.2 |
+```

package/skills/specify/ba-doc-generator/references/template-tester.md

@@ -0,0 +1,108 @@
+# Template: Test Basis Document
+> Dành cho: Tester / QA Engineer
+> Mục đích: Cơ sở để viết test case, kiểm thử nghiệm thu
+
+---
+
+## Nguyên tắc viết cho Tester/QA
+- Liệt kê đầy đủ acceptance criteria — mỗi criteria = 1 test case tiềm năng
+- Bao gồm cả positive và negative scenarios
+- Edge case phải được mô tả rõ
+- Data test gợi ý nếu có thể
+- Không mơ hồ: "hệ thống hoạt động đúng" không phải acceptance criteria
+
+---
+
+## CẤU TRÚC TÀI LIỆU
+
+```
+# [Tên tính năng] — Test Basis
+**Ngày**: [Date] | **BA**: [Name] | **QA**: [Name] | **Phiên bản**: [v0.1]
+
+---
+
+## 1. Phạm vi kiểm thử
+- **Trong scope test**: [Danh sách chức năng cần test]
+- **Ngoài scope test**: [Chức năng không test trong sprint này]
+- **Môi trường**: [Dev / Staging / UAT]
+
+---
+
+## 2. Actors & Preconditions
+| Actor | Điều kiện tiên quyết |
+|-------|---------------------|
+| [Role 1] | Đã đăng nhập, có quyền [X], dữ liệu [Y] đã tồn tại |
+| [Role 2] | Tài khoản chưa kích hoạt |
+
+---
+
+## 3. Acceptance Criteria
+
+### [Use Case / Feature 1]: [Tên]
+
+#### ✅ Positive Scenarios
+| AC# | Mô tả | Input | Expected Output | Priority |
+|-----|-------|-------|----------------|----------|
+| AC-01 | [Tên scenario] | [Data input] | [Kết quả mong đợi cụ thể] | High |
+| AC-02 | | | | Medium |
+
+#### ❌ Negative Scenarios
+| AC# | Mô tả | Input | Expected Output | Priority |
+|-----|-------|-------|----------------|----------|
+| AC-N01 | [Nhập sai format] | [Data sai] | [Error message cụ thể] | High |
+| AC-N02 | [Bỏ trống field bắt buộc] | null / empty | "[Validation message]" | High |
+
+#### ⚠️ Edge Cases
+| AC# | Mô tả | Input | Expected Output |
+|-----|-------|-------|----------------|
+| AC-E01 | [Giá trị biên: max length] | [255 ký tự] | [Chấp nhận / Từ chối] |
+| AC-E02 | [Giá trị âm / zero] | -1 / 0 | [Xử lý như thế nào] |
+
+---
+
+## 4. Business Rules cần verify
+| BR# | Rule | Cách verify |
+|-----|------|------------|
+| BR-01 | [Quy tắc 1] | [Test scenario tương ứng] |
+| BR-02 | [Công thức tính: A = B + C] | Input B=[X], C=[Y] → A phải = [Z] |
+
+---
+
+## 5. Integration Test Points
+| Điểm tích hợp | Hệ thống liên quan | Cần verify |
+|--------------|-------------------|------------|
+| [API call đến hệ thống X] | [Hệ thống X] | Response đúng format, timeout handling |
+| [Gửi email / notification] | [Email service] | Email được gửi, nội dung đúng |
+
+---
+
+## 6. Gợi ý Data Test
+| Loại data | Giá trị gợi ý | Mục đích |
+|-----------|--------------|----------|
+| Valid input | [Example] | Happy path |
+| Boundary value | [Min/Max] | Kiểm tra biên |
+| Invalid format | [Example] | Negative test |
+| Special characters | `<script>`, `'`, `"` | Security / XSS |
+| Empty / null | "" / null | Validation |
+
+---
+
+## 7. Non-Functional Requirements cần test
+- **Performance**: [Trang load trong X giây với Y concurrent users]
+- **Security**: [Phân quyền đúng theo role, không lộ data]
+- **Compatibility**: [Browser / Device cần test]
+
+---
+
+## 8. Regression Impact
+Các chức năng hiện có có thể bị ảnh hưởng khi deploy tính năng này:
+- [Module A] — vì [lý do]
+- [Module B] — vì [lý do]
+
+---
+
+## 9. Open Questions cho QA
+| # | Câu hỏi | Người trả lời | Trạng thái |
+|---|---------|--------------|-----------|
+| Q1 | [Chưa rõ behavior khi...] | BA | Pending |
+```

package/skills/specify/ba-doc-generator/references/template-user.md

@@ -0,0 +1,98 @@
+# Template: User Guide / Training Document
+> Dành cho: End User / Trainer
+> Mục đích: Hướng dẫn sử dụng hệ thống, tài liệu đào tạo
+
+---
+
+## Nguyên tắc viết cho User/Trainer
+- Ngôn ngữ đơn giản, tránh hoàn toàn jargon kỹ thuật
+- Mỗi bước chỉ làm 1 việc, đánh số rõ ràng
+- Có ví dụ thực tế gần gũi với công việc hàng ngày của user
+- Dùng Note / Warning / Tip để highlight thông tin quan trọng
+- Thêm placeholder [Hình ảnh/Screenshot] để trainer điền vào sau
+
+---
+
+## CẤU TRÚC TÀI LIỆU
+
+```
+# Hướng dẫn sử dụng: [Tên tính năng]
+**Phiên bản**: [v1.0] | **Cập nhật**: [Date] | **Áp dụng cho**: [Tên hệ thống]
+
+---
+
+## Giới thiệu
+[1-2 câu mô tả tính năng này giúp được gì cho người dùng, bằng ngôn ngữ hàng ngày]
+
+**Ai dùng tài liệu này?** [Tên role / phòng ban]
+**Khi nào dùng?** [Trong tình huống nào thì dùng tính năng này]
+
+---
+
+## Điều kiện trước khi bắt đầu
+Trước khi thực hiện, bạn cần:
+- [ ] Đã có tài khoản và đăng nhập vào hệ thống
+- [ ] Có quyền [tên quyền]
+- [ ] [Điều kiện khác nếu có]
+
+---
+
+## Hướng dẫn thực hiện
+
+### [Tên thao tác 1: ví dụ "Tạo đơn hàng mới"]
+
+**Bước 1:** [Hành động cụ thể — ví dụ: Nhấn vào nút "Tạo mới" ở góc trên bên phải]
+[Hình ảnh/Screenshot 1]
+
+**Bước 2:** [Hành động — ví dụ: Điền thông tin vào form]
+- Trường **[Tên trường]**: Nhập [hướng dẫn cụ thể, ví dụ: tên khách hàng]
+- Trường **[Tên trường]**: Chọn từ danh sách [mô tả danh sách]
+- Trường **[Tên trường]** *(bắt buộc)*: [Hướng dẫn]
+
+> 📝 **Lưu ý:** [Thông tin quan trọng user hay bị nhầm]
+
+**Bước 3:** [Hành động — ví dụ: Nhấn "Lưu" để hoàn tất]
+[Hình ảnh/Screenshot 2]
+
+> ✅ **Kết quả:** Sau khi lưu thành công, hệ thống sẽ [mô tả điều gì xảy ra tiếp theo]
+
+---
+
+### [Tên thao tác 2: ví dụ "Tìm kiếm và xem đơn hàng"]
+
+**Bước 1:** ...
+
+---
+
+## Các lỗi thường gặp & Cách xử lý
+
+| Thông báo lỗi | Nguyên nhân | Cách xử lý |
+|--------------|-------------|------------|
+| "[Nội dung thông báo lỗi]" | [Nguyên nhân đơn giản] | [Hành động cần làm] |
+| "[Thông báo lỗi 2]" | | |
+
+---
+
+## Câu hỏi thường gặp (FAQ)
+
+**Q: [Câu hỏi user hay hỏi 1]?**
+A: [Trả lời đơn giản, rõ ràng]
+
+**Q: [Câu hỏi 2]?**
+A: [Trả lời]
+
+---
+
+> ⚠️ **Cảnh báo quan trọng:**
+> [Điều tuyệt đối không được làm, hoặc hành động không thể hoàn tác]
+
+> 💡 **Mẹo:**
+> [Thủ thuật giúp dùng nhanh hơn / hiệu quả hơn]
+
+---
+
+## Liên hệ hỗ trợ
+Nếu gặp vấn đề không có trong tài liệu này, liên hệ:
+- **Bộ phận hỗ trợ**: [Tên / Email / Hotline]
+- **Giờ làm việc**: [Thời gian hỗ trợ]
+```