muazsaf77-netizen/xyz-polytechnic

TVET Management System for Ethiopian Polytechnic Colleges # XYZ Polytechnic College — TVET Management System **A complete, production-ready PHP 8.2 MVC application for Ethiopian TVET institutions** ## 🎓 Overview XYZ Polytechnic Portal is an integrated management system for technical and vocational education and training (TVET) colleges in Ethiopia. It bridges the gap between college operations, Moodle LMS, and student engagement across Levels I–V with full bilingual (English/Amharic) support. ### Key Features ✅ **Admin Dashboard** — Programs, courses, trainers, student records, CoC exam results ✅ **Student Portal** — Login via Moodle, view courses, competencies, industry attachments ✅ **Public Website** — News, announcements, program information, admissions application ✅ **Moodle Integration** — Web Services API for SSO, grade sync, completion tracking ✅ **CoC Management** — Certificate of Competence exam results, awarding body tracking ✅ **Industry Attachments** — Work-based learning (WBL) tracking and approval workflow ✅ **Bilingual UI** — Amharic (አማርኛ) and English with seamless language toggle ✅ **Security** — CSRF tokens, prepared statements, password hashing, session management ## 🛠 Tech Stack | Component | Version | Purpose | |-----------|---------|----------| | **PHP** | 8.2+ | Backend runtime | | **MySQL** | 8.0+ | Database | | **Moodle** | 4.1+ | LMS & Web Services | | **Bootstrap** | 5.3+ | UI framework | | **jQuery** | 3.7+ | Frontend interactions | | **Docker** | 20.10+ | Containerization | ## 📋 Prerequisites - **PHP 8.2+** with PDO, cURL, mbstring extensions - **MySQL 8.0+** or MariaDB 10.5+ - **Apache 2.4+** with mod_rewrite - **Moodle 4.1+** (for LMS integration) - **Git** (for version control) ## 🚀 Quick Start ### Option A: Manual Installation ```bash # 1. Clone repository git clone github.com cd xyz-polytechnic # 2. Copy configuration cp config/database.php.example config/database.php cp config/moodle.php.example config/moodle.php cp .env.example …