bmad-odoo 1.0.0

package/bmm/workflows/1-analysis/analyze-process/workflow.md

@@ -0,0 +1,60 @@
+---
+name: analyze-process
+description: Phân tích quy trình nghiệp vụ và ánh xạ với chức năng Odoo thông qua khám phá từng bước có cấu trúc.
+web_bundle: true
+---
+
+# Quy Trình Phân Tích Quy Trình Nghiệp Vụ Odoo
+
+**Mục tiêu:** Phân tích quy trình nghiệp vụ hiện tại và xác định cách ánh xạ với chức năng Odoo thông qua khám phá hợp tác.
+
+**Vai trò của bạn:** Ngoài tên, phong cách giao tiếp, và persona của bạn, bạn còn là một Chuyên viên Phân tích Nghiệp vụ tập trung vào Odoo hợp tác với người dùng như đồng nghiệp. Đây là quan hệ đối tác, không phải quan hệ khách hàng-nhà cung cấp. Bạn mang tư duy có cấu trúc và chuyên môn Odoo, trong khi người dùng mang kiến thức về lĩnh vực và quy trình nghiệp vụ.
+
+---
+
+## KIẾN TRÚC QUY TRÌNH
+
+Quy trình này sử dụng **kiến trúc step-file** để thực thi có kỷ luật:
+
+### Nguyên Tắc Cốt Lõi
+
+- **Thiết kế Micro-file**: Mỗi bước là file hướng dẫn độc lập, là một phần của quy trình tổng thể phải được tuân theo chính xác
+- **Tải Just-In-Time**: Chỉ file bước hiện tại được tải vào bộ nhớ - không bao giờ tải file bước tương lai cho đến khi được yêu cầu
+- **Thực thi Tuần tự**: Trình tự trong các file bước phải được hoàn thành theo thứ tự, không được bỏ qua hoặc tối ưu hóa
+- **Theo dõi Trạng thái**: Ghi lại tiến độ trong frontmatter file đầu ra sử dụng mảng `stepsCompleted`
+- **Xây dựng Chỉ-thêm**: Xây dựng tài liệu bằng cách thêm nội dung theo hướng dẫn vào file đầu ra
+
+### Quy Tắc Xử Lý Bước
+
+1. **ĐỌC HOÀN CHỈNH**: Luôn đọc toàn bộ file bước trước khi thực hiện bất kỳ hành động nào
+2. **TUÂN THEO TRÌNH TỰ**: Thực thi tất cả các phần đánh số theo thứ tự, không bao giờ đi chệch
+3. **CHỜ ĐẦU VÀO**: Nếu một menu được trình bày, dừng lại và chờ lựa chọn của người dùng
+4. **KIỂM TRA TIẾP TỤC**: Nếu bước có menu với Tiếp tục là một tùy chọn, chỉ tiến tới bước tiếp theo khi người dùng chọn 'C' (Tiếp tục)
+5. **LƯU TRẠNG THÁI**: Cập nhật `stepsCompleted` trong frontmatter trước khi tải bước tiếp theo
+6. **TẢI TIẾP**: Khi được chỉ định, tải, đọc toàn bộ file, sau đó thực thi file bước tiếp theo
+
+### Quy Tắc Quan Trọng (KHÔNG NGOẠI LỆ)
+
+- 🛑 **KHÔNG BAO GIỜ** tải nhiều file bước cùng lúc
+- 📖 **LUÔN** đọc toàn bộ file bước trước khi thực thi
+- 🚫 **KHÔNG BAO GIỜ** bỏ qua bước hoặc tối ưu hóa trình tự
+- 💾 **LUÔN** cập nhật frontmatter của file đầu ra khi viết đầu ra cuối cùng cho một bước cụ thể
+- 🎯 **LUÔN** tuân theo hướng dẫn chính xác trong file bước
+- ⏸️ **LUÔN** dừng tại menu và chờ đầu vào của người dùng
+- 📋 **KHÔNG BAO GIỜ** tạo danh sách todo trong đầu từ các bước tương lai
+
+---
+
+## TRÌNH TỰ KHỞI TẠO
+
+### 1. Tải Cấu Hình
+
+Tải và đọc toàn bộ config từ {project-root}/_bmad-odoo/bmm/config.yaml và giải quyết:
+
+- `project_name`, `output_folder`, `planning_artifacts`, `user_name`, `communication_language`, `document_output_language`, `user_skill_level`
+
+Tải kiến thức Odoo từ {project-root}/_bmad-odoo/bmm/data/odoo-knowledge-base.md
+
+### 2. THỰC THI Bước Đầu Tiên
+
+Tải, đọc toàn bộ file và sau đó thực thi `{project-root}/_bmad-odoo/bmm/workflows/1-analysis/analyze-process/steps/step-01-init.md` để bắt đầu quy trình.

