{"id":43244541,"url":"https://github.com/huzefaaa2/mb","last_synced_at":"2026-02-01T12:04:15.594Z","repository":{"id":335090169,"uuid":"1144034478","full_name":"Huzefaaa2/mb","owner":"Huzefaaa2","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-29T02:38:21.000Z","size":74,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-29T02:53:07.333Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Huzefaaa2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-28T07:59:07.000Z","updated_at":"2026-01-29T02:38:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Huzefaaa2/mb","commit_stats":null,"previous_names":["huzefaaa2/mb"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Huzefaaa2/mb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Huzefaaa2%2Fmb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Huzefaaa2%2Fmb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Huzefaaa2%2Fmb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Huzefaaa2%2Fmb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Huzefaaa2","download_url":"https://codeload.github.com/Huzefaaa2/mb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Huzefaaa2%2Fmb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28977671,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T11:31:13.034Z","status":"ssl_error","status_checked_at":"2026-02-01T11:30:25.558Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-01T12:03:41.153Z","updated_at":"2026-02-01T12:04:15.576Z","avatar_url":"https://github.com/Huzefaaa2.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Magic Bus Compass 360 - Youth Development Platform\n\n**Transform raw engagement data into strategic insights for youth development in the APAC region.**\n\n![Platform Status](https://img.shields.io/badge/Status-Active-brightgreen) ![Python](https://img.shields.io/badge/Python-3.11-blue) ![Streamlit](https://img.shields.io/badge/Streamlit-1.28-red) ![Azure](https://img.shields.io/badge/Azure-Blob_Storage-blue)\n\n## 📋 Table of Contents\n\n- [Overview](#overview)\n- [Key Features](#key-features)\n- [Recent Updates - Phase 3B](#-recent-updates---phase-3b-jan-29-2026)\n- [Architecture](#architecture)\n- [System Flows](#system-flows)\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Documentation](#documentation)\n- [Tech Stack](#tech-stack)\n- [Contributing](#contributing)\n\n---\n\n## 🎯 Overview\n\nMagic Bus Compass 360 is an integrated youth development platform that combines:\n- **Real-time engagement tracking** from APAC region datasets\n- **Decision Intelligence dashboards** powered by Azure Blob Storage\n- **Youth learning journey** management and feedback collection\n- **Admin oversight** and strategic decision support\n- **Data-driven proposals** for funding and interventions\n\nThe platform processes 50+ youth profiles across multiple learning domains, providing actionable insights for stakeholder decision-making.\n\n---\n\n## ✨ Key Features\n\n### 👥 Youth Management\n- Registration and onboarding workflows (5-phase Intelligent Orchestrator)\n- Profile management with education background\n- Learning module assignment and tracking\n- Progress monitoring and engagement metrics\n- **[NEW] Youth Potential Score™** - AI-powered composite scoring (Engagement, Retention, Skills, Placement)\n- **[NEW] Learning Pathway \u0026 Milestones** - 5-stage development tracker\n\n### 📊 Decision Intelligence Dashboard (11 Interactive Tabs)\n- **Executive Overview**: Real-time KPIs (enrollment, completion, dropout risk)\n- **Mobilisation Funnel**: Track progression through learning stages\n- **Sector Heatmap**: Youth interests × readiness alignment\n- **At-Risk Youth**: Priority identification and intervention\n- **Module Effectiveness**: Learning content performance analysis\n- **Gamification Impact**: Badge/points ROI comparison\n- **Screening Analytics**: Voice assessment results and soft skills extraction\n- **[NEW] Youth Potential Score™**: 4-tier distribution, top 20 leaderboard, trend analysis\n- **[NEW] Retention Analytics**: Progress toward 85% target, intervention effectiveness tracking\n- **[NEW] Skill Development**: Role-based gap analysis, personalized learning paths (5 roles)\n- **Proposal Generator**: AI-powered funding proposals\n\n### 💼 Admin Controls\n- User role management (Youth, Admin, Instructor)\n- Learning module creation and configuration\n- Feedback survey distribution and collection\n- System health monitoring\n- **[NEW] Churn Prevention Dashboard** - At-risk student identification, intervention controls, effectiveness tracking\n- **[NEW] Retention Management** - 5 intervention types (Mentorship, Badge Challenge, 1-on-1 Support, Career Coaching, Peer Pairing)\n\n### 📈 Analytics \u0026 AI Engine\n- 50+ youth profiles with engagement data\n- 6 enriched feature tables for decision-making\n- SQLite + Azure Blob Storage hybrid data sources\n- Real-time feature computation pipeline\n- **[NEW] 5 Advanced AI Features**:\n  - ⭐ **Youth Potential Score™** - Composite metric (4 components, 4-tier system)\n  - 🎓 **Skill Gap Bridger** - Role-based analysis for 5 career paths\n  - 🚨 **Churn Risk Prediction** - Binary classifier with intervention tracking\n  - 🎮 **Gamified Retention** - 6 badge types, streak tracking, engagement incentives\n  - 🤝 **Peer Matching Network** - Similarity-based mentor/buddy pairing (k=0.65)\n\n---\n\n## 🏗️ Architecture\n\n### High-Level System Architecture\n\n```mermaid\ngraph TB\n    subgraph \"Data Sources\"\n        SQLite[\"SQLite Database\u003cbr/\u003e50 Youth Records\u003cbr/\u003e9 Tables\"]\n        Azure[\"Azure Blob Storage\u003cbr/\u003eAPAC Region\u003cbr/\u003eRead-Only Access\"]\n    end\n    \n    subgraph \"Backend Services\"\n        Connector[\"Azure Blob Connector\u003cbr/\u003e- Data retrieval\u003cbr/\u003e- Error handling\u003cbr/\u003e- Caching\"]\n        Engineer[\"Feature Engineer\u003cbr/\u003e- 6 feature tables\u003cbr/\u003e- Dropout risk\u003cbr/\u003e- Sector fit\"]\n        Dashboard[\"Decision Dashboard\u003cbr/\u003e- KPI generation\u003cbr/\u003e- Heatmap building\u003cbr/\u003e- Insights\"]\n    end\n    \n    subgraph \"Streamlit Frontend\"\n        Auth[\"Login \u0026 Register\u003cbr/\u003ePages\"]\n        Youth[\"Youth Dashboard\u003cbr/\u003e- Profile\u003cbr/\u003e- Progress\u003cbr/\u003e- Feedback\"]\n        Admin[\"Admin Portal\u003cbr/\u003e- Module Mgmt\u003cbr/\u003e- Surveys\u003cbr/\u003e- Reports\"]\n        DI[\"Decision Intelligence\u003cbr/\u003e- 7 Tabs\u003cbr/\u003e- Interactive Charts\u003cbr/\u003e- Exports\"]\n    end\n    \n    SQLite --\u003e|Load| Connector\n    Azure --\u003e|Load| Connector\n    Connector --\u003e|Features| Engineer\n    Engineer --\u003e|KPIs \u0026 Data| Dashboard\n    Dashboard --\u003e|Insights| DI\n    Auth --\u003e|Auth| Youth\n    Auth --\u003e|Auth| Admin\n    Youth --\u003e|Engagement| SQLite\n    Admin --\u003e|Config| SQLite\n    DI --\u003e|Display| Dashboard\n```\n\n### Component Architecture\n\n```mermaid\ngraph LR\n    subgraph \"Presentation Layer\"\n        UI[\"Streamlit UI\u003cbr/\u003e6 Pages\u003cbr/\u003eMulti-role\"]\n    end\n    \n    subgraph \"Application Layer\"\n        AppSvcs[\"Application Services\u003cbr/\u003e- Auth Service\u003cbr/\u003e- Module Service\u003cbr/\u003e- Feedback Service\"]\n    end\n    \n    subgraph \"Data Service Layer\"\n        Connectors[\"Data Connectors\u003cbr/\u003e- SQLite Driver\u003cbr/\u003e- Azure Connector\u003cbr/\u003e- Cache Layer\"]\n    end\n    \n    subgraph \"Data Layer\"\n        DB[\"SQLite\u003cbr/\u003emb_compass.db\u003cbr/\u003e9 Tables\"]\n        Blob[\"Azure Blob\u003cbr/\u003eAPAC Datasets\u003cbr/\u003e25+ CSVs\"]\n    end\n    \n    UI --\u003e|API Calls| AppSvcs\n    AppSvcs --\u003e|Queries| Connectors\n    Connectors --\u003e|Read/Write| DB\n    Connectors --\u003e|Read| Blob\n```\n\n### Data Flow Architecture\n\n```mermaid\ngraph TD\n    A[\"Youth Registration\"] --\u003e|Store| B[\"mb_users Table\u003cbr/\u003e50 students\"]\n    C[\"Learning Modules\"] --\u003e|Assign| D[\"learning_modules Table\u003cbr/\u003eModule Assignments\"]\n    E[\"Youth Progress\"] --\u003e|Track| F[\"Feature Engineer\"]\n    D --\u003e|Input| F\n    B --\u003e|Input| F\n    F --\u003e|Compute| G[\"student_daily_features\u003cbr/\u003e50 rows\"]\n    F --\u003e|Compute| H[\"dropout_risk\u003cbr/\u003e50 rows\"]\n    F --\u003e|Compute| I[\"sector_fit\u003cbr/\u003e50 rows\"]\n    F --\u003e|Compute| J[\"module_effectiveness\u003cbr/\u003e16 rows\"]\n    G --\u003e|Display| K[\"Decision Dashboard\"]\n    H --\u003e|Display| K\n    I --\u003e|Display| K\n    J --\u003e|Display| K\n    K --\u003e|Visualize| L[\"7-Tab Dashboard\"]\n    L --\u003e|KPIs| M[\"Executive Overview\u003cbr/\u003e50 enrolled, 70.9% completion\"]\n```\n\n---\n\n## 🔄 System Flows\n\n### 1. Youth Registration Flow\n\n```mermaid\nsequenceDiagram\n    participant Youth as Youth User\n    participant App as Streamlit App\n    participant Auth as Auth Service\n    participant DB as SQLite DB\n    \n    Youth-\u003e\u003eApp: Visit Platform\n    App-\u003e\u003eYouth: Show Login/Register\n    Youth-\u003e\u003eApp: Fill Registration Form\n    Note over App: Validate Email \u0026 Password\n    App-\u003e\u003eAuth: Authenticate\n    Auth-\u003e\u003eDB: Check User Exists\n    DB--\u003e\u003eAuth: Not Found\n    Auth-\u003e\u003eDB: Create New User\n    DB--\u003e\u003eAuth: User Created\n    Auth--\u003e\u003eApp: Success\n    App-\u003e\u003eDB: Store Profile Data\n    DB--\u003e\u003eApp: Stored\n    App-\u003e\u003eYouth: Redirect to Dashboard\n```\n\n### 2. Youth Dashboard Flow\n\n```mermaid\nsequenceDiagram\n    participant Youth as Youth\n    participant App as Youth Dashboard\n    participant Service as Data Service\n    participant DB as Database\n    \n    Youth-\u003e\u003eApp: Login\n    App-\u003e\u003eService: Get User Profile\n    Service-\u003e\u003eDB: Query mb_users\n    DB--\u003e\u003eService: User Data\n    Service-\u003e\u003eDB: Query learning_modules\n    DB--\u003e\u003eService: Module List\n    Service-\u003e\u003eApp: Profile \u0026 Modules\n    App-\u003e\u003eApp: Render Dashboard\n    App-\u003e\u003eYouth: Display Profile, Progress, Feedback Form\n    Youth-\u003e\u003eApp: Submit Feedback\n    App-\u003e\u003eService: Save Feedback\n    Service-\u003e\u003eDB: Insert youth_feedback_surveys\n    DB--\u003e\u003eService: Saved\n    Service--\u003e\u003eApp: Confirmation\n    App-\u003e\u003eYouth: Success Message\n```\n\n### 3. Admin Control Flow\n\n```mermaid\nsequenceDiagram\n    participant Admin as Admin User\n    participant App as Admin Portal\n    participant Service as Admin Service\n    participant DB as Database\n    \n    Admin-\u003e\u003eApp: Login as Admin\n    App-\u003e\u003eService: Load Admin Dashboard\n    Service-\u003e\u003eDB: Query All Users\n    DB--\u003e\u003eService: 50 Users\n    Service-\u003e\u003eDB: Query learning_modules\n    DB--\u003e\u003eService: 16 Modules\n    Service-\u003e\u003eApp: Dashboard Data\n    App-\u003e\u003eAdmin: Display Overview\n    Admin-\u003e\u003eApp: Create New Module\n    App-\u003e\u003eService: Add Module\n    Service-\u003e\u003eDB: Insert learning_modules\n    DB--\u003e\u003eService: Inserted\n    Service-\u003e\u003eApp: Success\n    App-\u003e\u003eAdmin: Module Added\n    Admin-\u003e\u003eApp: Distribute Survey\n    App-\u003e\u003eService: Send Survey Emails\n    Service-\u003e\u003eDB: Create survey_distribution_logs\n    DB--\u003e\u003eService: Sent\n    Service--\u003e\u003eApp: Delivery Report\n```\n\n### 4. Decision Intelligence Flow\n\n```mermaid\nsequenceDiagram\n    participant User as Stakeholder\n    participant UI as DI Dashboard\n    participant Engineer as Feature Engineer\n    participant Connector as Data Connector\n    participant Data as Database/Blob\n    \n    User-\u003e\u003eUI: Navigate to DI Dashboard\n    UI-\u003e\u003eEngineer: Request Features\n    Engineer-\u003e\u003eConnector: Load Data\n    Connector-\u003e\u003eData: Query SQLite\n    Data--\u003e\u003eConnector: 50 Records\n    Connector-\u003e\u003eConnector: Check Azure\n    Connector--\u003e\u003eEngineer: Data Ready\n    Engineer-\u003e\u003eEngineer: Compute 6 Features\n    Engineer-\u003e\u003eEngineer: Aggregate Metrics\n    Engineer--\u003e\u003eUI: Features \u0026 Insights\n    UI-\u003e\u003eUI: Build Charts\n    UI-\u003e\u003eUI: Format KPIs\n    UI-\u003e\u003eUser: Display 7 Tabs\n    User-\u003e\u003eUI: View Sector Heatmap\n    UI-\u003e\u003eUser: Interactive Visualization\n    User-\u003e\u003eUI: Download Proposal\n    UI-\u003e\u003eUser: PDF Export\n```\n\n---\n\n## 📊 Data Model\n\n### Entity-Relationship Overview\n\n```mermaid\nerDiagram\n    MB_USERS ||--o{ LEARNING_MODULES : \"assigns\"\n    MB_USERS ||--o{ CAREER_SURVEYS : \"completes\"\n    MB_USERS ||--o{ YOUTH_FEEDBACK_SURVEYS : \"submits\"\n    LEARNING_MODULES ||--o{ CAREER_SURVEYS : \"covers\"\n    SURVEY_TEMPLATES ||--o{ SURVEY_DISTRIBUTION_LOGS : \"used-in\"\n    \n    MB_USERS {\n        int user_id\n        string student_id\n        string email\n        string full_name\n        string education_level\n        timestamp created_at\n    }\n    \n    LEARNING_MODULES {\n        int module_assignment_id\n        int user_id\n        string title\n        string status\n        int progress\n        timestamp completed_date\n    }\n    \n    CAREER_SURVEYS {\n        int survey_id\n        int user_id\n        string survey_data\n        timestamp completed_at\n    }\n    \n    YOUTH_FEEDBACK_SURVEYS {\n        int survey_id\n        int user_id\n        string job_title\n        int overall_satisfaction\n        timestamp completed_at\n    }\n    \n    SURVEY_TEMPLATES {\n        int template_id\n        string template_type\n        string template_name\n        json questions_json\n        boolean is_active\n    }\n    \n    SURVEY_DISTRIBUTION_LOGS {\n        int log_id\n        string survey_type\n        string recipient_email\n        timestamp sent_date\n        boolean completed\n    }\n```\n\n---\n\n## 🚀 Installation\n\n### Prerequisites\n- Python 3.11+\n- pip/conda\n- SQLite3\n- Git\n\n### Setup Steps\n\n1. **Clone Repository**\n```bash\ngit clone https://github.com/Huzefaaa2/mb.git\ncd mb\n```\n\n2. **Create Virtual Environment**\n```bash\npython -m venv .venv\n.venv\\Scripts\\activate  # Windows\nsource .venv/bin/activate  # macOS/Linux\n```\n\n3. **Install Dependencies**\n```bash\npip install -r requirements.txt\n```\n\n4. **Configure Environment**\n```bash\ncp .env.example .env\n# Edit .env with your settings\n```\n\n5. **Initialize Database**\n```bash\npython scripts/init_db.py\n```\n\n6. **Run Platform**\n```bash\nstreamlit run mb/app.py\n```\n\nVisit: `http://localhost:8501`\n\n---\n\n## ⚡ Quick Start\n\n### Access the Platform\n\n1. **Login Page** (`http://localhost:8501`)\n   - Register new account or login\n   - Email-based authentication\n\n2. **Youth Dashboard** \n   - View profile and learning progress\n   - Submit feedback surveys\n   - Track module completion\n\n3. **Decision Intelligence** (Admin)\n   - Navigate to: Admin \u0026 Intelligence → Decision Intelligence Dashboard\n   - View 7-tab analytics dashboard\n   - Download proposals\n\n### Demo Data\n- **50 Youth Profiles** pre-loaded\n- **16 Learning Modules** configured\n- **70.9% Completion Rate** current baseline\n- **40% Dropout Risk** identification active\n\n---\n\n## 📚 Documentation\n\n### Wiki Pages\nComprehensive documentation available in the [Wiki](https://github.com/Huzefaaa2/mb/wiki):\n\n- **[Architecture](docs/wiki/01-Architecture.md)** - System design and C4 diagrams\n- **[Data Model](docs/wiki/02-Data-Model.md)** - Database schema and relationships\n- **[API Reference](docs/wiki/03-API-Reference.md)** - Backend services\n- **[Feature Engineering](docs/wiki/04-Feature-Engineering.md)** - Analytics pipeline\n- **[Deployment](docs/wiki/05-Deployment.md)** - Production setup\n- **[Troubleshooting](docs/wiki/06-Troubleshooting.md)** - Common issues\n\n### Key Documentation Files\n- [Azure Integration Guide](docs/AZURE_INTEGRATION_GUIDE.md)\n- [Feature Engineering Reference](docs/FEATURES_DOCUMENTATION.md)\n- [API Specifications](docs/API_SPECIFICATION.md)\n\n---\n\n## 🏛️ Tech Stack\n\n| Component | Technology | Version |\n|-----------|-----------|---------|\n| **Frontend** | Streamlit | 1.28.1 |\n| **Backend** | Python | 3.11 |\n| **Database** | SQLite3 | Latest |\n| **Cloud Storage** | Azure Blob Storage | Latest |\n| **Analytics** | Pandas, NumPy | Latest |\n| **Visualization** | Plotly | 5.18 |\n| **Testing** | Pytest | Latest |\n\n---\n\n## 📁 Project Structure\n\n```\nmb/\n├── README.md                          # This file\n├── requirements.txt                   # Python dependencies\n├── QUICK_START.py                     # Demo script\n│\n├── mb/                                # Main application\n│   ├── app.py                         # Streamlit entry point\n│   ├── pages/                         # Page modules\n│   │   ├── 0_login.py                 # Authentication\n│   │   ├── 1_register.py              # Registration\n│   │   ├── 2_youth_dashboard.py       # Youth profile\n│   │   ├── 2_confirmation.py          # Confirmation page\n│   │   ├── 3_magicbus_admin.py        # Admin portal\n│   │   ├── 4_decision_intelligence_azure.py  # DI Dashboard\n│   │   └── 5_feedback_survey.py       # Feedback collection\n│   │\n│   ├── data_sources/                  # Data integration\n│   │   ├── azure_blob_connector.py    # Azure connectivity\n│   │   ├── azure_feature_engineer.py  # Feature computation\n│   │   └── azure_decision_dashboard.py # Analytics engine\n│   │\n│   ├── components/                    # UI components\n│   └── services/                      # Business logic\n│\n├── config/                            # Configuration\n│   ├── settings.py                    # Environment settings\n│   └── secrets.py                     # Secrets management\n│\n├── data/                              # Data directory\n│   ├── mb_compass.db                  # SQLite database\n│   └── synthetic/                     # Generated datasets\n│\n├── scripts/                           # Utilities\n│   ├── init_db.py                     # Database initialization\n│   ├── generate_synthetic_data.py     # Data generation\n│   └── verify_setup.py                # Setup verification\n│\n├── docs/                              # Documentation\n│   ├── wiki/                          # Wiki pages (C4 diagrams)\n│   ├── AZURE_INTEGRATION_GUIDE.md     # Azure setup\n│   └── FEATURES_DOCUMENTATION.md      # Features guide\n│\n└── tests/                             # Unit tests\n    └── test_integrations.py           # Integration tests\n```\n\n---\n\n## 🔐 Security \u0026 Privacy\n\n- ✅ Role-based access control (Youth, Admin, Instructor)\n- ✅ Email-based authentication\n- ✅ Data encryption at rest (SQLite)\n- ✅ Secure connection strings (environment variables)\n- ✅ PII protection (no plaintext passwords)\n- ✅ Survey data anonymization\n\n---\n\n## 📊 Key Metrics\n\n| Metric | Value | Status |\n|--------|-------|--------|\n| Youth Enrolled | 50 | ✅ Active |\n| Learning Modules | 16 | ✅ Configured |\n| Completion Rate | 70.9% | ✅ Above Target |\n| Dropout Risk (High) | 40% | ⚠️ Monitor |\n| Engagement Score | 57% | ✅ Healthy |\n| Retention Goal | 85% | ✅ Targeting |\n| Dashboard Tabs | 11 | ✅ Live |\n| AI Features | 5 | ✅ Deployed |\n| Dashboard Response Time | \u003c1s | ✅ Optimal |\n| Feature Computation | 15-30s | ✅ Acceptable |\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'Add amazing feature'`)\n4. Push to branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Development Guidelines\n- Follow PEP 8 style guide\n- Write tests for new features\n- Document API changes\n- Update relevant Wiki pages\n\n---\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 📞 Support \u0026 Contact\n\n- **Issues**: [GitHub Issues](https://github.com/Huzefaaa2/mb/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/Huzefaaa2/mb/discussions)\n- **Email**: support@magicbus.local\n- **Documentation**: [Wiki](https://github.com/Huzefaaa2/mb/wiki)\n\n---\n\n## 🙏 Acknowledgments\n\n- Magic Bus Foundation for youth development mission\n- APAC region partners for data collaboration\n- Azure for cloud infrastructure\n- Streamlit team for amazing dashboard framework\n\n---\n\n**Last Updated**: January 29, 2026 | **Version**: 1.0.0 (Phase 3B Complete)\n\n---\n\n## 🚀 Recent Updates - Phase 3B (Jan 29, 2026)\n\n### New Dashboard Tabs (Decision Intelligence)\n- **Tab 7: ⭐ Youth Potential Score™** - KPI metrics, tier distribution, top 20 leaderboard\n- **Tab 8: 📉 Retention Analytics** - Retention gauge (65%→85%), intervention effectiveness\n- **Tab 9: 🎓 Skill Development** - Role analyzer, learning paths, skill requirements\n\n### Youth Dashboard Enhancements\n- **⭐ Your Youth Potential Score** - Composite scoring with tier assignment\n- **🎯 Your Learning Pathway** - 5-stage milestone tracker with progress visualization\n\n### Admin Dashboard Improvements\n- **🚨 Churn Prevention Tab** - At-risk students, intervention controls, effectiveness log\n\n### Configuration Exposed\n- All Phase 3 features toggleable via `config/settings.py`\n- 50+ configuration options for feature tuning\n- Complete settings for all 5 AI features\n\n### Documentation\n- `PHASE_3B_COMPLETION.md` - Complete feature guide (451 lines)\n- `PROJECT_STATUS.md` - Overall project overview (437 lines)\n- Git history with 5 well-documented commits\n\n### Status\n✅ **Phase 3B Complete** - Dashboard integration finished  \n🚀 **Ready for UAT** - All features tested and deployed  \n📊 **Project 80% Complete** - 4 phases delivered, Phase 4 (Testing) recommended next\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuzefaaa2%2Fmb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuzefaaa2%2Fmb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuzefaaa2%2Fmb/lists"}