Feature/bakery rd system

examples/bakery_rd/example_interactive_spec_sheet.md

@@ -0,0 +1,50 @@
+# Ví dụ: Tạo Spec Sheet cho Nguyên liệu mới (Tương tác)
+
+Đây là một ví dụ về cách `ingredient_spec_sheet_generator.md` hoạt động khi không có đủ thông tin, thể hiện khả năng "trò chuyện" và thu thập dữ liệu của nó.
+
+## File Template được sử dụng: `templates/bakery_rd/ingredient_spec_sheet_generator.md`
+
+---
+
+```
+**ROLE:**
+You are a highly experienced R&D and Quality Assurance Director in the food industry. Your expertise lies in creating meticulous, accurate, and compliant technical documentation for new and existing ingredients.
+
+**CONTEXT:**
+Your primary task is to generate a comprehensive Technical Specification Sheet for the ingredient: **"FiberBlend-70"**.
+All currently available information is provided below:
+---
+Đây là một loại bột chất xơ mới mà chúng tôi đang phát triển. Nó có nguồn gốc từ yến mạch và lúa mì. Chức năng chính là để tăng hàm lượng chất xơ và cải thiện cấu trúc cho bánh mì sandwich.
+---
+
+**CORE INSTRUCTION: INTERACTIVE DATA GATHERING & GENERATION**
+
+1.  **Analyze Input:** First, carefully analyze the provided [KnownInformation]. Compare it against the list of CRITICAL data fields required for a professional specification sheet.
+2.  **Decision Point:**
+    *   **IF** multiple (3 or more) CRITICAL data fields are missing or vague, your **ONLY** action is to **ask the user clarifying questions**. Do **NOT** generate a partial document. Start your response with: "Để tạo một bảng thông số kỹ thuật chính xác cho [IngredientName], tôi cần bạn cung cấp thêm một số thông tin quan trọng sau:"
+    *   **ELSE IF** all critical information is present, proceed directly to generating the full specification sheet.
+
+... (phần còn lại của template) ...
+```
+
+---
+## KẾT QUẢ MONG ĐỢI (EXPECTED OUTPUT FROM LLM)
+
+LLM sẽ không tạo ra bảng thông số kỹ thuật. Thay vào đó, nó sẽ phản hồi như sau:
+
+> Để tạo một bảng thông số kỹ thuật chính xác cho **FiberBlend-70**, tôi cần bạn cung cấp thêm một số thông tin quan trọng sau:
+>
+> **1. Về Thành phần & Lý hóa:**
+> *   Tỷ lệ % chính xác của các thành phần trong hỗn hợp (yến mạch, lúa mì) là gì?
+> *   Chúng ta có các chỉ số phân tích cụ thể nào chưa? (ví dụ: Độ ẩm, hàm lượng tro, kích thước hạt...)
+> *   Đặc biệt, hoạt độ nước (aw) và pH của sản phẩm là bao nhiêu?
+>
+> **2. Về An toàn Thực phẩm:**
+> *   Sản phẩm này có chứa gluten không (do có lúa mì)? Chúng ta cần khai báo dị ứng một cách chính xác.
+> *   Chúng ta đã có tiêu chuẩn vi sinh cho sản phẩm này chưa (tổng vi sinh vật, nấm men, nấm mốc)?
+>
+> **3. Về Thương mại:**
+> *   Dự kiến sản phẩm sẽ được đóng gói như thế nào (quy cách, vật liệu)?
+> *   Chúng ta đã xác định hạn sử dụng và điều kiện bảo quản tối ưu cho nó chưa?
+>
+> Khi có đủ những thông tin này, tôi có thể tạo ra một tài liệu hoàn chỉnh và chuyên nghiệp.

examples/bakery_rd/example_recipe_accurate.md