package/bmm/workflows/1-analysis/create-odoo-product-brief/steps/step-01-init.md

@@ -0,0 +1,45 @@
+# Bước 1: Khởi Tạo Product Brief Odoo
+
+## 1. Chào Người Dùng
+
+Chào {user_name}! Tôi sẽ giúp bạn tạo Product Brief cho dự án Odoo.
+
+## 2. Thông Tin Dự Án Cơ Bản
+
+### 2.1 Tên Dự Án
+**Tên dự án:** ___
+
+### 2.2 Tầm Nhìn Sản Phẩm (Vision)
+Mô tả ngắn gọn (1-2 câu) về mục tiêu cuối cùng của dự án:
+> ___
+
+### 2.3 Vấn Đề Cần Giải Quyết
+Vấn đề nghiệp vụ hiện tại mà dự án này sẽ giải quyết là gì?
+> ___
+
+### 2.4 Phạm Vi Odoo
+Phạm vi liên quan đến Odoo:
+- [ ] Triển khai Odoo mới
+- [ ] Mở rộng hệ thống Odoo hiện có
+- [ ] Migration từ phiên bản cũ
+- [ ] Tích hợp với hệ thống khác
+
+### 2.5 Phiên Bản Odoo
+- [ ] Odoo 17.0 (khuyến nghị)
+- [ ] Odoo 16.0
+- [ ] Odoo Enterprise
+- [ ] Odoo Community
+
+---
+
+## 3. Menu
+
+```
+[C] Tiếp tục - Chuyển sang bước tiếp theo
+[H] Trợ giúp
+[X] Thoát
+```
+
+## 4. Hành Động Tiếp Theo
+
+Khi chọn **[C]**: Tải `steps/step-02-users-stakeholders.md`

package/bmm/workflows/1-analysis/create-odoo-product-brief/steps/step-02-users-stakeholders.md

@@ -0,0 +1,46 @@
+# Bước 2: Người Dùng & Các Bên Liên Quan
+
+## 1. Xác Định Người Dùng Odoo
+
+### 1.1 Nhóm Người Dùng Chính
+
+| Nhóm | Vai trò | Modules sử dụng | Số lượng |
+|------|---------|-----------------|----------|
+| Quản lý | Xem báo cáo, phê duyệt | Dashboard, Reports | |
+| Kế toán | Ghi nhận, đối chiếu | Accounting | |
+| Bán hàng | Tạo báo giá, đơn hàng | Sales, CRM | |
+| Kho | Nhập xuất, kiểm kê | Inventory | |
+| Mua hàng | Đặt hàng NCC | Purchase | |
+| Sản xuất | Lệnh sản xuất | Manufacturing | |
+
+### 1.2 Kỳ Vọng Của Từng Nhóm
+
+**Nhóm 1:** ___
+- Kỳ vọng: 
+- Điểm đau hiện tại:
+
+**Nhóm 2:** ___
+- Kỳ vọng:
+- Điểm đau hiện tại:
+
+### 1.3 Các Bên Liên Quan (Stakeholders)
+
+| Stakeholder | Quyền lợi | Mức độ ảnh hưởng |
+|-------------|-----------|------------------|
+| Ban giám đốc | ROI, hiệu quả | Cao |
+| IT | Bảo trì, hỗ trợ | Cao |
+| End users | Dễ sử dụng | Trung bình |
+
+---
+
+## 2. Menu
+
+```
+[C] Tiếp tục
+[A] Thêm nhóm người dùng
+[B] Quay lại
+```
+
+## 3. Hành Động Tiếp Theo
+
+Khi chọn **[C]**: Tải `steps/step-03-odoo-modules.md`

package/bmm/workflows/1-analysis/create-odoo-product-brief/steps/step-03-odoo-modules.md

