# 🌐 LIVE DOMAIN WORKFLOW TESTING GUIDE

## 🎯 Live Portal Information

**Domain:** https://collegeportal.aspirafile.co.in/

**Status:** ✅ **LIVE AND ACCESSIBLE**

---

## 🏠 HOMEPAGE OVERVIEW

**URL:** https://collegeportal.aspirafile.co.in/

### Features Visible:
✅ **Professional Landing Page**
- Title: "Excellence College of Engineering"
- Tagline: "Transform Your Academic Journey"
- Modern, responsive design

✅ **Three Portal Gateways:**
1. **Faculty Portal** → https://collegeportal.aspirafile.co.in/staff/login
2. **Student Hub** → https://collegeportal.aspirafile.co.in/student/login
3. **Admin Control** → https://collegeportal.aspirafile.co.in/login

✅ **Key Features Highlighted:**
- AI-Powered Scheduling
- Zero Scheduling Conflicts
- Intelligent Auto-Allocation
- Smart Time Optimization
- Unified Campus Hub
- Instant Notifications
- Secure Cloud Storage
- Analytics Dashboard
- Mobile First Design

---

## 🔐 LOGIN PORTALS

### 1️⃣ Admin Portal
**URL:** https://collegeportal.aspirafile.co.in/login

**Page Title:** "Secure Administrative Portal"

**Login Credentials:**
```
Email: admin@college.com
Password: password
```

**What to Test:**
- [ ] Login page loads correctly
- [ ] Can login with admin credentials
- [ ] Redirects to admin dashboard
- [ ] Dashboard shows statistics (students, staff, departments, subjects)
- [ ] Can navigate to all sections (Departments, Subjects, Staff, Students, Settings, Allocations)
- [ ] Subject creation form has "Category" field
- [ ] Settings page shows Dynamic System Limits
- [ ] Can view all allocations

---

### 2️⃣ Staff Portal
**URL:** https://collegeportal.aspirafile.co.in/staff/login

**Page Title:** "Faculty Management Portal"

**Login Credentials (Sample):**
```
Staff ID: FAC001
Password: 1976-02-05

Staff ID: FAC002
Password: 1983-02-05

Staff ID: FAC003
Password: 1980-02-05
```

**What to Test:**
- [ ] Login page loads correctly
- [ ] Can login with staff credentials (Staff ID + DOB)
- [ ] Redirects to staff dashboard
- [ ] Dashboard shows welcome message with staff name
- [ ] Can view "My Subjects" (2-4 assigned subjects)
- [ ] Can view "My Students" (enrolled students)
- [ ] Can access "Select Subjects" section
- [ ] All subject categories are visible (not just assigned category)
- [ ] Can select additional subjects
- [ ] Limit validation works (max 5 subjects)
- [ ] Full subjects (5/5 faculty) show as disabled
- [ ] Student count per subject displays correctly (e.g., "15/30")

---

### 3️⃣ Student Portal
**URL:** https://collegeportal.aspirafile.co.in/student/login

**Page Title:** "Student Academic Hub"

**Login Credentials (Sample):**
```
Student ID: STU001
Password: 2008-02-05

Student ID: STU002
Password: 2005-02-05

Student ID: STU003
Password: 2005-02-05
```

**What to Test:**
- [ ] Login page loads correctly
- [ ] Can login with student credentials (Student ID + DOB)
- [ ] Redirects to student dashboard
- [ ] Dashboard shows welcome message with student name
- [ ] Credit usage cards are visible:
  - Total Credits: X / 160
  - Semester Credits: Y / 25
- [ ] Progress bars show credit usage
- [ ] Can access "Subject Allocation" or "Enroll Subjects"
- [ ] Subjects are organized by 6 categories
- [ ] Can click "Select Faculty" on a subject
- [ ] Faculty list shows with student counts (e.g., "15/30")
- [ ] Can enroll in a subject with faculty
- [ ] Credits update automatically after enrollment
- [ ] Can view "My Subjects" (enrolled courses)
- [ ] Can remove/drop a subject
- [ ] Credits decrease after removing subject
- [ ] Credit limit validation works:
  - Semester limit: 25 credits
  - Total limit: 160 credits
