def is_vibecoding_suitable(project_type):
    """判斷項目是否適合使用 VibeCoding"""
    suitable_scenarios = [
        "原型驗證",      # 快速驗證產品想法
        "內部工具",      # 企業(yè)內部管理工具
        "小型應用",      # 輕量級 Web 應用
        "API 服務",      # 后端 API 服務
        "數(shù)據(jù)處理",      # 數(shù)據(jù)清洗和處理腳本
        "自動化流程"     # 工作流自動化
    ]
    
    return project_type in suitable_scenarios

P0: 概念理解 → P1: 提示詞優(yōu)化 → P2: 方案評估 → P3: 代碼生成 → P4: 環(huán)境配置 → P5: 測試驗證

class ConceptUnderstanding:
    """概念理解階段"""
    
    def __init__(self, project_name, domain):
        self.project_name = project_name
        self.domain = domain
    
    def research_domain(self):
        """研究領域知識"""
        print(f"研究 {self.domain} 領域知識...")
    
    def define_objectives(self):
        """定義項目目標"""
        objectives = [
            "明確業(yè)務問題",
            "確定目標用戶",
            "定義核心價值",
            "劃定邊界范圍"
        ]
        return objectives
    
    def document_concept(self):
        """記錄概念文檔"""
        concept_doc = f"""
        # {self.project_name} 概念文檔
        
        ## 領域背景
        {self.domain} 領域的現(xiàn)狀和趨勢
        
        ## 業(yè)務問題
        需要解決的核心問題
        
        ## 目標用戶
        目標用戶群體特征
        
        ## 核心價值
        產品提供的核心價值
        
        ## 邊界范圍
        包含/不包含的功能
        """
        return concept_doc

class PromptOptimization:
    """提示詞優(yōu)化階段"""
    
    def __init__(self, requirements):
        self.requirements = requirements
    
    def analyze_with_multiple_models(self):
        """使用多個大模型分析需求"""
        models = ["DeepSeek", "Doubao", "Qwen"]
        analysis_results = {}
        
        for model in models:
            result = self._analyze_with_model(model)
            analysis_results[model] = result
        
        return analysis_results
    
    def _analyze_with_model(self, model):
        """使用單個模型分析需求"""
        prompt = f"""
        請分析以下需求文檔：
        
        {self.requirements}
        
        請?zhí)峁?
        1. 需求理解總結
        2. 核心功能識別
        3. 技術難點預判
        4. 潛在風險提示
        """
        return f"{model} 分析結果"
    
    def compare_and_select(self, analysis_results):
        """對比分析結果，選擇最優(yōu)方案"""
        best_model = max(analysis_results, key=lambda k: len(analysis_results[k]))
        return analysis_results[best_model]
    
    def refine_prompt(self, selected_analysis):
        """基于分析結果優(yōu)化提示詞"""
        refined_prompt = f"""
        # 優(yōu)化后的提示詞
        
        ## 需求理解
        {selected_analysis['summary']}
        
        ## 核心功能
        {selected_analysis['features']}
        
        ## 技術約束
        {selected_analysis['constraints']}
        
        ## 輸出要求
        - 每階段生成獨立文檔
        - 需要確認后進入下一階段
        - 代碼完整，可直接運行
        """
        return refined_prompt

class SolutionEvaluation:
    """方案評估階段"""
    
    def __init__(self, requirements_doc):
        self.requirements_doc = requirements_doc
    
    def create_evaluator_prompt(self):
        """創(chuàng)建評估專家提示詞"""
        return f"""
        你是資深 AICoding 評審專家，專精于代碼生成方案的邏輯審查與技術可行性評估。
        
        ## 核心能力
        - 精準解讀需求文檔，提取關鍵功能點與技術約束
        - 系統(tǒng)性評估 AICoding 提出的修改計劃
        - 識別修改計劃中的邏輯漏洞、冗余步驟、過度設計及潛在技術隱患
        - 給出可落地的優(yōu)化建議
        
        ## 評估標準
        1. 需求匹配度：方案是否滿足所有需求
        2. 技術合理性：技術選型是否合適
        3. 架構完整性：架構設計是否完整
        4. 可維護性：代碼是否易于維護
        5. 性能考慮：是否考慮性能優(yōu)化
        6. 安全性：是否考慮安全問題
        
        ## 輸出格式
        - 需求理解：一句話概括核心目標
        - 評估意見：合理部分、需調整部分、不合理部分
        - 優(yōu)化建議：分條給出具體建議
        - 風險提示：性能、安全、可維護性風險
        
        ## 需求文檔
        {self.requirements_doc}
        """
    
    def evaluate_design_documents(self, documents):
        """評估設計文檔"""
        evaluation_results = {}
        
        for doc_name, content in documents.items():
            result = self._evaluate_document(doc_name, content)
            evaluation_results[doc_name] = result
        
        return evaluation_results
    
    def _evaluate_document(self, doc_name, content):
        """評估單個文檔"""
        evaluation = {
            "document": doc_name,
            "strengths": [],      # 優(yōu)點
            "weaknesses": [],     # 缺點
            "suggestions": [],    # 建議
            "risks": []           # 風險
        }
        
        # 模擬評估邏輯
        if doc_name == "architecture.md":
            evaluation["strengths"] = ["分層架構清晰", "技術棧合理"]
            evaluation["weaknesses"] = ["缺少容錯機制"]
            evaluation["suggestions"] = ["添加服務降級方案"]
            evaluation["risks"] = ["高并發(fā)場景需要優(yōu)化"]
        
        return evaluation
    
    def generate_adjusted_plan(self, evaluations):
        """生成調整后的方案"""
        adjusted_plan = {
            "original_plan": evaluations,
            "changes": [],
            "justification": []
        }
        
        for doc_name, eval_result in evaluations.items():
            if eval_result["suggestions"]:
                adjusted_plan["changes"].append({
                    "document": doc_name,
                    "suggestions": eval_result["suggestions"]
                })
        
        return adjusted_plan