@@ -0,0 +1,59 @@
+# Bước 3: Odoo Modules Mapping
+
+## 1. Đánh Giá Modules Cần Thiết
+
+### 1.1 Core Modules (Bắt buộc)
+
+| Module | Tên | Cần thiết | Ghi chú |
+|--------|-----|-----------|---------|
+| `base` | Contacts | ✓ | Luôn có |
+| `sale` | Sales | ? | |
+| `purchase` | Purchase | ? | |
+| `stock` | Inventory | ? | |
+| `account` | Accounting | ? | |
+| `crm` | CRM | ? | |
+| `hr` | Human Resources | ? | |
+| `project` | Project | ? | |
+| `manufacturing` | Manufacturing | ? | |
+
+### 1.2 OCA Modules Đề Xuất
+
+Dựa trên yêu cầu, các OCA modules có thể hữu ích:
+
+| Module OCA | Mục đích | Repo |
+|------------|----------|------|
+| | | |
+
+### 1.3 Custom Modules Cần Phát Triển
+
+| Module | Mục đích | Độ phức tạp |
+|--------|----------|-------------|
+| | | Thấp/TB/Cao |
+
+## 2. Sơ Đồ Modules
+
+```
+┌─────────────────────────────────────────┐
+│              ODOO SOLUTION              │
+├─────────────┬─────────────┬─────────────┤
+│   SALES     │  INVENTORY  │  PURCHASE   │
+├─────────────┼─────────────┼─────────────┤
+│  ACCOUNTING │     HR      │   PROJECT   │
+├─────────────┴─────────────┴─────────────┤
+│            CUSTOM MODULES               │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 3. Menu
+
+```
+[C] Tiếp tục
+[D] Chi tiết module
+[B] Quay lại
+```
+
+## 4. Hành Động Tiếp Theo
+
+Khi chọn **[C]**: Tải `steps/step-04-scope-timeline.md`

package/bmm/workflows/1-analysis/create-odoo-product-brief/steps/step-04-scope-timeline.md

@@ -0,0 +1,64 @@
+# Bước 4: Phạm Vi & Timeline
+
+## 1. Phạm Vi Dự Án
+
+### 1.1 Trong Phạm Vi (In Scope)
+
+| # | Tính năng/Module | Mô tả | Ưu tiên |
+|---|-----------------|-------|---------|
+| 1 | | | P1/P2/P3 |
+| 2 | | | |
+| 3 | | | |
+
+### 1.2 Ngoài Phạm Vi (Out of Scope)
+
+- [ ] ___
+- [ ] ___
+
+### 1.3 Giả Định & Ràng Buộc
+
+**Giả định:**
+- Dữ liệu cũ đã được làm sạch
+- Người dùng được training
+- Hạ tầng server sẵn sàng
+
+**Ràng buộc:**
+- Budget: ___
+- Timeline: ___
+- Resources: ___
+
+## 2. Timeline Đề Xuất
+
+### 2.1 Các Giai Đoạn
+
+```
+Phase 1: Analysis & Design     │████│ 2-3 tuần
+Phase 2: Development           │████████████│ 4-8 tuần
+Phase 3: Testing & UAT         │████│ 2-3 tuần
+Phase 4: Training & Go-live    │████│ 2 tuần
+
+Tổng: 10-16 tuần
+```
+
+### 2.2 Milestones
+
+| Milestone | Mục tiêu | Ngày dự kiến |
+|-----------|----------|--------------|
+| M1 | PRD hoàn thành | |
+| M2 | Development xong | |
+| M3 | UAT pass | |
+| M4 | Go-live | |
+
+---
+
+## 3. Menu
+
+```
+[C] Tiếp tục - Hoàn thành Product Brief
+[E] Chỉnh sửa
+[B] Quay lại
+```
+
+## 4. Hành Động Tiếp Theo
+
+Khi chọn **[C]**: Tải `steps/step-05-complete.md`

package/bmm/workflows/1-analysis/create-odoo-product-brief/steps/step-05-complete.md

@@ -0,0 +1,32 @@
+# Bước 5: Hoàn Thành Product Brief
+
+## 1. Tóm Tắt
+
+```
+📋 ODOO PRODUCT BRIEF
+
+Dự án: {project_name}
+Phiên bản Odoo: {version}
+Timeline: {timeline}
+
+MODULES:
+├── Core: {list core modules}
+├── OCA: {list oca modules}
+└── Custom: {list custom modules}
+
+STAKEHOLDERS: {count}
+USER GROUPS: {count}
+```
+
+## 2. Đầu Ra
+
+Lưu vào: `{planning_artifacts}/product-brief-{project_name}.md`
+
+## 3. Bước Tiếp Theo Đề Xuất
+
+```
+[1] Tạo PRD chi tiết (workflow create-odoo-prd)
+[2] Phân tích Gap Analysis (workflow gap-analysis)
+[3] Thiết kế kiến trúc (workflow create-odoo-addon)
+[X] Quay về menu chính
+```

package/bmm/workflows/1-analysis/create-odoo-product-brief/workflow.md

@@ -0,0 +1,35 @@
+---
+name: create-odoo-product-brief
+description: Tạo Product Brief cho dự án Odoo với focus vào module mapping và gap analysis.
+web_bundle: true
+---
+
+# Quy Trình Tạo Product Brief Odoo
+
+**Mục tiêu:** Tạo Product Brief toàn diện cho dự án Odoo, bao gồm đánh giá module mapping và gap analysis.
+
+**Vai trò:** Business Analyst Odoo hợp tác với Product Manager.
+
+---
+
+## KIẾN TRÚC QUY TRÌNH
+
+Quy trình này sử dụng **kiến trúc step-file** để thực thi có kỷ luật.
+
+### Nguyên Tắc Cốt Lõi
+- Thiết kế Micro-file: Mỗi bước là file hướng dẫn độc lập
+- Tải Just-In-Time: Chỉ file bước hiện tại được tải
+- Thực thi Tuần tự: Tuân theo thứ tự, không bỏ qua
+
+---
+
+## TRÌNH TỰ KHỞI TẠO
+
+### 1. Tải Cấu Hình
+
+Tải config từ {project-root}/_bmad-odoo/bmm/config.yaml
+Tải kiến thức từ {project-root}/_bmad-odoo/bmm/data/odoo-knowledge-base.md
+
+### 2. THỰC THI Bước Đầu Tiên
+
+Tải và thực thi `{project-root}/_bmad-odoo/bmm/workflows/1-analysis/create-odoo-product-brief/steps/step-01-init.md`

package/bmm/workflows/1-analysis/create-product-brief/product-brief.template.md

@@ -0,0 +1,10 @@
+---
+stepsCompleted: []
+inputDocuments: []
+date: { system-date }
+author: { user }
+---
+
+# Product Brief: {{project_name}}
+
+<!-- Content will be appended sequentially through collaborative workflow steps -->

package/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md

@@ -0,0 +1,182 @@
+---
+name: 'step-01-init'
+description: 'Initialize the product brief workflow by detecting continuation state and setting up the document'
+
+# Path Definitions
+workflow_path: '{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief'
+
+# File References
+thisStepFile: '{workflow_path}/steps/step-01-init.md'
+nextStepFile: '{workflow_path}/steps/step-02-vision.md'
+workflowFile: '{workflow_path}/workflow.md'
+outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
+
+# Template References
+productBriefTemplate: '{workflow_path}/product-brief.template.md'
+---
+
+# Step 1: Product Brief Initialization
+
+## STEP GOAL:
+
+Initialize the product brief workflow by detecting continuation state and setting up the document structure for collaborative product discovery.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate content without user input
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
+- 📋 YOU ARE A FACILITATOR, not a content generator
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Role Reinforcement:
+
+- ✅ You are a product-focused Business Analyst facilitator
+- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
+- ✅ We engage in collaborative dialogue, not command-response
+- ✅ You bring structured thinking and facilitation skills, while the user brings domain expertise and product vision
+- ✅ Maintain collaborative discovery tone throughout
+
+### Step-Specific Rules:
+
+- 🎯 Focus only on initialization and setup - no content generation yet
+- 🚫 FORBIDDEN to look ahead to future steps or assume knowledge from them
+- 💬 Approach: Systematic setup with clear reporting to user
+- 📋 Detect existing workflow state and handle continuation properly
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Show your analysis of current state before taking any action
+- 💾 Initialize document structure and update frontmatter appropriately
+- 📖 Set up frontmatter `stepsCompleted: [1]` before loading next step
+- 🚫 FORBIDDEN to load next step until user selects 'C' (Continue)
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Variables from workflow.md are available in memory
+- Focus: Workflow initialization and document setup only
+- Limits: Don't assume knowledge from other steps or create content yet
+- Dependencies: Configuration loaded from workflow.md initialization
+
+## Sequence of Instructions (Do not deviate, skip, or optimize)
+
+### 1. Check for Existing Workflow State
+
+First, check if the output document already exists:
+
+**Workflow State Detection:**
+
+- Look for file `{outputFile}`
+- If exists, read the complete file including frontmatter
+- If not exists, this is a fresh workflow
+
+### 2. Handle Continuation (If Document Exists)
+
+If the document exists and has frontmatter with `stepsCompleted`:
+
+**Continuation Protocol:**
+
+- **STOP immediately** and load `{workflow_path}/steps/step-01b-continue.md`
+- Do not proceed with any initialization tasks
+- Let step-01b handle all continuation logic
+- This is an auto-proceed situation - no user choice needed
+
+### 3. Fresh Workflow Setup (If No Document)
+
+If no document exists or no `stepsCompleted` in frontmatter:
+
+#### A. Input Document Discovery
+
+load context documents using smart discovery. Documents can be in the following locations:
+- {planning_artifacts}/**
+- {output_folder}/**
+- {product_knowledge}/**
+- docs/**
+
+Also - when searching - documents can be a single markdown file, or a folder with an index and multiple files. For Example, if searching for `*foo*.md` and not found, also search for a folder called *foo*/index.md (which indicates sharded content)
+
+Try to discover the following:
+- Brainstorming Reports (`*brainstorming*.md`)
+- Research Documents (`*research*.md`)
+- Project Documentation (generally multiple documents might be found for this in the `{product_knowledge}` or `docs` folder.)
+- Project Context (`**/project-context.md`)
+
+<critical>Confirm what you have found with the user, along with asking if the user wants to provide anything else. Only after this confirmation will you proceed to follow the loading rules</critical>
+
+**Loading Rules:**
+
+- Load ALL discovered files completely that the user confirmed or provided (no offset/limit)
+- If there is a project context, whatever is relevant should try to be biased in the remainder of this whole workflow process
+- For sharded folders, load ALL files to get complete picture, using the index first to potentially know the potential of each document
+- index.md is a guide to what's relevant whenever available
+- Track all successfully loaded files in frontmatter `inputDocuments` array
+
+#### B. Create Initial Document
+
+**Document Setup:**
+
+- Copy the template from `{productBriefTemplate}` to `{outputFile}`, and update the frontmatter fields
+
+#### C. Present Initialization Results
+
+**Setup Report to User:**
+"Welcome {{user_name}}! I've set up your product brief workspace for {{project_name}}.
+
+**Document Setup:**
+
+- Created: `{outputFile}` from template
+- Initialized frontmatter with workflow state
+
+**Input Documents Discovered:**
+
+- Research: {number of research files loaded or "None found"}
+- Brainstorming: {number of brainstorming files loaded or "None found"}
+- Project docs: {number of project files loaded or "None found"}
+- Project Context: {number of project context files loaded or "None found"}
+
+**Files loaded:** {list of specific file names or "No additional documents found"}
+
+Do you have any other documents you'd like me to include, or shall we continue to the next step?"
+
+### 4. Present MENU OPTIONS
+
+Display: "**Proceeding to product vision discovery...**"
+
+#### Menu Handling Logic:
+
+- After setup report is presented, immediately load, read entire file, then execute {nextStepFile}
+
+#### EXECUTION RULES:
+
+- This is an initialization step with auto-proceed after setup completion
+- Proceed directly to next step after document setup and reporting
+
+## CRITICAL STEP COMPLETION NOTE
+
+ONLY WHEN [setup completion is achieved and frontmatter properly updated], will you then load and read fully `{nextStepFile}` to execute and begin product vision discovery.
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Existing workflow detected and properly handed off to step-01b
+- Fresh workflow initialized with template and proper frontmatter
+- Input documents discovered and loaded using sharded-first logic
+- All discovered files tracked in frontmatter `inputDocuments`
+- Menu presented and user input handled correctly
+- Frontmatter updated with `stepsCompleted: [1]` before proceeding
+
+### ❌ SYSTEM FAILURE:
+
+- Proceeding with fresh initialization when existing workflow exists
+- Not updating frontmatter with discovered input documents
+- Creating document without proper template structure
+- Not checking sharded folders first before whole files
+- Not reporting discovered documents to user clearly
+- Proceeding without user selecting 'C' (Continue)
+
+**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.