A comprehensive, modern web application that serves as an AI-powered campus management system for Khalifa University. CLNKR (Campus Life Next-gen Knowledge & Resources) provides a complete solution for room booking, course registration, event scheduling, maintenance requests, and administrative oversight.
- AI Chatbot: Interactive assistant that helps with all campus needs through natural language processing
- Room Booking System: Browse and book library study rooms with real-time availability, conflict detection, and administrative approval workflow
- Professor Directory: Comprehensive directory with search functionality, contact information, office locations, and office hours
- Course Registration: Browse available courses, view enrollment status, and register with one-click functionality
- Event Scheduling: Create and manage campus events with calendar views (requires admin approval for all users)
- Maintenance Requests: Submit and track facility maintenance requests with status tracking (pending, in_progress, completed)
- Personal Dashboard: Track bookings, registrations, study hours, and recent activity
- Schedule View: Calendar interface showing course schedules and bookings in list, week, and month views
- User Profile Management: Update personal information, change password, and manage account settings
- Admin Panel: Comprehensive administrative interface for user management
- User Management: View all users, edit user information (first name, last name, birthday, gender, role), manage passwords, and delete accounts
- Approval System: Approve or reject pending bookings, events, and maintenance requests
- Faculty Approval: Review and approve faculty account registrations
- Analytics Dashboard: View booking trends
- Students: Can book rooms, register for courses, create events (pending approval), submit maintenance requests
- Faculty: Same as students, with additional title field and email auto-generation (firstname.lastname@ku.ac.ae). Requires admin approval before login
- Administrators: Full access including user management, approval workflows, and analytics
- Facility Staff: Can handle maintenance requests and view analytics
- Modern glass morphism effects
- Animated gradient backgrounds
- Smooth transitions and hover effects
- Responsive design for all devices
- Dark theme with vibrant accents
- Interactive chat interface
- Golden aura effect for special instructors (Dina Atia and Sani Umar)
- Python 3.8 or higher
- pip (Python package manager)
-
Clone or download this project to your local machine
-
Install Python dependencies:
pip install -r requirements.txt- Run the application:
python app.py- Open your browser and navigate to:
http://localhost:5000
- For admin access, navigate to:
http://localhost:5000/admin
- Username:
Blitz - Password:
COSC336
- LLM-Powered: Uses OpenAI GPT models for natural language understanding (API key is hardcoded)
- Rule-Based Fallback: Falls back to pattern matching if LLM initialization fails
- Natural language processing for understanding student queries
- Quick action buttons for common tasks
- Context-aware responses with access to rooms, courses, bookings, and registrations
- Typing indicators and smooth animations
- Supports room booking, course registration, and profile updates via chat
- Intelligent intent recognition and action execution
- Real-time availability status
- Filter by availability, capacity, or type
- One-click booking with modal form
- Edit and delete bookings through dropdown menu
- Feature tags (Whiteboard, Projector, etc.)
- Automatic room release when booking period ends
- Conflict detection and approval workflow
- Search by name, department, or email
- Contact information display
- Office hours and locations
- Beautiful card-based layout
- Special golden aura styling for distinguished professors
- Browse all available courses
- View professor, credits, and schedule
- See enrollment counts and available spots
- One-click registration
- Success notifications
- Create events with title, description, date/time, and location
- Calendar views (list, week, month)
- All events require admin approval
- Edit and manage created events
- Submit maintenance requests with priority levels
- Track request status (pending, in_progress, completed)
- View request history
- Admin approval workflow
- Live statistics tracking
- Recent bookings display with edit/delete options
- Course registration history
- Study hours calculation
- Quick access to all features
- User management with search functionality
- Edit user information (first name, last name, birthday, gender, role, title)
- Approve/reject faculty accounts
- Manage user passwords
- Delete user accounts
- Approve/reject bookings, events, and maintenance requests
- View all user bookings and course registrations
Backend:
- Python Flask - Web framework
- Flask-CORS - Cross-origin resource sharing
- RESTful API design
- JSON file-based data persistence
- Session-based authentication
Frontend:
- Pure JavaScript (ES6+) with object-oriented design
- CSS3 with animations and glass morphism effects
- HTML5
- Font Awesome icons
- Google Fonts (Inter)
CLNKR/
│
├── app.py # Flask backend server
├── requirements.txt # Python dependencies
├── README.md # This file
├── PROJECT_DOCUMENTATION.txt # Detailed documentation
│
├── backend/ # Backend modules
│ ├── __init__.py
│ ├── data_manager.py # Data persistence
│ ├── validators.py # Input validation
│ ├── user_manager.py # User operations
│ ├── booking_manager.py # Booking operations
│ ├── chat_processor.py # Chat processing
│ ├── event_manager.py # Event management
│ ├── maintenance_manager.py # Maintenance requests
│ └── analytics_manager.py # Analytics and reporting
│
├── data/ # Data files (JSON)
│ ├── users.json # User accounts
│ ├── bookings.json # Room bookings
│ ├── rooms.json # Room definitions
│ ├── professors.json # Professor data
│ ├── courses.json # Course catalog
│ ├── events.json # Campus events
│ └── maintenance.json # Maintenance requests
│
├── templates/ # HTML templates
│ ├── index.html # Main application page
│ ├── login.html # Login page
│ ├── signup.html # Signup page
│ ├── admin_login.html # Admin login page
│ └── admin_panel.html # Admin panel
│
└── static/ # Static assets
├── css/
│ ├── styles.css # Main stylesheet
│ ├── auth.css # Authentication styles
│ └── admin.css # Admin panel styles
└── js/
├── core/ # Core JavaScript modules
│ ├── App.js # Main application class
│ ├── UIManager.js # UI management
│ ├── ChatManager.js # Chat functionality
│ ├── BookingManager.js # Booking operations
│ ├── DashboardManager.js # Dashboard
│ ├── ScheduleManager.js # Schedule/calendar
│ ├── SearchManager.js # Global search
│ ├── ProfileManager.js # Profile management
│ ├── ProfessorManager.js # Professor directory
│ ├── CourseManager.js # Course registration
│ ├── EventManager.js # Event scheduling
│ ├── MaintenanceManager.js # Maintenance
│ ├── AnalyticsManager.js # Analytics
│ └── BookingApprovalManager.js # Approvals
├── auth.js # Authentication logic
├── admin_auth.js # Admin authentication
└── admin_panel.js # Admin panel logic
The application runs with default settings, but you can modify:
- Port: Change port in
app.py(default: 5000) - Debug Mode: Set to False in production
- Data: Modify JSON files in
data/directory for rooms, professors, courses - Admin Credentials: Change in
app.py(ADMIN_USERNAME and ADMIN_PASSWORD) - OpenAI API Key: Hardcoded in
backend/chat_processor.py(line 53) - OpenAI Project ID: Hardcoded in
backend/chat_processor.py(line 65 and 88)
POST /api/auth/signup- Create new user account (supports student and faculty)POST /api/auth/login- User loginPOST /api/auth/logout- User logoutGET /api/auth/check- Check authentication statusGET /api/auth/profile- Get user profilePUT /api/auth/profile- Update user profilePOST /api/auth/change-password- Change password
GET /api/rooms- Get all roomsPOST /api/rooms/book- Book a roomGET /api/bookings- Get user bookingsPUT /api/bookings/<id>- Update bookingDELETE /api/bookings/<id>- Cancel bookingGET /api/bookings/pending- Get pending bookings (admin)POST /api/bookings/<id>/approve- Approve booking (admin)POST /api/bookings/<id>/reject- Reject booking (admin)
GET /api/professors- Get all professorsPOST /api/professors/search- Search professors
GET /api/courses- Get all coursesPOST /api/courses/register- Register for courseGET /api/registrations- Get user registrations
GET /api/events- Get all eventsPOST /api/events- Create event (requires approval)PUT /api/events/<id>- Update eventDELETE /api/events/<id>- Delete eventGET /api/events/pending- Get pending events (admin)POST /api/events/<id>/approve- Approve event (admin)POST /api/events/<id>/reject- Reject event (admin)
GET /api/maintenance- Get maintenance requestsPOST /api/maintenance- Create maintenance requestPUT /api/maintenance/<id>/status- Update request statusGET /api/maintenance/pending- Get pending requests (admin)POST /api/maintenance/<id>/approve- Approve request (admin)POST /api/maintenance/<id>/reject- Reject request (admin)
GET /api/analytics- Get analytics data (admin/facility staff)
POST /api/admin/login- Admin loginPOST /api/admin/logout- Admin logoutGET /api/admin/check- Check admin authenticationGET /api/admin/users- Get all usersGET /api/admin/users/<email>- Get user detailsPUT /api/admin/users/<email>- Update userPUT /api/admin/users/<email>/password- Update user passwordPUT /api/admin/users/<email>/approve- Approve faculty accountDELETE /api/admin/users/<email>- Delete userDELETE /api/admin/bookings/<id>- Delete booking (admin)
POST /api/chat- Process chat messages
- Chat First: Start with the chat interface for guided assistance
- Quick Actions: Use the quick action buttons for common tasks
- Search: Use the global search bar for quick lookups across rooms, courses, and professors
- Filters: Use room filters to find the perfect study space
- Dashboard: Check your dashboard regularly to track your activities
- Schedule: Use the schedule view to see all your bookings and courses in calendar format
- Admin Panel: Administrators can manage all users and approve pending requests from the admin panel
- Chrome (recommended)
- Firefox
- Safari
- Edge
- Opera
- Database integration (SQLite/PostgreSQL)
- Real-time notifications
- Email confirmations
- Advanced scheduling features
- Mobile app version
- Enhanced analytics and reporting
- Integration with university systems
If the application doesn't start:
- Ensure Python 3.8+ is installed:
python --version- Ensure all dependencies are installed:
pip install -r requirements.txt- Check if port 5000 is available:
lsof -i :5000 # On Mac/Linux
netstat -ano | findstr :5000 # On Windows- Try a different port by modifying the last line in
app.py:
app.run(debug=True, port=5001) # Change to different port- Ensure the
data/directory exists and contains the required JSON files
This project is open source and available for educational purposes.
Feel free to fork this project and submit pull requests with improvements!
Built by Blitzict and co