- [ ] Error message shown when trying to exceed limits

---

## 🎬 COMPLETE WORKFLOW DEMONSTRATION

### **WORKFLOW 1: ADMIN CREATES SYSTEM DATA** (5 minutes)

**Step 1: Login**
1. Open: https://collegeportal.aspirafile.co.in/login
2. Enter Email: `admin@college.com`
3. Enter Password: `password`
4. Click "Login" or "Authenticate"
5. ✅ Verify: Redirected to admin dashboard

**Step 2: View Dashboard**
1. Observe statistics cards:
   - Total Students: 20
   - Total Staff: 10
   - Total Departments: 5
   - Total Subjects: 24+
2. ✅ Verify: All counts are correct

**Step 3: Manage Departments**
1. Navigate: Sidebar → Admin Management → Departments
2. ✅ Verify: 5 departments visible (CS, EC, ME, CE, IT)
3. Optional: Create a new demo department

**Step 4: Manage Subject Categories**
1. Navigate: Sidebar → Academic → Subject Categories
2. ✅ Verify: 6 categories visible:
   - Core Engineering
   - Programming & Software
   - Mathematics
   - Electronics & Hardware
   - Management & Humanities
   - Laboratory

**Step 5: Manage Subjects**
1. Navigate: Sidebar → Academic → Subjects
2. ✅ Verify: 24 subjects visible with categories
3. Click "Add Subject"
4. ✅ **CRITICAL:** Verify "Subject Main Category" dropdown is present
5. Optional: Create a demo subject

**Step 6: Manage Staff**
1. Navigate: Sidebar → Admin Management → Staff
2. ✅ Verify: 10 staff members visible
3. Click "View" on first staff (Dr. Rajesh Kumar - FAC001)
4. ✅ Verify: Shows personal details, assigned subjects, category

**Step 7: Manage Students**
1. Navigate: Sidebar → Admin Management → Students
2. ✅ Verify: 20 students visible
3. Click "View" on first student (Aarav Sharma - STU001)
4. ✅ Verify: Shows personal details, department, credit limits

**Step 8: Configure Settings**
1. Navigate: Sidebar → Settings
2. Scroll to "Dynamic System Limits" section
3. ✅ Verify: All limit settings visible:
   - Max Subjects per Faculty: 5
   - Max Faculty per Subject: 5
   - Default Subject Credits: 3
   - Students per Subject: 50
   - Students per Faculty-Subject: 30
   - Total Student Credit Limit: 160
   - Semester Credit Min: 20
   - Semester Credit Max: 25
4. Optional: Change a limit and save

**Step 9: View Allocations**
1. Navigate: Sidebar → Allocations
2. ✅ Verify: Allocation table shows student-faculty-subject mappings

**Step 10: Logout**
1. Click profile icon → Logout
2. ✅ Verify: Redirected to login page

---

### **WORKFLOW 2: STAFF MANAGES SUBJECTS** (3 minutes)

**Step 1: Login**
1. Open: https://collegeportal.aspirafile.co.in/staff/login
2. Enter Staff ID: `FAC001`
3. Enter Password: `1976-02-05`
4. Click "Login" or "Access Dashboard"
5. ✅ Verify: Redirected to staff dashboard

**Step 2: View Dashboard**
1. ✅ Verify: Welcome message shows "Welcome, Dr. Rajesh Kumar"
2. ✅ Verify: Dashboard cards show:
   - My Subjects count
   - My Students count

**Step 3: View My Subjects**
1. Navigate: Sidebar → My Subjects
2. ✅ Verify: 2-4 assigned subjects visible
3. ✅ Verify: Each subject shows:
   - Subject name and code
   - Category
   - Student count (e.g., "15/30")
   - Semester

**Step 4: View My Students**
1. Navigate: Sidebar → My Students
2. ✅ Verify: List of enrolled students visible
3. ✅ Verify: Shows student name, ID, subject, department

**Step 5: Select Additional Subjects**
1. Navigate: Sidebar → Select Subjects
2. ✅ Verify: ALL subject categories visible (not just assigned category)
3. ✅ Verify: Faculty count per subject (e.g., "3/5 faculty")
4. Click "Select" on a subject
5. ✅ Verify: Subject added to assigned list

