Package Exports

bmad-odoo
bmad-odoo/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (bmad-odoo) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

BMAD-Odoo - Hướng Dẫn Sử Dụng

BMAD Framework mở rộng cho phát triển Odoo ERP

Giới Thiệu

BMAD-Odoo là một framework mở rộng từ BMAD (Brian's Method for AI Development), được tùy chỉnh đặc biệt cho việc phát triển và triển khai Odoo ERP.

Tính Năng Chính

🤖 10 AI Agents chuyên biệt cho từng vai trò trong dự án Odoo
📝 44 Workflows bao phủ toàn bộ vòng đời phát triển
🇻🇳 Hỗ trợ tiếng Việt đầy đủ
📚 Knowledge Base tích hợp kiến thức Odoo
⚙️ Auto-setup tự động cấu hình workflows khi cài đặt

Cài Đặt

Yêu Cầu

Node.js 18+
Odoo 16.0+ hoặc 17.0
AI IDE hỗ trợ (Cursor, VS Code với extension AI)

Cách 1: Cài Đặt từ NPM (Khuyến nghị)

# Cài đặt package
npm install bmad-odoo

# Package sẽ tự động:
# - Tạo thư mục .agent/workflows/
# - Cài đặt các slash commands cho agents

Cách 2: Cài Đặt Thủ Công

# Clone repository
git clone https://github.com/phamdungtk/bmad-odoo.git

# Copy vào node_modules
cp -r bmad-odoo node_modules/

Cấu Hình

File Cấu Hình Chính

Chỉnh sửa file bmm/config.yaml:

# Thông tin người dùng
user_name: "Tên của bạn"
communication_language: "Tiếng Việt"

# Thư mục đầu ra
output_folder: "_bmad-odoo-output"
planning_artifacts: "_bmad-odoo-output/planning"
implementation_artifacts: "_bmad-odoo-output/implementation"

# Cấu hình Odoo
odoo:
  version: "17.0"
  edition: "community"           # community hoặc enterprise
  customModulesPath: "addons_custom"
  oca_path: "addons_oca"

Các Agents

Danh Sách Agents

Agent	Tên	Vai Trò	Slash Command
💼 Sofia	Business Analyst	Phân tích quy trình, gap analysis	`/analyst`
🏗️ Antonio	Technical Architect	Thiết kế kiến trúc module	`/architect`
💻 Carlos	Developer	Phát triển code Odoo	`/dev`
📊 Maria	Product Manager	Quản lý sản phẩm, tạo PRD	`/pm`
🏃 Diego	Scrum Master	Quản lý Sprint, story	`/sm`
🧪 Elena	Test Architect	Thiết kế test cases	`/tea`
🎨 Sally	UX Designer	Thiết kế UX cho Odoo views	`/ux-designer`
⚡ Barry	Quick Flow Dev	Phát triển nhanh	`/quick-flow-solo-dev`
📝 Paige	Tech Writer	Tài liệu hóa module	`/tech-writer`
🎯 Master	BMAD-Odoo Master	Điều phối tổng thể	(auto)

Cách Kích Hoạt Agent

/analyst    # Kích hoạt Sofia - Business Analyst
/dev        # Kích hoạt Carlos - Developer
/pm         # Kích hoạt Maria - Product Manager

Workflows

Phân Loại Workflows

1. Analysis (Phân Tích)

Workflow	Mô Tả
`analyze-process`	Phân tích quy trình nghiệp vụ Odoo
`gap-analysis`	Phân tích khoảng trống yêu cầu
`create-product-brief`	Tạo Product Brief
`create-odoo-product-brief`	Tạo Product Brief cho Odoo
`research`	Nghiên cứu thị trường/kỹ thuật

2. Planning (Lập Kế Hoạch)

Workflow	Mô Tả
`create-odoo-addon`	Thiết kế Odoo Addon mới
`create-odoo-epic`	Tạo Epic phát triển
`create-odoo-prd`	Tạo PRD Odoo
`create-odoo-ux-design`	Thiết kế UX Odoo views
`plan-odoo-migration`	Lập kế hoạch migration
`create-ux-design`	Tạo thiết kế UX chung
`prd`	Tạo Product Requirements Doc

3. Solutioning (Giải Pháp)

Workflow	Mô Tả
`create-architecture`	Thiết kế kiến trúc
`create-epics-and-stories`	Tạo Epics & Stories
`check-implementation-readiness`	Kiểm tra sẵn sàng triển khai
`enhance-existing-system`	Nâng cấp hệ thống có sẵn
`quick-addon`	Tạo addon nhanh

4. Implementation (Triển Khai)

Workflow	Mô Tả
`dev-story`	Thực thi Dev Story
`code-review`	Đánh giá mã nguồn
`create-next-story`	Tạo Story tiếp theo
`rapid-brownfield`	Phát triển brownfield nhanh
`sprint-planning`	Lập kế hoạch Sprint
`sprint-status`	Trạng thái Sprint
`correct-course`	Điều chỉnh hướng đi
`retrospective`	Họp nhìn lại

5. Testing (Kiểm Thử)

Workflow	Mô Tả
`odoo-test-design`	Thiết kế test Odoo
`test-design`	Thiết kế kiểm thử
`test-review`	Đánh giá kiểm thử
`automate`	Tự động hóa kiểm thử

6. Documentation (Tài Liệu)

Workflow	Mô Tả
`document-odoo`	Tài liệu hóa Odoo module
`document-project`	Tài liệu hóa dự án
`generate-project-context`	Tạo project context

Quy Trình Làm Việc

Quy Trình Phát Triển Odoo Addon Mới

┌─────────────────────────────────────────────────────────────┐
│                    QUY TRÌNH PHÁT TRIỂN                      │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  1. ANALYSIS (Phân Tích)                                    │
│     └─▶ /analyst → [AP] Phân tích quy trình                 │
│     └─▶ /analyst → [GA] Gap Analysis                        │
│                                                              │
│  2. PLANNING (Lập Kế Hoạch)                                 │
│     └─▶ /pm → [OPB] Tạo Product Brief Odoo                  │
│     └─▶ /pm → [OPR] Tạo PRD Odoo                            │
│     └─▶ /pm → [CE] Tạo Epic                                 │
│                                                              │
│  3. DESIGN (Thiết Kế)                                       │
│     └─▶ /architect → [CO] Thiết kế Addon                    │
│     └─▶ /ux-designer → [OUX] Thiết kế UX Views              │
│                                                              │
│  4. IMPLEMENTATION (Triển Khai)                             │
│     └─▶ /sm → [CS] Tạo Story                                │
│     └─▶ /dev → [DS] Dev Story                               │
│     └─▶ /dev → [CR] Code Review                             │
│                                                              │
│  5. TESTING (Kiểm Thử)                                      │
│     └─▶ /tea → [OTD] Thiết kế Test Odoo                     │
│                                                              │
│  6. DOCUMENTATION (Tài Liệu)                                │
│     └─▶ /tech-writer → [OD] Tài liệu Odoo Module            │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Ví Dụ: Phân Tích Quy Trình Bán Hàng

# Bước 1: Kích hoạt Business Analyst
/analyst

# Bước 2: Chọn menu [AP] Phân tích quy trình
> AP

# Bước 3: Workflow sẽ hướng dẫn qua các bước:
#   - Thu thập thông tin cơ bản
#   - Phân tích trạng thái hiện tại
#   - Xác định điểm đau
#   - Mapping với Odoo modules
#   - Đề xuất giải pháp

Cấu Trúc Thư Mục

_bmad-odoo/
├── _config/                    # Manifest files
│   ├── agent-manifest.csv
│   └── workflow-manifest.csv
├── bmm/                        # BMAD Method Materials
│   ├── agents/                 # 9 Agent definitions
│   │   ├── analyst.md
│   │   ├── architect.md
│   │   ├── dev.md
│   │   ├── pm.md
│   │   ├── sm.md
│   │   ├── tea.md
│   │   ├── ux-designer.md
│   │   ├── quick-flow-solo-dev.md
│   │   └── tech-writer.md
│   ├── config.yaml             # Main configuration
│   ├── data/
│   │   └── odoo-knowledge-base.md
│   ├── teams/
│   │   └── default-team.md
│   ├── testarch/               # Test architecture
│   │   └── odoo-test-design/
│   └── workflows/              # 44 workflows
│       ├── 1-analysis/
│       ├── 2-plan-workflows/
│       ├── 3-solutioning/
│       ├── 4-implementation/
│       ├── bmad-quick-flow/
│       ├── document-odoo/
│       ├── document-project/
│       ├── excalidraw-diagrams/
│       ├── generate-project-context/
│       ├── testarch/
│       └── workflow-status/
├── core/                       # Core components
│   ├── agents/
│   │   └── bmad-odoo-master.md
│   └── workflows/
│       └── party-mode/
└── README.md                   # This file

Tài Liệu Tham Khảo

Files Quan Trọng

File	Mô Tả
`bmm/config.yaml`	Cấu hình chính
`bmm/data/odoo-knowledge-base.md`	Kiến thức Odoo
`bmm/testarch/odoo-testing-guide.md`	Hướng dẫn test Odoo
`_bmad-odoo-tieng-viet.md`	Tổng quan tiếng Việt

Liên Kết

Hỗ Trợ

Nếu bạn gặp vấn đề, hãy kiểm tra:

Config.yaml - Đảm bảo cấu hình đúng
Slash commands - Sử dụng đúng lệnh kích hoạt agent
Workflow steps - Làm theo từng bước tuần tự

Phiên bản: 1.0.0
Cập nhật: 2026-01-02
Ngôn ngữ: Tiếng Việt