Krikorios
0c22188feb
✨ Features: • Real AI chatbot with OpenRouter API (bilingual Arabic/English) • Comprehensive UTAS Oman content with programs and admissions • Modern responsive design with Tailwind CSS • Student/Admin authentication and dashboards • Full course catalog with search and filtering • Contact forms and application processes 🤖 AI Capabilities: • Language detection (Arabic/English) • UTAS Oman knowledge base integration • Contextual responses about programs, admissions, scholarships • No mock data - all responses from real AI 🛠️ Technology Stack: • Next.js 14 + React 19 + TypeScript • OpenRouter API with Meta LLaMA 3.1 • Prisma ORM with SQLite • Tailwind CSS for styling 📋 Demo Ready: • Test users file included (TEST-USERS.md) • Navigation test checklist (NAVIGATION-TEST.md) • Clean codebase with proper gitignore • Production-ready configuration
125 lines
3.5 KiB
Markdown
125 lines
3.5 KiB
Markdown
# UTAS Oman University Portal
|
|
|
|
A modern, bilingual (Arabic/English) university portal for the University of Tasmania's campus in Muscat, Sultanate of Oman. Features an AI-powered chatbot using OpenRouter API for intelligent student assistance.
|
|
|
|
## 🌟 Features
|
|
|
|
### 🤖 AI-Powered Chatbot
|
|
- **Real AI**: Uses OpenRouter API with Meta LLaMA model
|
|
- **Bilingual Support**: Automatically detects and responds in Arabic or English
|
|
- **UTAS Oman Context**: Specialized knowledge about campus, programs, and admissions
|
|
- **No Mock Data**: All responses generated by real AI
|
|
|
|
### 🎓 Academic Programs
|
|
- Comprehensive undergraduate and postgraduate program listings
|
|
- UTAS Oman-specific courses aligned with Oman Vision 2040
|
|
- Detailed program information, requirements, and career outcomes
|
|
- Search and filtering capabilities
|
|
|
|
### 🌐 Bilingual Interface
|
|
- Arabic and English language support
|
|
- Cultural appropriateness for Omani students
|
|
- RTL (Right-to-Left) text support for Arabic
|
|
|
|
### 📱 Modern Design
|
|
- Responsive design for all devices
|
|
- Clean, professional interface
|
|
- UTAS Oman branding and colors
|
|
- Accessibility features
|
|
|
|
## 🚀 Getting Started
|
|
|
|
### Prerequisites
|
|
- Node.js 18+
|
|
- OpenRouter API key
|
|
|
|
### Installation
|
|
|
|
1. **Clone the repository**
|
|
```bash
|
|
git clone <repository-url>
|
|
cd university-portal
|
|
```
|
|
|
|
2. **Install dependencies**
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
3. **Set up environment variables**
|
|
```bash
|
|
cp .env.example .env.local
|
|
```
|
|
|
|
Add your OpenRouter API key to `.env.local`:
|
|
```
|
|
OPENROUTER_API_KEY=your_openrouter_api_key_here
|
|
```
|
|
|
|
4. **Run the development server**
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
5. **Open your browser**
|
|
Navigate to [http://localhost:3000](http://localhost:3000)
|
|
|
|
## 🛠️ Technology Stack
|
|
|
|
- **Framework**: Next.js 14+ with React 19
|
|
- **Styling**: Tailwind CSS
|
|
- **TypeScript**: Full type safety
|
|
- **AI Integration**: OpenRouter API
|
|
- **Database**: Prisma (for future enhancements)
|
|
|
|
## 🎯 AI Chatbot Features
|
|
|
|
The AI chatbot is the centerpiece of this portal:
|
|
|
|
- **Language Detection**: Automatically detects Arabic or English input
|
|
- **Contextual Responses**: Uses UTAS Oman knowledge base for relevant information
|
|
- **OpenRouter Integration**: Powered by Meta LLaMA 3.1 8B model
|
|
- **Conversation Memory**: Maintains conversation history for context
|
|
- **Error Handling**: Graceful fallbacks when API is unavailable
|
|
|
|
### Testing the Chatbot
|
|
|
|
Try these sample queries:
|
|
|
|
**English:**
|
|
- "Tell me about MBA programs"
|
|
- "What are the admission requirements?"
|
|
- "How can I apply for scholarships?"
|
|
|
|
**Arabic:**
|
|
- "أخبرني عن برامج الماجستير"
|
|
- "ما هي متطلبات القبول؟"
|
|
- "كيف يمكنني التقدم للحصول على منح دراسية؟"
|
|
|
|
## 🏫 About UTAS Oman
|
|
|
|
This portal represents the University of Tasmania's campus in Muscat, Sultanate of Oman:
|
|
|
|
- **Location**: Knowledge Oasis Muscat
|
|
- **Programs**: Aligned with Oman Vision 2040
|
|
- **Quality**: Australian education standards
|
|
- **Local Relevance**: Designed for Omani students and industry needs
|
|
|
|
## 📞 Contact Information
|
|
|
|
- **Phone**: +968 2414 3555
|
|
- **Email**: admissions@utas.edu.om
|
|
- **Address**: Knowledge Oasis Muscat, Sultanate of Oman
|
|
|
|
## 🤝 Contributing
|
|
|
|
This is a demo project showcasing AI-enhanced university portal capabilities. For improvements or suggestions, please open an issue.
|
|
|
|
## 📄 License
|
|
|
|
This project is for demonstration purposes.
|
|
|
|
---
|
|
|
|
**Built with ❤️ for UTAS Oman students and the future of education in Oman.**
|