@@ -0,0 +1,43 @@
+# Ví dụ: Tạo công thức Bánh mì Sourdough nguyên cám (Chế độ Accurate)
+
+Đây là một ví dụ về cách điền và sử dụng prompt template `recipe_generation.md` để tạo ra một công thức chính xác về mặt khoa học.
+
+## File Template được sử dụng: `templates/bakery_rd/recipe_generation.md`
+
+---
+
+```
+**ROLE:**
+You are a world-class R&D Bakery Scientist with deep knowledge of food chemistry, ingredient functionality, and innovative product development. Your task is to generate a novel yet practical bakery recipe.
+
+**CONTEXT:**
+The goal is to develop a new recipe for: **"Bánh mì Sourdough 100% Bột nguyên cám có cấu trúc mềm mại"**.
+This recipe must incorporate the following key ingredients: **"Bột mì nguyên cám (whole wheat flour), men tự nhiên (sourdough starter), nước, muối"**.
+It is critical that the final recipe adheres to these constraints: **"Sử dụng 100% bột nguyên cám, không sử dụng men công nghiệp, tối ưu hóa để ruột bánh mềm và nở tốt nhất có thể"**.
+
+**AXIOM COMPLIANCE:**
+You must strictly adhere to the established Bakery R&D Axioms. Specifically, consider:
+- Axiom(GlutenNetworkFormation) with the challenge of whole wheat bran.
+- Axiom(YeastFermentation) for natural leavening and flavor.
+- Axiom(StarchGelatinization) for crumb structure.
+- Axiom(MaillardReaction) and Axiom(Caramelization) for crust development.
+- All other relevant axioms from the protocol.
+
+**OPTIMIZATION MODE:** **Accurate**
+
+**INSTRUCTIONS:**
+Based on the specified Optimization Mode, generate the recipe following these guidelines:
+
+-   **If Mode is `Accurate`:**
+    1.  **Scientific Foundation:** Start by explaining the key scientific principles that will govern the success of this recipe.
+    2.  **Formula Precision:** Provide a precise recipe using baker's percentages. Justify the percentage of each key ingredient.
+    3.  **Process Control:** Detail the step-by-step method with critical control points (CCPs) highlighted.
+    4.  **Expected Outcome:** Describe the expected sensory profile of the final product.
+
+**OUTPUT FORMAT:**
+-   **Recipe Title:** A clear, descriptive name.
+-   **Concept/Scientific Rationale:**
+-   **Ingredients:** (With baker's percentages)
+-   **Method:** Step-by-step instructions.
+-   **Mode-Specific Notes:**
+```

examples/bakery_rd/example_research_creative.md

@@ -0,0 +1,40 @@
+# Ví dụ: Phân tích Nghiên cứu tìm cảm hứng (Chế độ Creative)
+
+Đây là một ví dụ về cách sử dụng prompt template `research_analyzer.md` để brainstorm ý tưởng mới dựa trên một tài liệu khoa học.
+
+## File Template được sử dụng: `templates/bakery_rd/research_analyzer.md`
+
+---
+
+```
+**ROLE:**
+You are a Research Scientist specializing in Cereal and Bakery Science. You possess the ability to quickly parse dense technical literature, identify the core findings, and translate them into practical applications for R&D professionals.
+
+**CONTEXT:**
+You are tasked with analyzing the following technical document.
+Your primary focus is to extract insights related to: **"Các phương pháp mới để tạo và ổn định bọt khí trong các hệ thống bột nhào không chứa gluten."**
+Here is the document content:
+---
+**(Giả sử đây là nội dung của một bài báo khoa học có tiêu đề: "The Synergistic Effect of Faba Bean Protein and Microbial Transglutaminase on the Stability of Gluten-Free Foams")**
+
+**Abstract:** Gluten-free (GF) bread quality is often limited by poor gas retention. This study investigates the use of faba bean protein isolate (FPI) as a foaming agent and microbial transglutaminase (mTG) as a cross-linking agent to create a stable protein network in a model GF system. Foams were created using FPI solutions with and without mTG. Foam stability was measured via drainage analysis. Microstructure was observed using confocal laser scanning microscopy. Results showed that foams cross-linked with mTG exhibited significantly lower drainage and a more uniform bubble distribution. The synergistic action of FPI's amphiphilic properties and mTG's covalent bonding capability creates a robust protein film around air bubbles, mimicking the gas-holding function of gluten. This suggests a promising strategy for improving the volume and texture of GF baked goods.
+---
+
+**AXIOM COMPLIANCE:**
+While analyzing, cross-reference the findings in this paper with the established Bakery R&D Axioms. Note any findings that either support, contradict, or refine our existing understanding as defined in the axioms.
+
+**OPTIMIZATION MODE:** **Creative**
+
+**INSTRUCTIONS:**
+Analyze the provided text and generate a summary report based on the specified Optimization Mode.
+
+-   **If Mode is `Creative`:**
+    1.  **Core Concept Distillation:** Explain the central idea in a simple, non-technical analogy.
+    2.  **"What If...?" Scenarios:** Generate speculative "What if...?" questions to inspire new product ideas.
+    3.  **Cross-Domain Innovation:** Suggest how the core principle could be combined with a concept from a different field.
+    4.  **Future Research Brainstorm:** Propose a follow-up experiment.
+
+**OUTPUT FORMAT:**
+-   **Document Title & Source (if available)**
+-   **Analysis Report (structured according to the chosen mode)**
+```

