# Tác Vụ Tạo Epic Odoo

## Mục đích
Tạo epic phát triển Odoo hoàn chỉnh, gom nhóm các user stories liên quan, định nghĩa giá trị nghiệp vụ và điều phối kỹ thuật cho brownfield hoặc tính năng mới.

## Khi nào dùng
**Dùng khi:**
- Yêu cầu quá lớn cho một story (cần 2–6 stories)
- Nhiều tính năng liên quan cần phối hợp phát triển
- Nâng cấp module lớn hoặc tạo module mới
- Cần điều phối đa chức năng
- Cần chia pha để tối đa giá trị nghiệp vụ

**Dùng create-next-story khi:**
- Một story đủ đáp ứng yêu cầu
- Không cần điều phối nhiều nỗ lực

## Điều kiện tiên quyết
**Đầu vào bắt buộc:**
- Yêu cầu nghiệp vụ / đặc tả chức năng
- Persona người dùng & yêu cầu workflow
- Tiêu chí thành công, metrics giá trị
- Ràng buộc kỹ thuật, yêu cầu tích hợp

**Yêu cầu Odoo:**
- Phiên bản mục tiêu (13.0–18.0)
- Dependencies & tùy biến hiện có
- Tích hợp với module chuẩn
- Đa công ty, bản địa hóa

## Hướng dẫn

### 1. Nền tảng Epic
**Metadata**
- Epic ID (EPIC-ODO-001…)
- Business Theme (năng lực nghiệp vụ chính)
- Phiên bản Odoo mục tiêu
- Kích thước epic (số story ước tính 2–6)
- Ưu tiên (Critical/High/Medium)
- Timeline mục tiêu & mốc

**Tuyên bố tầm nhìn**
```
For [người dùng/bên liên quan],
Who need [vấn đề/cơ hội],
The [epic name] epic
Will deliver [khả năng chính]
That provide [giá trị đo được]
Unlike [hiện trạng/giải pháp thay thế].
```

### 2. Định nghĩa giá trị nghiệp vụ
**Mục tiêu**
- Mục tiêu chính, phụ
- Chỉ số thành công (KPI/ROI/hiệu suất)
- Tác động tới mục tiêu tổ chức

**Giá trị cho người dùng**
- Lợi ích trải nghiệm & năng suất
- Tối ưu quy trình/tự động hóa
- Tăng cường tích hợp & luồng dữ liệu
- Tuân thủ/giảm rủi ro

### 3. Phạm vi & Breakdown story
**Scope**
- Bao gồm: chức năng cốt lõi, tích hợp thiết yếu, MVP
- Loại trừ: cải tiến tương lai, nice-to-have, cấu hình nâng cao

**Nhận diện story**
```yaml
story_breakdown:
  story_1:
    title: "[Story 1 Title]"
    user_story: "As a [user], I want [capability], so that [value]"
    business_value: "[Giá trị mang lại]"
    technical_focus: "[Khu vực kỹ thuật chính]"
    estimated_effort: "[Story points/giờ]"
    dependencies: "[Story khác/đối tác ngoài]"
  story_2:
    ...
```

### 4. Kiến trúc kỹ thuật Odoo
**Module**
- Module mới sẽ tạo
- Module mở rộng
- Dependencies OCA
- Cách tích hợp với module chuẩn

**Data model**
- Model mới, model mở rộng
- Quan hệ chính
- Di chuyển/chuyển đổi dữ liệu

**Tích hợp**
- Nội bộ (các module Odoo)
- Bên ngoài (API/hệ thống ngoài)
- Luồng dữ liệu
- Mô hình bảo mật, quyền

### 5. Điều phối phát triển
**Phụ thuộc giữa stories**
```yaml
dependency_map:
  story_1:
    prerequisites: "[Cần xong trước]"
    enables: "[Cho phép bắt đầu gì]"
    external_dependencies: "[Hệ thống/tài nguyên ngoài]"
```

**Pha giao hàng**
```yaml
delivery_phases:
  phase_1:
    name: "[MVP/Phase 1]"
    stories: "[Danh sách story]"
    business_value: "[Giá trị phase 1]"
    success_criteria: "[Cách đo thành công]"
  phase_2:
    ...
```

### 6. Chiến lược chất lượng & kiểm thử
- Unit: từng component
- Integration: module + hệ thống
- UAT: kịch bản nghiệp vụ với stakeholder
- Performance: tải, mở rộng
- Migration: dữ liệu/nâng cấp

**Quality gates**
- Story done, Phase done, Epic done, Production readiness

