┌─────────────────────────────────────────────────────────────────────────────┐
│                    CAPSTONE PROJECT TYPES                                   │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  1. RESEARCH PROJECT                                                       │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • In-depth analysis of a specific topic                            │   │
│  │ • Literature review and synthesis                                  │   │
│  │ • Original insights and recommendations                           │   │
│  │ • Examples: Tokenomics analysis, regulatory impact study            │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  2. TECHNICAL PROJECT                                                      │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Development of a blockchain-based solution                        │   │
│  │ • Smart contracts, DApps, or protocols                             │   │
│  │ • Implementation and testing                                       │   │
│  │ • Examples: DeFi protocol, NFT marketplace, DAO framework          │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  3. BUSINESS/PRODUCT PROJECT                                               │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Business plan for a blockchain venture                           │   │
│  │ • Go-to-market strategy                                             │   │
│  │ • Financial modelling and tokenomics                                │   │
│  │ • Examples: DeFi startup plan, blockchain consulting proposal       │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  4. POLICY/REGULATORY PROJECT                                              │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Analysis of regulatory frameworks                                │   │
│  │ • Policy recommendations                                            │   │
│  │ • Comparative jurisdictional analysis                              │   │
│  │ • Examples: Crypto regulation proposal, compliance framework       │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                    PROJECT SELECTION PROCESS                                │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  1. BRAINSTORM                                                             │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Generate project ideas                                            │   │
│  │ • Consider interests and skills                                    │   │
│  │ • Review problem areas                                              │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                    │                                        │
│                                    v                                        │
│  2. RESEARCH                                                               │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Investigate feasibility                                           │   │
│  │ • Review existing solutions                                         │   │
│  │ • Assess technical requirements                                    │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                    │                                        │
│                                    v                                        │
│  3. EVALUATION                                                             │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Apply selection criteria                                          │   │
│  │ • Compare project options                                          │   │
│  │ • Choose best fit                                                  │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                    │                                        │
│                                    v                                        │
│  4. PROPOSAL                                                               │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │ • Define project scope                                              │   │
│  │ • Outline deliverables                                             │   │
│  │ • Create timeline                                                  │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

# ===================================================================
# MODULE 10, LESSON 1: CAPSTONE PROJECT OVERVIEW AND IDEATION
# ===================================================================

import pandas as pd
import matplotlib.pyplot as plt
from typing import Dict, List
import warnings
warnings.filterwarnings('ignore')

print("="*70)
print("CAPSTONE PROJECT OVERVIEW AND IDEATION")
print("="*70)

# ----------------------------------------------------------------
# PART A: PROJECT SELECTION MATRIX
# ----------------------------------------------------------------

print("\n" + "-"*60)
print("PART A: Project Selection Matrix")
print("-"*60)

class ProjectSelector:
    """
    Tool for selecting and evaluating capstone projects.
    """
    def __init__(self):
        self.projects = []
        self.criteria = ['Relevance', 'Feasibility', 'Impact', 'Interest', 'Originality']
    
    def add_project(self, name: str, scores: Dict[str, int]):
        self.projects.append({
            'name': name,
            'scores': scores
        })
    
    def evaluate(self) -> pd.DataFrame:
        data = []
        for project in self.projects:
            total = sum(project['scores'].values())
            avg = total / len(self.criteria)
            data.append({
                'Project': project['name'],
                **project['scores'],
                'Total': total,
                'Average': avg
            })
        return pd.DataFrame(data)

# Create selector
selector = ProjectSelector()

# Add projects
selector.add_project('DeFi Lending Protocol', {
    'Relevance': 5, 'Feasibility': 4, 'Impact': 5, 'Interest': 4, 'Originality': 3
})

selector.add_project('NFT Marketplace for Real Estate', {
    'Relevance': 4, 'Feasibility': 3, 'Impact': 4, 'Interest': 3, 'Originality': 5
})