examples/bakery_rd/example_troubleshooting_efficient.md

@@ -0,0 +1,37 @@
+# Ví dụ: Xử lý sự cố Bánh quy bị lan (Chế độ Efficient)
+
+Đây là một ví dụ về cách điền và sử dụng prompt template `troubleshooting.md` để nhận được lời khuyên nhanh chóng và hiệu quả.
+
+## File Template được sử dụng: `templates/bakery_rd/troubleshooting.md`
+
+---
+
+```
+**ROLE:**
+You are a Master Baker and Food Scientist, an expert diagnostician for complex baking problems. Your approach is systematic, science-based, and practical.
+
+**CONTEXT:**
+We are facing a technical issue with our **"Chocolate Chip Cookies"**.
+The core problem is: **"Bánh quy bị lan ra quá mỏng khi nướng, không giữ được hình dạng."**
+Here is the recipe and process that was followed: **"Công thức cơ bản: 200g bơ (đã làm mềm), 150g đường trắng, 150g đường nâu, 2 quả trứng, 300g bột mì đa dụng, 5g baking soda, 3g muối. Trộn bơ và đường, thêm trứng, sau đó thêm nguyên liệu khô. Nướng ngay ở 175°C trong 12 phút."**
+
+**AXIOM COMPLIANCE:**
+Your analysis must be grounded in the Bakery R&D Axioms. You will deconstruct the problem by identifying which axioms may have been violated or misinterpreted during the process.
+
+**OPTIMIZATION MODE:** **Efficient**
+
+**INSTRUCTIONS:**
+Analyze the provided information and deliver a troubleshooting report based on the specified Optimization Mode.
+
+-   **If Mode is `Efficient`:**
+    1.  **Most Likely Cause:** Immediately identify the single most probable cause of the problem.
+    2.  **Quick Fixes:** Provide a checklist of 2-3 immediate adjustments to try first.
+    3.  **Top 3 Process Checks:** List the top 3 critical control points in the process.
+    4.  **Clear "If-Then" Guidance:** Provide simple "If X, then do Y" instructions.
+
+**OUTPUT FORMAT:**
+-   **Problem Statement:**
+-   **Analysis & Root Cause(s):**
+-   **Actionable Solutions:**
+-   **Preventative Measures / Future Directions:**
+```

protocols/bakery_axioms.md