### 7. Rủi ro & Giảm thiểu
**Kỹ thuật**: phức tạp tích hợp, hiệu suất, di chuyển dữ liệu, tương thích phiên bản  
**Nghiệp vụ**: chấp nhận người dùng, thay đổi quy trình, timeline, nguồn lực  
```yaml
risk_mitigation:
  technical_risks:
    - risk: "[Mô tả]"
      impact: "[H/M/L]"
      probability: "[H/M/L]"
      mitigation: "[Cách giảm thiểu]"
  business_risks:
    - ...
```

### 8. Thẩm định & phê duyệt epic
**Độ đầy đủ**
- [ ] Vision rõ giá trị
- [ ] Breakdown phủ đủ yêu cầu
- [ ] Kiến trúc khả thi
- [ ] Dependencies đã nhận diện
- [ ] Chiến lược chất lượng đủ

**Căn chỉnh stakeholder**
- [ ] Nghiệp vụ phê duyệt phạm vi/giá trị
- [ ] Kỹ thuật phê duyệt kiến trúc
- [ ] PM phê duyệt timeline/nguồn lực
- [ ] QA phê duyệt chiến lược test

**Nguồn lực & thời gian**
- [ ] Kỹ năng sẵn có
- [ ] Timeline thực tế theo effort & deps
- [ ] Ngoại phụ thuộc giải quyết được
- [ ] Giảm thiểu rủi ro khả thi

## Template đầu ra
```yaml
epic_id: "[EPIC-ID]"
title: "[Epic Title]"
business_theme: "[Business capability]"
odoo_version: "[Target version]"
priority: "[Critical/High/Medium]"
estimated_timeline: "[Estimate]"

vision_statement: |
  For [target users],
  Who need [problem],
  The [epic name] epic
  Will deliver [capabilities]
  That provide [value]
  Unlike [current state].

business_value:
  primary_objectives:
    - "[Obj 1]"
    - "[Obj 2]"
  success_metrics:
    - metric: "[Metric]"
      target: "[Target]"
      measurement: "[How]"

scope:
  included:
    - "[Core 1]"
    - "[Core 2]"
  excluded:
    - "[Future 1]"
    - "[Future 2]"

stories:
  - id: "[STORY-ID-1]"
    title: "[Story 1 Title]"
    user_story: "[Story 1 user story]"
    business_value: "[Value]"
    estimated_effort: "[Effort]"
  - id: "[STORY-ID-2]"
    ...

technical_architecture:
  modules:
    new: "[New modules]"
    extended: "[Extended modules]"
    dependencies: "[OCA/standard deps]"
  data_models:
    new: "[New models]"
    extended: "[Extended models]"
    relationships: "[Key relations]"

delivery_phases:
  - phase: 1
    name: "[Phase 1]"
    stories: "[Story IDs]"
    business_value: "[Value]"
  - phase: 2
    ...

quality_strategy:
  testing_approach: "[Summary]"
  quality_gates: "[Gates]"
  acceptance_criteria: "[Epic-level AC]"

risks:
  - risk: "[Risk]"
    impact: "[H/M/L]"
    probability: "[H/M/L]"
    mitigation: "[Plan]"

dependencies:
  - dependency: "[Dep]"
    type: "[Internal/External]"
    status: "[Status/Timeline]"
```

## Tiêu chí thành công
1) Epic nêu rõ giá trị và căn chỉnh chiến lược  
2) Breakdown cover đủ yêu cầu, không thiếu sót  
3) Kiến trúc khả thi, tuân thực hành Odoo/OCA  
4) Dependencies rõ và có phương án xử lý  
5) Chiến lược QA đảm bảo kiểm thử toàn diện  
6) Rủi ro lớn được nhận diện và giảm thiểu khả thi  
7) Stakeholder phê duyệt phạm vi, cách tiếp cận, timeline  
8) Cấu trúc điều phối rõ cho phát triển story

## Lưu ý
- **Tập trung giá trị**: mọi story phải đóng góp giá trị đo được  
- **Best practices Odoo/OCA**: luôn tuân chuẩn  
- **Giao hàng gia tăng**: chia pha để sớm tạo giá trị  
- **Quản trị rủi ro**: chủ động nhận diện & giảm thiểu  
- **Căn chỉnh stakeholder**: thống nhất phạm vi & cách làm  
- **Điều phối**: hướng dẫn rõ quản lý phụ thuộc story

Epic được cấu trúc tốt giúp phối hợp phát triển, giữ trọng tâm giá trị nghiệp vụ và xuất sắc kỹ thuật.