**Step 6: Test Limit Validation**
1. Try to select a 6th subject
2. ✅ Verify: Alert message "You can select maximum 5 subjects"
3. Find a subject with 5/5 faculty
4. ✅ Verify: "Select" button is disabled with "Full" indicator

**Step 7: Logout**
1. Click profile icon → Logout
2. ✅ Verify: Redirected to staff login page

---

### **WORKFLOW 3: STUDENT ENROLLS IN SUBJECTS** (4 minutes)

**Step 1: Login**
1. Open: https://collegeportal.aspirafile.co.in/student/login
2. Enter Student ID: `STU001`
3. Enter Password: `2008-02-05`
4. Click "Login" or "View My Profile"
5. ✅ Verify: Redirected to student dashboard

**Step 2: View Dashboard**
1. ✅ Verify: Welcome message shows "Welcome, Aarav Sharma"
2. ✅ Verify: Credit usage cards visible:
   - Total Credits: X / 160 credits used
   - Semester Credits: Y / 25 credits used
3. ✅ Verify: Progress bars show credit usage

**Step 3: Browse Available Subjects**
1. Navigate: Sidebar → Subject Allocation / Enroll Subjects
2. ✅ Verify: Subjects organized by 6 categories:
   - Core Engineering (4 subjects)
   - Programming & Software (6 subjects)
   - Mathematics (4 subjects)
   - Electronics & Hardware (3 subjects)
   - Management & Humanities (3 subjects)
   - Laboratory (4 subjects)
3. ✅ Verify: Each subject shows:
   - Subject name and code
   - Credits
   - Available faculty count
   - Student enrollment status (e.g., "35/50 enrolled")

**Step 4: Select Subject and Faculty**
1. Click "Select Faculty" on a subject (e.g., "Programming in C")
2. ✅ Verify: Modal/page shows available faculty:
   - Faculty name and ID
   - Student count (e.g., "15/30")
   - "Enroll" button (active if space available)
   - "Full" indicator if 30/30
3. Click "Enroll" for a faculty with available space
4. ✅ Verify: Success message displayed
5. ✅ Verify: Credits update automatically

**Step 5: View My Subjects**
1. Navigate: Sidebar → My Subjects
2. ✅ Verify: Enrolled subjects table shows:
   - Subject name and code
   - Faculty name
   - Credits
   - Semester
   - Time slot (if assigned)
   - Remove/Drop button

**Step 6: Test Credit Limit Validation**
1. Navigate back to Subject Allocation
2. Enroll in subjects until approaching 25 credits
3. Try to add a subject that would exceed 25 credits
4. ✅ Verify: Error message displayed:
   ```
   ⚠️ Cannot enroll in this subject!
   Adding this subject (X credits) would exceed your 
   semester credit limit of 25 credits.
   Current semester credits: Y/25
   ```

**Step 7: Remove a Subject**
1. Navigate: My Subjects
2. Click "Remove" on a subject
3. Confirm removal
4. ✅ Verify: Subject removed from list
5. ✅ Verify: Credits decrease automatically
6. ✅ Verify: Dashboard updates

**Step 8: Logout**
1. Click profile icon → Logout
2. ✅ Verify: Redirected to student login page

---

## 🎯 CRITICAL FEATURES CHECKLIST

### ✅ Three Separate Login Systems
- [ ] Admin login works (Email/Password)
- [ ] Staff login works (Staff ID/DOB)
- [ ] Student login works (Student ID/DOB)
- [ ] Each redirects to appropriate dashboard

### ✅ Subject Category Field (Previously Fixed Bug)
- [ ] Admin subject creation form has "Category" dropdown
- [ ] Categories display in subject lists
- [ ] Staff can select from all categories

### ✅ Dynamic System Limits
- [ ] Admin can view all limit settings
- [ ] Admin can modify limits
- [ ] Limits are enforced in real-time
- [ ] Error messages shown when limits exceeded

### ✅ Credit Tracking (Students)
- [ ] Dashboard shows credit usage cards
- [ ] Progress bars display correctly
- [ ] Credits update after enrollment
- [ ] Credits decrease after removal
- [ ] Semester limit enforced (25 credits)
- [ ] Total limit enforced (160 credits)