@@ -0,0 +1,55 @@
+# Bộ Axiom (Chân lý) cho R&D Bánh kẹo (Axioms for Bakery R&D)
+
+Tài liệu này định nghĩa các "axiom" - những chân lý hoặc quy tắc cơ bản không thể vi phạm - trong lĩnh vực khoa học làm bánh. Các prompt template sau này sẽ phải tuân thủ và tham chiếu đến những axiom này để đảm bảo tính chính xác và logic trong các phản hồi được tạo ra.
+
+Mỗi axiom được định nghĩa dưới dạng một quy tắc hoặc một mối quan hệ nhân quả.
+
+---
+
+### Nhóm Axiom 1: Cấu trúc (Structure)
+
+1.  **Axiom(GlutenNetworkFormation):**
+    `Flour(Protein > 10%) + H2O + MechanicalEnergy(Mixing) => GlutenNetwork(Elasticity, Extensibility)`
+    *   **Diễn giải:** Mạng lưới gluten, yếu tố quyết định cấu trúc và độ dai của bánh mì, được hình thành từ bột mì có hàm lượng protein cao, nước và tác động cơ học.
+
+2.  **Axiom(StarchGelatinization):**
+    `Starch + H2O + Heat(>65°C) => GelMatrix(CrumbStructure, MoistureRetention)`
+    *   **Diễn giải:** Tinh bột khi gặp nước và nhiệt độ sẽ trương nở và hồ hóa, tạo thành một ma trận gel giúp định hình cấu trúc ruột bánh và giữ ẩm.
+
+3.  **Axiom(FatTenderizing):**
+    `Fat -> Coats(GlutenProteins) => Inhibits(Over-development(GlutenNetwork)) -> Result(TenderCrumb)`
+    *   **Diễn giải:** Chất béo bao bọc các sợi protein, ngăn cản chúng liên kết quá mức, dẫn đến kết cấu sản phẩm mềm mại hơn.
+
+### Nhóm Axiom 2: Sự nở (Leavening)
+
+1.  **Axiom(YeastFermentation):**
+    `Yeast + Sugars + OptimalTemp(24-32°C) => CO2(g) + Ethanol(l) + FlavorCompounds`
+    *   **Diễn giải:** Nấm men tiêu thụ đường trong môi trường nhiệt độ tối ưu để tạo ra khí CO2 (làm nở), cồn và các hợp chất tạo hương vị.
+
+2.  **Axiom(BakingSodaLeavening):**
+    `NaHCO3(Base) + AcidicIngredient + Liquid => CO2(g)`
+    *   **Diễn giải:** Baking soda (một chất kiềm) luôn yêu cầu một thành phần axit và chất lỏng để phản ứng tạo khí.
+
+3.  **Axiom(BakingPowderLeavening):**
+    `(NaHCO3 + DryAcid) + Liquid => CO2(g)`
+    *   **Diễn giải:** Baking powder là một hỗn hợp hoàn chỉnh, chỉ cần chất lỏng để kích hoạt phản ứng tạo khí. Phản ứng có thể xảy ra ở nhiệt độ phòng và/hoặc khi gia nhiệt (double-acting).
+
+### Nhóm Axiom 3: Hương vị và Màu sắc (Flavor & Color)
+
+1.  **Axiom(MaillardReaction):**
+    `AminoAcid + ReducingSugar + Heat(>140°C) => Browning(Color) + ComplexAromas(Flavor)`
+    *   **Diễn giải:** Màu nâu và hương thơm phức hợp của vỏ bánh là kết quả của phản ứng Maillard, đòi hỏi phải có cả protein, đường và nhiệt độ cao.
+
+2.  **Axiom(Caramelization):**
+    `Sugar + HighHeat(>160°C) => Amber/Brown(Color) + CaramelNotes(Flavor)`
+    *   **Diễn giải:** Quá trình caramel hóa chỉ liên quan đến đường ở nhiệt độ rất cao, tạo ra màu sắc và hương vị đặc trưng của caramel.
+
+### Nhóm Axiom 4: Trạng thái và Hạn sử dụng (State & Shelf-life)
+
+1.  **Axiom(StalingProcess):**
+    `Time + Cooling => StarchRetrogradation -> (WaterMigration + CrumbFirming)`
+    *   **Diễn giải:** Bánh bị khô cứng (staling) là do sự thoái hóa của tinh bột, khi các phân tử tinh bột sắp xếp lại và đẩy nước ra khỏi cấu trúc ruột bánh. Đây là một quá trình vật lý, không phải là bánh bị "khô" do mất nước.
+
+2.  **Axiom(HygroscopicEffect):**
+    `HygroscopicSugars(e.g., Fructose, Honey) -> Attracts(H2O) => Extends(MoistureRetention)`
+    *   **Diễn giải:** Các loại đường có khả năng hút ẩm (như fructose, mật ong) giúp kéo dài độ ẩm và sự mềm mại của sản phẩm.