A comprehensive multi-tenant platform connecting TVET institutions, graduates, and employers
The Graduate Tracking System is a sophisticated multi-tenant web application designed to bridge the gap between Technical and Vocational Education and Training (TVET) institutions, their graduates, and potential employers. The platform facilitates graduate career tracking, job placement, institutional analytics, and comprehensive reporting while maintaining complete data isolation between institutions.
To create a seamless ecosystem where TVET institutions can effectively track their graduates' career progress, employers can find qualified talent, and graduates can access meaningful employment opportunities.
- Complete Data Isolation: Each institution operates in its own secure environment
- Domain-Based Tenant Resolution: Automatic tenant identification via domains
- Scalable Infrastructure: Support for unlimited institutions
- Centralized Super Admin Management: System-wide oversight and control
- Super Admin: System-wide management and analytics
- Institution Admin: Graduate and course management within their institution
- Employer: Job posting, candidate search, and application management
- Graduate: Profile management, job applications, and career tracking
- Comprehensive Profiles: Academic records, skills, certifications, employment status
- Bulk Import/Export: Excel-based data management with validation
- Employment Tracking: Real-time career progress monitoring
- Privacy Controls: Granular profile visibility settings
- Profile Completion Tracking: Guided profile enhancement
- Smart Job Matching: AI-powered candidate-job matching algorithms
- Application Tracking: Complete hiring workflow management
- Employer Verification: Comprehensive company validation process
- Job Analytics: Performance metrics and placement insights
- Automated Notifications: Real-time updates for all stakeholders
- Employment Analytics: Graduation-to-employment tracking
- Course Performance: Program effectiveness analysis
- Predictive Analytics: Job placement probability modeling
- Custom Reports: Flexible report builder with export capabilities
- KPI Dashboards: Real-time performance indicators
- Trend Analysis: Historical data insights and forecasting
- Advanced Graduate Search: Multi-criteria candidate filtering
- Job Recommendation Engine: Personalized job suggestions
- Skill-Based Matching: Competency-driven connections
- Saved Searches: Persistent search preferences
- Smart Notifications: Relevant opportunity alerts
- Messaging System: Direct communication between stakeholders
- Discussion Forums: Graduate networking and peer support
- Announcement System: Institution-wide communications
- Help Desk: Integrated support ticket system
- Feedback Collection: Continuous improvement mechanisms
- Framework: Laravel 11 with PHP 8.3+
- Multi-Tenancy: Stancl Tenancy package for complete isolation
- Database: PostgreSQL with tenant-specific schemas
- Authentication: Laravel Breeze with Spatie Permissions
- API: RESTful APIs with comprehensive validation
- Queue System: Redis-backed job processing
- Caching: Multi-layer caching strategy
- Framework: Vue.js 3 with Composition API
- Type Safety: Full TypeScript implementation
- UI Framework: Tailwind CSS with Shadcn/Vue components
- State Management: Pinia for complex state handling
- Build Tool: Vite for optimized development and production builds
- Testing: Vitest for unit and integration testing
- Containerization: Docker support for consistent environments
- CI/CD: Automated testing and deployment pipelines
- Monitoring: Application performance and error tracking
- Security: Multi-layer security with audit logging
- Backup: Automated database and file backups
- PHP 8.3+
- Node.js 18+
- Composer 2.x
- PostgreSQL 13+
- Redis (optional, for caching and queues)
-
Clone and Setup
git clone <repository-url> cd graduate-tracking-system composer install npm install
-
Environment Configuration
cp .env.example .env php artisan key:generate
-
Database Setup
# Configure your .env file with database credentials php artisan migrate php artisan tenants:migrate php artisan db:seed -
Create Sample Data
php scripts/data/create_sample_data.php php scripts/data/create_tenant_sample_data.php
-
Start Development Servers
# Windows Batch script (simple) .\start-dev.bat # PowerShell script (enhanced) .\start-dev-final.ps1 # Interactive helper scripts/development/dev-helper.bat # Or start manually php artisan serve --port=8080 npm run dev
-
Access the Application
- Main Application: http://127.0.0.1:8080
- Login Page: http://127.0.0.1:8080/login
| Role | Password | Dashboard URL | |
|---|---|---|---|
| Super Admin | admin@system.com | password | http://127.0.0.1:8080/super-admin/dashboard |
| Institution Admin | admin@tech-institute.edu | password | http://127.0.0.1:8080/institution-admin/dashboard |
| Graduate | john.smith@student.edu | password | http://127.0.0.1:8080/graduate/dashboard |
| Employer | techcorp@company.com | password | http://127.0.0.1:8080/employer/dashboard |
✅ All accounts now have proper roles and permissions - 403 errors fixed!
- Main Application: http://127.0.0.1:8080
- Login: http://127.0.0.1:8080/login
- Register: http://127.0.0.1:8080/register
- Testing Suite: http://127.0.0.1:8080/testing
- System-wide institution management
- User management across all tenants
- Employer verification and approval
- System analytics and reporting
- Security monitoring and audit logs
- System health monitoring
- Graduate profile management
- Course and program administration
- Bulk data import/export
- Institution-specific analytics
- Staff and tutor management
- Graduate outcome tracking
- Company profile management
- Job posting and management
- Graduate search and filtering
- Application review and tracking
- Hiring analytics and metrics
- Communication with candidates
- Profile completion and maintenance
- Job browsing and applications
- Career progress tracking
- Classmate networking
- Assistance request system
- Employment status updates
- Graduate employment rates by course and year
- Salary progression tracking
- Industry placement analysis
- Geographic employment distribution
- Time-to-employment metrics
- Course effectiveness measurements
- Graduate satisfaction scores
- Employer feedback analysis
- Placement success rates
- Alumni engagement metrics
- Job placement probability modeling
- Career path recommendations
- Market demand forecasting
- Skills gap analysis
- Employment trend predictions
# Interactive development helper
scripts/development/dev-helper.bat
# Data management
php scripts/data/check_users.php
php scripts/data/create_sample_data.php
# Testing utilities
php scripts/testing/test_analytics.php
scripts/testing/run-tests.bat
# Debugging tools
scripts/debugging/fix_blank_screen.bat
php scripts/debugging/diagnose_blank_screen.php# Run comprehensive test suite
scripts/testing/run-tests.bat
# Quick system test
php scripts/testing/quick_test.php
# User acceptance testing
http://127.0.0.1:8080/testing- ESLint: JavaScript/TypeScript linting
- PHP CS Fixer: PHP code style enforcement
- PHPStan: Static analysis for PHP
- Automated Testing: Unit, integration, and feature tests
- Code Coverage: Comprehensive test coverage reporting
- Complete data isolation between tenants
- Cross-tenant access prevention
- Tenant-specific authentication
- Audit logging for all data access
- Role-based access control (RBAC)
- Multi-factor authentication support
- Session management and security
- Password policies and complexity requirements
- Encryption of sensitive data at rest
- HTTPS enforcement for all communications
- Input sanitization and XSS protection
- SQL injection prevention
- GDPR compliance features
- Database query optimization with eager loading
- Redis caching for frequently accessed data
- CDN support for static assets
- Image optimization and compression
- Lazy loading for improved page speeds
- Horizontal scaling support
- Load balancer compatibility
- Database connection pooling
- Queue-based background processing
- Microservice-ready architecture
- Automatic tenant creation and setup
- Domain-based tenant resolution
- Tenant-specific database schemas
- Isolated file storage per tenant
- Tenant analytics and usage tracking
- Complete database separation
- Tenant-specific migrations
- Isolated user authentication
- Separate file storage spaces
- Independent caching layers
- Development Guide - Complete development setup
- Script Organization - Development script documentation
- Port Configuration - Network configuration details
- Cleanup Summary - Project organization details
- RESTful API endpoints
- Authentication mechanisms
- Request/response formats
- Error handling guidelines
- Rate limiting policies
# Use the deployment script
./deploy.sh
# Or deploy manually
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
npm run build- Production environment variables
- Database optimization settings
- Caching configuration
- Security hardening
- Performance monitoring
We welcome contributions to the Graduate Tracking System! Please follow these guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Follow coding standards (ESLint, PHP CS Fixer)
- Write comprehensive tests
- Update documentation as needed
- Submit a pull request
- Follow PSR-12 coding standards for PHP
- Use TypeScript for all frontend code
- Write unit tests for new features
- Update documentation for API changes
- Follow semantic versioning
This project is licensed under the MIT License - see the LICENSE file for details.
- Laravel Community - For the robust PHP framework
- Vue.js Team - For the progressive JavaScript framework
- Stancl Tenancy - For multi-tenant architecture support
- Spatie - For excellent Laravel packages
- Tailwind CSS - For the utility-first CSS framework
- TVET Institutions - For inspiring this solution
For support and questions:
- Documentation: Check the comprehensive guides in the
/docsdirectory - Issues: Report bugs and feature requests via GitHub Issues
- Development: Use
scripts/development/dev-helper.batfor development assistance - Testing: Access the testing suite at
/testingendpoint
Empowering TVET institutions to track graduate success and connect talent with opportunity
Built with ❤️ using Laravel, Vue.js, TypeScript, and modern web technologies