class CodeGeneration:
    """代碼生成階段"""
    
    def __init__(self, design_documents, prompt):
        self.design_documents = design_documents
        self.prompt = prompt
    
    def read_design_documents(self):
        """讀取設計文檔"""
        docs_content = {}
        for doc_name, path in self.design_documents.items():
            with open(path, 'r', encoding='utf-8') as f:
                docs_content[doc_name] = f.read()
        return docs_content
    
    def build_code_generation_prompt(self):
        """構建代碼生成提示詞"""
        docs_content = self.read_design_documents()
        
        prompt = f"""
        # 代碼生成指令
        
        請仔細閱讀以下設計文檔：
        
        ## 技術棧與架構設計
        {docs_content.get('architecture.md', '')}
        
        ## 數(shù)據(jù)庫設計
        {docs_content.get('database.md', '')}
        
        ## 技術方案
        {docs_content.get('technical_solution.md', '')}
        
        ## 核心要求
        {self.prompt}
        
        ## 輸出要求
        1. 按模塊逐步生成代碼
        2. 每個文件內容完整
        3. 說明文件存放路徑
        4. 包含配置文件和環(huán)境變量示例
        5. 提供啟動指南
        """
        
        return prompt
    
    def generate_code_in_batches(self, modules):
        """分批次生成代碼"""
        code_output = {}
        
        for module in modules:
            module_prompt = self._build_module_prompt(module)
            code = self._generate_module_code(module_prompt)
            code_output[module] = code
        
        return code_output
    
    def _build_module_prompt(self, module):
        """構建模塊代碼生成提示詞"""
        return f"""
        ## 模塊：{module}
        
        請生成 {module} 模塊的完整代碼，包括：
        - 接口定義
        - 實現(xiàn)代碼
        - 測試代碼
        - 文檔說明
        """
    
    def _generate_module_code(self, prompt):
        """生成模塊代碼（模擬）"""
        return f"http:// {prompt.split('模塊：')[1].strip()} 模塊代碼"
    
    def generate_claude_md(self, project_path):
        """生成 claude.md 用于后續(xù)迭代"""
        claude_md = f"""
        # {project_path} 項目文檔
        
        ## 項目概述
        項目簡介和目標
        
        ## 技術棧
        - 前端：Vue3 + Element Plus
        - 后端：FastAPI + SQLAlchemy
        - 數(shù)據(jù)庫：MySQL + Redis
        
        ## 目錄結構
        項目目錄說明
        
        ## 配置文件
        環(huán)境變量說明
        
        ## 啟動方式
        本地啟動和部署說明
        
        ## 迭代記錄
        后續(xù)修改和優(yōu)化記錄
        """
        
        with open(f"{project_path}/claude.md", 'w', encoding='utf-8') as f:
            f.write(claude_md)
        
        return claude_md

