AmanyaPeter/skills-hub-uganda

# Vocational Institute Student Management System A comprehensive student management system for vocational institutes in Uganda. ## Features - **Dashboard**: Overview of enrollment, active students, and financial stats. - **Students**: Manage student records, profiles, and biodata. - **Enrollment**: Register new students with auto-generated IDs. - **Finance**: Track payments, generate receipts, and manage course fees. - **Courses**: Manage vocational courses and intakes. - **Reports**: Export data and view system reports. ## Documentation For a deep dive into the system architecture, data models, and business logic, see SYSTEM_DOCUMENTATION.md. ## Tech Stack - **Frontend**: React, TypeScript, Vite, Tailwind CSS, shadcn/ui. - **Backend**: Native PHP 8+, SQLite (Embedded Database). ## Setup 1. **Clone the repository**. 2. **Install Frontend Dependencies**: ```sh npm install ``` 3. **Setup Backend (Initial)**: - The system uses SQLite. No external database server required. - Initialize the database file from the schema: ```sh php backend/scripts/init_db.php ``` - Key backend files: `backend/database/skills_hub.sqlite`. 4. **Run Development Servers**: - Frontend: `npm run dev` - Backend: `php -S localhost:8000 -t backend/public` ## Default Login - **Email**: admin@skillshub.ug - **Password**: password123