### ✅ Faculty Student Limits
- [ ] Per-subject student limits enforced
- [ ] Per-faculty-subject limits enforced (30 students)
- [ ] "Full" indicators show when limit reached
- [ ] Enroll button disabled when full

### ✅ Data Consistency
- [ ] Admin creates subject → Staff can see it
- [ ] Admin creates subject → Student can see it
- [ ] Student enrolls → Staff sees student count increase
- [ ] Admin changes limit → Immediate effect on all users

### ✅ Premium UI Design
- [ ] Modern, responsive design
- [ ] Smooth animations and transitions
- [ ] Professional color scheme
- [ ] Card-based layouts with shadows
- [ ] Mobile-friendly interface

---

## 📊 EXPECTED SYSTEM DATA

After seeding, your live domain should have:

- **Departments:** 5 (CS, EC, ME, CE, IT)
- **Semesters:** 40 (8 per department)
- **Subject Categories:** 6
- **Subjects:** 24
- **Staff:** 10
- **Students:** 20
- **Time Slots:** 9

---

## 🔧 TROUBLESHOOTING

### Issue: Can't Login
**Solution:**
- Verify exact credentials (case-sensitive)
- For Staff/Student: Date format must be YYYY-MM-DD
- Clear browser cache and cookies
- Try incognito/private mode

### Issue: Data Not Showing
**Solution:**
- Verify database was seeded on live server
- Check database connection in .env file
- Run migrations: `php artisan migrate:fresh --seed`

### Issue: Features Not Working
**Solution:**
- Check browser console (F12) for JavaScript errors
- Verify all assets are uploaded (CSS, JS files)
- Check file permissions on server
- Clear application cache: `php artisan cache:clear`

### Issue: 500 Internal Server Error
**Solution:**
- Check Laravel logs: `storage/logs/laravel.log`
- Verify .env configuration
- Check database credentials
- Ensure storage directory is writable

---

## 📱 TESTING TIPS

### Use Multiple Browser Windows
Open three separate windows/tabs:
1. Admin Portal
2. Staff Portal
3. Student Portal

This allows you to see real-time updates across all user types.

### Test on Different Devices
- Desktop/Laptop
- Tablet
- Mobile phone

Verify responsive design works on all screen sizes.

### Test Different Browsers
- Chrome
- Firefox
- Edge
- Safari (if available)

Ensure compatibility across browsers.

---

## 🎬 DEMO RECORDING TIPS

If you're recording a demo video:

1. **Start with Homepage** - Show the professional landing page
2. **Admin First** - Demonstrate complete system setup
3. **Staff Second** - Show faculty management features
4. **Student Last** - Show enrollment and credit tracking
5. **Highlight Key Features:**
   - Subject category field
   - Dynamic limits configuration
   - Real-time credit tracking
   - Limit validation with error messages
   - Data consistency across users

---

## 📋 QUICK REFERENCE

### Admin Login
```
URL: https://collegeportal.aspirafile.co.in/login
Email: admin@college.com
Password: password
```

### Staff Login (Sample)
```
URL: https://collegeportal.aspirafile.co.in/staff/login
FAC001: 1976-02-05
FAC002: 1983-02-05
FAC003: 1980-02-05
```

### Student Login (Sample)
```
URL: https://collegeportal.aspirafile.co.in/student/login
STU001: 2008-02-05
STU002: 2005-02-05
STU003: 2005-02-05
```

**📌 See ALL_CREDENTIALS.md for complete list**

---

## ✅ WORKFLOW VERIFICATION COMPLETE

Your live domain at **https://collegeportal.aspirafile.co.in/** is:

✅ **Accessible and Running**
✅ **Professional Landing Page**
✅ **Three Login Portals Active**
✅ **Ready for Complete Workflow Testing**

**Next Steps:**
1. Open the domain in your browser
2. Follow this guide step-by-step
3. Test all three workflows (Admin → Staff → Student)
4. Check off items in the checklist as you verify them
5. Note any issues or errors for fixing

---

**Happy Testing! 🚀**

Your College Portal is live and ready to showcase the complete workflow across all three user roles!