Create app.py

app.py

@@ -0,0 +1,739 @@
+"""
+IT-Business Analysis Assistant - Professional Version with DeepSeek AI
+Enhanced Local Templates for Comprehensive BA Coverage
+"""
+
+import os
+import json
+import difflib
+import logging
+import requests
+from pathlib import Path
+from typing import Tuple, List, Dict, Any, Optional
+
+import gradio as gr
+from dotenv import load_dotenv
+
+# Load environment variables
+load_dotenv()
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
+logger = logging.getLogger(__name__)
+
+# ---------------------------
+# Configuration
+# ---------------------------
+class Config:
+    """Application configuration"""
+    
+    BASE_DIR = Path(__file__).resolve().parent
+    DATA_DIR = BASE_DIR / "data"
+    KEYWORDS_FILE = DATA_DIR / "ba_keywords.json"
+    KEYWORD_MATCH_THRESHOLD = 0.7
+    
+    APP_NAME = "Professional IT Business Analysis Assistant"
+    APP_VERSION = "3.0.0"
+    APP_DESCRIPTION = "AI-powered guide for BA concepts and business domains"
+    
+    # DeepSeek API Configuration - Reads from secrets
+    DEEPSEEK_API_KEY = os.environ.get("BA_Assistant") or os.environ.get("DEEPSEEK_API_KEY") or ""
+    DEEPSEEK_BASE_URL = "https://api.deepseek.com/v1"
+    DEEPSEEK_MODEL = "deepseek-chat"
+
+# ===== API KEY TEST (Using Config) =====
+print("\n" + "="*50)
+print("🔍 TESTING DEEPSEEK API KEY DIRECTLY")
+print("="*50)
+
+if Config.DEEPSEEK_API_KEY:
+    print(f"Testing key: {Config.DEEPSEEK_API_KEY[:10]}...")
+    
+    try:
+        headers = {"Authorization": f"Bearer {Config.DEEPSEEK_API_KEY}"}
+        response = requests.get(
+            "https://api.deepseek.com/v1/models",
+            headers=headers,
+            timeout=10
+        )
+        print(f"Status Code: {response.status_code}")
+        if response.status_code == 200:
+            print("✅ SUCCESS! Key works!")
+            print(f"Response: {response.json()}")
+        else:
+            print(f"❌ FAILED: {response.text}")
+    except Exception as e:
+        print(f"❌ ERROR: {e}")
+else:
+    print("❌ No API key found in environment")
+print("="*50 + "\n")
+# ===== END TEST =====
+
+# Initialize DeepSeek
+DEEPSEEK_AVAILABLE = False
+DEEPSEEK_ERROR = None
+
+if Config.DEEPSEEK_API_KEY:
+    logger.info(f"✅ DeepSeek API key found (length: {len(Config.DEEPSEEK_API_KEY)})")
+    
+    # Simple validation - just check key length
+    if len(Config.DEEPSEEK_API_KEY) > 20:
+        DEEPSEEK_AVAILABLE = True
+        logger.info("✅ DeepSeek API is AVAILABLE and ready to use!")
+    else:
+        DEEPSEEK_ERROR = "API key too short"
+        logger.warning(f"⚠️ {DEEPSEEK_ERROR}")
+else:
+    DEEPSEEK_ERROR = "No API key found"
+    logger.info("📚 No API key - using local templates")
+
+# ---------------------------
+# Load BA Keywords
+# ---------------------------
+def load_ba_keywords() -> Dict[str, List[str]]:
+    """Load BA keywords from JSON file"""
+    try:
+        if not Config.KEYWORDS_FILE.exists():
+            logger.warning("Keywords file not found, using defaults")
+            return get_default_ba_keywords()
+            
+        with open(Config.KEYWORDS_FILE, 'r', encoding='utf-8') as f:
+            data = json.load(f)
+            return data.get('categories', get_default_ba_keywords())
+    except Exception as e:
+        logger.error(f"Error loading keywords: {e}")
+        return get_default_ba_keywords()
+
+def get_default_ba_keywords() -> Dict[str, List[str]]:
+    """Fallback default BA keywords"""
+    return {
+        "Core Concepts": [
+            "business analysis", "requirements gathering", "stakeholder analysis",
+            "business case", "scope definition", "gap analysis", "requirements",
+            "stakeholder", "business need", "value proposition", "traceability",
+            "swot analysis", "pestle analysis", "mosco w", "prioritization"
+        ],
+        "Methodologies": [
+            "agile", "scrum", "kanban", "waterfall", "babok", "bpmn", "uml",
+            "user stories", "acceptance criteria", "sprint", "product backlog"
+        ],
+        "Requirements": [
+            "functional requirements", "non-functional requirements", "srs", "brd",
+            "user stories", "acceptance criteria", "requirements traceability",
+            "traceability matrix", "rtm", "use cases", "epics", "features"
+        ],
+        "Business Domains": [
+            "financial services", "banking", "healthcare", "retail", "supply chain",
+            "insurance", "manufacturing", "telecom", "e-commerce", "logistics"
+        ]
+    }
+
+# Load keywords
+BA_KEYWORDS = load_ba_keywords()
+
+# Create a simple list of all keywords for matching
+ALL_KEYWORDS = []
+for category, keywords in BA_KEYWORDS.items():
+    ALL_KEYWORDS.extend([k.lower() for k in keywords])
+ALL_KEYWORDS = list(set(ALL_KEYWORDS))
+logger.info(f"📊 Loaded {len(ALL_KEYWORDS)} keywords")
+
+# ---------------------------
+# Simple Keyword Detection
+# ---------------------------
+def is_ba_related(question: str) -> Tuple[bool, List[str], List[str]]:
+    """
+    Simple check if question contains BA-related keywords
+    """
+    if not question or not question.strip():
+        return False, [], []
+    
+    question_lower = question.lower()
+    matched_keywords = []
+    matched_categories = set()
+    
+    # Simple contains check
+    for keyword in ALL_KEYWORDS:
+        if keyword in question_lower:
+            matched_keywords.append(keyword)
+            for cat, keys in BA_KEYWORDS.items():
+                if any(k.lower() == keyword for k in keys):
+                    matched_categories.add(cat)
+                    break
+    
+    # Also check individual words for common BA terms
+    words = question_lower.split()
+    ba_terms = ["stakeholder", "requirement", "agile", "scrum", "babok", 
+                "banking", "healthcare", "traceability", "waterfall", "kanban",
+                "swot", "pestle", "business case", "gap analysis", "mosco w"]
+    for term in ba_terms:
+        if term in words or term in question_lower:
+            matched_keywords.append(term)
+            if term in ["stakeholder", "requirement", "traceability", "business case", "gap analysis"]:
+                matched_categories.add("Core Concepts")
+            elif term in ["agile", "scrum", "babok", "waterfall", "kanban"]:
+                matched_categories.add("Methodologies")
+            elif term in ["swot", "pestle", "mosco w"]:
+                matched_categories.add("Core Concepts")
+            elif term in ["banking", "healthcare"]:
+                matched_categories.add("Business Domains")
+    
+    is_related = len(matched_keywords) > 0
+    return is_related, list(set(matched_keywords))[:5], list(matched_categories)
+
+# ---------------------------
+# Get DeepSeek Response
+# ---------------------------
+def get_deepseek_response(question: str) -> Optional[str]:
+    """Get response from DeepSeek API"""
+    
+    if not DEEPSEEK_AVAILABLE:
+        logger.info("DeepSeek not available, skipping API call")
+        return None
+    
+    try:
+        logger.info(f"Calling DeepSeek API for question: {question[:50]}...")
+        
+        url = f"{Config.DEEPSEEK_BASE_URL}/chat/completions"
+        headers = {
+            "Authorization": f"Bearer {Config.DEEPSEEK_API_KEY}",
+            "Content-Type": "application/json"
+        }
+        payload = {
+            "model": Config.DEEPSEEK_MODEL,
+            "messages": [
+                {"role": "system", "content": "You are a senior IT Business Analysis consultant. Provide professional, practical advice."},
+                {"role": "user", "content": question}
+            ],
+            "temperature": 0.7,
+            "max_tokens": 800
+        }
+        
+        response = requests.post(url, headers=headers, json=payload, timeout=30)
+        
+        if response.status_code != 200:
+            logger.warning(f"DeepSeek API error: {response.status_code} - {response.text}")
+            return None
+            
+        result = response.json()
+        logger.info("✅ DeepSeek API call successful")
+        return result["choices"][0]["message"]["content"]
+        
+    except requests.exceptions.Timeout:
+        logger.warning("DeepSeek API timeout")
+        return None
+    except requests.exceptions.ConnectionError:
+        logger.warning("DeepSeek API connection error")
+        return None
+    except Exception as e:
+        logger.warning(f"DeepSeek API error: {type(e).__name__}: {e}")
+        return None
+
+# ---------------------------
+# Enhanced Local Response Templates
+# ---------------------------
+def get_local_response(question: str, keywords: List[str], categories: List[str]) -> str:
+    """Get response from local templates"""
+    
+    question_lower = question.lower()
+    
+    # AGILE SPECIFIC
+    if "agile" in question_lower and "scrum" not in question_lower:
+        return """
+## 🔄 Agile Methodology
+
+### Core Agile Principles
+- **Individuals and interactions** over processes and tools
+- **Working software** over comprehensive documentation
+- **Customer collaboration** over contract negotiation
+- **Responding to change** over following a plan
+
+### Agile Methodologies
+- **Scrum**: Sprint-based framework with defined roles
+- **Kanban**: Visual workflow management with WIP limits
+- **XP (Extreme Programming)**: Technical practices for quality
+- **Lean**: Focus on value and eliminating waste
+
+### When to Use Agile
+- Requirements expected to change
+- Fast delivery to market is important
+- Close collaboration possible
+- Complex or uncertain projects
+"""
+    
+    # SCRUM SPECIFIC
+    elif "scrum" in question_lower:
+        return """
+## 🏃 Scrum Framework
+
+### Scrum Roles
+| **Role** | **Responsibilities** |
+|----------|----------------------|
+| **Product Owner** | Manages backlog, maximizes value, stakeholder liaison |
+| **Scrum Master** | Facilitates process, removes impediments, coaches team |
+| **Development Team** | Self-organizing, cross-functional, delivers increments |
+
+### Scrum Events
+| **Event** | **Purpose** | **Duration** |
+|-----------|-------------|--------------|
+| **Sprint Planning** | Plan work for upcoming sprint | Max 8 hours for 1-month sprint |
+| **Daily Stand-up** | Sync progress, plan next 24 hours | 15 minutes |
+| **Sprint Review** | Demonstrate completed work | Max 4 hours for 1-month sprint |
+| **Sprint Retrospective** | Inspect and adapt process | Max 3 hours for 1-month sprint |
+
+### Scrum Artifacts
+- **Product Backlog**: Prioritized list of all desired work
+- **Sprint Backlog**: Selected items for current sprint + plan
+- **Increment**: Potentially releasable product at end of sprint
+"""
+    
+    # KANBAN SPECIFIC
+    elif "kanban" in question_lower:
+        return """
+## 📋 Kanban Method
+
+### Core Principles
+- **Visualize Work**: Use boards with columns (To Do, Doing, Done)
+- **Limit Work in Progress (WIP)** : Focus on completing tasks
+- **Manage Flow**: Optimize throughput and reduce cycle time
+- **Make Policies Explicit**: Clearly define processes
+- **Improve Collaboratively**: Evolve with team feedback
+
+### Kanban Metrics
+- **Lead Time**: Time from request to delivery
+- **Cycle Time**: Time work is actively being worked on
+- **Throughput**: Amount of work completed per time period
+- **WIP Limits**: Maximum items allowed in each column
+"""
+    
+    # WATERFALL SPECIFIC
+    elif "waterfall" in question_lower:
+        return """
+## 💧 Waterfall Methodology
+
+### Phases of Waterfall
+1. **Requirements Analysis**: Document all requirements upfront
+2. **Design**: Create system architecture and design specifications
+3. **Implementation**: Build the system according to design
+4. **Testing**: Verify system meets requirements
+5. **Deployment**: Release to production
+6. **Maintenance**: Ongoing support and fixes
+
+### When to Use Waterfall
+- Requirements are clear and stable
+- Project is simple and well-understood
+- Regulatory/compliance needs extensive documentation
+- Fixed budget and timeline are critical
+"""
+    
+    # BABOK SPECIFIC
+    elif "babok" in question_lower:
+        return """
+## 📘 BABOK Guide (Business Analysis Body of Knowledge)
+
+### Six Knowledge Areas
+| **Knowledge Area** | **Description** |
+|-------------------|-----------------|
+| **1. Business Analysis Planning & Monitoring** | Planning BA approach, stakeholder engagement |
+| **2. Elicitation & Collaboration** | Gathering requirements from stakeholders |
+| **3. Requirements Life Cycle Management** | Managing requirements throughout the project |
+| **4. Strategy Analysis** | Understanding business needs and context |
+| **5. Requirements Analysis & Design Definition** | Structuring and validating requirements |
+| **6. Solution Evaluation** | Assessing solution performance and value |
+
+### Certification Levels
+| **Certification** | **Experience** | **Target** |
+|-------------------|---------------|------------|
+| **ECBA** (Entry) | None | New to BA field |
+| **CCBA** (Capability) | 2-3 years | Experienced practitioners |
+| **CBAP** (Professional) | 5+ years | Senior BAs and leaders |
+"""
+    
+    # STAKEHOLDER SPECIFIC
+    elif "stakeholder" in question_lower:
+        return """
+## 👥 Stakeholder Management
+
+### Stakeholder Identification
+**Internal Stakeholders:**
+- Project Sponsor, Product Owner, Team Members, Department Managers
+
+**External Stakeholders:**
+- Customers, Vendors, Regulators, Partners
+
+### Power-Interest Grid
+- **High Power, High Interest**: Manage closely (sponsors, key customers)
+- **High Power, Low Interest**: Keep satisfied (executives, regulators)
+- **Low Power, High Interest**: Keep informed (end users, SMEs)
+- **Low Power, Low Interest**: Monitor (general staff)
+
+### RACI Matrix
+- **R** = Responsible (does the work)
+- **A** = Accountable (approves)
+- **C** = Consulted (provides input)
+- **I** = Informed (receives updates)
+"""
+    
+    # REQUIREMENTS SPECIFIC
+    elif "requirement" in question_lower or "gathering" in question_lower:
+        return """
+## 📝 Requirements Engineering
+
+### Types of Requirements
+| **Type** | **Description** | **Example** |
+|----------|-----------------|-------------|
+| **Business Requirements** | High-level organizational needs | "Increase customer satisfaction by 20%" |
+| **User Requirements** | What users need to do | "Users need to reset password easily" |
+| **Functional Requirements** | What system must do | "System shall send password reset email" |
+| **Non-Functional Requirements** | Quality attributes | "System shall respond within 2 seconds" |
+
+### Elicitation Techniques
+- **Interviews**: One-on-one discussions with stakeholders
+- **Workshops**: Collaborative sessions with multiple stakeholders
+- **Surveys**: Gather input from large groups
+- **Observation**: Understand current workflows
+- **Document Analysis**: Review existing documentation
+"""
+    
+    # TRACEABILITY SPECIFIC
+    elif "traceability" in question_lower or "rtm" in question_lower:
+        return """
+## 🔍 Requirements Traceability
+
+### What is Traceability?
+The ability to track requirements throughout the project lifecycle—from origin to delivery.
+
+### Traceability Matrix (RTM)
+| **Req ID** | **Requirement** | **Source** | **Design** | **Test Case** | **Status** |
+|------------|-----------------|------------|------------|---------------|------------|
+| REQ-001 | User login | Stakeholder interview | UI-101 | TC-201 | ✅ Done |
+
+### Why Traceability Matters
+| **Scenario** | **Without Traceability** | **With Traceability** |
+|--------------|-------------------------|----------------------|
+| Regulatory audit | 3 months preparation | 3 days with documentation |
+| Requirement change | 2 weeks impact analysis | 2 hours automated |
+"""
+    
+    # BANKING/FINANCIAL SPECIFIC
+    elif "banking" in question_lower or "financial" in question_lower:
+        return """
+## 🏦 Banking & Financial Services
+
+### Key Regulations
+| **Regulation** | **Region** | **Impact** |
+|----------------|------------|------------|
+| **Basel III/IV** | Global | Capital adequacy, risk management |
+| **SOX** | US | Internal controls, audit trails |
+| **PSD2/Open Banking** | EU | API requirements, customer data access |
+
+### Common Projects
+- Core banking transformation
+- Payment systems
+- Mobile banking apps
+- Regulatory reporting
+
+### Sample Requirements
+REQ-BANK-001: System shall enforce dual control for transactions > $1M
+REQ-BANK-002: All user actions shall be logged with timestamp and user ID
+"""
+    
+    # HEALTHCARE SPECIFIC
+    elif "healthcare" in question_lower or "hipaa" in question_lower:
+        return """
+## 🏥 Healthcare IT
+
+### Key Regulations
+| **Regulation** | **Scope** | **BA Impact** |
+|----------------|-----------|---------------|
+| **HIPAA** | US | Privacy, security, patient data |
+| **FDA 21 CFR Part 11** | US | Medical device software validation |
+| **HL7/FHIR** | Global | Healthcare data interoperability |
+
+### Sample Requirements
+REQ-HC-001: System shall encrypt all PHI at rest and in transit
+REQ-HC-002: User sessions shall timeout after 15 minutes of inactivity
+REQ-HC-003: System shall support HL7 v2.x messages for ADT feeds
+"""
+    
+    # RETAIL SPECIFIC
+    elif "retail" in question_lower or "e-commerce" in question_lower:
+        return """
+## 🛍️ Retail & E-commerce
+
+### Key Industry Trends
+- **Omnichannel**: Unified experience across channels
+- **Personalization**: Tailored customer experience
+- **Mobile Commerce**: App-based shopping
+
+### Sample Requirements
+REQ-RT-001: System shall support BOPIS (Buy Online, Pickup In Store)
+REQ-RT-002: Inventory levels shall update in real-time across all channels
+REQ-RT-003: Customer profiles shall be unified across online and in-store
+"""
+    
+    # BUSINESS CASE SPECIFIC
+    elif "business case" in question_lower:
+        return """
+## 💼 Business Case Development
+
+### What is a Business Case?
+A business case provides justification for initiating a project or task. It presents the benefits, costs, and risks of various options.
+
+### Business Case Structure
+| **Section** | **Description** |
+|-------------|-----------------|
+| **Executive Summary** | Brief overview of the proposal |
+| **Problem Statement** | Current issues and opportunities |
+| **Options Analysis** | Evaluation of possible solutions |
+| **Cost-Benefit Analysis** | Financial justification |
+| **Risk Assessment** | Potential risks and mitigation |
+| **Recommendation** | Proposed solution with rationale |
+
+### Key Metrics
+- **ROI** (Return on Investment)
+- **NPV** (Net Present Value)
+- **Payback Period**
+- **IRR** (Internal Rate of Return)
+"""
+    
+    # SWOT ANALYSIS SPECIFIC
+    elif "swot" in question_lower:
+        return """
+## 📊 SWOT Analysis
+
+### What is SWOT?
+SWOT is a strategic planning technique used to identify Strengths, Weaknesses, Opportunities, and Threats.
+
+### SWOT Matrix
+| **Positive** | **Negative** |
+|--------------|--------------|
+| **Strengths** (Internal) | **Weaknesses** (Internal) |
+| • Unique capabilities | • Resource gaps |
+| • Competitive advantages | • Skill deficiencies |
+| • Valuable assets | • Process inefficiencies |
+| **Opportunities** (External) | **Threats** (External) |
+| • Market growth | • New competitors |
+| • Emerging technologies | • Regulatory changes |
+| • Strategic partnerships | • Economic downturns |
+
+### How to Use SWOT
+1. List internal strengths and weaknesses
+2. Identify external opportunities and threats
+3. Develop strategies that:
+   - Leverage strengths to capture opportunities
+   - Address weaknesses to mitigate threats
+"""
+    
+    # PESTLE ANALYSIS SPECIFIC
+    elif "pestle" in question_lower:
+        return """
+## 🌍 PESTLE Analysis
+
+### What is PESTLE?
+PESTLE analyzes external factors affecting an organization: Political, Economic, Social, Technological, Legal, Environmental.
+
+### PESTLE Framework
+| **Factor** | **Examples** |
+|------------|--------------|
+| **Political** | Government policies, trade restrictions, tax policies |
+| **Economic** | Inflation, interest rates, economic growth |
+| **Social** | Demographics, cultural trends, lifestyle changes |
+| **Technological** | Automation, R&D, technology innovation |
+| **Legal** | Employment laws, health & safety, regulations |
+| **Environmental** | Climate change, sustainability, carbon footprint |
+
+### When to Use PESTLE
+- Strategic planning
+- Market entry decisions
+- New product development
+- Business transformation projects
+"""
+    
+    # GAP ANALYSIS SPECIFIC
+    elif "gap analysis" in question_lower:
+        return """
+## 🔄 Gap Analysis
+
+### What is Gap Analysis?
+Gap analysis compares current state with desired future state to identify what's missing.
+
+### Gap Analysis Process
+1. **Define Current State**: Document existing processes, capabilities, performance
+2. **Define Future State**: Describe desired outcomes and objectives
+3. **Identify Gaps**: List what's missing or needs improvement
+4. **Develop Action Plan**: Create initiatives to close gaps
+
+### Gap Analysis Framework
+| **Area** | **Current State** | **Future State** | **Gap** | **Action** |
+|----------|-------------------|------------------|---------|------------|
+| Process | Manual data entry | Automated workflow | Automation missing | Implement RPA |
+| Skills | Basic Excel | Advanced analytics | Training needed | Upskill team |
+| Technology | Legacy system | Cloud platform | Migration required | Cloud strategy |
+"""
+    
+    # REQUIREMENTS PRIORITIZATION SPECIFIC
+    elif "prioritization" in question_lower or "mosco w" in question_lower:
+        return """
+## ⚖️ Requirements Prioritization
+
+### MoSCoW Method
+| **Priority** | **Meaning** | **Description** |
+|--------------|-------------|-----------------|
+| **M**ust have | Critical | Non-negotiable requirements |
+| **S**hould have | Important | High priority but can wait |
+| **C**ould have | Nice to have | Desirable if time permits |
+| **W**on't have | Out of scope | Explicitly excluded for now |
+
+### Other Prioritization Techniques
+| **Technique** | **Description** | **Best For** |
+|---------------|-----------------|--------------|
+| **Kano Model** | Classifies features as Basic, Performance, or Delighters | Customer satisfaction |
+| **Value vs Effort** | Plot requirements on value/effort matrix | Quick wins identification |
+| **100-Point Method** | Stakeholders allocate 100 points across requirements | Group consensus |
+| **Pairwise Comparison** | Compare requirements in pairs | Detailed analysis |
+"""
+    
+    # GENERIC RESPONSE
+    else:
+        cats = ', '.join(categories) if categories else 'General BA'
+        topics = ', '.join(keywords[:3]) if keywords else 'BA concepts'
+        
+        return f"""
+## 📊 Business Analysis Information
+
+**Categories:** {cats}
+**Topics:** {topics}
+
+### Quick Reference
+- **Core Concepts**: Requirements, stakeholders, scope, value, business case, SWOT, PESTLE
+- **Methodologies**: Agile, Scrum, Waterfall, BABOK, Kanban
+- **Domains**: Banking, Healthcare, Retail, Supply Chain
+
+### Popular BA Techniques
+- **MoSCoW Prioritization**: Must/Should/Could/Won't
+- **SWOT Analysis**: Strengths/Weaknesses/Opportunities/Threats
+- **PESTLE**: Political/Economic/Social/Technological/Legal/Environmental
+- **Gap Analysis**: Current vs Future state
+- **Business Case**: ROI, NPV, Payback period
+
+### Ask for More Details
+Try specific questions like:
+- "Explain Scrum roles and events"
+- "What is the difference between Agile and Waterfall?"
+- "How to create a traceability matrix?"
+- "Banking regulations for BAs"
+- "Healthcare compliance requirements (HIPAA)"
+- "How to create a business case?"
+- "Explain SWOT analysis"
+- "What is PESTLE analysis?"
+- "How to prioritize requirements with MoSCoW?"
+"""
+
+# ---------------------------
+# Main Function
+# ---------------------------
+def ask_ba_assistant(question: str) -> str:
+    """Main function to handle BA queries"""
+    
+    question = question.strip()
+    
+    if not question:
+        return "Please enter a question about IT-Business Analysis."
+    
+    # Check if BA-related
+    is_related, keywords, categories = is_ba_related(question)
+    
+    if not is_related:
+        return """❌ I specialize in IT-Business Analysis topics only.
+
+### ✅ Try Asking About:
+• What is requirements gathering?
+• How to manage stakeholders?
+• Explain Agile methodology
+• Banking domain analysis
+• Healthcare IT requirements
+• How to create a business case?
+• Explain SWOT analysis
+• What is PESTLE analysis?
+• How to prioritize requirements with MoSCoW?
+"""
+    
+    # Try DeepSeek if available
+    if DEEPSEEK_AVAILABLE:
+        logger.info(f"Attempting DeepSeek for: {question}")
+        ai_response = get_deepseek_response(question)
+        if ai_response:
+            return ai_response + "\n\n---\n*Powered by DeepSeek AI Free Tier*"
+        else:
+            logger.info("DeepSeek failed, falling back to local templates")
+    
+    # Fallback to local templates
+    response = get_local_response(question, keywords, categories)
+    return response + "\n\n---\n*Professional Knowledge Base*"
+
+# ---------------------------
+# Build Interface
+# ---------------------------
+def build_app():
+    """Build the Gradio interface"""
+    
+    if DEEPSEEK_AVAILABLE:
+        status = "🟢 DEEPSEEK AI ACTIVE"
+        status_detail = "Using DeepSeek Free Tier (5M tokens/month)"
+    else:
+        status = "🟡 LOCAL TEMPLATES"
+        status_detail = DEEPSEEK_ERROR if DEEPSEEK_ERROR else "No API key configured"
+    
+    with gr.Blocks(theme=gr.themes.Soft()) as demo:
+        gr.Markdown(f"""
+        <div style='text-align:center;'>
+            <h1>📊 Professional IT Business Analysis Assistant</h1>
+            <p><i>AI-powered guide for BA concepts and business domains</i></p>
+            <p>Version 3.0.0 | Mode: {status}</p>
+            <p style='font-size:0.9em; color:#666;'>{status_detail}</p>
+        </div>
+        """)
+        
+        with gr.Row():
+            with gr.Column(scale=2):
+                question = gr.Textbox(
+                    label="Ask your BA question",
+                    placeholder="e.g., How to manage stakeholders? What is requirements traceability? Explain SWOT analysis",
+                    lines=3
+                )
+                submit_btn = gr.Button("🔍 Get Guidance", variant="primary", size="lg")
+                
+            with gr.Column(scale=3):
+                output = gr.Textbox(
+                    label="Response",
+                    lines=20,
+                    interactive=False,
+                    show_copy_button=True
+                )
+        
+        gr.Examples(
+            examples=[
+                ["How to manage stakeholders?"],
+                ["What is requirements traceability?"],
+                ["Explain Agile methodology"],
+                ["Banking domain analysis techniques"],
+                ["Healthcare compliance requirements"],
+                ["How to create a business case?"],
+                ["Explain SWOT analysis"],
+                ["What is PESTLE analysis?"],
+                ["How to prioritize requirements with MoSCoW?"]
+            ],
+            inputs=question
+        )
+        
+        submit_btn.click(fn=ask_ba_assistant, inputs=question, outputs=output)
+    
+    return demo
+
+# ---------------------------
+# Launch
+# ---------------------------
+if __name__ == "__main__":
+    demo = build_app()
+    demo.launch(server_name="0.0.0.0", server_port=7860)