selector.add_project('DAO Governance Framework', {
    'Relevance': 4, 'Feasibility': 4, 'Impact': 4, 'Interest': 4, 'Originality': 4
})

selector.add_project('Cross-Chain Bridge Solution', {
    'Relevance': 5, 'Feasibility': 2, 'Impact': 5, 'Interest': 5, 'Originality': 4
})

selector.add_project('Tokenomics Analysis Platform', {
    'Relevance': 4, 'Feasibility': 4, 'Impact': 3, 'Interest': 3, 'Originality': 4
})

print("Project Selection Matrix:")
eval_df = selector.evaluate()
print(eval_df.sort_values('Average', ascending=False).to_string(index=False))

# ----------------------------------------------------------------
# PART B: PROJECT PLANNING TEMPLATE
# ----------------------------------------------------------------

print("\n" + "-"*60)
print("PART B: Project Planning Template")
print("-"*60)

project_plan = {
    "Project Title": "",
    "Project Type": "",
    "Problem Statement": "",
    "Objectives": [],
    "Scope": {
        "In Scope": [],
        "Out of Scope": []
    },
    "Deliverables": [],
    "Timeline": [],
    "Resources Required": [],
    "Risks": [],
    "Success Metrics": []
}

print("Project Planning Template:")
for section, content in project_plan.items():
    print(f"\n{section.upper()}:")
    if isinstance(content, list):
        print("  • [Define your items here]")
    elif isinstance(content, dict):
        for key, value in content.items():
            print(f"  {key}: [Define]")
    else:
        print(f"  [Define: {section}]")

# ----------------------------------------------------------------
# PART C: ASSESSMENT CRITERIA
# -----------------------------------------------------------------

print("\n" + "-"*60)
print("PART C: Assessment Criteria")
print("-"*60)

criteria_data = {
    'Criteria': ['Project Scope', 'Research/Development', 'Analysis/Implementation', 'Innovation', 'Documentation', 'Presentation'],
    'Weight (%)': [10, 25, 25, 15, 15, 10],
    'Description': [
        'Clear, appropriate, well-defined',
        'Thorough, systematic, rigorous',
        'Insightful, correct, complete',
        'Original, creative, value-adding',
        'Clear, comprehensive, professional',
        'Effective communication, engagement'
    ]
}

criteria_df = pd.DataFrame(criteria_data)
print(criteria_df.to_string(index=False))

# ----------------------------------------------------------------
# PART D: PROJECT TIMELINE
# -----------------------------------------------------------------

print("\n" + "-"*60)
print("PART D: Project Timeline")
print("-"*60)

timeline_data = {
    'Phase': ['Ideation', 'Proposal', 'Research/Development', 'Testing', 'Documentation', 'Presentation'],
    'Duration (weeks)': [2, 2, 4, 2, 2, 1],
    'Activities': [
        'Brainstorming, problem identification',
        'Proposal writing, scope definition',
        'Data collection, development, analysis',
        'Testing, validation, iteration',
        'Report writing, code documentation',
        'Presentation creation, practice'
    ]
}

timeline_df = pd.DataFrame(timeline_data)
print(timeline_df.to_string(index=False))

# ----------------------------------------------------------------
# PART E: SUMMARY AND NEXT STEPS
# -----------------------------------------------------------------

print("\n" + "="*70)
print("PART E: Summary and Next Steps")
print("="*70)

print("""
Capstone Project Overview and Ideation – Key Takeaways:

1. The capstone project integrates knowledge from all modules.
2. Project types: research, technical, business, policy.
3. Selection criteria: relevance, feasibility, impact, interest, originality.
4. Deliverables: proposal, reports, final report, presentation, technical artifacts.
5. Assessment: scope, research/development, analysis/implementation, innovation, documentation, presentation.
6. Timeline: ideation → proposal → development → testing → documentation → presentation.

Next Steps:
  - Brainstorm project ideas.
  - Apply the selection matrix to choose a project.
  - Write a project proposal.
  - Create a detailed project plan.
  - Begin research or development.
""")