class EnvironmentConfiguration:
    """環(huán)境配置階段"""
    
    def __init__(self, project_path, tech_stack):
        self.project_path = project_path
        self.tech_stack = tech_stack
    
    def create_virtual_environment(self):
        """創(chuàng)建虛擬環(huán)境"""
        env_config = {
            "environment": "conda",
            "python_version": "3.11",
            "requirements": self.tech_stack["backend"]["packages"]
        }
        
        return env_config
    
    def generate_config_files(self):
        """生成配置文件"""
        config_files = {}
        
        # .env 文件
        config_files[".env"] = """
        # 數(shù)據(jù)庫配置
        DB_HOST=localhost
        DB_PORT=3306
        DB_USER=admin
        DB_PASSWORD=password
        DB_NAME=app
        
        # Redis 配置
        REDIS_HOST=localhost
        REDIS_PORT=6379
        
        # 應用配置
        APP_PORT=8000
        DEBUG=True
        SECRET_KEY=your-secret-key
        """
        
        # .gitignore 文件
        config_files[".gitignore"] = """
        __pycache__/
        *.pyc
        *.pyo
        .env
        .venv/
        .idea/
        node_modules/
        dist/
        build/
        """
        
        return config_files
    
    def write_config_files(self, config_files):
        """寫入配置文件"""
        for filename, content in config_files.items():
            with open(f"{self.project_path}/{filename}", 'w', encoding='utf-8') as f:
                f.write(content.strip())
    
    def generate_readme(self):
        """生成 README.md"""
        readme = f"""
        # {self.project_path.split('/')[-1]}
        
        項目簡介
        
        ## 技術棧
        
        ### 前端
        - Vue 3
        - Element Plus
        - Vite
        
        ### 后端
        - FastAPI
        - SQLAlchemy
        - MySQL
        
        ## 快速開始
        
        ### 環(huán)境要求
        - Python 3.11+
        - Node.js 18+
        - MySQL 8.0+
        
        ### 安裝依賴
        
        ```bash
        # 創(chuàng)建虛擬環(huán)境
        conda create -n app python=3.11
        conda activate app
        
        # 安裝后端依賴
        pip install -r requirements.txt
        
        # 安裝前端依賴
        cd frontend
        npm install
        ```
        
        ### 配置環(huán)境變量
        
        復制 `.env.example` 為 `.env`，修改配置信息。
        
        ### 啟動服務
        
        ```bash
        # 啟動后端
        python main.py
        
        # 啟動前端
        cd frontend
        npm run dev
        ```
        
        ## 項目結構
        
        項目目錄說明
        
        ## 開發(fā)指南
        
        開發(fā)規(guī)范和注意事項
        
        ## License
        
        MIT
        """
        
        return readme

class TestingValidation:
    """測試驗證階段"""
    
    def __init__(self, project_path):
        self.project_path = project_path
    
    def initialize_database(self):
        """初始化數(shù)據(jù)庫"""
        steps = [
            "創(chuàng)建數(shù)據(jù)庫",
            "運行遷移腳本",
            "插入初始數(shù)據(jù)",
            "驗證數(shù)據(jù)完整性"
        ]
        
        for step in steps:
            print(f"執(zhí)行：{step}")
        
        return True
    
    def run_unit_tests(self):
        """運行單元測試"""
        test_results = {
            "total": 25,
            "passed": 23,
            "failed": 2,
            "coverage": "85%"
        }
        
        return test_results
    
    def run_integration_tests(self):
        """運行集成測試"""
        integration_tests = [
            "API 接口測試",
            "數(shù)據(jù)庫連接測試",
            "前后端交互測試",
            "權限驗證測試"
        ]
        
        results = {}
        for test in integration_tests:
            results[test] = "通過"
        
        return results
    
    def verify_application(self):
        """驗證應用是否正常運行"""
        verification_checklist = [
            "服務是否正常啟動",
            "數(shù)據(jù)庫連接是否正常",
            "API 接口是否可訪問",
            "前端頁面是否可加載",
            "核心功能是否可用",
            "錯誤處理是否完善"
        ]
        
        results = {}
        for check in verification_checklist:
            results[check] = True
        
        return results
    
    def generate_test_report(self):
        """生成測試報告"""
        unit_results = self.run_unit_tests()
        integration_results = self.run_integration_tests()
        app_verification = self.verify_application()
        
        report = f"""
        # 測試驗證報告
        
        ## 單元測試
        - 總數(shù)：{unit_results['total']}
        - 通過：{unit_results['passed']}
        - 失?。簕unit_results['failed']}
        - 覆蓋率：{unit_results['coverage']}
        
        ## 集成測試
        {integration_results}
        
        ## 應用驗證
        {app_verification}
        
        ## 結論
        {'項目驗證通過' if all(app_verification.values()) else '項目需要修復'}
        """
        
        return report

success_factors = {
    "前期準備": "充分理解概念，用 AI 分析需求，對比不同模型",
    "提示詞優(yōu)化": "確認并優(yōu)化提示詞，確保語義對齊",
    "評估階段": "創(chuàng)建專業(yè)評估人設，審查所有設計文檔",
    "代碼生成": "分批次分階段生成，確保質量",
    "環(huán)境配置": "生成配置文件、啟動指南、README.md",
    "測試驗證": "執(zhí)行數(shù)據(jù)庫初始化，確保一次跑通"
}