Fresh start: TalimBot project without binary files

.dockerignore

@@ -0,0 +1,53 @@
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Git
+.git/
+.gitignore
+
+# Data files (will be regenerated)
+backend/data/students.json
+
+# Documentation (not needed in runtime)
+*.md
+!README.md
+
+# Local development files
+.env
+.env.local
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# PowerShell scripts (local dev only)
+*.ps1
+
+# Backup files
+*.backup
+*.bak
+
+# Render config (not needed for HuggingFace)
+render.yaml
+
+# Railway config (not needed for HuggingFace)
+Procfile
+runtime.txt

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -0,0 +1,35 @@
+# Read the doc: https://huggingface.co/docs/hub/spaces-sdks-docker
+# Dockerfile for TalimBot - AI-Powered Student Grouping System
+
+FROM python:3.11
+
+# Create non-root user (Hugging Face security requirement)
+RUN useradd -m -u 1000 user
+USER user
+
+# Set environment variables
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH \
+    PYTHONUNBUFFERED=1
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements and install dependencies
+COPY --chown=user ./requirements.txt /app/requirements.txt
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+# Copy the entire backend folder (contains main.py, static files, etc.)
+COPY --chown=user ./backend /app/backend
+
+# Copy resources_references folder (optional, for documentation)
+COPY --chown=user ./resources_references /app/resources_references
+
+# Expose port 7860 (Hugging Face Spaces requirement)
+EXPOSE 7860
+
+# Change to backend directory where main.py is located
+WORKDIR /app/backend
+
+# Run the FastAPI application on port 7860
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]

HUGGINGFACE_DEPLOYMENT.md

@@ -0,0 +1,232 @@
+# Hugging Face Spaces Deployment Guide for TalimBot
+
+## Status: Ready to Deploy ✅
+
+All necessary files have been created and committed. Follow the steps below to complete the deployment.
+
+---
+
+## Files Created
+
+1. **Dockerfile** - Docker configuration for HF Spaces (port 7860)
+2. **.dockerignore** - Excludes unnecessary files from Docker build
+3. **README_HF.md** - Hugging Face Space description with metadata
+
+---
+
+## Step 1: Get Your Hugging Face Access Token
+
+1. Go to: https://huggingface.co/settings/tokens
+2. Click **"New token"**
+3. Name it: `TalimBot Deploy`
+4. Type: **Write** (must have write permissions)
+5. Click **"Generate a token"**
+6. **COPY THE TOKEN** (you won't see it again!)
+
+---
+
+## Step 2: Push to Hugging Face
+
+The git remote is already configured. Now push your code:
+
+```powershell
+git push huggingface main
+```
+
+When prompted:
+- **Username**: `parinazAkef` (your HF username)
+- **Password**: Paste your **access token** (not your actual password!)
+
+---
+
+## Step 3: Configure Environment Secret
+
+1. Go to: https://huggingface.co/spaces/parinazAkef/talimbot
+2. Click the **Settings** tab (top of page)
+3. Scroll to **"Variables and secrets"**
+4. Click **"New secret"**
+5. Name: `OPENROUTER_API_KEY`
+6. Value: Your OpenRouter API key (starts with `sk-or-v1-`)
+7. Click **"Save"**
+
+**✅ You've already done this step!**
+
+---
+
+## Step 4: Wait for Build
+
+After pushing, Hugging Face will:
+1. Show "Building" status (3-5 minutes)
+2. Pull Docker image, install dependencies
+3. Start your FastAPI app on port 7860
+4. Show "Running" status when ready
+
+---
+
+## Step 5: Access Your Live App
+
+Once status shows **"Running"** (green), your app will be available at:
+
+**Primary URL:**
+```
+https://huggingface.co/spaces/parinazAkef/talimbot
+```
+
+**Direct URL (no HF frame):**
+```
+https://parinazakef-talimbot.hf.space
+```
+
+---
+
+## Step 6: Test the Application
+
+### Teacher Login
+1. Go to your HF Space URL
+2. Click on **"معلم"** (Teacher)
+3. Password: `teacher123`
+4. You should see the teacher dashboard
+
+### Student Login
+1. Click on **"دانش آموز"** (Student)
+2. Enter national code: `0921111111` (demo account)
+3. You should see: **پریناز عاکف** dashboard
+
+### Test Grouping
+1. Login as teacher
+2. Use **"پر کردن داده‌های تست"** to generate 10 sample students
+3. Click **"شروع گروه‌بندی"**
+4. Enter course name (e.g., "ریاضی")
+5. Wait 30-60 seconds for AI grouping
+6. Check results!
+
+---
+
+## Troubleshooting
+
+### If Build Fails
+
+**Error: "Port 7860 not listening"**
+- Fixed! Our Dockerfile uses `--port 7860`
+
+**Error: "OPENROUTER_API_KEY not found"**
+- Go to Space Settings → Add secret `OPENROUTER_API_KEY`
+
+**Error: "File not found: main.py"**
+- Fixed! Dockerfile copies `backend/` folder and sets working directory
+
+### If Push Fails
+
+**Error: "Authentication failed"**
+- Make sure you're using an **access token**, not your password
+- Generate new token with **Write** permissions
+
+**Error: "Repository not found"**
+- Check space URL: https://huggingface.co/spaces/parinazAkef/talimbot
+- Make sure space exists and is public
+
+---
+
+## File Structure (Docker Container)
+
+```
+/app/
+  ├── requirements.txt
+  ├── backend/
+  │   ├── main.py                    # FastAPI app (runs on port 7860)
+  │   ├── grouping_logic.py         # AI grouping algorithm
+  │   ├── data/
+  │   │   └── students.json.backup  # Initial data template
+  │   └── static/
+  │       ├── pages/                # HTML pages
+  │       ├── assets/               # CSS, JS files
+  │       └── Icons/                # Images
+  └── resources_references/         # Documentation
+```
+
+---
+
+## Environment Variables
+
+The Space automatically provides:
+- `OPENROUTER_API_KEY` (from Secrets)
+- `PORT=7860` (HF Spaces requirement)
+
+Your FastAPI app reads `OPENROUTER_API_KEY` via:
+```python
+api_key = os.getenv("OPENROUTER_API_KEY")
+```
+
+---
+
+## Next Steps After Deployment
+
+1. **Update GitHub README** - Add HF Space badge and link
+2. **Share URL** - Send to users/colleagues
+3. **Monitor Usage** - Check Logs tab in HF Space
+4. **Add to Profile** - Pin Space to your HF profile
+
+---
+
+## Updating Your App
+
+To push changes:
+
+```powershell
+# Make your code changes
+git add .
+git commit -m "Your update description"
+
+# Push to GitHub (optional)
+git push fork main
+
+# Push to Hugging Face (triggers rebuild)
+git push huggingface main
+```
+
+HF will automatically rebuild and redeploy!
+
+---
+
+## Comparison: Railway vs Hugging Face
+
+| Feature | Railway | Hugging Face |
+|---------|---------|--------------|
+| Free Tier | 500 hours/month | Unlimited (24/7) |
+| Sleep Mode | No | No |
+| Cold Start | No | No |
+| Iran Access | Sometimes blocked | More accessible |
+| Custom Domain | Yes (paid) | Yes (subdomain free) |
+| Secrets | Environment variables | Secrets (encrypted) |
+| Logs | Real-time | Real-time |
+| Auto-deploy | Git push | Git push |
+
+---
+
+## Contact & Support
+
+- **Hugging Face Docs**: https://huggingface.co/docs/hub/spaces-sdks-docker
+- **Your Space**: https://huggingface.co/spaces/parinazAkef/talimbot
+- **OpenRouter Docs**: https://openrouter.ai/docs
+
+---
+
+## Summary
+
+✅ **Completed:**
+- Created Dockerfile (port 7860)
+- Created .dockerignore
+- Created README_HF.md
+- Committed files to git
+- Added HF remote
+
+🔄 **Your Action Required:**
+1. Get HF access token from https://huggingface.co/settings/tokens
+2. Run: `git push huggingface main`
+3. Enter username + token when prompted
+4. Wait for "Running" status
+5. Test at: https://parinazakef-talimbot.hf.space
+
+---
+
+Good luck! 🚀

MANUAL_UPDATE_INSTRUCTIONS.md

@@ -0,0 +1,150 @@
+# Manual Update Instructions for HuggingFace Space
+
+Since git push is timing out, you can update the files manually on HuggingFace.
+
+## Files to Update
+
+### 1. backend/static/pages/login.html
+
+**Go to:** https://huggingface.co/spaces/TalimBot/talimbot/blob/main/backend/static/pages/login.html
+
+**Click "Edit" button, then find and replace these sections:**
+
+**CHANGE 1 (around line 90):**
+
+Find:
+```html
+                            <input 
+                                type="text" 
+                                id="nationalCode" 
+                                placeholder="کد ملی ۱۰ رقمی "
+                                maxlength="10"
+                                class="w-full p-4 border-2 border-gray-300 rounded-xl text-center text-lg focus:border-teal-500 focus:ring-2 focus:ring-teal-200 outline-none transition-all"
+                                dir="ltr"
+                            >
+                            <p class="text-xs text-gray-500 mt-2 text-center">کد ملی ۱۰ رقمی خود را وارد کنید</p>
+```
+
+Replace with:
+```html
+                            <input 
+                                type="text" 
+                                id="nationalCode" 
+                                placeholder="کد ملی خود را وارد کنید"
+                                class="w-full p-4 border-2 border-gray-300 rounded-xl text-center text-lg focus:border-teal-500 focus:ring-2 focus:ring-teal-200 outline-none transition-all"
+                                dir="ltr"
+                            >
+                            <p class="text-xs text-gray-500 mt-2 text-center">کد ملی خود را بدون صفر ابتدایی وارد کنید</p>
+```
+
+**CHANGE 2 (around line 207):**
+
+Find:
+```javascript
+            if (selectedRole === 'student') {
+                let nationalCode = document.getElementById('nationalCode').value.trim();
+                
+                if (!nationalCode) {
+                    showError('لطفاً کد ملی خود را وارد کنید');
+                    return;
+                }
+                
+                if (nationalCode.length !== 10) {
+                    showError('کد ملی باید ۱۰ رقم باشد');
+                    return;
+                }
+                
+                // Remove leading zero if present
+                if (nationalCode.startsWith('0')) {
+                    nationalCode = nationalCode.substring(1);
+                }
+```
+
+Replace with:
+```javascript
+            if (selectedRole === 'student') {
+                let nationalCode = document.getElementById('nationalCode').value.trim();
+                
+                if (!nationalCode) {
+                    showError('لطفاً کد ملی خود را وارد کنید');
+                    return;
+                }
+                
+                // Check if starts with zero and show warning
+                if (nationalCode.startsWith('0')) {
+                    showError('لطفاً صفر ابتدایی را از کد ملی حذف کنید');
+                    return;
+                }
+                
+                // No length restriction - just check if it matches a student in database
+```
+
+**Then click "Commit changes to main"**
+
+---
+
+### 2. backend/static/pages/group-view.html
+
+**Go to:** https://huggingface.co/spaces/TalimBot/talimbot/blob/main/backend/static/pages/group-view.html
+
+**Click "Edit" button, then find and replace this section:**
+
+**CHANGE (around line 379):**
+
+Find:
+```html
+                        <div class="flex flex-wrap gap-3 text-sm">
+                            <span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>MBTI:</strong> ${member.mbti || 'ندارد'}
+                            </span>
+                            <span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>سبک:</strong> ${member.learningStyle || 'ندارد'}
+                            </span>
+                            <span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>نمره:</strong> ${member.grade.toFixed(2)}
+                            </span>
+                        </div>
+```
+
+Replace with:
+```html
+                        <div class="flex flex-wrap gap-3 text-sm">
+                            <span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>MBTI:</strong> ${member.mbti || 'ندارد'}
+                            </span>
+                            <span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>سبک:</strong> ${member.learningStyle || 'ندارد'}
+                            </span>
+                            ${member.ams ? `<span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>AMS:</strong> ${member.ams}
+                            </span>` : ''}
+                            ${member.cooperative ? `<span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>همکاری:</strong> ${member.cooperative}
+                            </span>` : ''}
+                        </div>
+```
+
+**Then click "Commit changes to main"**
+
+---
+
+## What These Changes Do
+
+1. **Login page**: Removes the 10-digit limit and shows a clear error if someone tries to enter a leading zero
+2. **Group view page**: Hides teammates' grades (معدل) and shows AMS and Cooperative scores instead
+
+## After Making Changes
+
+The Space will automatically rebuild (takes 2-3 minutes) and you'll see the changes live at:
+https://talimbot-talimbot.hf.space/pages/login.html
+
+---
+
+**Alternative: Try pushing again later when connection is better**
+
+If you prefer to keep trying git push, you can run:
+```powershell
+git push huggingface main --force
+```
+
+But given the network issues, manual editing on the website is faster and more reliable.

Procfile

@@ -0,0 +1 @@
+web: cd backend && uvicorn main:app --host 0.0.0.0 --port $PORT

README.md

@@ -0,0 +1,278 @@
+---
+title: TalimBot
+emoji: 🎓
+colorFrom: blue
+colorTo: indigo
+sdk: docker
+pinned: false
+license: mit
+---
+
+# TalimBot - AI-Powered Student Grouping System
+
+An intelligent educational platform that uses advanced psychology principles and AI to create optimal learning groups for adolescent students (ages 15-16).
+
+## Overview
+
+TalimBot is a comprehensive web-based system designed to help teachers form balanced, effective study groups by analyzing student personalities, learning styles, academic motivation, and cooperative skills. The system uses OpenAI's GPT-4o to create groups that maximize learning potential through Zone of Proximal Development (ZPD) theory and complementary personality matching.
+
+## Key Features
+
+### For Teachers
+- **AI-Powered Grouping**: Automated group formation using educational psychology principles
+- **Multi-Factor Analysis**: Considers 7 key criteria with weighted priorities:
+  - ZPD Optimization (30%) - Grade-based peer tutoring scaffolding
+  - MBTI Complementarity (25%) - Personality type balance
+  - VARK Diversity (20%) - Learning style variety
+  - Academic Motivation (15%) - AMS score distribution
+  - Cooperative Skills (10%) - Teamwork ability balance
+  - Course-Specific Requirements
+  - Student Preferences (5%)
+- **Real-time Dashboard**: Monitor student profile completion and grouping status
+- **Data Management**: Import/export student data via JSON, fill test data
+- **Result Control**: Show/hide grouping results to students
+- **Flexible Reset Options**: 
+  - Reset grouping only (preserve student data)
+  - Reset all data (complete system reset)
+
+### For Students
+- **Profile Management**: Complete personality and learning assessments
+- **Integrated Tests**: 
+  - MBTI personality test (16 types)
+  - VARK learning style questionnaire (Visual, Aural, Read/Write, Kinesthetic)
+  - AMS academic motivation scale (28 questions, 0-196 score)
+  - Cooperative learning skills assessment (25 questions, 0-125 score)
+- **Peer Preferences**: Select up to 4 preferred groupmates
+- **Group View**: See assigned group members and AI reasoning (when visible)
+- **Progress Tracking**: Monitor test completion status
+
+## Technical Architecture
+
+### Backend
+- **Framework**: FastAPI (Python)
+- **Database**: JSON file-based storage (students.json)
+- **AI Integration**: OpenRouter API with GPT-4o model
+- **Authentication**: Password-based teacher authentication, national code verification for students
+
+### Frontend
+- **UI Framework**: Tailwind CSS
+- **Language Support**: Persian (RTL layout) with Vazirmatn font
+- **Pages**:
+  - Login page (student/teacher authentication)
+  - Student dashboard (profile management, tests)
+  - Teacher dashboard (grouping management, analytics)
+  - Group view (display assigned groups)
+  - AMS questionnaire (academic motivation assessment)
+  - Cooperative questionnaire (teamwork skills assessment)
+
+### Deployment
+- **Platform**: Railway.app
+- **Server**: Uvicorn ASGI server
+- **Static Files**: Served via FastAPI StaticFiles
+- **Environment Variables**: OPENROUTER_API_KEY
+
+## Project Structure
+
+```
+talimbot/
+├── backend/
+│   ├── main.py                 # FastAPI application and API endpoints
+│   ├── grouping_logic.py       # AI grouping algorithm
+│   ├── data/
+│   │   ├── students.json       # Student data (gitignored)
+│   │   └── students.json.backup # Clean backup template
+│   └── static/
+│       ├── pages/              # HTML pages
+│       │   ├── login.html
+│       │   ├── student-dashboard.html
+│       │   ├── teacher-dashboard.html
+│       │   ├── group-view.html
+│       │   ├── ams-questionnaire.html
+│       │   ├── cooperative-questionnaire.html
+│       │   └── student-data.html
+│       ├── assets/
+│       │   ├── js/
+│       │   │   ├── data.js     # API client functions
+│       │   │   └── grouping.js # Grouping utilities
+│       │   └── css/
+│       │       └── styles.css  # Custom styles
+│       └── index.html          # Landing page
+├── resources_references/        # Documentation and reference files
+│   ├── RAILWAY_DEPLOYMENT.md   # Deployment guide
+│   ├── TEST_RESULTS_AND_SOLUTION.md
+│   ├── angizesh_tahsili.txt    # AMS questionnaire source
+│   ├── cooperative.txt         # Cooperative questionnaire source
+│   ├── students_class_notebook.txt # Original student data
+│   └── sample-student-data.json # JSON import example
+├── requirements.txt            # Python dependencies
+├── runtime.txt                 # Python version for Railway
+├── Procfile                    # Railway start command
+└── .gitignore                  # Git ignore rules
+
+```
+
+## Installation and Setup
+
+### Prerequisites
+- Python 3.11+
+- OpenRouter API key (get from https://openrouter.ai/keys)
+
+### Local Development
+
+1. Clone the repository:
+```bash
+git clone https://github.com/talimbot/talimbot.git
+cd talimbot
+```
+
+2. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+3. Set environment variable:
+```bash
+# Windows PowerShell
+$env:OPENROUTER_API_KEY="your-api-key-here"
+
+# Linux/Mac
+export OPENROUTER_API_KEY="your-api-key-here"
+```
+
+4. Run the server:
+```bash
+cd backend
+uvicorn main:app --reload --host 0.0.0.0 --port 8000
+```
+
+5. Access the application:
+```
+http://localhost:8000
+```
+
+### Railway Deployment
+
+1. Fork this repository to your GitHub account
+
+2. Create a new project on Railway.app
+
+3. Connect your GitHub repository
+
+4. Add environment variable in Railway dashboard:
+   - Key: `OPENROUTER_API_KEY`
+   - Value: Your OpenRouter API key
+
+5. Railway will auto-deploy using the Procfile
+
+## Usage Guide
+
+### Teacher Workflow
+
+1. **Login**: Access teacher dashboard with password (default: teacher123)
+
+2. **Monitor Students**: View student profile completion status
+
+3. **Fill Test Data** (Optional): Use the test data generator to fill 10 sample students for testing
+
+4. **Import Data** (Optional): Upload JSON file with student information
+
+5. **Perform Grouping**:
+   - Enter course name
+   - Click "Start Grouping" button
+   - Wait for AI processing (30-60 seconds)
+   - Review generated groups with detailed reasoning
+
+6. **Show Results**: Toggle result visibility to allow students to view their groups
+
+7. **Reset Options**:
+   - Reset Grouping: Clear groups, keep student data
+   - Reset All Data: Complete system wipe
+
+### Student Workflow
+
+1. **Login**: Enter student number (S001-S030) and national code
+
+2. **Complete Profile**:
+   - Take MBTI personality test (external link)
+   - Complete VARK learning style questionnaire
+   - Fill AMS academic motivation scale (28 questions)
+   - Complete cooperative skills assessment (25 questions)
+   - Select up to 4 preferred groupmates (optional)
+
+3. **Save Information**: Click "Save All Information" button
+
+4. **View Group**: Access group view page to see assigned group (when teacher makes it visible)
+
+## Grouping Algorithm
+
+The AI grouping system follows a sophisticated 7-tier priority framework:
+
+1. **ZPD Optimization (30%)**: Mixes high and medium performers for peer tutoring
+2. **MBTI Complementarity (25%)**: Pairs complementary personality types (e.g., ENFP+INTJ)
+3. **VARK Diversity (20%)**: Ensures multiple learning styles in each group
+4. **Academic Motivation (15%)**: Distributes high-motivation students across groups
+5. **Cooperative Skills (10%)**: Balances teamwork abilities
+6. **Course-Specific Requirements**: Adapts to subject matter needs
+7. **Student Preferences (5%)**: Honors preferences when they don't compromise other criteria
+
+Groups are typically 5 students each, with some groups of 4 to avoid very small groups.
+
+## Data Structure
+
+### Student Object
+```json
+{
+  "studentNumber": "S001",
+  "name": "Student Name",
+  "nationalCode": "1234567890",
+  "mbti": "INTJ",
+  "learningStyle": "Visual",
+  "ams": "150",
+  "cooperative": "95",
+  "grade": 18.5,
+  "preferredStudents": ["S002", "S003"],
+  "group": 1
+}
+```
+
+## API Endpoints
+
+- `GET /api/students` - Get all students
+- `GET /api/student/{student_number}` - Get specific student
+- `PUT /api/student/{student_number}` - Update student data
+- `POST /api/grouping/perform` - Execute AI grouping
+- `GET /api/grouping/status` - Get grouping statistics
+- `POST /api/grouping/reset` - Reset grouping only
+- `POST /api/data/reset-all` - Reset all data
+- `POST /api/grouping/toggle-visibility` - Show/hide results
+- `POST /api/auth/teacher` - Verify teacher password
+- `POST /api/auth/student` - Authenticate student
+- `GET /api/student/{student_number}/group` - Get student's group
+
+## Security Notes
+
+- Student data stored in students.json (excluded from version control)
+- Teacher password: "teacher123" (change in production)
+- National codes used for student authentication
+- API key required for AI grouping functionality
+
+## Educational Foundation
+
+This system is based on:
+- **Vygotsky's Zone of Proximal Development (ZPD)**: Optimal learning occurs when students work slightly above their current level with peer support
+- **MBTI Complementarity Research**: Diverse personality types enhance team creativity and problem-solving
+- **VARK Learning Theory**: Multiple learning styles improve knowledge retention
+- **Academic Motivation Scale (AMS)**: Measures intrinsic and extrinsic motivation factors
+- **Cooperative Learning Principles**: Teamwork skills are essential for collaborative success
+
+## License
+
+This project is for educational purposes.
+
+## Contributors
+
+Developed for educational psychology research and classroom implementation.
+
+## Support
+
+For issues or questions, please refer to the documentation in the `resources_references/` folder.

README_HF.md

@@ -0,0 +1,54 @@
+---
+title: TalimBot
+emoji: 🎓
+colorFrom: teal
+colorTo: cyan
+sdk: docker
+pinned: false
+license: mit
+---
+
+# TalimBot - AI-Powered Student Grouping System
+
+An intelligent educational platform that uses advanced psychology principles and AI to create optimal learning groups for adolescent students (ages 15-16).
+
+## Features
+
+- **AI-Powered Grouping**: Automated group formation using OpenAI GPT-4o
+- **Educational Psychology**: Based on ZPD theory, MBTI complementarity, VARK learning styles
+- **Teacher Dashboard**: Monitor students and manage grouping
+- **Student Dashboard**: Complete personality and learning assessments
+- **Persian Language**: Full RTL support with Vazirmatn font
+
+## Tech Stack
+
+- **Backend**: FastAPI (Python 3.11)
+- **Frontend**: Vanilla JavaScript, Tailwind CSS
+- **AI**: OpenRouter API with GPT-4o
+- **Deployment**: Hugging Face Spaces (Docker)
+
+## Usage
+
+1. **Teacher Login**: Use password to access teacher dashboard
+2. **Student Login**: Enter national code (کد ملی) to access student dashboard
+3. **Complete Profiles**: Students fill MBTI, VARK, AMS, and Cooperative assessments
+4. **Create Groups**: Teacher runs AI grouping algorithm
+5. **View Results**: Students see their assigned groups
+
+## Demo Account
+
+For demonstration purposes, login with:
+- National Code: 0921111111
+- Name: پریناز عاکف
+
+This account is for demo only and won't be included in grouping.
+
+## Configuration
+
+This Space requires the `OPENROUTER_API_KEY` environment variable to be set in the Secrets section.
+
+Get your free API key at: https://openrouter.ai/keys
+
+## License
+
+MIT License - For educational purposes

backend/README.md

@@ -0,0 +1,53 @@
+# TalimBot Backend
+
+FastAPI backend server for the TalimBot student grouping system.
+
+## Quick Start
+
+```bash
+# Install dependencies (one time only)
+pip install -r requirements.txt
+
+# Start the server
+python main.py
+```
+
+Server will run on `http://localhost:8000`
+
+## API Endpoints
+
+- `GET /` - Health check
+- `GET /api/students` - Get all students
+- `GET /api/student/{id}` - Get specific student
+- `PUT /api/student/{id}` - Update student info
+- `POST /api/grouping/perform` - Perform AI grouping
+- `GET /api/grouping/status` - Get grouping statistics
+- `POST /api/grouping/toggle-visibility` - Show/hide results to students
+- `POST /api/grouping/reset` - Reset grouping
+
+## Configuration
+
+### OpenRouter API Key
+Located in `grouping_logic.py`:
+```python
+OPENROUTER_API_KEY = 'your-key-here'
+```
+
+### Teacher Password
+Located in `main.py` (SystemData model):
+```python
+teacherPassword: str = "teacher123"
+```
+
+## Data Storage
+
+Student data is stored in `data/students.json` (auto-created on first run)
+
+## Dependencies
+
+- fastapi - Web framework
+- uvicorn - ASGI server
+- pydantic - Data validation
+- aiohttp - Async HTTP client for API calls
+
+See `requirements.txt` for versions.

backend/data/students.json

@@ -0,0 +1,388 @@
+{
+  "students": [
+    {
+      "studentNumber": "S001",
+      "name": "یاسمن آدینه پور",
+      "nationalCode": "929986644",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.77,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S002",
+      "name": "پریا احمدزاده",
+      "nationalCode": "980085330",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.28,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S003",
+      "name": "فاطمه اکبرزاده",
+      "nationalCode": "970154550",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 16.71,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S004",
+      "name": "آناهیتا الهی مهر",
+      "nationalCode": "26425955",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.05,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S005",
+      "name": "مریم امیری",
+      "nationalCode": "980093341",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.87,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S006",
+      "name": "باران برادران رحیمی",
+      "nationalCode": "960043985",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.07,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S007",
+      "name": "مایسا بصیری امین",
+      "nationalCode": "960089446",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.33,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S008",
+      "name": "دلارام ثابت عهد",
+      "nationalCode": "960125620",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.55,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S009",
+      "name": "شاینا جان محمدی",
+      "nationalCode": "960068041",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.47,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S010",
+      "name": "آیدا جوان",
+      "nationalCode": "95112313",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 16.77,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S011",
+      "name": "سارینا حاجی آبادی",
+      "nationalCode": "999216751",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 16.08,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S012",
+      "name": "هستی حسن پور جوان",
+      "nationalCode": "960074198",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.55,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S013",
+      "name": "فاطمه حسینی",
+      "nationalCode": "2400410259",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.07,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S014",
+      "name": "غزل خسروی",
+      "nationalCode": "929995767",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 15.05,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S015",
+      "name": "غزل ذباح",
+      "nationalCode": "960110186",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.25,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S016",
+      "name": "نازنین زهرا راشکی",
+      "nationalCode": "3661516087",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.02,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S017",
+      "name": "ویونا روح نواز",
+      "nationalCode": "314458344",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.7,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S018",
+      "name": "روژینا سعادتی",
+      "nationalCode": "960051023",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.2,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S019",
+      "name": "ترنم شعبانی",
+      "nationalCode": "950083100",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.37,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S020",
+      "name": "ستایش شفابخش",
+      "nationalCode": "960126899",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.36,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S021",
+      "name": "فاطمه شیرزادخان",
+      "nationalCode": "980120756",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.33,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S022",
+      "name": "آرزو علی جوی",
+      "nationalCode": "960054316",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.98,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S023",
+      "name": "آناهیتا قنادزاده",
+      "nationalCode": "960089836",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.84,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S024",
+      "name": "نیایش کارگر",
+      "nationalCode": "929956052",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.74,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S025",
+      "name": "باران کبریایی نسب",
+      "nationalCode": "980119588",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.82,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S026",
+      "name": "زینب کیانوش",
+      "nationalCode": "970072678",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.58,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S027",
+      "name": "ستایش محمودی",
+      "nationalCode": "929904656",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.33,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S028",
+      "name": "ستایش مشتاقی",
+      "nationalCode": "361282217",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.67,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S029",
+      "name": "مهتاب معلمی",
+      "nationalCode": "960070265",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.56,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S030",
+      "name": "باران وحدتی",
+      "nationalCode": "929916913",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 15.02,
+      "preferredStudents": [],
+      "group": null
+    }
+  ],
+  "courseName": "ریاضی",
+  "groupingComplete": true,
+  "groupingResults": {
+    "groups": [
+      {
+        "groupNumber": 1,
+        "students": [
+          "S001",
+          "S003",
+          "S004"
+        ],
+        "reasoning": "این گروه شامل ۲ درون‌گرا (S001, S003) و ۱ برون‌گرا (S004) است. همچنین این گروه شامل یک دانش‌آموز با سبک یادگیری بصری (S001)، یک دانش‌آموز با سبک یادگیری حرکتی (S003) و یک دانش‌آموز با سبک یادگیری بصوتی (S004) است. همچنین نمرات این دانش‌آموزان به ترتیب 18.77، 16.71 و 19.05 است که یک توازن خوب بین نمرات دا��ش‌آموزان در این گروه ایجاد می‌کند."
+      },
+      {
+        "groupNumber": 2,
+        "students": [
+          "S002"
+        ],
+        "reasoning": "این گروه شامل یک برون‌گرا (S002) است که با توجه به داده‌های ورودی تنها دانش‌آموز برون‌گرا در داده‌ها است. همچنین این دانش‌آموز با سبک یادگیری بصوتی و نمره 17.28 انتخاب شده است."
+      }
+    ]
+  },
+  "resultsVisible": false,
+  "teacherPassword": "teacher123"
+}

backend/data/students.json.backup

@@ -0,0 +1,388 @@
+{
+  "students": [
+    {
+      "studentNumber": "S001",
+      "name": "یاسمن آدینه پور",
+      "nationalCode": "929986644",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.77,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S002",
+      "name": "پریا احمدزاده",
+      "nationalCode": "980085330",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.28,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S003",
+      "name": "فاطمه اکبرزاده",
+      "nationalCode": "970154550",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 16.71,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S004",
+      "name": "آناهیتا الهی مهر",
+      "nationalCode": "26425955",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.05,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S005",
+      "name": "مریم امیری",
+      "nationalCode": "980093341",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.87,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S006",
+      "name": "باران برادران رحیمی",
+      "nationalCode": "960043985",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.07,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S007",
+      "name": "مایسا بصیری امین",
+      "nationalCode": "960089446",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.33,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S008",
+      "name": "دلارام ثابت عهد",
+      "nationalCode": "960125620",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.55,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S009",
+      "name": "شاینا جان محمدی",
+      "nationalCode": "960068041",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.47,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S010",
+      "name": "آیدا جوان",
+      "nationalCode": "95112313",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 16.77,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S011",
+      "name": "سارینا حاجی آبادی",
+      "nationalCode": "999216751",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 16.08,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S012",
+      "name": "هستی حسن پور جوان",
+      "nationalCode": "960074198",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.55,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S013",
+      "name": "فاطمه حسینی",
+      "nationalCode": "2400410259",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.07,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S014",
+      "name": "غزل خسروی",
+      "nationalCode": "929995767",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 15.05,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S015",
+      "name": "غزل ذباح",
+      "nationalCode": "960110186",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.25,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S016",
+      "name": "نازنین زهرا راشکی",
+      "nationalCode": "3661516087",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.02,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S017",
+      "name": "ویونا روح نواز",
+      "nationalCode": "314458344",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.7,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S018",
+      "name": "روژینا سعادتی",
+      "nationalCode": "960051023",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.2,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S019",
+      "name": "ترنم شعبانی",
+      "nationalCode": "950083100",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.37,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S020",
+      "name": "ستایش شفابخش",
+      "nationalCode": "960126899",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.36,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S021",
+      "name": "فاطمه شیرزادخان",
+      "nationalCode": "980120756",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.33,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S022",
+      "name": "آرزو علی جوی",
+      "nationalCode": "960054316",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.98,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S023",
+      "name": "آناهیتا قنادزاده",
+      "nationalCode": "960089836",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.84,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S024",
+      "name": "نیایش کارگر",
+      "nationalCode": "929956052",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.74,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S025",
+      "name": "باران کبریایی نسب",
+      "nationalCode": "980119588",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.82,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S026",
+      "name": "زینب کیانوش",
+      "nationalCode": "970072678",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.58,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S027",
+      "name": "ستایش محمودی",
+      "nationalCode": "929904656",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 19.33,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S028",
+      "name": "ستایش مشتاقی",
+      "nationalCode": "361282217",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 17.67,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S029",
+      "name": "مهتاب معلمی",
+      "nationalCode": "960070265",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 18.56,
+      "preferredStudents": [],
+      "group": null
+    },
+    {
+      "studentNumber": "S030",
+      "name": "باران وحدتی",
+      "nationalCode": "929916913",
+      "mbti": null,
+      "learningStyle": null,
+      "ams": null,
+      "cooperative": null,
+      "grade": 15.02,
+      "preferredStudents": [],
+      "group": null
+    }
+  ],
+  "courseName": "ریاضی",
+  "groupingComplete": true,
+  "groupingResults": {
+    "groups": [
+      {
+        "groupNumber": 1,
+        "students": [
+          "S001",
+          "S003",
+          "S004"
+        ],
+        "reasoning": "این گروه شامل ۲ درون‌گرا (S001, S003) و ۱ برون‌گرا (S004) است. همچنین این گروه شامل یک دانش‌آموز با سبک یادگیری بصری (S001)، یک دانش‌آموز با سبک یادگیری حرکتی (S003) و یک دانش‌آموز با سبک یادگیری بصوتی (S004) است. همچنین نمرات این دانش‌آموزان به ترتیب 18.77، 16.71 و 19.05 است که یک توازن خوب بین نمرات دا��ش‌آموزان در این گروه ایجاد می‌کند."
+      },
+      {
+        "groupNumber": 2,
+        "students": [
+          "S002"
+        ],
+        "reasoning": "این گروه شامل یک برون‌گرا (S002) است که با توجه به داده‌های ورودی تنها دانش‌آموز برون‌گرا در داده‌ها است. همچنین این دانش‌آموز با سبک یادگیری بصوتی و نمره 17.28 انتخاب شده است."
+      }
+    ]
+  },
+  "resultsVisible": false,
+  "teacherPassword": "teacher123"
+}

backend/grouping_logic.py

@@ -0,0 +1,334 @@
+import requests
+import json
+import os
+from typing import List, Dict, Any, Optional
+
+# API Configuration
+OPENROUTER_API_URL = 'https://openrouter.ai/api/v1/chat/completions'
+
+def analyze_mbti(mbti: str) -> Dict[str, str]:
+    """Helper to break down MBTI into explicit tags"""
+    if not mbti or len(mbti) < 4:
+        return {"type": "Unknown", "tags": []}
+    
+    m = mbti.upper()
+    return {
+        "energy": 'Introvert (درون‌گرا)' if m[0] == 'I' else 'Extrovert (برون‌گرا)',
+        "info": 'Intuitive' if m[1] == 'N' else 'Sensing',
+        "decision": 'Thinking' if m[2] == 'T' else 'Feeling',
+        "structure": 'Judging' if m[3] == 'J' else 'Perceiving'
+    }
+
+def group_students_with_ai(students: List[Any], course_name: str, api_key: Optional[str] = None) -> Dict[str, Any]:
+    """
+    Group students using OpenRouter API (ChatGPT) with advanced educational psychology principles
+    Args:
+        students: List of student objects
+        course_name: Name of the course
+        api_key: OpenRouter API key (optional, falls back to env var)
+    """
+    # Get API key from parameter or environment variable
+    openrouter_key = api_key or os.getenv('OPENROUTER_API_KEY', '')
+    
+    # Clean the API key - remove any whitespace and newlines
+    if openrouter_key:
+        openrouter_key = openrouter_key.strip().replace('\n', '').replace('\r', '')
+    
+    if not openrouter_key or openrouter_key == '':
+        raise Exception(
+            "OpenRouter API key not configured! "
+            "Please add OPENROUTER_API_KEY in Railway Variables tab. "
+            "Get your free key at: https://openrouter.ai/keys"
+        )
+    
+    # Validate API key format (but don't log the key)
+    if not openrouter_key.startswith('sk-or-v1-'):
+        raise Exception(
+            f"Invalid API key format. OpenRouter keys should start with 'sk-or-v1-'. "
+            f"Please check your OPENROUTER_API_KEY in Railway Variables."
+        )
+    
+    # Sanitization & Data Enrichment
+    valid_student_ids = set(s.studentNumber for s in students)
+    
+    student_data = []
+    for s in students:
+        mbti_details = analyze_mbti(s.mbti)
+        student_data.append({
+            "id": s.studentNumber,
+            "name": s.name,
+            "mbti": s.mbti,
+            "mbti_analysis": mbti_details,
+            "learningStyle": s.learningStyle,
+            "ams": s.ams if hasattr(s, 'ams') else None,
+            "cooperative": s.cooperative if hasattr(s, 'cooperative') else None,
+            "grade": s.grade,
+            "preferredStudents": [id for id in (s.preferredStudents or []) if id in valid_student_ids]
+        })
+    
+    # Dynamic Group Size Logic
+    total_students = len(students)
+    if total_students < 4:
+        size_guidance = "a single group"
+    elif total_students < 8:
+        size_guidance = "groups of 3-4 students"
+    else:
+        # Prefer groups of 5, but use groups of 4 if needed to avoid very small groups
+        # Examples: 30 students = 6 groups of 5
+        #          27 students = 5 groups of 5 + 1 group of 2 (bad) → instead: 3 groups of 5 + 3 groups of 4 (good)
+        #          25 students = 5 groups of 5
+        #          22 students = 4 groups of 5 + 1 group of 2 (bad) → instead: 2 groups of 5 + 3 groups of 4 (good)
+        remainder = total_students % 5
+        if remainder == 1:
+            # e.g., 21 students: would be 4 groups of 5 + 1 of 1 → instead make 3 groups of 5 + 2 groups of 3
+            size_guidance = "groups of 5 students, with some groups of 3-4 if needed to avoid groups smaller than 3"
+        elif remainder == 2:
+            # e.g., 22 students: would be 4 groups of 5 + 1 of 2 → instead make 2 groups of 5 + 3 groups of 4
+            size_guidance = "groups of 5 students, with some groups of 4 if needed to avoid groups of 2"
+        else:
+            size_guidance = "groups of 5 students"
+    
+    # The Enhanced Prompt
+    prompt = f"""You are an expert educational psychologist specializing in adolescent team formation and Vygotsky's Zone of Proximal Development (ZPD). Create optimal learning groups for "{course_name}" course with 15-16 year old students.
+
+INPUT DATA:
+{json.dumps(student_data, ensure_ascii=False, indent=2)}
+
+TOTAL STUDENTS: {total_students}
+GROUPING STRATEGY: Prefer {size_guidance}. IMPORTANT: Avoid creating groups with only 1-2 students. If the math doesn't work out evenly with groups of 5, adjust by creating some groups of 4 to balance the numbers. For example:
+- 30 students = 6 groups of 5 ✓
+- 27 students = 3 groups of 5 + 3 groups of 4 ✓ (NOT 5 groups of 5 + 1 group of 2 ✗)
+- 25 students = 5 groups of 5 ✓
+- 22 students = 2 groups of 5 + 3 groups of 4 ✓ (NOT 4 groups of 5 + 1 group of 2 ✗)
+
+STUDENT AGE CONTEXT (15-16 years - Adolescence):
+- High need for peer acceptance and social belonging
+- Developing abstract thinking and metacognition
+- Identity formation through social interactions
+- Sensitivity to feedback from peers
+- Collaborative learning enhances engagement
+
+GROUPING FRAMEWORK - PRIORITY ORDER:
+
+1. **ZPD OPTIMIZATION (Zone of Proximal Development)** - 30%
+   - Mix academic performance (grade field) to create ZPD scaffolding
+   - Place high performers (معدل بالا) with medium performers for peer tutoring
+   - Avoid grouping all high or all low performers together
+   - Target: Each group should have grade variance of 1-2 points to maximize learning
+
+2. **MBTI COMPLEMENTARITY (NOT Similarity)** - 25%
+   Research-based MBTI pairings for adolescent teamwork:
+   - ENFP + INTJ: Visionary creativity with strategic planning
+   - ENTP + INFJ: Innovation meets deep insight and empathy
+   - ENTJ + INFP: Leadership with values-driven creativity
+   - ESTJ + ISFP: Organization with practical creativity
+   - ESFJ + INTP: Social cohesion with analytical thinking
+   - ESTP + ISFJ: Action-oriented with detail consciousness
+   - ENFJ + ISTP: Motivational leadership with technical problem-solving
+   - ESFP + ISTJ: Enthusiasm with reliability and structure
+   
+   KEY PRINCIPLES:
+   - Balance E (Extrovert) and I (Introvert): 2-3 of each per group
+   - Complement T (Thinking) with F (Feeling) for balanced decision-making
+   - Mix N (Intuitive) with S (Sensing) for big-picture + detail focus
+   - Combine J (Judging) with P (Perceiving) for structure + flexibility
+
+3. **VARK DIVERSITY (Learning Styles)** - 20%
+   - Include different learning styles in each group:
+     * Visual (دیداری): Diagrams, charts, spatial understanding
+     * Aural (شنیداری): Discussions, verbal explanations
+     * Read/Write: Text-based learning, note-taking
+     * Kinesthetic (حرکتی): Hands-on, experiential learning
+   - Diversity ensures multiple teaching approaches within group
+   - Adolescents learn best when exposed to varied learning methods
+
+4. **ACADEMIC MOTIVATION (AMS Score)** - 15%
+   - AMS field: Academic Motivation Scale (0-196)
+   - Balance high and moderate motivation levels
+   - High motivation students (>140) can inspire others
+   - Avoid grouping all low-motivation (<100) students together
+   - Target: Each group has at least one high-motivation member
+
+5. **COOPERATIVE LEARNING SKILLS** - 10%
+   - Cooperative field: Cooperation ability (0-125)
+   - High cooperation students (>88) act as social facilitators
+   - Mix cooperation levels for peer modeling
+   - Students with strong cooperation skills help integrate introverts
+
+6. **COURSE-SPECIFIC REQUIREMENTS** - Based on "{course_name}":
+   - Math/Science: Prioritize T (Thinking) types, Visual/Kinesthetic learners
+   - Literature/Humanities: Include F (Feeling) types, Read/Write learners
+   - Projects/Labs: Need high Kinesthetic and ESTP/ISTP types
+   - Discussion-based: Ensure Aural learners and E (Extrovert) types
+
+7. **STUDENT PREFERENCES** - 5% (Secondary consideration)
+   - Honor "preferredStudents" field ONLY if it doesn't compromise above criteria
+   - Adolescents benefit from working outside comfort zones
+   - Strategic separation can reduce cliques and expand social circles
+
+CRITICAL RULES:
+✓ ALL students MUST be assigned to a group
+✓ PREFER groups of 5 students to minimize total number of groups
+✓ Adjust group sizes (use groups of 4) to avoid creating groups with only 1-2 students
+✓ Each group should have 3-5 students (never 1-2 students alone)
+✓ Each group needs MBTI balance: 2-3 Introverts + 2-3 Extroverts
+✓ Each group needs grade diversity: Mix high (>18) with medium (16-18) performers
+✓ Prioritize complementary MBTI types over similar types
+✓ Use provided data fields - DO NOT invent values
+✓ **ABSOLUTELY CRITICAL**: Each student ID can appear in EXACTLY ONE group. NO DUPLICATES. Verify this before outputting.
+✓ Double-check: Count total students in all groups = input students count
+
+OUTPUT FORMAT (Valid JSON Only):
+{{
+  "groups": [
+    {{
+      "groupNumber": 1,
+      "students": ["S001", "S002", "S003", "S004"],
+      "reasoning": "توضیحات کامل به فارسی - شامل: (1) تحلیل ZPD: معدل‌ها و چگونگی یادگیری همیاری (2) تکمیل MBTI: چرا این تیپ‌ها با هم سازگارند (3) تنوع VARK (4) سطح انگیزش و همکاری (5) مناسب بودن برای درس {course_name}. مثال: 'این گروه دارای ZPD مطلوب است: S001 (معدل 19.5) و S002 (معدل 17.2) به S003 (معدل 16) کمک می‌کنند. تکمیل MBTI: ENFP (S001) با خلاقیت و INTJ (S002) با برنامه‌ریزی استراتژیک همکاری می‌کنند. تنوع یادگیری: 2 Visual، 1 Aural، 1 Kinesthetic. انگیزش بالا (AMS>150) در S001 الهام‌بخش است.'"
+    }}
+  ]
+}}"""
+
+    # Make API call using requests library
+    headers = {
+        'Content-Type': 'application/json',
+        'Authorization': f'Bearer {openrouter_key}',
+        'HTTP-Referer': 'https://talimbot.up.railway.app',
+        'X-Title': 'TalimBot'
+    }
+    
+    payload = {
+        'model': 'openai/gpt-4o',  # Using GPT-4o for better accuracy and reasoning
+        'messages': [
+            {
+                'role': 'system',
+                'content': 'You are a precise algorithmic grouping assistant. You MUST output ONLY valid JSON - no markdown, no code blocks, no extra text. Start directly with { and end with }. CRITICAL RULE: Each student can appear in EXACTLY ONE group - no duplicates allowed. You rely on the explicit "mbti_analysis" fields provided in the user prompt for your reasoning. Verify that all student IDs appear exactly once across all groups.'
+            },
+            {
+                'role': 'user',
+                'content': prompt
+            }
+        ],
+        'temperature': 0.2  # Lower temperature for more consistent, logical grouping
+    }
+    
+    print(f"Sending request to OpenRouter API...")
+    
+    response = requests.post(
+        OPENROUTER_API_URL,
+        headers=headers,
+        json=payload,
+        timeout=60
+    )
+    
+    print(f"Response status: {response.status_code}")
+    print(f"Response preview: {response.text[:200]}")
+    
+    if response.status_code == 401:
+        try:
+            error_data = response.json()
+            error_msg = error_data.get('error', {}).get('message', 'Unauthorized')
+        except:
+            error_msg = response.text
+        
+        raise Exception(
+            f"OpenRouter Authentication Error: {error_msg}. "
+            f"Your API key is configured but invalid. Please:\n"
+            f"1. Go to https://openrouter.ai/keys\n"
+            f"2. Check if your key is active and has credits\n"
+            f"3. Create a NEW key if needed\n"
+            f"4. Update OPENROUTER_API_KEY in Railway Variables"
+        )
+    
+    if response.status_code == 402:
+        raise Exception(
+            "OpenRouter Payment Required: Your account has no credits. "
+            "Add credits at https://openrouter.ai/credits"
+        )
+    
+    if not response.ok:
+        try:
+            error_data = response.json()
+            error_detail = error_data.get('error', {}).get('message', response.text)
+        except:
+            error_detail = response.text
+        raise Exception(f"API request failed ({response.status_code}): {error_detail}")
+    
+    data = response.json()
+    content = data['choices'][0]['message']['content']
+    print(f"🔍 DEBUG: Got response content, length: {len(content)}")
+    
+    # Parse Result - Extract JSON from markdown code blocks if present
+    try:
+        # Try direct JSON parse first
+        grouping_result = json.loads(content)
+    except json.JSONDecodeError as e:
+        # Try to extract JSON from markdown code blocks
+        import re
+        
+        # Look for JSON in ```json ... ``` or ``` ... ``` blocks
+        json_match = re.search(r'```(?:json)?\s*(\{.*?\})\s*```', content, re.DOTALL)
+        if json_match:
+            try:
+                grouping_result = json.loads(json_match.group(1))
+                print(f"✅ Extracted JSON from markdown code block")
+            except json.JSONDecodeError:
+                print(f"Failed to parse JSON from code block: {json_match.group(1)[:200]}")
+                raise Exception("Invalid JSON from API (even after markdown extraction)")
+        else:
+            # Try to find JSON object in the content
+            json_match = re.search(r'\{.*"groups".*\}', content, re.DOTALL)
+            if json_match:
+                try:
+                    grouping_result = json.loads(json_match.group(0))
+                    print(f"✅ Extracted JSON object from response")
+                except json.JSONDecodeError:
+                    print(f"Failed to parse extracted JSON: {json_match.group(0)[:200]}")
+                    raise Exception("Invalid JSON from API (extraction failed)")
+            else:
+                print(f"❌ No JSON found in response. Full content:\n{content}")
+                raise Exception("Invalid JSON from API - no valid JSON structure found")
+    
+    # Failsafe: Add missing students if AI messed up
+    assigned_students = set()
+    for group in grouping_result['groups']:
+        if 'students' in group:
+            assigned_students.update(group['students'])
+    
+    all_ids = [s.studentNumber for s in students]
+    missing = [id for id in all_ids if id not in assigned_students]
+    
+    if missing:
+        print(f'AI missed students, adding to last group: {missing}')
+        if grouping_result['groups']:
+            grouping_result['groups'][-1]['students'].extend(missing)
+            grouping_result['groups'][-1]['reasoning'] += f" (سیستم دانش‌آموزان {', '.join(missing)} را به این گروه اضافه کرد)"
+        else:
+            grouping_result['groups'].append({
+                "groupNumber": 1,
+                "students": missing,
+                "reasoning": "گروه بازیابی شده توسط سیستم"
+            })
+    
+    return grouping_result
+
+async def random_grouping(students: List[Any]) -> Dict[str, Any]:
+    """Fallback random grouping if API fails"""
+    import random
+    
+    shuffled = students.copy()
+    random.shuffle(shuffled)
+    
+    group_size = 5
+    num_groups = (len(shuffled) + group_size - 1) // group_size
+    
+    groups = []
+    for i in range(num_groups):
+        group_students = shuffled[i * group_size:(i + 1) * group_size]
+        groups.append({
+            "groupNumber": i + 1,
+            "students": [s.studentNumber for s in group_students],
+            "reasoning": "گروه‌بندی تصادفی (API در دسترس نبود)"
+        })
+    
+    return {"groups": groups}

backend/main.py

@@ -0,0 +1,428 @@
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.staticfiles import StaticFiles
+from fastapi.responses import FileResponse
+from pydantic import BaseModel
+from typing import List, Optional, Dict, Any
+import json
+import os
+from pathlib import Path
+from dotenv import load_dotenv
+
+# Load environment variables from .env file (for local development)
+load_dotenv()
+
+app = FastAPI()
+
+# CORS configuration - allow all origins for flexibility
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Data file path
+DATA_FILE = Path(__file__).parent / "data" / "students.json"
+DATA_FILE.parent.mkdir(exist_ok=True)
+
+# Pydantic models
+class Student(BaseModel):
+    studentNumber: str
+    name: str
+    nationalCode: str = ""
+    mbti: Optional[str] = None
+    learningStyle: Optional[str] = None
+    ams: Optional[str] = None
+    cooperative: Optional[str] = None
+    grade: float
+    preferredStudents: List[str] = []
+    group: Optional[int] = None
+
+class StudentUpdate(BaseModel):
+    mbti: Optional[str] = None
+    learningStyle: Optional[str] = None
+    ams: Optional[str] = None
+    cooperative: Optional[str] = None
+    preferredStudents: Optional[List[str]] = None
+
+class GroupingRequest(BaseModel):
+    courseName: str
+
+class TeacherAuthRequest(BaseModel):
+    password: str
+
+class StudentAuthRequest(BaseModel):
+    studentNumber: str
+    nationalCode: str
+
+class SystemData(BaseModel):
+    students: List[Student]
+    courseName: str = ""
+    groupingComplete: bool = False
+    groupingResults: Optional[Dict[str, Any]] = None
+    resultsVisible: bool = False
+    teacherPassword: str = "teacher123"
+
+# Initialize data
+def load_data() -> SystemData:
+    if DATA_FILE.exists():
+        with open(DATA_FILE, 'r', encoding='utf-8') as f:
+            data = json.load(f)
+            return SystemData(**data)
+    else:
+        # Initialize with real 30 students from class data
+        initial_students = [
+            Student(studentNumber='S001', name='یاسمن آدینه پور', nationalCode='929986644', grade=18.77),
+            Student(studentNumber='S002', name='پریا احمدزاده', nationalCode='980085330', grade=17.28),
+            Student(studentNumber='S003', name='فاطمه اکبرزاده', nationalCode='970154550', grade=16.71),
+            Student(studentNumber='S004', name='آناهیتا الهی مهر', nationalCode='26425955', grade=19.05),
+            Student(studentNumber='S005', name='مریم امیری', nationalCode='980093341', grade=18.87),
+            Student(studentNumber='S006', name='باران برادران رحیمی', nationalCode='960043985', grade=19.07),
+            Student(studentNumber='S007', name='مایسا بصیری امین', nationalCode='960089446', grade=19.33),
+            Student(studentNumber='S008', name='دلارام ثابت عهد', nationalCode='960125620', grade=19.55),
+            Student(studentNumber='S009', name='شاینا جان محمدی', nationalCode='960068041', grade=19.47),
+            Student(studentNumber='S010', name='آیدا جوان', nationalCode='95112313', grade=16.77),
+            Student(studentNumber='S011', name='سارینا حاجی آبادی', nationalCode='999216751', grade=16.08),
+            Student(studentNumber='S012', name='هستی حسن پور جوان', nationalCode='960074198', grade=19.55),
+            Student(studentNumber='S013', name='فاطمه حسینی', nationalCode='2400410259', grade=19.07),
+            Student(studentNumber='S014', name='غزل خسروی', nationalCode='929995767', grade=15.05),
+            Student(studentNumber='S015', name='غزل ذباح', nationalCode='960110186', grade=19.25),
+            Student(studentNumber='S016', name='نازنین زهرا راشکی', nationalCode='3661516087', grade=17.02),
+            Student(studentNumber='S017', name='ویونا روح نواز', nationalCode='314458344', grade=18.70),
+            Student(studentNumber='S018', name='روژینا سعادتی', nationalCode='960051023', grade=18.20),
+            Student(studentNumber='S019', name='ترنم شعبانی', nationalCode='950083100', grade=19.37),
+            Student(studentNumber='S020', name='ستایش شفابخش', nationalCode='960126899', grade=18.36),
+            Student(studentNumber='S021', name='فاطمه شیرزادخان', nationalCode='980120756', grade=19.33),
+            Student(studentNumber='S022', name='آرزو علی جوی', nationalCode='960054316', grade=17.98),
+            Student(studentNumber='S023', name='آناهیتا قنادزاده', nationalCode='960089836', grade=18.84),
+            Student(studentNumber='S024', name='نیایش کارگر', nationalCode='929956052', grade=17.74),
+            Student(studentNumber='S025', name='باران کبریایی نسب', nationalCode='980119588', grade=18.82),
+            Student(studentNumber='S026', name='زینب کیانوش', nationalCode='970072678', grade=18.58),
+            Student(studentNumber='S027', name='ستایش محمودی', nationalCode='929904656', grade=19.33),
+            Student(studentNumber='S028', name='ستایش مشتاقی', nationalCode='361282217', grade=17.67),
+            Student(studentNumber='S029', name='مهتاب معلمی', nationalCode='960070265', grade=18.56),
+            Student(studentNumber='S030', name='باران وحدتی', nationalCode='929916913', grade=15.02),
+        ]
+        
+        data = SystemData(students=initial_students)
+        save_data(data)
+        return data
+
+def save_data(data: SystemData):
+    with open(DATA_FILE, 'w', encoding='utf-8') as f:
+        json.dump(data.dict(), f, ensure_ascii=False, indent=2)
+
+# API Endpoints
+@app.get("/")
+def read_root():
+    return {"message": "TalimBot API is running"}
+
+@app.get("/api/students")
+def get_all_students():
+    data = load_data()
+    return {"students": data.students}
+
+@app.get("/api/student/{student_number}")
+def get_student(student_number: str):
+    # Return demo account if requested
+    if student_number == "DEMO":
+        return Student(
+            studentNumber="DEMO",
+            name="پریناز عاکف",
+            nationalCode="0921111111",
+            grade=0.0,
+            mbti=None,
+            learningStyle=None,
+            ams=None,
+            cooperative=None,
+            preferredStudents=[],
+            group=None
+        )
+    
+    data = load_data()
+    student = next((s for s in data.students if s.studentNumber == student_number), None)
+    if not student:
+        raise HTTPException(status_code=404, detail="Student not found")
+    return student
+
+@app.put("/api/student/{student_number}")
+def update_student(student_number: str, updates: StudentUpdate):
+    # Silently ignore updates to demo account (pretend it worked)
+    if student_number == "DEMO":
+        demo_student = Student(
+            studentNumber="DEMO",
+            name="پریناز عاکف",
+            nationalCode="0921111111",
+            grade=0.0,
+            mbti=updates.mbti,
+            learningStyle=updates.learningStyle,
+            ams=updates.ams,
+            cooperative=updates.cooperative,
+            preferredStudents=updates.preferredStudents or [],
+            group=None
+        )
+        return {"success": True, "student": demo_student}
+    
+    data = load_data()
+    student = next((s for s in data.students if s.studentNumber == student_number), None)
+    if not student:
+        raise HTTPException(status_code=404, detail="Student not found")
+    
+    # Update only provided fields
+    update_dict = updates.dict(exclude_unset=True)
+    for key, value in update_dict.items():
+        setattr(student, key, value)
+    
+    save_data(data)
+    return {"success": True, "student": student}
+
+class GroupingRequest(BaseModel):
+    courseName: str
+
+@app.post("/api/grouping/perform")
+async def perform_grouping(request: GroupingRequest):
+    data = load_data()
+    
+    # Get API key from environment variable
+    api_key = os.getenv("OPENROUTER_API_KEY")
+    
+    if not api_key:
+        raise HTTPException(
+            status_code=500, 
+            detail="OpenRouter API key not configured. Please set OPENROUTER_API_KEY in Railway Variables tab"
+        )
+    
+    # Get students with complete info (mbti and learningStyle required)
+    students_with_info = [s for s in data.students if s.mbti and s.learningStyle]
+    
+    if len(students_with_info) == 0:
+        raise HTTPException(status_code=400, detail="No students have completed their profiles yet")
+    
+    try:
+        # Import grouping logic
+        from grouping_logic import group_students_with_ai
+        
+        # group_students_with_ai is now synchronous (uses requests library)
+        # Run it in a thread pool to avoid blocking
+        import asyncio
+        from concurrent.futures import ThreadPoolExecutor
+        
+        loop = asyncio.get_event_loop()
+        with ThreadPoolExecutor() as executor:
+            grouping_result = await loop.run_in_executor(
+                executor,
+                lambda: group_students_with_ai(students_with_info, request.courseName, api_key)
+            )
+        
+        # Apply grouping to students
+        for student in data.students:
+            student.group = None
+        
+        for group in grouping_result["groups"]:
+            for student_number in group["students"]:
+                student = next((s for s in data.students if s.studentNumber == student_number), None)
+                if student:
+                    student.group = group["groupNumber"]
+        
+        data.courseName = request.courseName
+        data.groupingComplete = True
+        data.groupingResults = grouping_result
+        data.resultsVisible = False  # Teacher must manually show results
+        
+        save_data(data)
+        return {"success": True, "results": grouping_result}
+    
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+@app.get("/api/grouping/status")
+def get_grouping_status():
+    data = load_data()
+    students_with_info = [s for s in data.students if s.mbti and s.learningStyle]
+    students_grouped = [s for s in data.students if s.group is not None]
+    
+    return {
+        "totalStudents": len(data.students),
+        "studentsWithCompleteInfo": len(students_with_info),
+        "studentsGrouped": len(students_grouped),
+        "groupingComplete": data.groupingComplete,
+        "resultsVisible": data.resultsVisible,
+        "courseName": data.courseName,
+        "groups": data.groupingResults.get("groups", []) if data.groupingResults else []
+    }
+
+class PasswordRequest(BaseModel):
+    password: str
+
+@app.post("/api/grouping/toggle-visibility")
+def toggle_results_visibility(request: PasswordRequest):
+    data = load_data()
+    if request.password != data.teacherPassword:
+        raise HTTPException(status_code=403, detail="Invalid password")
+    
+    data.resultsVisible = not data.resultsVisible
+    save_data(data)
+    return {"success": True, "resultsVisible": data.resultsVisible}
+
+@app.post("/api/grouping/reset")
+def reset_grouping(request: PasswordRequest):
+    data = load_data()
+    if request.password != data.teacherPassword:
+        raise HTTPException(status_code=403, detail="Invalid password")
+    
+    # Clear ONLY grouping-related data, keep student profiles intact
+    for student in data.students:
+        student.group = None
+    
+    data.groupingComplete = False
+    data.groupingResults = None
+    data.resultsVisible = False
+    data.courseName = ""
+    
+    save_data(data)
+    return {"success": True}
+
+@app.post("/api/data/reset-all")
+def reset_all_data(request: PasswordRequest):
+    data = load_data()
+    if request.password != data.teacherPassword:
+        raise HTTPException(status_code=403, detail="Invalid password")
+    
+    # Clear ALL student data fields AND grouping
+    for student in data.students:
+        student.group = None
+        student.mbti = None
+        student.learningStyle = None
+        student.ams = None
+        student.cooperative = None
+        student.preferredStudents = []
+    
+    data.groupingComplete = False
+    data.groupingResults = None
+    data.resultsVisible = False
+    data.courseName = ""
+    
+    save_data(data)
+    return {"success": True}
+
+@app.post("/api/auth/teacher")
+def check_teacher_password(request: TeacherAuthRequest):
+    data = load_data()
+    return {"valid": request.password == data.teacherPassword}
+
+@app.post("/api/auth/student")
+def authenticate_student(request: StudentAuthRequest):
+    # Special demo account - not stored in database
+    # Check for national code without leading zero (frontend strips it)
+    if request.nationalCode == "921111111":
+        demo_student = Student(
+            studentNumber="DEMO",
+            name="پریناز عاکف",
+            nationalCode="921111111",
+            grade=0.0,
+            mbti=None,
+            learningStyle=None,
+            ams=None,
+            cooperative=None,
+            preferredStudents=[],
+            group=None
+        )
+        return {"valid": True, "student": demo_student}
+    
+    data = load_data()
+    student = next((s for s in data.students if s.studentNumber == request.studentNumber), None)
+    if not student:
+        raise HTTPException(status_code=404, detail="Student not found")
+    
+    if student.nationalCode != request.nationalCode:
+        raise HTTPException(status_code=401, detail="Invalid national code")
+    
+    return {"valid": True, "student": student}
+
+class NationalCodeAuthRequest(BaseModel):
+    nationalCode: str
+
+@app.post("/api/auth/student-by-nationalcode")
+def authenticate_student_by_nationalcode(request: NationalCodeAuthRequest):
+    # Special demo account - not stored in database
+    # Check for national code without leading zero (frontend strips it)
+    if request.nationalCode == "921111111":
+        demo_student = Student(
+            studentNumber="DEMO",
+            name="پریناز عاکف",
+            nationalCode="921111111",
+            grade=0.0,
+            mbti=None,
+            learningStyle=None,
+            ams=None,
+            cooperative=None,
+            preferredStudents=[],
+            group=None
+        )
+        return {"valid": True, "student": demo_student}
+    
+    data = load_data()
+    # Find student by national code (without leading zero)
+    student = next((s for s in data.students if s.nationalCode == request.nationalCode), None)
+    if not student:
+        raise HTTPException(status_code=404, detail="کد ملی در سیستم یافت نشد")
+    
+    return {"valid": True, "student": student}
+
+@app.get("/api/student/{student_number}/group")
+def get_student_group(student_number: str):
+    # Demo account has no group
+    if student_number == "DEMO":
+        raise HTTPException(status_code=404, detail="Demo account is not part of any group")
+    
+    data = load_data()
+    
+    if not data.resultsVisible:
+        raise HTTPException(status_code=403, detail="Results are not yet visible")
+    
+    student = next((s for s in data.students if s.studentNumber == student_number), None)
+    if not student:
+        raise HTTPException(status_code=404, detail="Student not found")
+    
+    if student.group is None:
+        raise HTTPException(status_code=404, detail="Student not assigned to a group yet")
+    
+    # Find all students in the same group
+    group_members = [s for s in data.students if s.group == student.group]
+    
+    # Find the group details from results
+    group_info = None
+    if data.groupingResults:
+        for g in data.groupingResults.get("groups", []):
+            if g["groupNumber"] == student.group:
+                group_info = g
+                break
+    
+    return {
+        "groupNumber": student.group,
+        "members": group_members,
+        "reasoning": group_info.get("reasoning", "") if group_info else "",
+        "courseName": data.courseName
+    }
+
+@app.get("/api/data/backup")
+def get_data_backup():
+    """Download complete student data as JSON backup for safekeeping"""
+    data = load_data()
+    return data.dict()
+
+# ============================================
+# STATIC FILE SERVING (Frontend HTML/CSS/JS)
+# ============================================
+
+# Define static directory path
+STATIC_DIR = Path(__file__).parent / "static"
+
+# Mount static files FIRST - this handles all non-API routes
+app.mount("/", StaticFiles(directory=str(STATIC_DIR), html=True), name="static")
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)

backend/requirements.txt

@@ -0,0 +1,6 @@
+fastapi==0.104.1
+uvicorn==0.24.0
+pydantic==2.5.0
+requests==2.31.0
+python-multipart==0.0.6
+python-dotenv==1.0.0

backend/static/assets/css/styles.css

@@ -0,0 +1,727 @@
+/* سیستم گروه‌بندی دانشجویان - طراحی مدرن فارسی */
+
+@import url('https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;600;700&display=swap');
+
+* {
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}
+
+:root {
+    --primary-color: #381c80;
+    --primary-dark: #2a1560;
+    --secondary-color: #1e3a8a;
+    --accent-color: #5b21b6;
+    --success-color: #10b981;
+    --warning-color: #f59e0b;
+    --danger-color: #ef4444;
+    --text-dark: #1f2937;
+    --text-light: #6b7280;
+    --bg-light: #f8fafc;
+    --bg-white: #ffffff;
+    --border-color: #e2e8f0;
+    --shadow-sm: 0 1px 2px 0 rgba(56, 28, 128, 0.05);
+    --shadow-md: 0 4px 6px -1px rgba(56, 28, 128, 0.1), 0 2px 4px -1px rgba(56, 28, 128, 0.06);
+    --shadow-lg: 0 10px 15px -3px rgba(56, 28, 128, 0.15), 0 4px 6px -2px rgba(56, 28, 128, 0.08);
+    --shadow-xl: 0 20px 25px -5px rgba(56, 28, 128, 0.2), 0 10px 10px -5px rgba(56, 28, 128, 0.1);
+}
+
+body {
+    font-family: 'Vazirmatn', sans-serif;
+    background: linear-gradient(135deg, var(--primary-color) 0%, var(--secondary-color) 100%);
+    min-height: 100vh;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: 20px;
+    color: var(--text-dark);
+    line-height: 1.8;
+    direction: rtl;
+    text-align: right;
+}
+
+/* صفحات مختلف با تصاویر پس‌زمینه */
+body.login-page {
+    background: url('images/blueBackground.jpg') no-repeat center center fixed;
+    background-size: cover;
+}
+
+body.dashboard-page {
+    background: url('images/darkBlueMixed.png') no-repeat center center fixed;
+    background-size: cover;
+    align-items: flex-start;
+}
+
+body.teacher-page {
+    background: url('images/darkBluePlain.jpg') no-repeat center center fixed;
+    background-size: cover;
+    align-items: flex-start;
+}
+
+/* اور‌لی برای خوانایی بهتر متن */
+body.login-page::before,
+body.dashboard-page::before,
+body.teacher-page::before {
+    content: '';
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background: rgba(56, 28, 128, 0.15);
+    z-index: -1;
+}
+
+/* انیمیشن‌ها */
+@keyframes fadeInUp {
+    from {
+        opacity: 0;
+        transform: translateY(30px);
+    }
+    to {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}
+
+@keyframes spin {
+    to { transform: rotate(360deg); }
+}
+
+/* کانتینرها */
+.container {
+    background: rgba(255, 255, 255, 0.98);
+    backdrop-filter: blur(10px);
+    border-radius: 20px;
+    box-shadow: var(--shadow-xl);
+    padding: 35px;
+    max-width: 480px;
+    width: 100%;
+    animation: fadeInUp 0.5s ease;
+    border: 1px solid rgba(255, 255, 255, 0.3);
+}
+
+.dashboard-container {
+    max-width: 1150px;
+    padding: 25px;
+    background: transparent;
+    box-shadow: none;
+    border: none;
+}
+
+/* لوگو و هدر */
+.logo-section {
+    text-align: center;
+    margin-bottom: 20px;
+}
+
+.logo-section img {
+    max-width: 200px;
+    height: auto;
+    margin-bottom: 15px;
+}
+
+.header {
+    text-align: center;
+    margin-bottom: 25px;
+}
+
+.header h1 {
+    font-size: 1.7rem;
+    font-weight: 700;
+    color: var(--primary-color);
+    margin-bottom: 8px;
+}
+
+.header p {
+    color: var(--text-light);
+    font-size: 0.95rem;
+}
+
+/* انتخاب نقش */
+.role-selector {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 12px;
+    margin-bottom: 20px;
+}
+
+.role-option {
+    padding: 18px 12px;
+    border: 2px solid var(--border-color);
+    border-radius: 12px;
+    text-align: center;
+    cursor: pointer;
+    transition: all 0.3s ease;
+    background: var(--bg-white);
+}
+
+.role-option:hover {
+    border-color: var(--primary-color);
+    transform: translateY(-2px);
+    box-shadow: var(--shadow-md);
+}
+
+.role-option.selected {
+    border-color: var(--primary-color);
+    background: linear-gradient(135deg, var(--primary-color) 0%, var(--secondary-color) 100%);
+    color: white;
+}
+
+.role-option .icon {
+    font-size: 2.2rem;
+    margin-bottom: 8px;
+}
+
+.role-option h3 {
+    font-size: 0.95rem;
+    font-weight: 600;
+}
+
+/* فرم‌ها */
+.form-group {
+    margin-bottom: 18px;
+}
+
+.form-group label {
+    display: block;
+    font-weight: 600;
+    margin-bottom: 8px;
+    color: var(--text-dark);
+    font-size: 0.9rem;
+}
+
+.form-group input,
+.form-group select,
+.form-group textarea {
+    width: 100%;
+    padding: 12px 15px;
+    border: 2px solid var(--border-color);
+    border-radius: 10px;
+    font-size: 0.95rem;
+    transition: all 0.3s ease;
+    background: var(--bg-white);
+    font-family: 'Vazirmatn', sans-serif;
+}
+
+.form-group input:focus,
+.form-group select:focus,
+.form-group textarea:focus {
+    outline: none;
+    border-color: var(--primary-color);
+    box-shadow: 0 0 0 3px rgba(56, 28, 128, 0.1);
+}
+
+.form-row {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 15px;
+}
+
+/* دکمه‌ها */
+.btn {
+    width: 100%;
+    padding: 13px 20px;
+    border: none;
+    border-radius: 10px;
+    font-size: 0.95rem;
+    font-weight: 600;
+    cursor: pointer;
+    transition: all 0.3s ease;
+    text-align: center;
+    text-decoration: none;
+    display: inline-block;
+    font-family: 'Vazirmatn', sans-serif;
+}
+
+/* دکمه‌های جمع‌وجور که در وسط کانتینر قرار می‌گیرند (یک سوم/نیم عرض) */
+.btn--compact {
+    display: block;
+    width: 33%;
+    max-width: 360px;
+    min-width: 160px;
+    margin: 0.35rem auto;
+    padding: 10px 12px;
+    border-radius: 10px;
+}
+
+.btn-primary {
+    background: linear-gradient(135deg, var(--primary-color) 0%, var(--secondary-color) 100%);
+    color: white;
+}
+
+.btn-primary:hover {
+    transform: translateY(-2px);
+    box-shadow: var(--shadow-lg);
+}
+
+.btn-primary:active {
+    transform: translateY(0);
+}
+
+.btn-secondary {
+    background: var(--bg-light);
+    color: var(--text-dark);
+    border: 2px solid var(--border-color);
+}
+
+.btn-secondary:hover {
+    background: var(--border-color);
+}
+
+.btn-success {
+    background: linear-gradient(135deg, #10b981 0%, #059669 100%);
+    color: white;
+}
+
+.btn-success:hover {
+    transform: translateY(-2px);
+    box-shadow: var(--shadow-lg);
+}
+
+/* کارت‌ها */
+.card {
+    background: rgba(255, 255, 255, 0.98);
+    backdrop-filter: blur(10px);
+    border-radius: 16px;
+    padding: 22px;
+    margin-bottom: 18px;
+    border: 1px solid rgba(255, 255, 255, 0.4);
+    box-shadow: 0 8px 32px rgba(56, 28, 128, 0.12);
+    transition: all 0.3s ease;
+}
+
+/* Header card tweaks: centered title and positioned logout button */
+.header-card {
+    padding-top: 14px;
+    padding-bottom: 14px;
+}
+
+.header-card .logout-btn {
+    position: absolute;
+    right: 18px; /* put logout on the right like previous layout */
+    top: 14px;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: 8px 12px;
+    color: var(--text-dark);
+    background: var(--bg-light);
+    border: 1px solid var(--border-color);
+    border-radius: 10px;
+    text-decoration: none;
+    font-weight: 700;
+    transition: all 0.18s ease;
+}
+
+.header-card .logout-btn:hover {
+    background: rgba(56, 28, 128, 0.04);
+    transform: translateY(-2px);
+}
+
+/* two-column grid used in teacher page to align cards horizontally */
+.two-col-grid {
+    display: grid;
+    grid-template-columns: repeat(2, 1fr);
+    gap: 16px;
+}
+
+@media (max-width: 900px) {
+    .two-col-grid {
+        grid-template-columns: 1fr;
+    }
+}
+
+/* small inline button variant for header logout when needed */
+.btn--small {
+    display: inline-block;
+    width: auto;
+    padding: 8px 12px;
+}
+
+/* Group results layout */
+#groupResultsList {
+    display: flex;
+    gap: 16px;
+    flex-wrap: wrap;
+}
+
+.group-card {
+    flex: 1 1 calc(50% - 16px);
+    max-width: calc(50% - 16px);
+    box-sizing: border-box;
+    padding: 18px;
+    background: var(--bg-light);
+    border-radius: 12px;
+    border-right: 4px solid var(--primary-color);
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+}
+
+.group-card-header {
+    color: var(--primary-color);
+    margin: 0;
+    font-size: 1.05rem;
+}
+
+.group-reasoning {
+    color: var(--text-light);
+    font-size: 0.9rem;
+    margin: 0;
+}
+
+.group-members-list {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+    max-height: 220px;
+    overflow: auto;
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
+.group-member-item {
+    padding: 10px;
+    background: white;
+    border-radius: 8px;
+    font-size: 0.9rem;
+}
+
+@media (max-width: 900px) {
+    .group-card {
+        flex-basis: 100%;
+        max-width: 100%;
+    }
+}
+
+/* cap the overall results area so it doesn't push the whole page too far; individual groups scroll internally */
+#groupResultsCard .card-body {
+    max-height: 520px;
+    overflow: auto;
+}
+
+.card:hover {
+    box-shadow: 0 12px 40px rgba(56, 28, 128, 0.18);
+    transform: translateY(-3px);
+}
+
+.card-header {
+    font-size: 1.15rem;
+    font-weight: 700;
+    color: var(--primary-color);
+    margin-bottom: 15px;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+}
+
+.card-body {
+    color: var(--text-dark);
+}
+
+/* اطلاعات نمایشی */
+.info-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+    gap: 12px;
+    margin-bottom: 15px;
+}
+
+.info-display {
+    background: var(--bg-light);
+    padding: 12px 15px;
+    border-radius: 10px;
+    border-right: 3px solid var(--primary-color);
+}
+
+.info-display .label {
+    font-weight: 500;
+    color: var(--text-light);
+    font-size: 0.8rem;
+    margin-bottom: 4px;
+}
+
+.info-display .value {
+    font-size: 1.05rem;
+    color: var(--text-dark);
+    font-weight: 700;
+}
+
+/* لینک‌های تست */
+.links-section {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 12px;
+    margin-bottom: 15px;
+}
+
+.external-link {
+    padding: 16px 12px;
+    background: linear-gradient(135deg, var(--primary-color) 0%, var(--secondary-color) 100%);
+    border: none;
+    border-radius: 12px;
+    text-align: center;
+    text-decoration: none;
+    color: white;
+    font-weight: 600;
+    transition: all 0.3s ease;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 6px;
+    font-size: 0.9rem;
+    box-shadow: 0 4px 12px rgba(56, 28, 128, 0.2);
+}
+
+.external-link:hover {
+    transform: translateY(-3px);
+    box-shadow: 0 8px 20px rgba(56, 28, 128, 0.3);
+    background: linear-gradient(135deg, var(--primary-dark) 0%, var(--primary-color) 100%);
+}
+
+.external-link .icon {
+    font-size: 1.8rem;
+}
+
+/* هشدارها */
+.alert {
+    padding: 12px 16px;
+    border-radius: 10px;
+    margin-bottom: 15px;
+    font-weight: 500;
+    font-size: 0.9rem;
+}
+
+.alert-info {
+    background: rgba(56, 28, 128, 0.1);
+    color: var(--primary-color);
+    border: 1px solid rgba(56, 28, 128, 0.3);
+}
+
+.alert-success {
+    background: rgba(16, 185, 129, 0.1);
+    color: var(--success-color);
+    border: 1px solid rgba(16, 185, 129, 0.3);
+}
+
+.alert-warning {
+    background: rgba(245, 158, 11, 0.1);
+    color: var(--warning-color);
+    border: 1px solid rgba(245, 158, 11, 0.3);
+}
+
+/* آمار */
+.stats-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+    gap: 15px;
+    margin-bottom: 20px;
+}
+
+.stat-card {
+    background: linear-gradient(135deg, var(--primary-color) 0%, var(--secondary-color) 100%);
+    color: white;
+    padding: 20px;
+    border-radius: 12px;
+    text-align: center;
+}
+
+.stat-card .stat-value {
+    font-size: 2.2rem;
+    font-weight: 700;
+    margin-bottom: 5px;
+}
+
+.stat-card .stat-label {
+    font-size: 0.9rem;
+    opacity: 0.95;
+}
+
+/* لیست گروه */
+.group-list {
+    list-style: none;
+}
+
+.group-member {
+    background: var(--bg-light);
+    padding: 12px 15px;
+    border-radius: 10px;
+    margin-bottom: 10px;
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    transition: all 0.3s ease;
+}
+
+.group-member:hover {
+    background: var(--border-color);
+    transform: translateX(5px);
+}
+
+.group-member .member-icon {
+    font-size: 1.4rem;
+}
+
+.group-member .member-info {
+    flex: 1;
+}
+
+.group-member .member-name {
+    font-weight: 600;
+    color: var(--text-dark);
+    font-size: 0.95rem;
+    margin-bottom: 3px;
+}
+
+.group-member .member-details {
+    font-size: 0.8rem;
+    color: var(--text-light);
+}
+
+/* چک‌باکس‌ها */
+.checkbox-group {
+    max-height: 250px;
+    overflow-y: auto;
+    border: 2px solid var(--border-color);
+    border-radius: 10px;
+    padding: 8px;
+}
+
+.checkbox-item {
+    padding: 10px;
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    cursor: pointer;
+    border-radius: 8px;
+    transition: all 0.2s ease;
+}
+
+.checkbox-item:hover {
+    background: var(--bg-light);
+}
+
+.checkbox-item input[type="checkbox"] {
+    width: 18px;
+    height: 18px;
+    cursor: pointer;
+}
+
+.checkbox-item label {
+    cursor: pointer;
+    margin: 0;
+    font-weight: 500;
+    font-size: 0.9rem;
+}
+
+/* لینک بازگشت */
+.back-link {
+    display: inline-block;
+    margin-bottom: 15px;
+    color: var(--primary-color);
+    text-decoration: none;
+    font-weight: 600;
+    transition: all 0.3s ease;
+    font-size: 0.95rem;
+}
+
+.back-link:hover {
+    transform: translateX(5px);
+}
+
+/* حالت خالی */
+.empty-state {
+    text-align: center;
+    padding: 35px 20px;
+}
+
+.empty-state .icon {
+    font-size: 3.5rem;
+    opacity: 0.3;
+    margin-bottom: 15px;
+}
+
+.empty-state h3 {
+    font-size: 1.2rem;
+    color: var(--text-dark);
+    margin-bottom: 10px;
+}
+
+.empty-state p {
+    color: var(--text-light);
+    font-size: 0.9rem;
+}
+
+/* لودینگ */
+.loading {
+    display: inline-block;
+    width: 20px;
+    height: 20px;
+    border: 3px solid rgba(255, 255, 255, 0.3);
+    border-radius: 50%;
+    border-top-color: white;
+    animation: spin 1s ease-in-out infinite;
+}
+
+/* طراحی ریسپانسیو */
+@media (max-width: 768px) {
+    .container {
+        padding: 25px;
+    }
+    
+    .header h1 {
+        font-size: 1.5rem;
+    }
+    
+    .role-selector {
+        grid-template-columns: 1fr;
+    }
+    
+    .links-section {
+        grid-template-columns: 1fr;
+    }
+    
+    .stats-grid {
+        grid-template-columns: 1fr;
+    }
+    
+    .form-row {
+        grid-template-columns: 1fr;
+    }
+    
+    .info-grid {
+        grid-template-columns: 1fr;
+    }
+}
+
+@media (min-width: 769px) and (max-width: 1024px) {
+    .dashboard-container {
+        max-width: 900px;
+    }
+}
+
+/* تنظیمات اسکرول */
+::-webkit-scrollbar {
+    width: 8px;
+}
+
+::-webkit-scrollbar-track {
+    background: var(--bg-light);
+}
+
+::-webkit-scrollbar-thumb {
+    background: var(--primary-color);
+    border-radius: 4px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+    background: var(--primary-dark);
+}
+
+/* ترانزیشن‌های نرم */
+a, button, input, select, .role-option, .card, .external-link, .checkbox-item {
+    transition: all 0.3s ease;
+}

backend/static/assets/js/data.js

@@ -0,0 +1,244 @@
+// Student Grouping System - Data Management
+// This file handles all data operations using Backend API
+
+// Backend API Configuration
+// Auto-detects if running on Railway deployment or localhost
+function getApiBaseUrl() {
+    // When deployed to Railway, it will use the same domain
+    // Railway serves both frontend and backend from the same URL
+    // So we use relative paths for API calls
+    if (window.location.hostname !== 'localhost' && window.location.hostname !== '127.0.0.1') {
+        // PRODUCTION: Running on Railway - use relative paths
+        return '/api';
+    }
+    
+    // DEVELOPMENT: Running locally
+    return 'http://localhost:8000/api';
+}
+
+const API_BASE_URL = getApiBaseUrl();
+
+// Utility function for API calls
+async function apiCall(endpoint, options = {}) {
+    try {
+        const response = await fetch(`${API_BASE_URL}${endpoint}`, {
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+        
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.detail || 'API request failed');
+        }
+        
+        return await response.json();
+    } catch (error) {
+        console.error('API Error:', error);
+        throw error;
+    }
+}
+
+// Get all data (for backward compatibility)
+async function getData() {
+    const students = await getAllStudents();
+    const status = await getGroupingStats();
+    return {
+        students: students,
+        courseName: status.courseName,
+        groupingComplete: status.groupingComplete,
+        resultsVisible: status.resultsVisible,
+        teacherPassword: 'teacher123'
+    };
+}
+
+// Get student by student number
+async function getStudent(studentNumber) {
+    try {
+        return await apiCall(`/student/${studentNumber}`);
+    } catch (error) {
+        return null;
+    }
+}
+
+// Update student information
+async function updateStudent(studentNumber, updates) {
+    try {
+        const result = await apiCall(`/student/${studentNumber}`, {
+            method: 'PUT',
+            body: JSON.stringify(updates)
+        });
+        return result.success;
+    } catch (error) {
+        return false;
+    }
+}
+
+// Get all students
+async function getAllStudents() {
+    const result = await apiCall('/students');
+    return result.students;
+}
+
+// Check if a student number exists in the system
+async function studentExists(studentNumber) {
+    const student = await getStudent(studentNumber);
+    return student !== null;
+}
+
+// Get students with complete information (REQUIRED fields only: MBTI and Learning Style)
+async function getStudentsWithCompleteInfo() {
+    const students = await getAllStudents();
+    return students.filter(s => s.mbti && s.learningStyle);
+}
+
+// Check if a student has complete profile (all fields filled)
+async function hasCompleteProfile(studentNumber) {
+    const student = await getStudent(studentNumber);
+    if (!student) return false;
+    
+    return !!(student.mbti && student.learningStyle && 
+              student.ams !== null && student.cooperative !== null);
+}
+
+// Get completion percentage for a student
+async function getProfileCompletion(studentNumber) {
+    const student = await getStudent(studentNumber);
+    if (!student) return 0;
+    
+    let completed = 0;
+    const total = 4;
+    
+    if (student.mbti) completed++;
+    if (student.learningStyle) completed++;
+    if (student.ams !== null) completed++;
+    if (student.cooperative !== null) completed++;
+    
+    return Math.round((completed / total) * 100);
+}
+
+// Get grouping statistics
+async function getGroupingStats() {
+    return await apiCall('/grouping/status');
+}
+
+// Check if grouping is complete
+async function isGroupingComplete() {
+    const stats = await getGroupingStats();
+    return stats.groupingComplete;
+}
+
+// Get course name
+async function getCourseName() {
+    const stats = await getGroupingStats();
+    return stats.courseName;
+}
+
+// Check teacher password
+async function checkTeacherPassword(password) {
+    try {
+        const result = await apiCall('/auth/teacher', {
+            method: 'POST',
+            body: JSON.stringify({ password })
+        });
+        return result.valid;
+    } catch (error) {
+        return false;
+    }
+}
+
+// Get student's group (only if results are visible)
+async function getStudentGroup(studentNumber) {
+    try {
+        return await apiCall(`/student/${studentNumber}/group`);
+    } catch (error) {
+        if (error.message.includes('not yet visible')) {
+            return { error: 'results_not_visible', message: 'نتایج هنوز توسط معلم نمایش داده نشده است.' };
+        }
+        if (error.message.includes('not assigned')) {
+            return { error: 'not_assigned', message: 'شما هنوز به گروهی اختصاص داده نشده‌اید.' };
+        }
+        throw error;
+    }
+}
+
+// Reset grouping only (keep student data)
+async function resetGrouping(password) {
+    return await apiCall('/grouping/reset', {
+        method: 'POST',
+        body: JSON.stringify({ password })
+    });
+}
+
+// Reset ALL data (student profiles + grouping)
+async function resetAllData(password) {
+    return await apiCall('/data/reset-all', {
+        method: 'POST',
+        body: JSON.stringify({ password })
+    });
+}
+
+// Toggle results visibility
+async function toggleResultsVisibility(password) {
+    return await apiCall('/grouping/toggle-visibility', {
+        method: 'POST',
+        body: JSON.stringify({ password })
+    });
+}
+
+// Legacy functions for backward compatibility (these are handled by backend now)
+function saveData(data) {
+    console.warn('saveData is deprecated - data is automatically saved to backend');
+}
+
+function initializeData() {
+    console.log('Data is managed by backend');
+    return true;
+}
+
+function addNewStudent(studentNumber, name, grade = 15) {
+    console.warn('addNewStudent should be done through admin panel');
+    return { success: false, message: 'Use backend API for adding students' };
+}
+
+function saveStudents(students) {
+    console.warn('saveStudents is deprecated - use backend API');
+}
+
+function deleteStudent(studentNumber) {
+    console.warn('deleteStudent should be done through admin panel');
+    return false;
+}
+
+function setGroupingComplete(status) {
+    console.warn('setGroupingComplete is handled by backend');
+}
+
+function setCourseName(name) {
+    console.warn('setCourseName is handled by backend');
+}
+
+function resetData() {
+    console.warn('resetData should be done through teacher dashboard');
+}
+
+// Export functions for use in other files
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = {
+        getData,
+        getStudent,
+        updateStudent,
+        getAllStudents,
+        studentExists,
+        getStudentsWithCompleteInfo,
+        hasCompleteProfile,
+        getProfileCompletion,
+        isGroupingComplete,
+        getCourseName,
+        checkTeacherPassword,
+        getGroupingStats,
+        getStudentGroup
+    };
+}

backend/static/assets/js/grouping.js

@@ -0,0 +1,159 @@
+// Grouping Logic with Backend API Integration
+// This file handles the student grouping process through the backend
+
+// API_BASE_URL is defined in data.js (loaded first)
+// No need to redeclare it here to avoid "already been declared" error
+
+/**
+ * Main grouping function - calls backend API
+ * @param {string} courseName - The name of the course
+ * @returns {Promise<Object>} - Grouping results
+ */
+async function performGrouping(courseName) {
+    try {
+        console.log(`Requesting grouping from backend for course: ${courseName}`);
+        
+        const response = await fetch(`${API_BASE_URL}/grouping/perform`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({ 
+                courseName
+            })
+        });
+
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.detail || 'Grouping failed');
+        }
+
+        const result = await response.json();
+        console.log('Grouping successful!', result);
+        return result.results;
+    } catch (error) {
+        console.error('Grouping error:', error);
+        throw error;
+    }
+}
+
+/**
+ * Get grouping statistics
+ * @returns {Promise<Object>} - Statistics about current grouping
+ */
+async function getGroupingStats() {
+    try {
+        const response = await fetch(`${API_BASE_URL}/grouping/status`);
+        if (!response.ok) {
+            throw new Error('Failed to get grouping status');
+        }
+        return await response.json();
+    } catch (error) {
+        console.error('Error getting grouping stats:', error);
+        throw error;
+    }
+}
+
+/**
+ * Toggle visibility of results to students
+ * @param {string} password - Teacher password
+ * @returns {Promise<Object>} - New visibility status
+ */
+async function toggleResultsVisibility(password) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/grouping/toggle-visibility`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({ password })
+        });
+
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.detail || 'Failed to toggle visibility');
+        }
+
+        const result = await response.json();
+        return result;
+    } catch (error) {
+        console.error('Error toggling visibility:', error);
+        throw error;
+    }
+}
+
+/**
+ * Reset grouping (clear all group assignments)
+ * @param {string} password - Teacher password
+ */
+async function resetGrouping(password) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/grouping/reset`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({ password })
+        });
+
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.detail || 'Failed to reset grouping');
+        }
+
+        return await response.json();
+    } catch (error) {
+        console.error('Error resetting grouping:', error);
+        throw error;
+    }
+}
+
+/**
+ * Get student's group information
+ * @param {string} studentNumber - Student number
+ * @returns {Promise<Object>} - Group information
+ */
+async function getStudentGroup(studentNumber) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/student/${studentNumber}/group`);
+        
+        if (!response.ok) {
+            const error = await response.json();
+            if (error.detail.includes('not yet visible')) {
+                return { 
+                    error: 'not_visible', 
+                    message: 'نتایج هنوز توسط استاد نمایش داده نشده است.' 
+                };
+            }
+            if (error.detail.includes('not assigned')) {
+                return { 
+                    error: 'not_assigned', 
+                    message: 'شما هنوز به گروهی اختصاص داده نشده‌اید.' 
+                };
+            }
+            throw new Error(error.detail);
+        }
+
+        return await response.json();
+    } catch (error) {
+        console.error('Error getting student group:', error);
+        throw error;
+    }
+}
+
+// Legacy function - now handled by backend
+function applyGrouping(groupingResult, courseName) {
+    console.warn('applyGrouping is now handled automatically by the backend');
+}
+
+// Export functions
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = {
+        performGrouping,
+        getGroupingStats,
+        toggleResultsVisibility,
+        resetGrouping,
+        getStudentGroup,
+        applyGrouping
+    };
+}

backend/static/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="fa">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta http-equiv="refresh" content="0; url=pages/login.html">
+    <title>TalimBot - سیستم گروه‌بندی هوشمند</title>
+    <script>window.location.href = 'pages/login.html';</script>
+</head>
+<body>
+    <p style="text-align: center; padding: 2rem;">در حال انتقال به صفحه ورود...</p>
+</body>
+</html>

backend/static/pages/ams-questionnaire.html

@@ -0,0 +1,436 @@
+<!DOCTYPE html>
+<html lang="fa" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>پرسشنامه انگیزش تحصیلی (AMS) - سیستم گروه‌بندی</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Vazirmatn', system-ui, -apple-system, sans-serif;
+        }
+        .question-card {
+            transition: all 0.3s ease;
+        }
+        .question-card:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
+        }
+        .scale-option {
+            transition: all 0.2s ease;
+        }
+        .scale-option:hover {
+            transform: scale(1.05);
+        }
+        .scale-option input:checked + label {
+            background: linear-gradient(135deg, #3b82f6 0%, #1d4ed8 100%);
+            color: white;
+            font-weight: 600;
+        }
+    </style>
+    <script>
+        tailwind.config = {
+            theme: {
+                extend: {
+                    fontFamily: {
+                        vazir: ['Vazirmatn', 'sans-serif']
+                    }
+                }
+            }
+        }
+    </script>
+</head>
+<body class="font-vazir bg-gray-50 min-h-screen">
+    <!-- Top Navigation Bar -->
+    <nav style="background-color: #1b6e6e;" class="shadow-lg border-b border-gray-200 sticky top-0 z-50">
+        <div class="max-w-7xl mx-auto px-4">
+            <div class="flex items-center justify-between h-16">
+                <div class="flex items-center gap-3">
+                    <div class="bg-white/20 w-10 h-10 rounded-lg flex items-center justify-center">
+                        <svg class="w-6 h-6 text-white" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M10.394 2.08a1 1 0 00-.788 0l-7 3a1 1 0 000 1.84L5.25 8.051a.999.999 0 01.356-.257l4-1.714a1 1 0 11.788 1.838L7.667 9.088l1.94.831a1 1 0 00.787 0l7-3a1 1 0 000-1.838l-7-3zM3.31 9.397L5 10.12v4.102a8.969 8.969 0 00-1.05-.174 1 1 0 01-.89-.89 11.115 11.115 0 01.25-3.762zM9.3 16.573A9.026 9.026 0 007 14.935v-3.957l1.818.78a3 3 0 002.364 0l5.508-2.361a11.026 11.026 0 01.25 3.762 1 1 0 01-.89.89 8.968 8.968 0 00-5.35 2.524 1 1 0 01-1.4 0zM6 18a1 1 0 001-1v-2.065a8.935 8.935 0 00-2-.712V17a1 1 0 001 1z"/>
+                        </svg>
+                    </div>
+                    <div>
+                        <h1 class="text-xl font-bold text-white">TalimBot</h1>
+                        <p class="text-xs text-white/80">پرسشنامه انگیزش تحصیلی</p>
+                    </div>
+                </div>
+                <button onclick="goBack()" class="bg-white text-teal-700 px-4 py-2 rounded-lg font-semibold hover:bg-teal-50 transition-colors flex items-center gap-2">
+                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18"/>
+                    </svg>
+                    بازگشت به داشبورد
+                </button>
+            </div>
+        </div>
+    </nav>
+
+    <!-- Main Content -->
+    <div class="max-w-5xl mx-auto px-4 py-8">
+        <!-- Header -->
+        <div class="bg-white rounded-2xl shadow-lg p-8 mb-8">
+            <h2 class="text-3xl font-bold text-gray-900 mb-4 text-center">پرسشنامه انگیزش تحصیلی (AMS)</h2>
+            <p class="text-gray-600 text-center mb-6">لطفاً برای هر جمله مشخص کنید که تا چه حد درباره شما درست است</p>
+            
+            <!-- Progress Bar -->
+            <div class="bg-gray-200 rounded-full h-3 mb-4">
+                <div id="progressBar" class="bg-gradient-to-r from-blue-500 to-blue-600 h-3 rounded-full transition-all duration-300" style="width: 0%"></div>
+            </div>
+            <p class="text-center text-sm text-gray-600">
+                <span id="progressText">0 از 28 سؤال پاسخ داده شده</span>
+            </p>
+        </div>
+
+        <!-- Scale Legend -->
+        <div class="bg-blue-50 border-2 border-blue-200 rounded-xl p-6 mb-8">
+            <h3 class="font-bold text-blue-900 mb-4 text-center">مقیاس پاسخ‌دهی:</h3>
+            <div class="grid grid-cols-2 md:grid-cols-4 lg:grid-cols-7 gap-2 text-sm">
+                <div class="bg-white p-2 rounded text-center border border-blue-200">
+                    <div class="font-bold text-blue-900">1</div>
+                    <div class="text-xs text-gray-600">اصلاً درست نیست</div>
+                </div>
+                <div class="bg-white p-2 rounded text-center border border-blue-200">
+                    <div class="font-bold text-blue-900">2</div>
+                    <div class="text-xs text-gray-600">خیلی کم درست است</div>
+                </div>
+                <div class="bg-white p-2 rounded text-center border border-blue-200">
+                    <div class="font-bold text-blue-900">3</div>
+                    <div class="text-xs text-gray-600">کمی درست است</div>
+                </div>
+                <div class="bg-white p-2 rounded text-center border border-blue-200">
+                    <div class="font-bold text-blue-900">4</div>
+                    <div class="text-xs text-gray-600">تا حدی درست است</div>
+                </div>
+                <div class="bg-white p-2 rounded text-center border border-blue-200">
+                    <div class="font-bold text-blue-900">5</div>
+                    <div class="text-xs text-gray-600">نسبتاً درست است</div>
+                </div>
+                <div class="bg-white p-2 rounded text-center border border-blue-200">
+                    <div class="font-bold text-blue-900">6</div>
+                    <div class="text-xs text-gray-600">خیلی درست است</div>
+                </div>
+                <div class="bg-white p-2 rounded text-center border border-blue-200">
+                    <div class="font-bold text-blue-900">7</div>
+                    <div class="text-xs text-gray-600">کاملاً درست است</div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Questions -->
+        <form id="amsForm">
+            <!-- Section A: بی‌انگیزشی -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-red-50 to-orange-50 p-4 rounded-xl border-r-4 border-red-500">
+                    <svg class="w-6 h-6 text-red-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.172 16.172a4 4 0 015.656 0M9 10h.01M15 10h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    بی‌انگیزشی
+                </h3>
+                <div class="space-y-4" id="sectionA"></div>
+            </div>
+
+            <!-- Section B: تنظیم بیرونی -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-yellow-50 to-amber-50 p-4 rounded-xl border-r-4 border-yellow-500">
+                    <svg class="w-6 h-6 text-yellow-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8c-1.657 0-3 .895-3 2s1.343 2 3 2 3 .895 3 2-1.343 2-3 2m0-8c1.11 0 2.08.402 2.599 1M12 8V7m0 1v8m0 0v1m0-1c-1.11 0-2.08-.402-2.599-1M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    انگیزش بیرونی – تنظیم بیرونی
+                </h3>
+                <div class="space-y-4" id="sectionB"></div>
+            </div>
+
+            <!-- Section C: درون‌فکنی‌شده -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-orange-50 to-red-50 p-4 rounded-xl border-r-4 border-orange-500">
+                    <svg class="w-6 h-6 text-orange-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z"/>
+                    </svg>
+                    انگیزش بیرونی – درون‌فکنی‌شده
+                </h3>
+                <div class="space-y-4" id="sectionC"></div>
+            </div>
+
+            <!-- Section D: همانندسازی‌شده -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-blue-50 to-indigo-50 p-4 rounded-xl border-r-4 border-blue-500">
+                    <svg class="w-6 h-6 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4M7.835 4.697a3.42 3.42 0 001.946-.806 3.42 3.42 0 014.438 0 3.42 3.42 0 001.946.806 3.42 3.42 0 013.138 3.138 3.42 3.42 0 00.806 1.946 3.42 3.42 0 010 4.438 3.42 3.42 0 00-.806 1.946 3.42 3.42 0 01-3.138 3.138 3.42 3.42 0 00-1.946.806 3.42 3.42 0 01-4.438 0 3.42 3.42 0 00-1.946-.806 3.42 3.42 0 01-3.138-3.138 3.42 3.42 0 00-.806-1.946 3.42 3.42 0 010-4.438 3.42 3.42 0 00.806-1.946 3.42 3.42 0 013.138-3.138z"/>
+                    </svg>
+                    انگیزش بیرونی – همانندسازی‌شده
+                </h3>
+                <div class="space-y-4" id="sectionD"></div>
+            </div>
+
+            <!-- Section E: کسب دانش -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-green-50 to-emerald-50 p-4 rounded-xl border-r-4 border-green-500">
+                    <svg class="w-6 h-6 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253"/>
+                    </svg>
+                    انگیزش درونی برای کسب دانش
+                </h3>
+                <div class="space-y-4" id="sectionE"></div>
+            </div>
+
+            <!-- Section F: کسب موفقیت -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-teal-50 to-cyan-50 p-4 rounded-xl border-r-4 border-teal-500">
+                    <svg class="w-6 h-6 text-teal-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 3v4M3 5h4M6 17v4m-2-2h4m5-16l2.286 6.857L21 12l-5.714 2.143L13 21l-2.286-6.857L5 12l5.714-2.143L13 3z"/>
+                    </svg>
+                    انگیزش درونی برای کسب موفقیت
+                </h3>
+                <div class="space-y-4" id="sectionF"></div>
+            </div>
+
+            <!-- Section G: تجربه تحریک/هیجان -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-purple-50 to-pink-50 p-4 rounded-xl border-r-4 border-purple-500">
+                    <svg class="w-6 h-6 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"/>
+                    </svg>
+                    انگیزش درونی برای تجربه تحریک/هیجان
+                </h3>
+                <div class="space-y-4" id="sectionG"></div>
+            </div>
+
+            <!-- Submit Button -->
+            <div class="flex justify-center">
+                <button type="submit" class="bg-gradient-to-r from-green-600 to-green-700 text-white px-12 py-4 rounded-xl font-bold text-lg hover:from-green-700 hover:to-green-800 shadow-lg hover:shadow-xl transform hover:scale-105 transition-all flex items-center gap-3">
+                    <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    محاسبه نتیجه
+                </button>
+            </div>
+        </form>
+
+        <!-- Results Modal (Hidden by default) -->
+        <div id="resultsModal" class="hidden fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
+            <div class="bg-white rounded-2xl shadow-2xl max-w-2xl w-full max-h-[90vh] overflow-y-auto">
+                <div class="bg-gradient-to-r from-blue-600 to-blue-700 text-white p-6 rounded-t-2xl">
+                    <h3 class="text-2xl font-bold text-center">نتایج پرسشنامه انگیزش تحصیلی</h3>
+                </div>
+                <div class="p-6">
+                    <div id="resultsContent" class="space-y-4"></div>
+                    
+                    <div class="mt-6 bg-blue-50 border-2 border-blue-300 rounded-xl p-4">
+                        <p class="text-center text-blue-900 font-semibold mb-2">نمره کل شما:</p>
+                        <p id="totalScore" class="text-4xl font-bold text-center text-blue-700"></p>
+                        <p id="interpretation" class="text-center text-gray-700 mt-2"></p>
+                    </div>
+
+                    <div class="mt-6 flex gap-4">
+                        <button onclick="saveAndReturn()" class="flex-1 bg-blue-600 text-white py-3 rounded-xl font-semibold hover:bg-blue-700 transition-colors flex items-center justify-center gap-2">
+                            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7H5a2 2 0 00-2 2v9a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-3m-1 4l-3 3m0 0l-3-3m3 3V4"/>
+                            </svg>
+                            ذخیره و بازگشت
+                        </button>
+                        <button onclick="closeResults()" class="flex-1 bg-gray-600 text-white py-3 rounded-xl font-semibold hover:bg-gray-700 transition-colors">
+                            بستن
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        const questions = {
+            A: [
+                "گاهی نمی‌دانم چرا باید برای درس خواندن تلاش کنم.",
+                "احساس می‌کنم درس خواندن برایم فایده‌ای ندارد.",
+                "بعضی وقت‌ها فکر می‌کنم ادامه دادن درس هیچ هدف مشخصی برایم ندارد.",
+                "وقتی درس می‌خوانم، نمی‌دانم برای چه چیزی زحمت می‌کشم."
+            ],
+            B: [
+                "برای اینکه والدین یا معلمانم از من ناراحت نشوند، درس می‌خوانم.",
+                "بیشتر برای گرفتن نمره خوب تلاش می‌کنم، نه چیز دیگر.",
+                "درس می‌خوانم چون از پیامدهای منفی نمره پایین می‌ترسم.",
+                "پیشرفت تحصیلی‌ام برایم مهم است چون دیگران از من انتظار دارند."
+            ],
+            C: [
+                "وقتی درس نمی‌خوانم احساس گناه می‌کنم.",
+                "درس خواندن باعث می‌شود حس بهتری نسبت به خودم داشته باشم.",
+                "اگر برای امتحان آماده نباشم، از خودم ناراحت می‌شوم.",
+                "بعضی وقت‌ها برای اینکه احساس ارزشمندی کنم، بیشتر درس می‌خوانم."
+            ],
+            D: [
+                "درس خواندن برایم مهم است چون می‌دانم در آینده به من کمک می‌کند.",
+                "یادگیری مطالب مدرسه را ارزشمند می‌دانم.",
+                "موفقیت در درس را بخشی از پیشرفت شخصی خودم می‌دانم.",
+                "برای این درس می‌خوانم که به هدف‌های آینده‌ام نزدیک‌تر شوم."
+            ],
+            E: [
+                "از یادگرفتن مطالب جدید لذت می‌برم.",
+                "وقتی چیزی را واقعاً یاد می‌گیرم، احساس رضایت می‌کنم.",
+                "فهمیدن موضوعات سخت برایم هیجان‌انگیز است.",
+                "دوست دارم درباره درس‌ها بیشتر بدانم، حتی خارج از کلاس."
+            ],
+            F: [
+                "حل کردن یک مسئله سخت به من حس موفقیت می‌دهد.",
+                "وقتی یک تکلیف را عالی انجام می‌دهم، احساس افتخار می‌کنم.",
+                "دوست دارم در درس‌ها عملکردی بالاتر از حد معمول داشته باشم.",
+                "تلاش می‌کنم چون می‌خواهم توانایی‌هایم را نشان بدهم."
+            ],
+            G: [
+                "بعضی درس‌ها برایم هیجان‌انگیز و جذاب هستند.",
+                "یادگیری برایم لذت‌بخش است، حتی وقتی سخت باشد.",
+                "وقتی در فعالیت‌های آموزشی مشارکت می‌کنم، احساس انرژی و شادی می‌کنم.",
+                "تجربه کردن روش‌های جدید یادگیری برایم جالب و هیجان‌آور است."
+            ]
+        };
+
+        const sectionNames = {
+            A: "بی‌انگیزشی",
+            B: "تنظیم بیرونی",
+            C: "درون‌فکنی‌شده",
+            D: "همانندسازی‌شده",
+            E: "کسب دانش",
+            F: "کسب موفقیت",
+            G: "تجربه هیجان"
+        };
+
+        let questionNumber = 1;
+
+        function createQuestion(text, section, index) {
+            const container = document.getElementById(`section${section}`);
+            const questionDiv = document.createElement('div');
+            questionDiv.className = 'question-card bg-white p-6 rounded-xl shadow-md border border-gray-200';
+            
+            let html = `
+                <div class="mb-4">
+                    <p class="font-semibold text-gray-800 text-lg">
+                        <span class="inline-block bg-blue-600 text-white w-8 h-8 rounded-full text-center leading-8 ml-2">${questionNumber}</span>
+                        ${text}
+                    </p>
+                </div>
+                <div class="grid grid-cols-7 gap-2">
+            `;
+            
+            for (let i = 1; i <= 7; i++) {
+                html += `
+                    <div class="scale-option">
+                        <input type="radio" id="q${questionNumber}_${i}" name="q${questionNumber}" value="${i}" class="hidden" onchange="updateProgress()">
+                        <label for="q${questionNumber}_${i}" class="block text-center py-3 px-2 rounded-lg border-2 border-gray-300 cursor-pointer hover:border-blue-400 transition-all">
+                            <div class="font-bold text-gray-700">${i}</div>
+                        </label>
+                    </div>
+                `;
+            }
+            
+            html += '</div>';
+            questionDiv.innerHTML = html;
+            container.appendChild(questionDiv);
+            questionNumber++;
+        }
+
+        function initializeQuestions() {
+            Object.keys(questions).forEach(section => {
+                questions[section].forEach((question, index) => {
+                    createQuestion(question, section, index);
+                });
+            });
+        }
+
+        function updateProgress() {
+            const totalQuestions = 28;
+            const answeredQuestions = document.querySelectorAll('input[type="radio"]:checked').length;
+            const percentage = (answeredQuestions / totalQuestions) * 100;
+            
+            document.getElementById('progressBar').style.width = percentage + '%';
+            document.getElementById('progressText').textContent = `${answeredQuestions} از ${totalQuestions} سؤال پاسخ داده شده`;
+        }
+
+        function calculateResults() {
+            const results = {};
+            let totalScore = 0;
+            let currentQ = 1;
+
+            Object.keys(questions).forEach(section => {
+                let sectionScore = 0;
+                for (let i = 0; i < 4; i++) {
+                    const answer = document.querySelector(`input[name="q${currentQ}"]:checked`);
+                    if (answer) {
+                        sectionScore += parseInt(answer.value);
+                    }
+                    currentQ++;
+                }
+                results[section] = sectionScore;
+                totalScore += sectionScore;
+            });
+
+            return { sections: results, total: totalScore };
+        }
+
+        function displayResults(results) {
+            const content = document.getElementById('resultsContent');
+            content.innerHTML = '';
+
+            Object.keys(results.sections).forEach(section => {
+                const score = results.sections[section];
+                const div = document.createElement('div');
+                div.className = 'bg-gray-50 p-4 rounded-lg border border-gray-200';
+                div.innerHTML = `
+                    <div class="flex justify-between items-center">
+                        <span class="font-semibold text-gray-800">${sectionNames[section]}</span>
+                        <span class="text-2xl font-bold text-blue-600">${score}/28</span>
+                    </div>
+                `;
+                content.appendChild(div);
+            });
+
+            document.getElementById('totalScore').textContent = `${results.total}/196`;
+            
+            let interpretation = '';
+            if (results.total <= 70) {
+                interpretation = '📉 انگیزش تحصیلی پایین - توصیه می‌شود با مشاور تحصیلی صحبت کنید';
+            } else if (results.total <= 140) {
+                interpretation = '📊 انگیزش تحصیلی متوسط - در مسیر مناسبی هستید';
+            } else {
+                interpretation = '📈 انگیزش تحصیلی بالا - عالی! انگیزه قوی برای یادگیری دارید';
+            }
+            document.getElementById('interpretation').textContent = interpretation;
+
+            document.getElementById('resultsModal').classList.remove('hidden');
+        }
+
+        function saveAndReturn() {
+            const totalText = document.getElementById('totalScore').textContent;
+            const scoreOnly = totalText.split('/')[0].trim();
+            
+            sessionStorage.setItem('amsScore', scoreOnly);
+            window.location.href = 'student-dashboard.html';
+        }
+
+        function closeResults() {
+            document.getElementById('resultsModal').classList.add('hidden');
+        }
+
+        function goBack() {
+            window.location.href = 'student-dashboard.html';
+        }
+
+        document.getElementById('amsForm').addEventListener('submit', function(e) {
+            e.preventDefault();
+            
+            const answeredQuestions = document.querySelectorAll('input[type="radio"]:checked').length;
+            if (answeredQuestions < 28) {
+                alert(`لطفاً به همه سؤالات پاسخ دهید. شما ${answeredQuestions} از 28 سؤال را پاسخ داده‌اید.`);
+                return;
+            }
+
+            const results = calculateResults();
+            displayResults(results);
+        });
+
+        window.onload = initializeQuestions;
+    </script>
+</body>
+</html>

backend/static/pages/cooperative-questionnaire.html

@@ -0,0 +1,401 @@
+<!DOCTYPE html>
+<html lang="fa" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>پرسشنامه یادگیری مشارکتی - سیستم گروه‌بندی</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Vazirmatn', system-ui, -apple-system, sans-serif;
+        }
+        .question-card {
+            transition: all 0.3s ease;
+        }
+        .question-card:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
+        }
+        .scale-option {
+            transition: all 0.2s ease;
+        }
+        .scale-option:hover {
+            transform: scale(1.05);
+        }
+        .scale-option input:checked + label {
+            background: linear-gradient(135deg, #10b981 0%, #059669 100%);
+            color: white;
+            font-weight: 600;
+        }
+    </style>
+    <script>
+        tailwind.config = {
+            theme: {
+                extend: {
+                    fontFamily: {
+                        vazir: ['Vazirmatn', 'sans-serif']
+                    }
+                }
+            }
+        }
+    </script>
+</head>
+<body class="font-vazir bg-gray-50 min-h-screen">
+    <!-- Top Navigation Bar -->
+    <nav style="background-color: #1b6e6e;" class="shadow-lg border-b border-gray-200 sticky top-0 z-50">
+        <div class="max-w-7xl mx-auto px-4">
+            <div class="flex items-center justify-between h-16">
+                <div class="flex items-center gap-3">
+                    <div class="bg-white/20 w-10 h-10 rounded-lg flex items-center justify-center">
+                        <svg class="w-6 h-6 text-white" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M10.394 2.08a1 1 0 00-.788 0l-7 3a1 1 0 000 1.84L5.25 8.051a.999.999 0 01.356-.257l4-1.714a1 1 0 11.788 1.838L7.667 9.088l1.94.831a1 1 0 00.787 0l7-3a1 1 0 000-1.838l-7-3zM3.31 9.397L5 10.12v4.102a8.969 8.969 0 00-1.05-.174 1 1 0 01-.89-.89 11.115 11.115 0 01.25-3.762zM9.3 16.573A9.026 9.026 0 007 14.935v-3.957l1.818.78a3 3 0 002.364 0l5.508-2.361a11.026 11.026 0 01.25 3.762 1 1 0 01-.89.89 8.968 8.968 0 00-5.35 2.524 1 1 0 01-1.4 0zM6 18a1 1 0 001-1v-2.065a8.935 8.935 0 00-2-.712V17a1 1 0 001 1z"/>
+                        </svg>
+                    </div>
+                    <div>
+                        <h1 class="text-xl font-bold text-white">TalimBot</h1>
+                        <p class="text-xs text-white/80">پرسشنامه یادگیری مشارکتی</p>
+                    </div>
+                </div>
+                <button onclick="goBack()" class="bg-white text-teal-700 px-4 py-2 rounded-lg font-semibold hover:bg-teal-50 transition-colors flex items-center gap-2">
+                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18"/>
+                    </svg>
+                    بازگشت به داشبورد
+                </button>
+            </div>
+        </div>
+    </nav>
+
+    <!-- Main Content -->
+    <div class="max-w-5xl mx-auto px-4 py-8">
+        <!-- Header -->
+        <div class="bg-white rounded-2xl shadow-lg p-8 mb-8">
+            <h2 class="text-3xl font-bold text-gray-900 mb-4 text-center">پرسشنامه یادگیری مشارکتی</h2>
+            <p class="text-gray-600 text-center mb-2">بر اساس مدل جانسون و جانسون، ۱۹۹۴</p>
+            <p class="text-gray-600 text-center mb-6">لطفاً میزان موافقت خود را با هر جمله مشخص کنید</p>
+            
+            <!-- Progress Bar -->
+            <div class="bg-gray-200 rounded-full h-3 mb-4">
+                <div id="progressBar" class="bg-gradient-to-r from-green-500 to-green-600 h-3 rounded-full transition-all duration-300" style="width: 0%"></div>
+            </div>
+            <p class="text-center text-sm text-gray-600">
+                <span id="progressText">0 از 25 سؤال پاسخ داده شده</span>
+            </p>
+        </div>
+
+        <!-- Scale Legend -->
+        <div class="bg-green-50 border-2 border-green-200 rounded-xl p-6 mb-8">
+            <h3 class="font-bold text-green-900 mb-4 text-center">مقیاس پاسخ‌دهی:</h3>
+            <div class="grid grid-cols-2 md:grid-cols-5 gap-2 text-sm">
+                <div class="bg-white p-3 rounded text-center border border-green-200">
+                    <div class="font-bold text-green-900">1</div>
+                    <div class="text-xs text-gray-600">کاملاً مخالفم</div>
+                </div>
+                <div class="bg-white p-3 rounded text-center border border-green-200">
+                    <div class="font-bold text-green-900">2</div>
+                    <div class="text-xs text-gray-600">مخالفم</div>
+                </div>
+                <div class="bg-white p-3 rounded text-center border border-green-200">
+                    <div class="font-bold text-green-900">3</div>
+                    <div class="text-xs text-gray-600">نظری ندارم</div>
+                </div>
+                <div class="bg-white p-3 rounded text-center border border-green-200">
+                    <div class="font-bold text-green-900">4</div>
+                    <div class="text-xs text-gray-600">موافقم</div>
+                </div>
+                <div class="bg-white p-3 rounded text-center border border-green-200">
+                    <div class="font-bold text-green-900">5</div>
+                    <div class="text-xs text-gray-600">کاملاً موافقم</div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Questions -->
+        <form id="cooperativeForm">
+            <!-- Section 1: وابستگی متقابل مثبت -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-blue-50 to-indigo-50 p-4 rounded-xl border-r-4 border-blue-500">
+                    <svg class="w-6 h-6 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z"/>
+                    </svg>
+                    بخش اول: وابستگی متقابل مثبت
+                </h3>
+                <div class="space-y-4" id="section1"></div>
+            </div>
+
+            <!-- Section 2: پاسخگویی فردی -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-green-50 to-emerald-50 p-4 rounded-xl border-r-4 border-green-500">
+                    <svg class="w-6 h-6 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    بخش دوم: پاسخگویی فردی
+                </h3>
+                <div class="space-y-4" id="section2"></div>
+            </div>
+
+            <!-- Section 3: تعامل چهره‌به‌چهره -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-yellow-50 to-amber-50 p-4 rounded-xl border-r-4 border-yellow-500">
+                    <svg class="w-6 h-6 text-yellow-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z"/>
+                    </svg>
+                    بخش سوم: تعامل چهره‌به‌چهره / ارتقای متقابل
+                </h3>
+                <div class="space-y-4" id="section3"></div>
+            </div>
+
+            <!-- Section 4: مهارت‌های اجتماعی -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-purple-50 to-pink-50 p-4 rounded-xl border-r-4 border-purple-500">
+                    <svg class="w-6 h-6 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197M13 7a4 4 0 11-8 0 4 4 0 018 0z"/>
+                    </svg>
+                    بخش چهارم: مهارت‌های اجتماعی
+                </h3>
+                <div class="space-y-4" id="section4"></div>
+            </div>
+
+            <!-- Section 5: پردازش گروهی -->
+            <div class="mb-8">
+                <h3 class="text-xl font-bold text-gray-800 mb-4 flex items-center gap-2 bg-gradient-to-r from-teal-50 to-cyan-50 p-4 rounded-xl border-r-4 border-teal-500">
+                    <svg class="w-6 h-6 text-teal-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"/>
+                    </svg>
+                    بخش پنجم: پردازش گروهی / بازاندیشی در عملکرد گروه
+                </h3>
+                <div class="space-y-4" id="section5"></div>
+            </div>
+
+            <!-- Submit Button -->
+            <div class="flex justify-center">
+                <button type="submit" class="bg-gradient-to-r from-green-600 to-green-700 text-white px-12 py-4 rounded-xl font-bold text-lg hover:from-green-700 hover:to-green-800 shadow-lg hover:shadow-xl transform hover:scale-105 transition-all flex items-center gap-3">
+                    <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    محاسبه نتیجه
+                </button>
+            </div>
+        </form>
+
+        <!-- Results Modal (Hidden by default) -->
+        <div id="resultsModal" class="hidden fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
+            <div class="bg-white rounded-2xl shadow-2xl max-w-2xl w-full max-h-[90vh] overflow-y-auto">
+                <div class="bg-gradient-to-r from-green-600 to-green-700 text-white p-6 rounded-t-2xl">
+                    <h3 class="text-2xl font-bold text-center">نتایج پرسشنامه یادگیری مشارکتی</h3>
+                </div>
+                <div class="p-6">
+                    <div id="resultsContent" class="space-y-4"></div>
+                    
+                    <div class="mt-6 bg-green-50 border-2 border-green-300 rounded-xl p-4">
+                        <p class="text-center text-green-900 font-semibold mb-2">نمره کل شما:</p>
+                        <p id="totalScore" class="text-4xl font-bold text-center text-green-700"></p>
+                        <p id="interpretation" class="text-center text-gray-700 mt-2"></p>
+                    </div>
+
+                    <div class="mt-6 flex gap-4">
+                        <button onclick="saveAndReturn()" class="flex-1 bg-green-600 text-white py-3 rounded-xl font-semibold hover:bg-green-700 transition-colors flex items-center justify-center gap-2">
+                            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7H5a2 2 0 00-2 2v9a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-3m-1 4l-3 3m0 0l-3-3m3 3V4"/>
+                            </svg>
+                            ذخیره و بازگشت
+                        </button>
+                        <button onclick="closeResults()" class="flex-1 bg-gray-600 text-white py-3 rounded-xl font-semibold hover:bg-gray-700 transition-colors">
+                            بستن
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        const questions = {
+            section1: [
+                "موفقیت من در فعالیت‌های این درس به همکاری اعضای گروه بستگی دارد.",
+                "اگر یکی از اعضای گروه کار خود را انجام ندهد، عملکرد کل گروه تحت تأثیر قرار می‌گیرد.",
+                "اعضای گروه برای رسیدن به هدف مشترک احساس مسئولیت مشترک دارند.",
+                "در فعالیت‌های گروهی، پیشرفت هر عضو به پیشرفت گروه کمک می‌کند.",
+                "هدف‌های گروه طوری طراحی شده‌اند که بدون همکاری، دستیابی به آن‌ها دشوار است."
+            ],
+            section2: [
+                "هر عضو گروه مسئول بخش مشخصی از کار است.",
+                "عملکرد من در گروه به‌طور جداگانه نیز مورد ارزیابی قرار می‌گیرد.",
+                "من باید وظیفه خودم را به‌خوبی انجام دهم تا گروه موفق شود.",
+                "همه اعضا می‌دانند که سهم هر فرد چه تأثیری بر نتیجه نهایی دارد.",
+                "هر فرد در گروه باید بتواند بخش مربوط به خود را توضیح دهد."
+            ],
+            section3: [
+                "اعضای گروه در کلاس به‌طور مستقیم با یکدیگر گفت‌وگو می‌کنند.",
+                "هنگام انجام فعالیت‌های گروهی، اعضا به یکدیگر کمک می‌کنند تا بهتر یاد بگیرند.",
+                "در گروه، توضیح دادن مطالب به یکدیگر امری معمول است.",
+                "اعضای گروه به یکدیگر بازخورد سازنده می‌دهند.",
+                "در فعالیت‌های گروهی، فرصت کافی برای تبادل نظر وجود دارد."
+            ],
+            section4: [
+                "اعضای گروه با احترام به نوبت یکدیگر صحبت می‌کنند.",
+                "اعضا برای حل اختلاف‌ها از گفت‌وگو و مذاکره استفاده می‌کنند.",
+                "اعضای گروه به یکدیگر گوش می‌دهند و صحبت‌های هم‌گروهی‌ها را قطع نمی‌کنند.",
+                "مدیریت زمان و تقسیم وظایف به شکل مؤثر انجام می‌شود.",
+                "اعضای گروه در تعاملات خود ادب و احترام را رعایت می‌کنند."
+            ],
+            section5: [
+                "در پایان فعالیت‌ها، گروه درباره نقاط قوت خود بحث می‌کند.",
+                "گروه به‌طور منظم درباره این‌که چگونه می‌توانند همکاری بهتری داشته باشند، بازاندیشی می‌کند.",
+                "اعضا درباره مشکلات گروه و راه‌حل‌های ممکن با هم صحبت می‌کنند.",
+                "گروه پس از هر فعالیت، ارزیابی کوتاهی از نحوه عملکرد خود انجام می‌دهد.",
+                "اعضای گروه در مورد بهبود عملکرد آینده تصمیم‌گیری مشترک می‌کنند."
+            ]
+        };
+
+        const sectionNames = {
+            section1: "وابستگی متقابل مثبت",
+            section2: "پاسخگویی فردی",
+            section3: "تعامل چهره‌به‌چهره",
+            section4: "مهارت‌های اجتماعی",
+            section5: "پردازش گروهی"
+        };
+
+        let questionNumber = 1;
+
+        function createQuestion(text, section, index) {
+            const container = document.getElementById(section);
+            const questionDiv = document.createElement('div');
+            questionDiv.className = 'question-card bg-white p-6 rounded-xl shadow-md border border-gray-200';
+            
+            let html = `
+                <div class="mb-4">
+                    <p class="font-semibold text-gray-800 text-lg">
+                        <span class="inline-block bg-green-600 text-white w-8 h-8 rounded-full text-center leading-8 ml-2">${questionNumber}</span>
+                        ${text}
+                    </p>
+                </div>
+                <div class="grid grid-cols-5 gap-2">
+            `;
+            
+            const scaleLabels = ['کاملاً مخالفم', 'مخالفم', 'نظری ندارم', 'موافقم', 'کاملاً موافقم'];
+            
+            for (let i = 1; i <= 5; i++) {
+                html += `
+                    <div class="scale-option">
+                        <input type="radio" id="q${questionNumber}_${i}" name="q${questionNumber}" value="${i}" class="hidden" onchange="updateProgress()">
+                        <label for="q${questionNumber}_${i}" class="block text-center py-3 px-2 rounded-lg border-2 border-gray-300 cursor-pointer hover:border-green-400 transition-all">
+                            <div class="font-bold text-gray-700">${i}</div>
+                            <div class="text-xs text-gray-500 mt-1">${scaleLabels[i-1]}</div>
+                        </label>
+                    </div>
+                `;
+            }
+            
+            html += '</div>';
+            questionDiv.innerHTML = html;
+            container.appendChild(questionDiv);
+            questionNumber++;
+        }
+
+        function initializeQuestions() {
+            Object.keys(questions).forEach(section => {
+                questions[section].forEach((question, index) => {
+                    createQuestion(question, section, index);
+                });
+            });
+        }
+
+        function updateProgress() {
+            const totalQuestions = 25;
+            const answeredQuestions = document.querySelectorAll('input[type="radio"]:checked').length;
+            const percentage = (answeredQuestions / totalQuestions) * 100;
+            
+            document.getElementById('progressBar').style.width = percentage + '%';
+            document.getElementById('progressText').textContent = `${answeredQuestions} از ${totalQuestions} سؤال پاسخ داده شده`;
+        }
+
+        function calculateResults() {
+            const results = {};
+            let totalScore = 0;
+            let currentQ = 1;
+
+            Object.keys(questions).forEach(section => {
+                let sectionScore = 0;
+                for (let i = 0; i < 5; i++) {
+                    const answer = document.querySelector(`input[name="q${currentQ}"]:checked`);
+                    if (answer) {
+                        sectionScore += parseInt(answer.value);
+                    }
+                    currentQ++;
+                }
+                results[section] = sectionScore;
+                totalScore += sectionScore;
+            });
+
+            return { sections: results, total: totalScore };
+        }
+
+        function displayResults(results) {
+            const content = document.getElementById('resultsContent');
+            content.innerHTML = '';
+
+            Object.keys(results.sections).forEach(section => {
+                const score = results.sections[section];
+                const div = document.createElement('div');
+                div.className = 'bg-gray-50 p-4 rounded-lg border border-gray-200';
+                div.innerHTML = `
+                    <div class="flex justify-between items-center">
+                        <span class="font-semibold text-gray-800">${sectionNames[section]}</span>
+                        <span class="text-2xl font-bold text-green-600">${score}/25</span>
+                    </div>
+                `;
+                content.appendChild(div);
+            });
+
+            document.getElementById('totalScore').textContent = `${results.total}/125`;
+            
+            let interpretation = '';
+            if (results.total <= 50) {
+                interpretation = '📉 یادگیری مشارکتی کم - نیاز به توسعه مهارت‌های کار گروهی';
+            } else if (results.total <= 88) {
+                interpretation = '📊 یادگیری مشارکتی متوسط - در مسیر خوبی هستید';
+            } else {
+                interpretation = '📈 یادگیری مشارکتی زیاد - عالی! مهارت‌های همکاری قوی دارید';
+            }
+            document.getElementById('interpretation').textContent = interpretation;
+
+            document.getElementById('resultsModal').classList.remove('hidden');
+        }
+
+        function saveAndReturn() {
+            const totalText = document.getElementById('totalScore').textContent;
+            const scoreOnly = totalText.split('/')[0].trim();
+            
+            sessionStorage.setItem('cooperativeScore', scoreOnly);
+            window.location.href = 'student-dashboard.html';
+        }
+
+        function closeResults() {
+            document.getElementById('resultsModal').classList.add('hidden');
+        }
+
+        function goBack() {
+            window.location.href = 'student-dashboard.html';
+        }
+
+        document.getElementById('cooperativeForm').addEventListener('submit', function(e) {
+            e.preventDefault();
+            
+            const answeredQuestions = document.querySelectorAll('input[type="radio"]:checked').length;
+            if (answeredQuestions < 25) {
+                alert(`لطفاً به همه سؤالات پاسخ دهید. شما ${answeredQuestions} از 25 سؤال را پاسخ داده‌اید.`);
+                return;
+            }
+
+            const results = calculateResults();
+            displayResults(results);
+        });
+
+        window.onload = initializeQuestions;
+    </script>
+</body>
+</html>

backend/static/pages/group-view.html

@@ -0,0 +1,405 @@
+<!DOCTYPE html>
+<html lang="fa" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>گروه من - سیستم گروه‌بندی</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Vazirmatn', system-ui, -apple-system, sans-serif;
+        }
+    </style>
+    <script>
+        tailwind.config = {
+            theme: {
+                extend: {
+                    fontFamily: {
+                        'vazir': ['Vazirmatn', 'system-ui', '-apple-system', 'sans-serif'],
+                    }
+                }
+            }
+        }
+    </script>
+</head>
+<body class="font-vazir bg-gray-50 min-h-screen">
+    <!-- Top Navigation Bar -->
+    <nav style="background-color: #1b6e6e;" class="shadow-lg border-b border-gray-200 sticky top-0 z-50">
+        <div class="max-w-7xl mx-auto px-4">
+            <div class="flex items-center justify-between h-16">
+                <!-- Logo/Brand -->
+                <div class="flex items-center gap-3">
+                    <div class="bg-white/20 w-10 h-10 rounded-lg flex items-center justify-center">
+                        <svg class="w-6 h-6 text-white" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M10.394 2.08a1 1 0 00-.788 0l-7 3a1 1 0 000 1.84L5.25 8.051a.999.999 0 01.356-.257l4-1.714a1 1 0 11.788 1.838L7.667 9.088l1.94.831a1 1 0 00.787 0l7-3a1 1 0 000-1.838l-7-3zM3.31 9.397L5 10.12v4.102a8.969 8.969 0 00-1.05-.174 1 1 0 01-.89-.89 11.115 11.115 0 01.25-3.762zM9.3 16.573A9.026 9.026 0 007 14.935v-3.957l1.818.78a3 3 0 002.364 0l5.508-2.361a11.026 11.026 0 01.25 3.762 1 1 0 01-.89.89 8.968 8.968 0 00-5.35 2.524 1 1 0 01-1.4 0zM6 18a1 1 0 001-1v-2.065a8.935 8.935 0 00-2-.712V17a1 1 0 001 1z"/>
+                        </svg>
+                    </div>
+                    <div>
+                        <h1 class="text-xl font-bold text-white">TalimBot</h1>
+                        <p class="text-xs text-white/80">سیستم گروه‌بندی هوشمند</p>
+                    </div>
+                </div>
+
+                <!-- Navigation Links -->
+                <div class="hidden md:flex items-center gap-1">
+                    <a href="student-dashboard.html" class="px-4 py-2 text-white/80 hover:text-white hover:bg-white/10 rounded-lg font-medium transition-colors">
+                        <span class="flex items-center gap-2">
+                            <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                                <path d="M10.707 2.293a1 1 0 00-1.414 0l-7 7a1 1 0 001.414 1.414L4 10.414V17a1 1 0 001 1h2a1 1 0 001-1v-2a1 1 0 011-1h2a1 1 0 011 1v2a1 1 0 001 1h2a1 1 0 001-1v-6.586l.293.293a1 1 0 001.414-1.414l-7-7z"/>
+                            </svg>
+                            داشبورد
+                        </span>
+                    </a>
+                    <a href="#" class="px-4 py-2 text-white bg-white/20 rounded-lg font-semibold border-b-2 border-white">
+                        <span class="flex items-center gap-2">
+                            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197M13 7a4 4 0 11-8 0 4 4 0 018 0z"/>
+                            </svg>
+                            گروه من
+                        </span>
+                    </a>
+                </div>
+
+                <!-- User Menu -->
+                <div class="flex items-center gap-4">
+                    <div class="hidden md:block text-left">
+                        <p class="text-sm font-semibold text-white" id="navStudentName">دانش آموز</p>
+                        <p class="text-xs text-white/80" id="navStudentNumber">-</p>
+                    </div>
+                    <div class="w-10 h-10 rounded-full bg-white/20 flex items-center justify-center text-white font-bold">
+                        <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M10 9a3 3 0 100-6 3 3 0 000 6zm-7 9a7 7 0 1114 0H3z" clip-rule="evenodd"/>
+                        </svg>
+                    </div>
+                    <a href="login.html" class="text-white/80 hover:text-red-300 transition-colors" title="خروج">
+                        <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 16l4-4m0 0l-4-4m4 4H7m6 4v1a3 3 0 01-3 3H6a3 3 0 01-3-3V7a3 3 0 013-3h4a3 3 0 013 3v1"/>
+                        </svg>
+                    </a>
+                </div>
+            </div>
+        </div>
+    </nav>
+
+    <!-- Main Content -->
+    <div class="max-w-7xl mx-auto px-4 py-8">
+        <!-- Page Header -->
+        <div class="mb-8 flex items-center gap-3">
+            <svg class="w-10 h-10 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z"/>
+            </svg>
+            <div>
+                <h2 class="text-3xl font-bold text-gray-900">گروه مطالعاتی شما</h2>
+                <p class="text-gray-600" id="headerSubtext">مشاهده اعضای گروه و اطلاعات همکاران</p>
+            </div>
+        </div>
+
+
+        <!-- Loading State -->
+        <div id="loadingState" class="hidden">
+            <div class="bg-white rounded-xl shadow-md p-12 text-center">
+                <div class="inline-block w-16 h-16 border-4 border-blue-600 border-t-transparent rounded-full animate-spin mb-4"></div>
+                <p class="text-gray-600 font-semibold">در حال بارگذاری اطلاعات گروه...</p>
+            </div>
+        </div>
+
+        <!-- Not Grouped State -->
+        <div id="notGroupedState" class="hidden">
+            <div class="bg-white rounded-xl shadow-md p-12">
+                <div class="text-center mb-8">
+                    <svg class="w-24 h-24 mx-auto mb-4 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    <h3 class="text-2xl font-bold text-gray-900 mb-3" id="notGroupedTitle">گروه‌بندی هنوز انجام نشده است</h3>
+                    <p class="text-gray-600 mb-2" id="notGroupedMessage">معلم هنوز فرآیند گروه‌بندی را تکمیل نکرده است.</p>
+                    <p class="text-gray-500">لطفاً بعداً دوباره بررسی کنید یا با معلم خود تماس بگیرید.</p>
+                </div>
+                <div class="flex gap-4 justify-center">
+                    <button onclick="window.location.href='student-dashboard.html'" 
+                            class="bg-gray-600 hover:bg-gray-700 text-white py-3 px-6 rounded-lg font-semibold transition-colors">
+                        بازگشت به داشبورد
+                    </button>
+                    <button onclick="window.location.reload()" 
+                            class="bg-blue-600 hover:bg-blue-700 text-white py-3 px-6 rounded-lg font-semibold transition-colors">
+                        بروزرسانی صفحه
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Grouped State -->
+        <div id="groupedState" class="hidden space-y-6">
+            <!-- Course Info -->
+            <div id="courseInfo" class="bg-blue-50 border-r-4 border-blue-500 rounded-lg p-4 flex items-center gap-2">
+                <svg class="w-6 h-6 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253"/>
+                </svg>
+                <p class="text-blue-800 font-semibold"><strong>درس:</strong> <span id="courseName">-</span></p>
+            </div>
+
+            <!-- Group Info & My Profile -->
+            <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+                <!-- Group Number Card -->
+                <div class="bg-white rounded-xl shadow-md p-6">
+                    <div class="flex items-center gap-2 mb-4">
+                        <svg class="w-7 h-7 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4M7.835 4.697a3.42 3.42 0 001.946-.806 3.42 3.42 0 014.438 0 3.42 3.42 0 001.946.806 3.42 3.42 0 013.138 3.138 3.42 3.42 0 00.806 1.946 3.42 3.42 0 010 4.438 3.42 3.42 0 00-.806 1.946 3.42 3.42 0 01-3.138 3.138 3.42 3.42 0 00-1.946.806 3.42 3.42 0 01-4.438 0 3.42 3.42 0 00-1.946-.806 3.42 3.42 0 01-3.138-3.138 3.42 3.42 0 00-.806-1.946 3.42 3.42 0 010-4.438 3.42 3.42 0 00.806-1.946 3.42 3.42 0 013.138-3.138z"/>
+                        </svg>
+                        <h3 class="text-xl font-bold text-gray-900">گروه <span id="groupNumber">-</span></h3>
+                    </div>
+                    <div class="grid grid-cols-2 gap-4">
+                        <div class="bg-blue-50 rounded-lg p-4 text-center">
+                            <p class="text-gray-600 text-sm mb-1">تعداد اعضا</p>
+                            <p class="text-3xl font-bold text-blue-600" id="memberCount">-</p>
+                        </div>
+                        <div class="bg-green-50 rounded-lg p-4 text-center">
+                            <p class="text-gray-600 text-sm mb-1">وضعیت گروه</p>
+                            <p class="text-lg font-bold text-green-600">فعال</p>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- My Profile Card -->
+                <div class="bg-white rounded-xl shadow-md p-6">
+                    <div class="flex items-center gap-2 mb-4">
+                        <svg class="w-7 h-7 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"/>
+                        </svg>
+                        <h3 class="text-xl font-bold text-gray-900">پروفایل من در گروه</h3>
+                    </div>
+                    <div class="space-y-3">
+                        <div class="flex justify-between items-center py-2 border-b border-gray-200">
+                            <span class="text-gray-600 font-medium">نوع شخصیت MBTI</span>
+                            <span class="text-gray-900 font-bold" id="myMbti">-</span>
+                        </div>
+                        <div class="flex justify-between items-center py-2 border-b border-gray-200">
+                            <span class="text-gray-600 font-medium">سبک یادگیری</span>
+                            <span class="text-gray-900 font-bold" id="myLearningStyle">-</span>
+                        </div>
+                        <div class="flex justify-between items-center py-2">
+                            <span class="text-gray-600 font-medium">نمره</span>
+                            <span class="text-gray-900 font-bold" id="myGrade">-</span>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Group Members Card -->
+            <div class="bg-white rounded-xl shadow-md p-6">
+                <div class="flex items-center gap-2 mb-4">
+                    <svg class="w-7 h-7 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z"/>
+                    </svg>
+                    <h3 class="text-xl font-bold text-gray-900">اعضای گروه</h3>
+                </div>
+                <div class="space-y-3" id="groupMembersList">
+                    <!-- Populated by JS -->
+                </div>
+            </div>
+
+            <!-- Action Buttons -->
+            <div class="flex gap-4">
+                <button onclick="window.location.href='student-dashboard.html'" 
+                        class="flex-1 bg-gray-600 hover:bg-gray-700 text-white py-4 px-6 rounded-xl font-bold text-lg transition-colors">
+                    بازگشت به داشبورد
+                </button>
+                <button onclick="window.location.reload()" 
+                        class="flex-1 bg-blue-600 hover:bg-blue-700 text-white py-4 px-6 rounded-xl font-bold text-lg transition-colors flex items-center justify-center gap-2">
+                    <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"/>
+                    </svg>
+                    بروزرسانی اطلاعات
+                </button>
+            </div>
+        </div>
+
+        <!-- Error State -->
+        <div id="errorState" class="hidden">
+            <div class="bg-white rounded-xl shadow-md p-12">
+                <div class="text-center mb-8">
+                    <svg class="w-24 h-24 mx-auto mb-4 text-red-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
+                    </svg>
+                    <h3 class="text-2xl font-bold text-gray-900 mb-3">خطا در بارگذاری اطلاعات!</h3>
+                    <p class="text-gray-600" id="errorMessage">قادر به بارگذاری اطلاعات گروه نیستیم.</p>
+                </div>
+                <div class="text-center">
+                    <button onclick="window.location.href='student-dashboard.html'" 
+                            class="bg-blue-600 hover:bg-blue-700 text-white py-3 px-6 rounded-lg font-semibold transition-colors">
+                        بازگشت به داشبورد
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- Footer -->
+    <footer class="bg-white border-t border-gray-200 mt-16">
+        <div class="max-w-7xl mx-auto px-4 py-6">
+            <div class="text-center text-gray-600 text-sm">
+                <p>© ۲۰۲۵ TalimBot - سیستم گروه‌بندی هوشمند دانش آموزان</p>
+            </div>
+        </div>
+    </footer>
+
+    <script src="../assets/js/data.js"></script>
+    <script src="../assets/js/grouping.js"></script>
+    <script>
+        let currentStudent = null;
+
+        // Check authentication on page load
+        function checkAuth() {
+            const studentNumber = sessionStorage.getItem('currentStudent');
+            if (!studentNumber) {
+                window.location.href = 'login.html';
+                return null;
+            }
+            return studentNumber;
+        }
+
+        function showState(state) {
+            document.getElementById('loadingState').classList.add('hidden');
+            document.getElementById('notGroupedState').classList.add('hidden');
+            document.getElementById('groupedState').classList.add('hidden');
+            document.getElementById('errorState').classList.add('hidden');
+
+            if (state) {
+                document.getElementById(state).classList.remove('hidden');
+            }
+        }
+
+        async function loadGroupInfo() {
+            showState('loadingState');
+
+            const studentNumber = checkAuth();
+            if (!studentNumber) return;
+
+            try {
+                currentStudent = await getStudent(studentNumber);
+
+                if (!currentStudent) {
+                    showState('errorState');
+                    document.getElementById('errorMessage').textContent = 'دانشجو یافت نشد. لطفاً دوباره وارد شوید.';
+                    return;
+                }
+
+                // Update nav
+                document.getElementById('navStudentName').textContent = currentStudent.name;
+                document.getElementById('navStudentNumber').textContent = currentStudent.studentNumber;
+
+                if (!currentStudent.mbti || !currentStudent.learningStyle) {
+                    showState('errorState');
+                    document.getElementById('errorMessage').textContent = 'لطفاً ابتدا پروفایل خود را در داشبورد تکمیل کنید.';
+                    return;
+                }
+
+                const status = await getGroupingStats();
+
+                if (!status.groupingComplete || !currentStudent.group) {
+                    showState('notGroupedState');
+                    document.getElementById('notGroupedTitle').textContent = 'گروه‌بندی هنوز انجام نشده است';
+                    document.getElementById('notGroupedMessage').textContent = 'معلم هنوز فرآیند گروه‌بندی را تکمیل نکرده است.';
+                    return;
+                }
+
+                // Check if teacher has made results visible
+                if (!status.resultsVisible) {
+                    showState('notGroupedState');
+                    document.getElementById('notGroupedTitle').textContent = 'نتایج گروه‌بندی هنوز نمایش داده نشده';
+                    document.getElementById('notGroupedMessage').textContent = 'معلم گروه‌بندی را انجام داده است اما هنوز آن را برای دانش‌آموزان نمایش نداده است.';
+                    return;
+                }
+
+                await displayGroupInfo();
+            } catch (error) {
+                console.error('Error loading group info:', error);
+                showState('errorState');
+                document.getElementById('errorMessage').textContent = 'خطا در بارگذاری اطلاعات. لطفاً اطمینان حاصل کنید که سرور در حال اجرا است.';
+            }
+        }
+
+        async function displayGroupInfo() {
+            const allStudents = await getAllStudents();
+            const groupMembers = allStudents.filter(s => s.group === currentStudent.group);
+
+            document.getElementById('headerSubtext').textContent = `شما در گروه ${currentStudent.group} قرار دارید`;
+
+            const status = await getGroupingStats();
+            const courseName = status.courseName;
+            if (courseName) {
+                document.getElementById('courseInfo').classList.remove('hidden');
+                document.getElementById('courseName').textContent = courseName;
+            } else {
+                document.getElementById('courseInfo').classList.add('hidden');
+            }
+
+            document.getElementById('groupNumber').textContent = currentStudent.group;
+            document.getElementById('memberCount').textContent = groupMembers.length;
+
+            document.getElementById('myMbti').textContent = currentStudent.mbti || 'تنظیم نشده';
+            document.getElementById('myLearningStyle').textContent = currentStudent.learningStyle || 'تنظیم نشده';
+            document.getElementById('myGrade').textContent = currentStudent.grade.toFixed(2);
+
+            const membersList = document.getElementById('groupMembersList');
+            membersList.innerHTML = '';
+
+            groupMembers.forEach(member => {
+                const div = document.createElement('div');
+                const isMe = member.studentNumber === currentStudent.studentNumber;
+                
+                div.className = `flex items-start gap-4 p-4 rounded-lg border-2 transition-all ${
+                    isMe 
+                        ? 'bg-blue-50 border-blue-500 shadow-md' 
+                        : 'bg-gray-50 border-gray-200 hover:border-blue-300 hover:shadow-sm'
+                }`;
+
+                div.innerHTML = `
+                    <div class="flex-shrink-0">
+                        <div class="w-12 h-12 rounded-full ${isMe ? 'bg-blue-500' : 'bg-gray-400'} flex items-center justify-center text-white">
+                            <svg class="w-7 h-7" fill="currentColor" viewBox="0 0 20 20">
+                                ${isMe 
+                                    ? '<path d="M9.049 2.927c.3-.921 1.603-.921 1.902 0l1.07 3.292a1 1 0 00.95.69h3.462c.969 0 1.371 1.24.588 1.81l-2.8 2.034a1 1 0 00-.364 1.118l1.07 3.292c.3.921-.755 1.688-1.54 1.118l-2.8-2.034a1 1 0 00-1.175 0l-2.8 2.034c-.784.57-1.838-.197-1.539-1.118l1.07-3.292a1 1 0 00-.364-1.118L2.98 8.72c-.783-.57-.38-1.81.588-1.81h3.461a1 1 0 00.951-.69l1.07-3.292z" />'
+                                    : '<path fill-rule="evenodd" d="M10 9a3 3 0 100-6 3 3 0 000 6zm-7 9a7 7 0 1114 0H3z" clip-rule="evenodd"/>'
+                                }
+                            </svg>
+                        </div>
+                    </div>
+                    <div class="flex-1">
+                        <div class="flex items-center gap-2 mb-1">
+                            <h4 class="font-bold text-lg text-gray-900">${member.name}</h4>
+                            ${isMe ? '<span class="bg-blue-500 text-white text-xs px-2 py-1 rounded-full font-semibold">شما</span>' : ''}
+                        </div>
+                        <p class="text-sm text-gray-600 mb-2">${member.studentNumber}</p>
+                        <div class="flex flex-wrap gap-3 text-sm">
+                            <span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>MBTI:</strong> ${member.mbti || 'ندارد'}
+                            </span>
+                            <span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>سبک:</strong> ${member.learningStyle || 'ندارد'}
+                            </span>
+                            ${member.ams ? `<span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>AMS:</strong> ${member.ams}
+                            </span>` : ''}
+                            ${member.cooperative ? `<span class="bg-white px-3 py-1 rounded-lg border border-gray-200">
+                                <strong>همکاری:</strong> ${member.cooperative}
+                            </span>` : ''}
+                        </div>
+                    </div>
+                `;
+
+                membersList.appendChild(div);
+            });
+
+            showState('groupedState');
+        }
+
+        window.onload = () => {
+            setTimeout(loadGroupInfo, 500);
+        };
+    </script>
+</body>
+</html>
+

backend/static/pages/login.html

@@ -0,0 +1,274 @@
+<!DOCTYPE html>
+<html lang="fa" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>ورود - سیستم گروه‌بندی دانش آموزان</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Vazirmatn', system-ui, -apple-system, sans-serif;
+        }
+        /* Hide browser's default password reveal button */
+        input[type="password"]::-ms-reveal,
+        input[type="password"]::-ms-clear {
+            display: none;
+        }
+        input[type="password"]::-webkit-credentials-auto-fill-button,
+        input[type="password"]::-webkit-caps-lock-indicator {
+            display: none;
+        }
+    </style>
+    <script>
+        tailwind.config = {
+            theme: {
+                extend: {
+                    fontFamily: {
+                        'vazir': ['Vazirmatn', 'system-ui', '-apple-system', 'sans-serif'],
+                    }
+                }
+            }
+        }
+    </script>
+</head>
+<body class="font-vazir bg-gray-50">
+    <!-- Split Layout -->
+    <div class="min-h-screen flex flex-col md:flex-row">
+        <!-- Left: Illustration Section -->
+        <div class="bg-gradient-to-br from-teal-600 via-cyan-500 to-blue-500 p-8 md:p-12 flex flex-col items-center justify-center md:w-2/5">
+            <div class="max-w-sm w-full">
+                <!-- Illustration Placeholder -->
+                <div class="bg-white/20 backdrop-blur-sm rounded-3xl p-8 mb-8 shadow-2xl">
+                    <div class="text-center text-white">
+                        <img src="../Icons/logo/logo.png" alt="TalimBot Logo" class="w-32 h-32 mx-auto mb-4 rounded-2xl">
+                        <h2 class="text-2xl font-bold mb-2">سیستم گروه‌بندی هوشمند</h2>
+                        <p class="text-teal-100 text-sm">مدیریت و گروه‌بندی دانش آموزان بر اساس شخصیت و سبک یادگیری</p>
+                    </div>
+                </div>
+                <h1 class="text-4xl font-extrabold text-white text-center drop-shadow-lg">
+                   TalimBot
+                </h1>
+            </div>
+        </div>
+
+        <!-- Right: Form Section -->
+        <div class="bg-white p-6 md:p-12 flex-1 flex items-center justify-center">
+            <div class="w-full max-w-md space-y-8">
+                <!-- Header -->
+                <div class="text-center">
+                    <h2 class="text-3xl font-bold text-gray-900 mb-2">سیستم گروه‌بندی دانش آموزان</h2>
+                    <p class="text-gray-600">لطفاً نقش خود را انتخاب کنید</p>
+                </div>
+
+                <!-- Role Selector -->
+                <!-- Role Selector -->
+                <div class="grid grid-cols-2 gap-4">
+                    <button type="button" id="studentRole" onclick="selectRole('student')" 
+                        class="role-card p-6 border-2 border-gray-200 rounded-2xl hover:border-teal-500 hover:bg-teal-50 transition-all duration-300 group">
+                        <img src="../Icons/studentIcon.png" alt="Student" class="w-24 h-24 mx-auto mb-3 object-cover">
+                        <h3 class="text-lg font-bold text-gray-800 group-hover:text-teal-600">دانش آموز</h3>
+                    </button>
+                    <button type="button" id="teacherRole" onclick="selectRole('teacher')" 
+                        class="role-card p-6 border-2 border-gray-200 rounded-2xl hover:border-cyan-500 hover:bg-cyan-50 transition-all duration-300 group">
+                        <img src="../Icons/teacherIcon3.png" alt="Teacher" class="w-24 h-24 mx-auto mb-3 object-cover">
+                        <h3 class="text-lg font-bold text-gray-800 group-hover:text-cyan-600">معلم</h3>
+                    </button>
+                </div>
+
+                <!-- Login Form -->
+                <form id="loginForm" onsubmit="handleLogin(event)" class="space-y-6">
+                    <!-- Student Login -->
+                    <div id="studentLogin" class="hidden space-y-4">
+                        <div>
+                            <label for="nationalCode" class="block text-sm font-semibold text-gray-700 mb-2">
+                                کد ملی
+                            </label>
+                            <input 
+                                type="text" 
+                                id="nationalCode" 
+                                placeholder="کد ملی خود را وارد کنید"
+                                class="w-full p-4 border-2 border-gray-300 rounded-xl text-center text-lg focus:border-teal-500 focus:ring-2 focus:ring-teal-200 outline-none transition-all"
+                                dir="ltr"
+                            >
+                            <p class="text-xs text-gray-500 mt-2 text-center">کد ملی خود را بدون صفر ابتدایی وارد کنید</p>
+                        </div>
+                    </div>
+
+                    <!-- Teacher Login -->
+                    <div id="teacherLogin" class="hidden">
+                        <label for="teacherPassword" class="block text-sm font-semibold text-gray-700 mb-2">
+                            رمز عبور
+                        </label>
+                        <div class="relative">
+                            <input 
+                                type="password" 
+                                id="teacherPassword" 
+                                placeholder="رمز عبور خود را وارد کنید"
+                                class="w-full p-4 pl-12 border-2 border-gray-300 rounded-xl focus:border-blue-500 focus:ring-2 focus:ring-blue-200 outline-none transition-all"
+                            >
+                            <button type="button" onclick="togglePassword()" class="absolute left-4 top-1/2 -translate-y-1/2 text-gray-500 hover:text-gray-700 focus:outline-none">
+                                <svg id="eyeIcon" class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+                                </svg>
+                            </button>
+                        </div>
+                        <!-- <p class="text-xs text-gray-500 mt-2 text-center flex items-center justify-center gap-1">
+                            <svg class="w-4 h-4" fill="currentColor" viewBox="0 0 20 20">
+                                <path d="M10 2a6 6 0 00-6 6v3.586l-.707.707A1 1 0 004 14h12a1 1 0 00.707-1.707L16 11.586V8a6 6 0 00-6-6zM10 18a3 3 0 01-3-3h6a3 3 0 01-3 3z"/>
+                            </svg>
+                            رمز عبور دمو: teacher123
+                        </p> -->
+                    </div>
+
+                    <!-- Submit Button -->
+                    <button 
+                        type="submit" 
+                        id="loginButton" 
+                        disabled
+                        class="w-full bg-gradient-to-r from-teal-600 to-cyan-600 text-white py-4 rounded-xl font-bold text-lg hover:from-teal-700 hover:to-cyan-700 disabled:from-gray-300 disabled:to-gray-400 disabled:cursor-not-allowed transform hover:scale-[1.02] active:scale-[0.98] transition-all duration-300 shadow-lg disabled:shadow-none"
+                    >
+                        ورود به سیستم
+                    </button>
+                </form>
+
+                <!-- Error Message -->
+                <div id="errorMessage" class="hidden bg-red-50 border-r-4 border-red-500 text-red-700 p-4 rounded-lg">
+                    <div class="flex items-center gap-2">
+                        <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z" clip-rule="evenodd"/>
+                        </svg>
+                        <span id="errorText" class="text-sm font-medium"></span>
+                    </div>
+                </div>
+
+                <!-- Footer -->
+                <div class="text-center text-sm text-gray-500">
+                    <p>نسخه 1.0.0 | آبان 1404</p>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <script src="../assets/js/data.js"></script>
+    <script>
+        let selectedRole = null;
+
+        function selectRole(role) {
+            selectedRole = role;
+            
+            // Update UI
+            const studentBtn = document.getElementById('studentRole');
+            const teacherBtn = document.getElementById('teacherRole');
+            
+            studentBtn.className = 'role-card p-6 border-2 rounded-2xl transition-all duration-300 group';
+            teacherBtn.className = 'role-card p-6 border-2 rounded-2xl transition-all duration-300 group';
+            
+            if (role === 'student') {
+                studentBtn.className += ' border-teal-500 bg-teal-50 shadow-lg scale-105';
+                document.getElementById('loginButton').className = document.getElementById('loginButton').className.replace('from-teal-600 to-cyan-600', 'from-teal-600 to-teal-700').replace('hover:from-teal-700 hover:to-cyan-700', 'hover:from-teal-700 hover:to-teal-800');
+            } else {
+                teacherBtn.className += ' border-cyan-500 bg-cyan-50 shadow-lg scale-105';
+                document.getElementById('loginButton').className = document.getElementById('loginButton').className.replace('from-teal-600 to-teal-700', 'from-teal-600 to-cyan-600').replace('hover:from-teal-700 hover:to-teal-800', 'hover:from-teal-700 hover:to-cyan-700');
+            }
+            
+            // Show appropriate form
+            document.getElementById('studentLogin').classList.toggle('hidden', role !== 'student');
+            document.getElementById('teacherLogin').classList.toggle('hidden', role !== 'teacher');
+            
+            // Enable login button
+            document.getElementById('loginButton').disabled = false;
+            
+            // Hide error
+            document.getElementById('errorMessage').classList.add('hidden');
+        }
+
+        function togglePassword() {
+            const input = document.getElementById('teacherPassword');
+            const type = input.type === 'password' ? 'text' : 'password';
+            input.type = type;
+        }
+
+        async function handleLogin(event) {
+            event.preventDefault();
+            
+            const errorDiv = document.getElementById('errorMessage');
+            errorDiv.classList.add('hidden');
+            
+            if (selectedRole === 'student') {
+                let nationalCode = document.getElementById('nationalCode').value.trim();
+                
+                if (!nationalCode) {
+                    showError('لطفاً کد ملی خود را وارد کنید');
+                    return;
+                }
+                
+                // Check if starts with zero and show warning
+                if (nationalCode.startsWith('0')) {
+                    showError('لطفاً صفر ابتدایی را از کد ملی حذف کنید');
+                    return;
+                }
+                
+                // No length restriction - just check if it matches a student in database
+                
+                try {
+                    // Authenticate student with backend using national code only
+                    const response = await fetch('/api/auth/student-by-nationalcode', {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json'
+                        },
+                        body: JSON.stringify({ nationalCode })
+                    });
+                    
+                    if (!response.ok) {
+                        const error = await response.json();
+                        showError(error.detail || 'خطا در ورود');
+                        return;
+                    }
+                    
+                    const result = await response.json();
+                    sessionStorage.setItem('currentStudent', result.student.studentNumber);
+                    sessionStorage.setItem('studentName', result.student.name);
+                    window.location.href = 'student-dashboard.html';
+                } catch (error) {
+                    showError('خطا در اتصال به سرور. لطفاً اطمینان حاصل کنید که سرور در حال اجرا است');
+                    console.error('Login error:', error);
+                }
+                
+            } else if (selectedRole === 'teacher') {
+                const password = document.getElementById('teacherPassword').value;
+                
+                if (!password) {
+                    showError('لطفاً رمز عبور را وارد کنید');
+                    return;
+                }
+                
+                try {
+                    const isValid = await checkTeacherPassword(password);
+                    if (!isValid) {
+                        showError('رمز عبور نادرست است. دوباره تلاش کنید.');
+                        return;
+                    }
+                    
+                    sessionStorage.setItem('isTeacher', 'true');
+                    window.location.href = 'teacher-dashboard.html';
+                } catch (error) {
+                    showError('خطا در اتصال به سرور');
+                    console.error('Login error:', error);
+                }
+            }
+        }
+
+        function showError(message) {
+            const errorDiv = document.getElementById('errorMessage');
+            const errorText = document.getElementById('errorText');
+            errorText.textContent = message;
+            errorDiv.classList.remove('hidden');
+        }
+    </script>
+</body>
+</html>

backend/static/pages/student-dashboard.html

@@ -0,0 +1,580 @@
+<!DOCTYPE html>
+<html lang="fa" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">
+    <meta http-equiv="Pragma" content="no-cache">
+    <meta http-equiv="Expires" content="0">
+    <!-- Version: 2.1 - Fixed AMS/Cooperative field preservation -->
+    <title>داشبورد دانش آموز - سیستم گروه‌بندی</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Vazirmatn', system-ui, -apple-system, sans-serif;
+        }
+    </style>
+    <script>
+        tailwind.config = {
+            theme: {
+                extend: {
+                    fontFamily: {
+                        'vazir': ['Vazirmatn', 'system-ui', '-apple-system', 'sans-serif'],
+                    }
+                }
+            }
+        }
+    </script>
+</head>
+<body class="font-vazir bg-gray-50 min-h-screen">
+    <!-- Top Navigation Bar -->
+    <nav style="background-color: #1b6e6e;" class="shadow-lg border-b border-gray-200 sticky top-0 z-50">
+        <div class="max-w-7xl mx-auto px-4">
+            <div class="flex items-center justify-between h-16">
+                <!-- Logo/Brand -->
+                <div class="flex items-center gap-3">
+                    <div class="bg-white/20 w-10 h-10 rounded-lg flex items-center justify-center">
+                        <svg class="w-6 h-6 text-white" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M10.394 2.08a1 1 0 00-.788 0l-7 3a1 1 0 000 1.84L5.25 8.051a.999.999 0 01.356-.257l4-1.714a1 1 0 11.788 1.838L7.667 9.088l1.94.831a1 1 0 00.787 0l7-3a1 1 0 000-1.838l-7-3zM3.31 9.397L5 10.12v4.102a8.969 8.969 0 00-1.05-.174 1 1 0 01-.89-.89 11.115 11.115 0 01.25-3.762zM9.3 16.573A9.026 9.026 0 007 14.935v-3.957l1.818.78a3 3 0 002.364 0l5.508-2.361a11.026 11.026 0 01.25 3.762 1 1 0 01-.89.89 8.968 8.968 0 00-5.35 2.524 1 1 0 01-1.4 0zM6 18a1 1 0 001-1v-2.065a8.935 8.935 0 00-2-.712V17a1 1 0 001 1z"/>
+                        </svg>
+                    </div>
+                    <div>
+                        <h1 class="text-xl font-bold text-white">TalimBot</h1>
+                        <p class="text-xs text-white/80">سیستم گروه‌بندی هوشمند</p>
+                    </div>
+                </div>
+
+                <!-- Navigation Links -->
+                <div class="hidden md:flex items-center gap-1">
+                    <a href="#" class="px-4 py-2 text-white bg-white/20 rounded-lg font-semibold border-b-2 border-white">
+                        <span class="flex items-center gap-2">
+                            <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                                <path d="M10.707 2.293a1 1 0 00-1.414 0l-7 7a1 1 0 001.414 1.414L4 10.414V17a1 1 0 001 1h2a1 1 0 001-1v-2a1 1 0 011-1h2a1 1 0 011 1v2a1 1 0 001 1h2a1 1 0 001-1v-6.586l.293.293a1 1 0 001.414-1.414l-7-7z"/>
+                            </svg>
+                            داشبورد
+                        </span>
+                    </a>
+                    <a href="group-view.html" class="px-4 py-2 text-white/80 hover:text-white hover:bg-white/10 rounded-lg font-medium transition-colors">
+                        <span class="flex items-center gap-2">
+                            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197M13 7a4 4 0 11-8 0 4 4 0 018 0z"/>
+                            </svg>
+                            گروه من
+                        </span>
+                    </a>
+                </div>
+
+                <!-- User Menu -->
+                <div class="flex items-center gap-4">
+                    <div class="hidden md:block text-left">
+                        <p class="text-sm font-semibold text-white" id="navStudentName">دانش آموز</p>
+                        <p class="text-xs text-white/80" id="navStudentNumber">-</p>
+                    </div>
+                    <div class="w-10 h-10 rounded-full bg-white/20 flex items-center justify-center text-white font-bold">
+                        <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M10 9a3 3 0 100-6 3 3 0 000 6zm-7 9a7 7 0 1114 0H3z" clip-rule="evenodd"/>
+                        </svg>
+                    </div>
+                    <a href="login.html" class="text-white/80 hover:text-red-300 transition-colors" title="خروج">
+                        <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 16l4-4m0 0l-4-4m4 4H7m6 4v1a3 3 0 01-3 3H6a3 3 0 01-3-3V7a3 3 0 013-3h4a3 3 0 013 3v1"/>
+                        </svg>
+                    </a>
+                </div>
+            </div>
+        </div>
+    </nav>
+
+    <!-- Main Content -->
+    <div class="max-w-7xl mx-auto px-4 py-8">
+        <!-- Welcome Section -->
+        <div class="mb-8">
+            <h2 class="text-3xl font-bold text-gray-900 mb-2" id="studentName"></h2>
+            <p class="text-gray-600 mb-3">لطفاً تمام تست‌های شخصیتی خود را تکمیل کنید و اطلاعات را ذخیره نمایید.</p>
+            <div class="bg-blue-50 border-r-4 border-blue-500 p-4 rounded-lg">
+                <p class="text-sm text-blue-800"><strong>💡 چرا این اطلاعات مهم است؟</strong> سیستم گروه‌بندی هوشمند از روش‌های علمی مانند <strong>ZPD</strong>، تکمیل شخصیتی MBTI، و تنوع سبک یادگیری VARK برای ساخت بهترین تیم‌ها استفاده می‌کند. هر چه اطلاعات کامل‌تری وارد کنید، گروه‌بندی دقیق‌تری خواهید داشت!</p>
+            </div>
+        </div>
+
+        <!-- Quick Stats -->
+        <div class="grid grid-cols-1 md:grid-cols-3 gap-6 mb-8">
+            <div class="bg-white rounded-xl shadow-md p-6 border-r-4 border-blue-500">
+                <div class="flex items-center justify-between">
+                    <div>
+                        <p class="text-gray-600 text-sm font-medium">شماره دانش‌آموزی</p>
+                        <p class="text-2xl font-bold text-gray-900 mt-1" id="studentNumber">-</p>
+                    </div>
+                    <div class="bg-blue-100 p-3 rounded-lg">
+                        <svg class="w-6 h-6 text-blue-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M10 9a3 3 0 100-6 3 3 0 000 6zm-7 9a7 7 0 1114 0H3z" clip-rule="evenodd"/>
+                        </svg>
+                    </div>
+                </div>
+            </div>
+
+            <div class="bg-white rounded-xl shadow-md p-6 border-r-4 border-green-500">
+                <div class="flex items-center justify-between">
+                    <div>
+                        <p class="text-gray-600 text-sm font-medium">تست‌های تکمیل شده</p>
+                        <p class="text-2xl font-bold text-gray-900 mt-1"><span id="testsCompleted">0</span> / 4</p>
+                    </div>
+                    <div class="bg-green-100 p-3 rounded-lg">
+                        <svg class="w-6 h-6 text-green-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/>
+                        </svg>
+                    </div>
+                </div>
+            </div>
+
+            <div class="bg-white rounded-xl shadow-md p-6 border-r-4 border-orange-500">
+                <div class="flex items-center justify-between">
+                    <div>
+                        <p class="text-gray-600 text-sm font-medium">معدل</p>
+                        <p class="text-2xl font-bold text-gray-900 mt-1" id="gradeDisplay">-</p>
+                    </div>
+                    <div class="bg-orange-100 p-3 rounded-lg">
+                        <svg class="w-6 h-6 text-orange-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M9.049 2.927c.3-.921 1.603-.921 1.902 0l1.07 3.292a1 1 0 00.95.69h3.462c.969 0 1.371 1.24.588 1.81l-2.8 2.034a1 1 0 00-.364 1.118l1.07 3.292c.3.921-.755 1.688-1.54 1.118l-2.8-2.034a1 1 0 00-1.175 0l-2.8 2.034c-.784.57-1.838-.197-1.539-1.118l1.07-3.292a1 1 0 00-.364-1.118L2.98 8.72c-.783-.57-.38-1.81.588-1.81h3.461a1 1 0 00.951-.69l1.07-3.292z"/>
+                        </svg>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Tests Section -->
+        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6 mb-8">
+            <!-- MBTI Test -->
+            <div class="bg-white rounded-xl shadow-md hover:shadow-xl transition-shadow p-6">
+                <div class="flex items-start gap-4 mb-4">
+                    <div class="bg-gradient-to-br from-blue-500 to-blue-600 p-4 rounded-xl flex-shrink-0">
+                        <svg class="w-8 h-8 text-white" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M9 4.804A7.968 7.968 0 005.5 4c-1.255 0-2.443.29-3.5.804v10A7.969 7.969 0 015.5 14c1.669 0 3.218.51 4.5 1.385A7.962 7.962 0 0114.5 14c1.255 0 2.443.29 3.5.804v-10A7.968 7.968 0 0014.5 4c-1.255 0-2.443.29-3.5.804V12a1 1 0 11-2 0V4.804z"/>
+                        </svg>
+                    </div>
+                    <div class="flex-1">
+                        <h3 class="font-bold text-lg text-gray-900 mb-2">MBTI - تیپ شخصیتی</h3>
+                        <p class="text-sm text-gray-600 leading-relaxed">شناخت تیپ شخصیتی برای ایجاد تعادل در گروه و درک نقاط قوت شما</p>
+                    </div>
+                </div>
+                <div class="space-y-3">
+                    <div class="flex gap-2">
+                        <a href="https://www.16personalities.com/fa" target="_blank" 
+                           class="flex-1 bg-blue-600 hover:bg-blue-700 text-white text-sm font-semibold py-3 px-4 rounded-lg transition-colors text-center flex items-center justify-center gap-2">
+                            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 12a9 9 0 01-9 9m9-9a9 9 0 00-9-9m9 9H3m9 9a9 9 0 01-9-9m9 9c1.657 0 3-4.03 3-9s-1.343-9-3-9m0 18c-1.657 0-3-4.03-3-9s1.343-9 3-9m-9 9a9 9 0 019-9"/>
+                            </svg>
+                            شروع آزمون
+                        </a>
+                        <a href="https://www.16personalities.com/" target="_blank" 
+                           class="bg-blue-100 hover:bg-blue-200 text-blue-700 text-sm font-semibold py-3 px-4 rounded-lg transition-colors">
+                            EN
+                        </a>
+                    </div>
+                    <div>
+                        <label class="block text-sm font-semibold text-gray-700 mb-2">نتیجه تست</label>
+                        <select id="mbtiInput" 
+                               class="w-full border-2 border-gray-300 rounded-lg py-3 px-4 focus:border-green-500 focus:ring-2 focus:ring-green-200 outline-none transition-all">
+                            <option value="">انتخاب کنید...</option>
+                            <option value="INTJ">INTJ</option>
+                            <option value="INTP">INTP</option>
+                            <option value="ENTJ">ENTJ</option>
+                            <option value="ENTP">ENTP</option>
+                            <option value="INFJ">INFJ</option>
+                            <option value="INFP">INFP</option>
+                            <option value="ENFJ">ENFJ</option>
+                            <option value="ENFP">ENFP</option>
+                            <option value="ISTJ">ISTJ</option>
+                            <option value="ISFJ">ISFJ</option>
+                            <option value="ESTJ">ESTJ</option>
+                            <option value="ESFJ">ESFJ</option>
+                            <option value="ISTP">ISTP</option>
+                            <option value="ISFP">ISFP</option>
+                            <option value="ESTP">ESTP</option>
+                            <option value="ESFP">ESFP</option>
+                        </select>
+                    </div>
+                </div>
+            </div>
+
+            <!-- VARK Test -->
+            <div class="bg-white rounded-xl shadow-md hover:shadow-xl transition-shadow p-6">
+                <div class="flex items-start gap-4 mb-4">
+                    <div class="bg-gradient-to-br from-green-500 to-green-600 p-4 rounded-xl flex-shrink-0">
+                        <svg class="w-8 h-8 text-white" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M6 6V5a3 3 0 013-3h2a3 3 0 013 3v1h2a2 2 0 012 2v3.57A22.952 22.952 0 0110 13a22.95 22.95 0 01-8-1.43V8a2 2 0 012-2h2zm2-1a1 1 0 011-1h2a1 1 0 011 1v1H8V5zm1 5a1 1 0 011-1h.01a1 1 0 110 2H10a1 1 0 01-1-1z" clip-rule="evenodd"/>
+                            <path d="M2 13.692V16a2 2 0 002 2h12a2 2 0 002-2v-2.308A24.974 24.974 0 0110 15c-2.796 0-5.487-.46-8-1.308z"/>
+                        </svg>
+                    </div>
+                    <div class="flex-1">
+                        <h3 class="font-bold text-lg text-gray-900 mb-2">VARK - سبک یادگیری</h3>
+                        <p class="text-sm text-gray-600 leading-relaxed">شناسایی سبک یادگیری شما (دیداری، شنیداری، خواندن/نوشتن، حرکتی)</p>
+                    </div>
+                </div>
+                <div class="space-y-3">
+                    <div class="flex gap-2">
+                        <a href="https://vark-learn.com/%D9%BE%D8%B1%D8%B3%D8%B4%D9%86%D8%A7%D9%85%D9%87-%D9%88%D8%A7%D8%B1%DA%A9/" target="_blank" 
+                           class="flex-1 bg-green-600 hover:bg-green-700 text-white text-sm font-semibold py-3 px-4 rounded-lg transition-colors text-center flex items-center justify-center gap-2">
+                            <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                                <path fill-rule="evenodd" d="M3 6a3 3 0 013-3h10a1 1 0 01.8 1.6L14.25 8l2.55 3.4A1 1 0 0116 13H6a1 1 0 00-1 1v3a1 1 0 11-2 0V6z" clip-rule="evenodd"/>
+                            </svg>
+                            شروع آزمون
+                        </a>
+                        <a href="https://vark-learn.com/the-vark-questionnaire/" target="_blank" 
+                           class="bg-green-100 hover:bg-green-200 text-green-700 text-sm font-semibold py-3 px-4 rounded-lg transition-colors">
+                            EN
+                        </a>
+                    </div>
+                    <div>
+                        <label class="block text-sm font-semibold text-gray-700 mb-2">نتیجه تست</label>
+                        <select id="varkInput" 
+                               class="w-full border-2 border-gray-300 rounded-lg py-3 px-4 focus:border-green-500 focus:ring-2 focus:ring-green-200 outline-none transition-all">
+                            <option value="">انتخاب کنید...</option>
+                            <option value="Visual">Visual (دیداری)</option>
+                            <option value="Aural">Aural (شنیداری)</option>
+                            <option value="Read/Write">Read/Write (خواندن/نوشتن)</option>
+                            <option value="Kinesthetic">Kinesthetic (حرکتی/عملی)</option>
+                        </select>
+                    </div>
+                </div>
+            </div>
+
+            <!-- AMS Test -->
+            <div class="bg-white rounded-xl shadow-md hover:shadow-xl transition-shadow p-6">
+                <div class="flex items-start gap-4 mb-4">
+                    <div class="bg-gradient-to-br from-orange-500 to-orange-600 p-4 rounded-xl flex-shrink-0">
+                        <svg class="w-8 h-8 text-white" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M11.3 1.046A1 1 0 0112 2v5h4a1 1 0 01.82 1.573l-7 10A1 1 0 018 18v-5H4a1 1 0 01-.82-1.573l7-10a1 1 0 011.12-.38z" clip-rule="evenodd"/>
+                        </svg>
+                    </div>
+                    <div class="flex-1">
+                        <h3 class="font-bold text-lg text-gray-900 mb-2">AMS - انگیزش تحصیلی</h3>
+                        <p class="text-sm text-gray-600 leading-relaxed">سنجش انگیزه درونی و بیرونی برای یادگیری و پیشرفت تحصیلی</p>
+                    </div>
+                </div>
+                <div class="space-y-3">
+                    <div class="flex gap-2">
+                        <a href="ams-questionnaire.html" 
+                           class="flex-1 bg-orange-600 hover:bg-orange-700 text-white text-sm font-semibold py-3 px-4 rounded-lg transition-colors text-center flex items-center justify-center gap-2">
+                            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
+                            </svg>
+                            شروع آزمون (28 سؤال)
+                        </a>
+                    </div>
+                    <div>
+                        <label class="block text-sm font-semibold text-gray-700 mb-2">نمره کل (از 196)</label>
+                        <input type="number" id="amsInput" placeholder="نمره را پس از تکمیل آزمون وارد کنید" min="0" max="196"
+                               class="w-full text-center text-lg font-bold border-2 border-gray-300 rounded-lg py-3 px-4 focus:border-orange-500 focus:ring-2 focus:ring-orange-200 outline-none transition-all">
+                    </div>
+                </div>
+            </div>
+
+            <!-- Cooperative Test -->
+            <div class="bg-white rounded-xl shadow-md hover:shadow-xl transition-shadow p-6">
+                <div class="flex items-start gap-4 mb-4">
+                    <div class="bg-gradient-to-br from-purple-500 to-purple-600 p-4 rounded-xl flex-shrink-0">
+                        <svg class="w-8 h-8 text-white" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M13 6a3 3 0 11-6 0 3 3 0 016 0zM18 8a2 2 0 11-4 0 2 2 0 014 0zM14 15a4 4 0 00-8 0v3h8v-3zM6 8a2 2 0 11-4 0 2 2 0 014 0zM16 18v-3a5.972 5.972 0 00-.75-2.906A3.005 3.005 0 0119 15v3h-3zM4.75 12.094A5.973 5.973 0 004 15v3H1v-3a3 3 0 013.75-2.906z"/>
+                        </svg>
+                    </div>
+                    <div class="flex-1">
+                        <h3 class="font-bold text-lg text-gray-900 mb-2">توانایی همکاری</h3>
+                        <p class="text-sm text-gray-600 leading-relaxed">سنجش مهارت‌های کار گروهی، تعامل و همکاری با دیگران</p>
+                    </div>
+                </div>
+                <div class="space-y-3">
+                    <div class="flex gap-2">
+                        <a href="cooperative-questionnaire.html" 
+                           class="flex-1 bg-purple-600 hover:bg-purple-700 text-white text-sm font-semibold py-3 px-4 rounded-lg transition-colors text-center flex items-center justify-center gap-2">
+                            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
+                            </svg>
+                            شروع آزمون (25 سؤال)
+                        </a>
+                    </div>
+                    <div>
+                        <label class="block text-sm font-semibold text-gray-700 mb-2">نمره کل (از 125)</label>
+                        <input type="number" id="cooperativeInput" placeholder="نمره را پس از تکمیل آزمون وارد کنید" min="0" max="125"
+                               class="w-full text-center text-lg font-bold border-2 border-gray-300 rounded-lg py-3 px-4 focus:border-purple-500 focus:ring-2 focus:ring-purple-200 outline-none transition-all">
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Preferences Section -->
+        <div class="bg-white rounded-xl shadow-md p-6 mb-8">
+            <div class="mb-6">
+                <h3 class="font-bold text-xl text-gray-900 mb-2 flex items-center gap-2">
+                    <svg class="w-6 h-6 text-gray-700" fill="currentColor" viewBox="0 0 20 20">
+                        <path d="M13 6a3 3 0 11-6 0 3 3 0 016 0zM18 8a2 2 0 11-4 0 2 2 0 014 0zM14 15a4 4 0 00-8 0v3h8v-3zM6 8a2 2 0 11-4 0 2 2 0 014 0zM16 18v-3a5.972 5.972 0 00-.75-2.906A3.005 3.005 0 0119 15v3h-3zM4.75 12.094A5.973 5.973 0 004 15v3H1v-3a3 3 0 013.75-2.906z"/>
+                    </svg>
+                    ترجیحات همگروهی
+                </h3>
+                <p class="text-gray-600">می‌توانید حداکثر 4 نفر از همکلاسی‌های خود را که دوست دارید در یک گروه باشید انتخاب کنید (اختیاری)</p>
+            </div>
+            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-3 mb-4" id="preferredStudentsCheckbox">
+                <!-- Populated by JS -->
+            </div>
+            <div class="bg-blue-50 border border-blue-200 rounded-lg p-3">
+                <p class="text-sm text-blue-800 font-medium text-center" id="selectedCount">انتخاب شده: 0/4</p>
+            </div>
+        </div>
+
+        <!-- Action Buttons -->
+        <div class="flex flex-col items-center gap-4">
+            <button onclick="saveAllResults()" 
+                    class="w-full md:w-1/3 bg-gradient-to-r from-blue-600 to-blue-700 hover:from-blue-700 hover:to-blue-800 text-white py-4 px-6 rounded-xl font-bold text-lg shadow-lg hover:shadow-xl transform hover:scale-[1.02] active:scale-[0.98] transition-all flex items-center justify-center gap-2">
+                <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7H5a2 2 0 00-2 2v9a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-3m-1 4l-3 3m0 0l-3-3m3 3V4"/>
+                </svg>
+                ذخیره تمام اطلاعات
+            </button>
+            <button onclick="viewGroup()" 
+                    class="w-full md:w-1/3 bg-gradient-to-r from-purple-600 to-purple-700 hover:from-purple-700 hover:to-purple-800 text-white py-4 px-6 rounded-xl font-bold text-lg shadow-lg hover:shadow-xl transform hover:scale-[1.02] active:scale-[0.98] transition-all flex items-center justify-center gap-2">
+                <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                    <path d="M13 6a3 3 0 11-6 0 3 3 0 016 0zM18 8a2 2 0 11-4 0 2 2 0 014 0zM14 15a4 4 0 00-8 0v3h8v-3zM6 8a2 2 0 11-4 0 2 2 0 014 0zM16 18v-3a5.972 5.972 0 00-.75-2.906A3.005 3.005 0 0119 15v3h-3zM4.75 12.094A5.973 5.973 0 004 15v3H1v-3a3 3 0 013.75-2.906z"/>
+                </svg>
+                مشاهده گروه من
+            </button>
+        </div>
+    </div>
+
+    <!-- Success Toast -->
+    <div id="successToast" class="hidden fixed top-20 left-1/2 -translate-x-1/2 bg-green-500 text-white px-6 py-4 rounded-xl shadow-2xl z-50">
+        <div class="flex items-center gap-2">
+            <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/>
+            </svg>
+            <span class="font-semibold">اطلاعات با موفقیت ذخیره شد!</span>
+        </div>
+    </div>
+
+    <!-- Footer -->
+    <footer class="bg-white border-t border-gray-200 mt-16">
+        <div class="max-w-7xl mx-auto px-4 py-6">
+            <div class="text-center text-gray-600 text-sm">
+                <p class="mb-2">نسخه 1.0.0 | آبان 1404</p>
+                <p>© ۲۰۲۵ TalimBot - سیستم گروه‌بندی هوشمند دانش آموزان</p>
+            </div>
+        </div>
+    </footer>
+
+    <script src="../assets/js/data.js"></script>
+    <script>
+        let currentStudent = null;
+        let allStudents = [];
+
+        // Check if user is authenticated
+        function checkAuth() {
+            const studentNumber = sessionStorage.getItem('currentStudent');
+            if (!studentNumber) {
+                window.location.href = 'login.html';
+                return null;
+            }
+            return studentNumber;
+        }
+
+        async function loadStudentData() {
+            const studentNumber = checkAuth();
+            if (!studentNumber) return;
+
+            try {
+                currentStudent = await getStudent(studentNumber);
+                allStudents = await getAllStudents();
+
+                if (!currentStudent) {
+                    alert('دانش آموز یافت نشد');
+                    window.location.href = 'login.html';
+                    return;
+                }
+
+                // Update nav and page info with Persian name
+                const displayName = currentStudent.name || studentNumber;
+                document.getElementById('studentName').textContent = `خوش آمدید، ${displayName}`;
+                document.getElementById('navStudentName').textContent = displayName;
+                document.getElementById('studentNumber').textContent = currentStudent.studentNumber;
+                document.getElementById('navStudentNumber').textContent = currentStudent.studentNumber;
+                document.getElementById('gradeDisplay').textContent = currentStudent.grade.toFixed(2);
+
+                // Count completed tests
+                let testsCompleted = 0;
+                if (currentStudent.mbti) testsCompleted++;
+                if (currentStudent.learningStyle) testsCompleted++;
+                if (currentStudent.ams) testsCompleted++;
+                if (currentStudent.cooperative) testsCompleted++;
+                document.getElementById('testsCompleted').textContent = testsCompleted;
+
+                // Load existing data from backend
+                if (currentStudent.mbti) document.getElementById('mbtiInput').value = currentStudent.mbti;
+                if (currentStudent.learningStyle) document.getElementById('varkInput').value = currentStudent.learningStyle;
+                if (currentStudent.ams) document.getElementById('amsInput').value = currentStudent.ams;
+                if (currentStudent.cooperative) document.getElementById('cooperativeInput').value = currentStudent.cooperative;
+
+                // Check for scores from questionnaires in sessionStorage (takes priority)
+                const amsScore = sessionStorage.getItem('amsScore');
+                const cooperativeScore = sessionStorage.getItem('cooperativeScore');
+                
+                if (amsScore) {
+                    document.getElementById('amsInput').value = amsScore;
+                    sessionStorage.removeItem('amsScore');
+                }
+                
+                if (cooperativeScore) {
+                    document.getElementById('cooperativeInput').value = cooperativeScore;
+                    sessionStorage.removeItem('cooperativeScore');
+                }
+
+                // Restore any unsaved form data from sessionStorage (in case user navigated away without saving)
+                const unsavedMbti = sessionStorage.getItem('unsavedMbti');
+                const unsavedVark = sessionStorage.getItem('unsavedVark');
+                const unsavedAms = sessionStorage.getItem('unsavedAms');
+                const unsavedCooperative = sessionStorage.getItem('unsavedCooperative');
+                
+                if (unsavedMbti) {
+                    document.getElementById('mbtiInput').value = unsavedMbti;
+                    sessionStorage.removeItem('unsavedMbti');
+                }
+                
+                if (unsavedVark) {
+                    document.getElementById('varkInput').value = unsavedVark;
+                    sessionStorage.removeItem('unsavedVark');
+                }
+                
+                if (unsavedAms) {
+                    document.getElementById('amsInput').value = unsavedAms;
+                    sessionStorage.removeItem('unsavedAms');
+                }
+                
+                if (unsavedCooperative) {
+                    document.getElementById('cooperativeInput').value = unsavedCooperative;
+                    sessionStorage.removeItem('unsavedCooperative');
+                }
+
+                populatePreferredStudents();
+            } catch (error) {
+                console.error('Error loading student data:', error);
+                alert('خطا در بارگذاری اطلاعات. لطفاً دوباره تلاش کنید');
+            }
+        }
+
+        function populatePreferredStudents() {
+            const container = document.getElementById('preferredStudentsCheckbox');
+            container.innerHTML = '';
+
+            allStudents.forEach(student => {
+                if (student.studentNumber === currentStudent.studentNumber) return;
+
+                const div = document.createElement('div');
+                div.className = 'flex items-center gap-2 p-3 border border-gray-200 rounded-lg hover:bg-gray-50 transition-colors';
+
+                const checkbox = document.createElement('input');
+                checkbox.type = 'checkbox';
+                checkbox.id = 'student_' + student.studentNumber;
+                checkbox.value = student.studentNumber;
+                checkbox.onchange = updateSelectedCount;
+                checkbox.className = 'w-5 h-5 text-blue-600 rounded focus:ring-2 focus:ring-blue-500';
+
+                if (currentStudent.preferredStudents && currentStudent.preferredStudents.includes(student.studentNumber)) {
+                    checkbox.checked = true;
+                }
+
+                const label = document.createElement('label');
+                label.htmlFor = 'student_' + student.studentNumber;
+                label.textContent = `${student.name} (${student.studentNumber})`;
+                label.className = 'text-sm text-gray-700 cursor-pointer flex-1';
+
+                div.appendChild(checkbox);
+                div.appendChild(label);
+                container.appendChild(div);
+            });
+
+            updateSelectedCount();
+        }
+
+        function updateSelectedCount() {
+            const checkboxes = document.querySelectorAll('#preferredStudentsCheckbox input[type="checkbox"]:checked');
+            const count = checkboxes.length;
+            document.getElementById('selectedCount').textContent = `انتخاب شده: ${count}/4`;
+
+            const allCheckboxes = document.querySelectorAll('#preferredStudentsCheckbox input[type="checkbox"]');
+            allCheckboxes.forEach(cb => {
+                if (!cb.checked && count >= 4) {
+                    cb.disabled = true;
+                    cb.parentElement.classList.add('opacity-50');
+                } else {
+                    cb.disabled = false;
+                    cb.parentElement.classList.remove('opacity-50');
+                }
+            });
+        }
+
+        async function saveAllResults() {
+            const mbti = document.getElementById('mbtiInput').value.trim().toUpperCase();
+            const vark = document.getElementById('varkInput').value.trim();
+            const ams = document.getElementById('amsInput').value.trim();
+            const cooperative = document.getElementById('cooperativeInput').value.trim();
+
+            const checkboxes = document.querySelectorAll('#preferredStudentsCheckbox input[type="checkbox"]:checked');
+            const preferredStudents = Array.from(checkboxes).map(cb => cb.value);
+
+            // Build update object with only non-empty values to prevent overwriting existing data
+            const updates = {};
+            if (mbti) updates.mbti = mbti;
+            if (vark) updates.learningStyle = vark;
+            if (ams) updates.ams = ams;
+            if (cooperative) updates.cooperative = cooperative;
+            // Always update preferred students (can be empty array)
+            updates.preferredStudents = preferredStudents;
+
+            const success = await updateStudent(currentStudent.studentNumber, updates);
+
+            if (success) {
+                const toast = document.getElementById('successToast');
+                toast.classList.remove('hidden');
+                setTimeout(() => toast.classList.add('hidden'), 3000);
+                await loadStudentData();
+            } else {
+                alert('خطا در ذخیره اطلاعات!');
+            }
+        }
+
+        function viewGroup() {
+            window.location.href = 'group-view.html';
+        }
+
+        // Preserve unsaved form data when navigating to questionnaire pages
+        function saveFormState() {
+            const mbti = document.getElementById('mbtiInput').value.trim();
+            const vark = document.getElementById('varkInput').value.trim();
+            const ams = document.getElementById('amsInput').value.trim();
+            const cooperative = document.getElementById('cooperativeInput').value.trim();
+            
+            // Only save to sessionStorage if values exist
+            if (mbti) sessionStorage.setItem('unsavedMbti', mbti);
+            if (vark) sessionStorage.setItem('unsavedVark', vark);
+            if (ams) sessionStorage.setItem('unsavedAms', ams);
+            if (cooperative) sessionStorage.setItem('unsavedCooperative', cooperative);
+        }
+
+        // Add click listeners to questionnaire links to save form state
+        window.onload = function() {
+            loadStudentData();
+            
+            // Save form state when clicking on questionnaire links
+            const amsLink = document.querySelector('a[href="ams-questionnaire.html"]');
+            const cooperativeLink = document.querySelector('a[href="cooperative-questionnaire.html"]');
+            
+            if (amsLink) {
+                amsLink.addEventListener('click', saveFormState);
+            }
+            
+            if (cooperativeLink) {
+                cooperativeLink.addEventListener('click', saveFormState);
+            }
+        };
+    </script>
+</body>
+</html>

backend/static/pages/student-data.html

@@ -0,0 +1,388 @@
+<!DOCTYPE html>
+<html lang="fa" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>ورود اطلاعات دانش‌آموزان - TalimBot</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Vazirmatn', sans-serif;
+        }
+    </style>
+</head>
+<body class="bg-gray-50">
+    <!-- Top Navigation -->
+    <nav style="background-color: #1b6e6e;" class="shadow-lg border-b border-gray-200 sticky top-0 z-50">
+        <div class="max-w-7xl mx-auto px-4">
+            <div class="flex justify-between items-center h-16">
+                <!-- Logo -->
+                <div class="flex items-center gap-3">
+                    <div class="w-10 h-10 bg-white/20 rounded-lg flex items-center justify-center text-white text-xl font-bold">
+                        T
+                    </div>
+                    <span class="text-xl font-bold text-white">TalimBot</span>
+                </div>
+
+                <!-- Navigation Links -->
+                <div class="hidden md:flex items-center gap-6">
+                    <a href="teacher-dashboard.html" class="text-white/80 hover:text-white font-medium transition-colors">
+                        داشبورد
+                    </a>
+                    <a href="student-data.html" class="text-white font-bold border-b-2 border-white pb-1">
+                        ورود اطلاعات
+                    </a>
+                </div>
+
+                <!-- User Menu -->
+                <div class="flex items-center gap-4">
+                    <div class="flex items-center gap-2">
+                        <div class="w-10 h-10 bg-white/20 rounded-full flex items-center justify-center">
+                            <svg class="w-6 h-6 text-white" fill="currentColor" viewBox="0 0 20 20">
+                                <path d="M10 9a3 3 0 100-6 3 3 0 000 6zm-7 9a7 7 0 1114 0H3z"/>
+                                <path d="M10 2a1 1 0 011 1v1a1 1 0 11-2 0V3a1 1 0 011-1z"/>
+                            </svg>
+                        </div>
+                        <div class="hidden md:block text-right">
+                            <p class="text-sm font-bold text-white">معلم</p>
+                            <p class="text-xs text-white/80">مدیر سیستم</p>
+                        </div>
+                    </div>
+                    <a href="login.html" class="text-white/80 hover:text-red-300 transition-colors" title="خروج">
+                        <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 16l4-4m0 0l-4-4m4 4H7m6 4v1a3 3 0 01-3 3H6a3 3 0 01-3-3V7a3 3 0 013-3h4a3 3 0 013 3v1"/>
+                        </svg>
+                    </a>
+                </div>
+            </div>
+        </div>
+    </nav>
+
+    <!-- Main Content -->
+    <div class="max-w-7xl mx-auto px-4 py-8">
+        <!-- Page Header -->
+        <div class="mb-8">
+            <h1 class="text-4xl font-bold text-gray-900 mb-2 flex items-center gap-3">
+                <svg class="w-10 h-10 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
+                </svg>
+                ورود اطلاعات دانش‌آموزان
+            </h1>
+            <p class="text-gray-600">اطلاعات دانش‌آموزان را وارد کنید تا در سیستم گروه‌بندی ثبت شود</p>
+        </div>
+
+        <!-- Instructions Card -->
+        <div class="bg-blue-50 border-r-4 border-blue-500 rounded-lg p-4 mb-6">
+            <div class="flex items-start gap-3">
+                <svg class="w-6 h-6 text-blue-600 flex-shrink-0 mt-1" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7-4a1 1 0 11-2 0 1 1 0 012 0zM9 9a1 1 0 000 2v3a1 1 0 001 1h1a1 1 0 100-2v-3a1 1 0 00-1-1H9z" clip-rule="evenodd"/>
+                </svg>
+                <div>
+                    <h3 class="font-bold text-blue-900 mb-1">راهنما</h3>
+                    <p class="text-blue-800 text-sm">نام، شماره دانش‌آموزی و نمره را وارد کنید. پس از هر ورودی روی "ذخیره" کلیک کنید تا فرم خالی شود و آماده ورود دانش‌آموز بعدی باشد.</p>
+                </div>
+            </div>
+        </div>
+
+        <!-- Stats Cards -->
+        <div class="grid grid-cols-1 md:grid-cols-2 gap-6 mb-8">
+            <div class="bg-white rounded-xl shadow-md p-6 border-r-4 border-purple-500">
+                <div class="flex items-center justify-between">
+                    <div>
+                        <p class="text-gray-600 text-sm mb-1">تعداد دانش‌آموزان ثبت شده</p>
+                        <p class="text-3xl font-bold text-purple-600" id="totalCount">0</p>
+                    </div>
+                    <div class="w-14 h-14 bg-purple-100 rounded-full flex items-center justify-center">
+                        <svg class="w-8 h-8 text-purple-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M9 6a3 3 0 11-6 0 3 3 0 016 0zM17 6a3 3 0 11-6 0 3 3 0 016 0zM12.93 17c.046-.327.07-.66.07-1a6.97 6.97 0 00-1.5-4.33A5 5 0 0119 16v1h-6.07zM6 11a5 5 0 015 5v1H1v-1a5 5 0 015-5z"/>
+                        </svg>
+                    </div>
+                </div>
+            </div>
+
+            <div class="bg-white rounded-xl shadow-md p-6 border-r-4 border-green-500">
+                <div class="flex items-center justify-between">
+                    <div>
+                        <p class="text-gray-600 text-sm mb-1">آخرین دانش‌آموز ثبت شده</p>
+                        <p class="text-xl font-bold text-green-600" id="lastStudent">-</p>
+                    </div>
+                    <div class="w-14 h-14 bg-green-100 rounded-full flex items-center justify-center">
+                        <svg class="w-8 h-8 text-green-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/>
+                        </svg>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Data Entry Form Card -->
+        <div class="bg-white rounded-xl shadow-md overflow-hidden mb-8">
+            <div class="p-6 border-b border-gray-200 bg-gradient-to-r from-purple-600 to-blue-600">
+                <h2 class="text-xl font-bold text-white flex items-center gap-2">
+                    <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                        <path d="M8 9a3 3 0 100-6 3 3 0 000 6zM8 11a6 6 0 016 6H2a6 6 0 016-6zM16 7a1 1 0 10-2 0v1h-1a1 1 0 100 2h1v1a1 1 0 102 0v-1h1a1 1 0 100-2h-1V7z"/>
+                    </svg>
+                    افزودن دانش‌آموز
+                </h2>
+            </div>
+            
+            <div class="p-8">
+                <div class="grid grid-cols-1 md:grid-cols-3 gap-6 mb-6">
+                    <div>
+                        <label class="block text-sm font-bold text-gray-700 mb-2">نام دانش‌آموز</label>
+                        <input 
+                            type="text" 
+                            id="studentName"
+                            placeholder="نام و نام خانوادگی..."
+                            class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:border-purple-500 focus:ring-2 focus:ring-purple-200 focus:outline-none transition-all"
+                        >
+                    </div>
+                    <div>
+                        <label class="block text-sm font-bold text-gray-700 mb-2">شماره دانش‌آموزی</label>
+                        <input 
+                            type="text" 
+                            id="studentId"
+                            placeholder="شماره دانش‌آموز..."
+                            class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:border-purple-500 focus:ring-2 focus:ring-purple-200 focus:outline-none transition-all"
+                        >
+                    </div>
+                    <div>
+                        <label class="block text-sm font-bold text-gray-700 mb-2">نمره (از 20)</label>
+                        <input 
+                            type="number" 
+                            id="studentGrade"
+                            min="0" 
+                            max="20" 
+                            placeholder="نمره..."
+                            class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:border-purple-500 focus:ring-2 focus:ring-purple-200 focus:outline-none transition-all text-center"
+                        >
+                    </div>
+                </div>
+
+                <div class="flex justify-center">
+                    <button onclick="addStudent()" class="w-1/3 bg-gradient-to-r from-purple-600 to-blue-600 hover:from-purple-700 hover:to-blue-700 text-white py-3 px-8 rounded-lg font-bold transition-all shadow-md hover:shadow-lg transform hover:scale-105 flex items-center justify-center gap-2">
+                        <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M7.707 10.293a1 1 0 10-1.414 1.414l3 3a1 1 0 001.414 0l3-3a1 1 0 00-1.414-1.414L11 11.586V6h5a2 2 0 012 2v7a2 2 0 01-2 2H4a2 2 0 01-2-2V8a2 2 0 012-2h5v5.586l-1.293-1.293zM9 4a1 1 0 012 0v2H9V4z"/>
+                        </svg>
+                        ذخیره
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Students List -->
+        <div class="bg-white rounded-xl shadow-md overflow-hidden">
+            <div class="p-6 border-b border-gray-200 bg-gradient-to-r from-purple-600 to-blue-600">
+                <h2 class="text-xl font-bold text-white flex items-center gap-2">
+                    <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                        <path d="M2 11a1 1 0 011-1h2a1 1 0 011 1v5a1 1 0 01-1 1H3a1 1 0 01-1-1v-5zM8 7a1 1 0 011-1h2a1 1 0 011 1v9a1 1 0 01-1 1H9a1 1 0 01-1-1V7zM14 4a1 1 0 011-1h2a1 1 0 011 1v12a1 1 0 01-1 1h-2a1 1 0 01-1-1V4z"/>
+                    </svg>
+                    لیست دانش‌آموزان ذخیره شده
+                </h2>
+            </div>
+            
+            <div class="overflow-x-auto">
+                <table class="w-full">
+                    <thead class="bg-gray-100">
+                        <tr>
+                            <th class="px-6 py-4 text-center text-sm font-bold text-gray-700 border-b">ردیف</th>
+                            <th class="px-6 py-4 text-center text-sm font-bold text-gray-700 border-b">شماره دانش‌آموز</th>
+                            <th class="px-6 py-4 text-center text-sm font-bold text-gray-700 border-b">نام دانش‌آموز</th>
+                            <th class="px-6 py-4 text-center text-sm font-bold text-gray-700 border-b">نمره (از 20)</th>
+                        </tr>
+                    </thead>
+                    <tbody id="studentsList">
+                        <tr>
+                            <td colspan="4" class="px-6 py-12 text-center text-gray-400">
+                                <svg class="w-16 h-16 mx-auto mb-4 text-gray-300" fill="currentColor" viewBox="0 0 20 20">
+                                    <path d="M9 6a3 3 0 11-6 0 3 3 0 016 0zM17 6a3 3 0 11-6 0 3 3 0 016 0zM12.93 17c.046-.327.07-.66.07-1a6.97 6.97 0 00-1.5-4.33A5 5 0 0119 16v1h-6.07zM6 11a5 5 0 015 5v1H1v-1a5 5 0 015-5z"/>
+                                </svg>
+                                <p class="text-lg font-medium">هنوز دانش‌آموزی ثبت نشده است</p>
+                                <p class="text-sm mt-2">از فرم بالا برای افزودن دانش‌آموز استفاده کنید</p>
+                            </td>
+                        </tr>
+                    </tbody>
+                </table>
+            </div>
+        </div>
+
+        <!-- Help Card -->
+        <!-- <div class="mt-6 bg-purple-50 rounded-xl shadow-md p-6">
+            <h3 class="text-lg font-bold text-purple-900 mb-3 flex items-center gap-2">
+                <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-8-3a1 1 0 00-.867.5 1 1 0 11-1.731-1A3 3 0 0113 8a3.001 3.001 0 01-2 2.83V11a1 1 0 11-2 0v-1a1 1 0 011-1 1 1 0 100-2zm0 8a1 1 0 100-2 1 1 0 000 2z" clip-rule="evenodd"/>
+                </svg>
+                سؤالات متداول
+            </h3>
+            <div class="space-y-2 text-sm text-purple-800">
+                <p><strong>چگونه نمره وارد کنم؟</strong> نمره باید عدد بین 0 تا 20 باشد.</p>
+                <p><strong>آیا باید همه فیلدها پر شود؟</strong> بله، برای گروه‌بندی موفق، اطلاعات همه دانش‌آموزان لازم است.</p>
+                <p><strong>اطلاعات کجا ذخیره می‌شود؟</strong> در نسخه فعلی در مرورگر ذخیره می‌شود. در آینده به پایگاه داده متصل خواهد شد.</p>
+            </div>
+        </div> -->
+
+        <!-- Footer -->
+        <footer class="bg-white border-t border-gray-200 mt-16">
+            <div class="max-w-7xl mx-auto px-4 py-6">
+                <div class="text-center text-gray-600 text-sm">
+                    <p class="mb-2">نسخه 1.0.0 | آبان 1404</p>
+                    <p>© ۲۰۲۵ TalimBot - سیستم گروه‌بندی هوشمند دانش آموزان</p>
+                </div>
+            </div>
+        </footer>
+    </div>
+
+    <script src="../assets/js/data.js"></script>
+    <script>
+        // Check authentication on page load
+        function checkAuth() {
+            const isTeacher = sessionStorage.getItem('isTeacher');
+            if (isTeacher !== 'true') {
+                window.location.href = 'login.html';
+            }
+        }
+
+        function logout() {
+            sessionStorage.clear();
+            window.location.href = 'login.html';
+        }
+
+        // Add student function
+        function addStudent() {
+            const name = document.getElementById('studentName').value.trim();
+            const studentId = document.getElementById('studentId').value.trim().toUpperCase();
+            const grade = document.getElementById('studentGrade').value.trim();
+
+            // Validation
+            if (!name) {
+                alert('لطفاً نام دانش‌آموز را وارد کنید');
+                return;
+            }
+            if (!studentId) {
+                alert('لطفاً شماره دانش‌آموزی را وارد کنید');
+                return;
+            }
+            if (!grade) {
+                alert('لطفاً نمره را وارد کنید');
+                return;
+            }
+            if (parseFloat(grade) < 0 || parseFloat(grade) > 20) {
+                alert('نمره باید بین 0 تا 20 باشد');
+                return;
+            }
+
+            // Validate student number format (must be S followed by numbers)
+            if (!/^S\d+$/.test(studentId)) {
+                alert('⚠️ فرمت شماره دانش‌آموزی نادرست است!\n\nشماره باید با حرف S شروع شود و بعد از آن فقط اعداد باشد\n\nمثال‌های صحیح: S001, S031, S100');
+                return;
+            }
+
+            // Try to add student using data.js function
+            const result = addNewStudent(studentId, name, parseFloat(grade));
+
+            if (result.success) {
+                // Clear form
+                document.getElementById('studentName').value = '';
+                document.getElementById('studentId').value = '';
+                document.getElementById('studentGrade').value = '';
+
+                // Focus back on student ID field
+                document.getElementById('studentId').focus();
+
+                // Update the list display
+                updateStudentsList();
+
+                // Update stats
+                updateStats();
+
+                // Show success message
+                showToast('✅ دانش‌آموز با موفقیت اضافه شد!\n' + name + ' (' + studentId + ')');
+            } else {
+                alert('❌ ' + result.message);
+            }
+        }
+
+        // Update students list display
+        function updateStudentsList() {
+            const tbody = document.getElementById('studentsList');
+            const allStudents = getAllStudents();
+            
+            if (allStudents.length === 0) {
+                tbody.innerHTML = `
+                    <tr>
+                        <td colspan="4" class="px-6 py-12 text-center text-gray-400">
+                            <svg class="w-16 h-16 mx-auto mb-4 text-gray-300" fill="currentColor" viewBox="0 0 20 20">
+                                <path d="M9 6a3 3 0 11-6 0 3 3 0 016 0zM17 6a3 3 0 11-6 0 3 3 0 016 0zM12.93 17c.046-.327.07-.66.07-1a6.97 6.97 0 00-1.5-4.33A5 5 0 0119 16v1h-6.07zM6 11a5 5 0 015 5v1H1v-1a5 5 0 015-5z"/>
+                            </svg>
+                            <p class="text-lg font-medium">هنوز دانش‌آموزی ثبت نشده است</p>
+                            <p class="text-sm mt-2">از فرم بالا برای افزودن دانش‌آموز استفاده کنید</p>
+                        </td>
+                    </tr>
+                `;
+                return;
+            }
+
+            tbody.innerHTML = '';
+            allStudents.forEach((student, index) => {
+                const row = document.createElement('tr');
+                row.className = 'hover:bg-gray-50 transition-colors';
+                row.innerHTML = `
+                    <td class="px-6 py-4 text-center border-b border-gray-200">
+                        <span class="font-bold text-gray-700">${index + 1}</span>
+                    </td>
+                    <td class="px-6 py-4 text-center border-b border-gray-200">
+                        <span class="text-gray-600 font-medium">${student.studentNumber}</span>
+                    </td>
+                    <td class="px-6 py-4 text-center border-b border-gray-200">
+                        <span class="text-gray-900 font-medium">${student.name}</span>
+                    </td>
+                    <td class="px-6 py-4 text-center border-b border-gray-200">
+                        <span class="text-purple-600 font-bold">${student.grade}</span>
+                    </td>
+                `;
+                tbody.appendChild(row);
+            });
+        }
+
+        // Update statistics
+        function updateStats() {
+            const allStudents = getAllStudents();
+            document.getElementById('totalCount').textContent = allStudents.length;
+            if (allStudents.length > 0) {
+                document.getElementById('lastStudent').textContent = allStudents[allStudents.length - 1].name;
+            } else {
+                document.getElementById('lastStudent').textContent = '-';
+            }
+        }
+
+        // Show success toast
+        function showToast(message) {
+            const toast = document.createElement('div');
+            toast.className = 'fixed top-20 left-1/2 -translate-x-1/2 bg-green-500 text-white px-6 py-4 rounded-xl shadow-2xl z-50 flex items-center gap-2';
+            toast.innerHTML = `
+                <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/>
+                </svg>
+                <span class="font-semibold">${message}</span>
+            `;
+            document.body.appendChild(toast);
+            
+            setTimeout(() => {
+                toast.remove();
+            }, 3000);
+        }
+
+        // Initialize on page load
+        window.onload = () => {
+            checkAuth();
+            updateStudentsList();
+            updateStats();
+        };
+    </script>
+</body>
+</html>
+
+

backend/static/pages/teacher-dashboard.html

@@ -0,0 +1,1017 @@
+<!DOCTYPE html>
+<html lang="fa" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">
+    <meta http-equiv="Pragma" content="no-cache">
+    <meta http-equiv="Expires" content="0">
+    <!-- Version: 2.1 - Fixed VARK 4 options + field preservation -->
+    <title>داشبورد معلم - سیستم گروه‌بندی</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
+    <style>
+        body {
+            font-family: 'Vazirmatn', system-ui, -apple-system, sans-serif;
+        }
+        @keyframes fadeIn {
+            from { opacity: 0; transform: translateY(-10px); }
+            to { opacity: 1; transform: translateY(0); }
+        }
+        .fade-in {
+            animation: fadeIn 0.3s ease-out;
+        }
+    </style>
+    <script>
+        tailwind.config = {
+            theme: {
+                extend: {
+                    fontFamily: {
+                        'vazir': ['Vazirmatn', 'system-ui', '-apple-system', 'sans-serif'],
+                    }
+                }
+            }
+        }
+    </script>
+</head>
+<body class="font-vazir bg-gray-50">
+    <div class="min-h-screen">
+        <!-- Top Navigation -->
+        <nav style="background-color: #1b6e6e;" class="shadow-lg border-b border-gray-200 sticky top-0 z-50">
+            <div class="max-w-7xl mx-auto px-4">
+                <div class="flex justify-between items-center h-16">
+                    <!-- Logo -->
+                    <div class="flex items-center gap-3">
+                        <div class="w-10 h-10 bg-white/20 rounded-lg flex items-center justify-center text-white text-xl font-bold">
+                            T
+                        </div>
+                        <span class="text-xl font-bold text-white">TalimBot</span>
+                    </div>
+
+                    <!-- Navigation Links -->
+                    <div class="hidden md:flex items-center gap-6">
+                        <a href="teacher-dashboard.html" class="text-white font-bold border-b-2 border-white pb-1">
+                            داشبورد
+                        </a>
+                        <!-- student-data.html removed - all 30 students already exist -->
+                    </div>
+
+                    <!-- User Menu -->
+                    <div class="flex items-center gap-4">
+                        <div class="flex items-center gap-2">
+                            <div class="w-10 h-10 bg-white/20 rounded-full flex items-center justify-center">
+                                <svg class="w-6 h-6 text-white" fill="currentColor" viewBox="0 0 20 20">
+                                    <path d="M10 9a3 3 0 100-6 3 3 0 000 6zm-7 9a7 7 0 1114 0H3z"/>
+                                    <path d="M10 2a1 1 0 011 1v1a1 1 0 11-2 0V3a1 1 0 011-1z"/>
+                                </svg>
+                            </div>
+                            <div class="hidden md:block text-right">
+                                <p class="text-sm font-bold text-white">معلم</p>
+                                <p class="text-xs text-white/80">مدیر سیستم</p>
+                            </div>
+                        </div>
+                        <a href="login.html" class="text-white/80 hover:text-red-300 transition-colors" title="خروج">
+                            <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 16l4-4m0 0l-4-4m4 4H7m6 4v1a3 3 0 01-3 3H6a3 3 0 01-3-3V7a3 3 0 013-3h4a3 3 0 013 3v1"/>
+                            </svg>
+                        </a>
+                    </div>
+                </div>
+            </div>
+        </nav>
+
+        <!-- Page Header -->
+        <div class="max-w-7xl mx-auto px-4 py-8">
+            <div class="mb-8">
+                <h1 class="text-4xl font-bold text-gray-900 mb-2 flex items-center gap-3">
+                    <svg class="w-10 h-10 text-blue-600" fill="currentColor" viewBox="0 0 20 20">
+                        <path d="M10 9a3 3 0 100-6 3 3 0 000 6zm-7 9a7 7 0 1114 0H3z"/>
+                        <path d="M10 2a1 1 0 011 1v1a1 1 0 11-2 0V3a1 1 0 011-1z"/>
+                    </svg>
+                    پنل مدیریت معلم
+                </h1>
+                <p class="text-gray-600">مدیریت گروه‌بندی دانش آموزان</p>
+            </div>
+        </div>
+
+        <div class="max-w-7xl mx-auto px-4 py-6 space-y-6">
+            <!-- Stats Grid -->
+            <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
+                <div class="bg-white rounded-2xl shadow-lg p-6 border-r-4 border-blue-500">
+                    <div class="flex items-center justify-between">
+                        <div>
+                            <p class="text-gray-600 text-sm font-medium">تعداد کل دانش آموزان</p>
+                            <p class="text-3xl font-bold text-gray-900 mt-2" id="totalStudents">30</p>
+                        </div>
+                        <div class="bg-blue-100 p-4 rounded-xl">
+                            <svg class="w-8 h-8 text-blue-600" fill="currentColor" viewBox="0 0 20 20">
+                                <path d="M9 6a3 3 0 11-6 0 3 3 0 016 0zM17 6a3 3 0 11-6 0 3 3 0 016 0zM12.93 17c.046-.327.07-.66.07-1a6.97 6.97 0 00-1.5-4.33A5 5 0 0119 16v1h-6.07zM6 11a5 5 0 015 5v1H1v-1a5 5 0 015-5z"/>
+                            </svg>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="bg-white rounded-2xl shadow-lg p-6 border-r-4 border-green-500">
+                    <div class="flex items-center justify-between">
+                        <div>
+                            <p class="text-gray-600 text-sm font-medium">پروفایل‌های تکمیل شده</p>
+                            <p class="text-3xl font-bold text-gray-900 mt-2" id="studentsWithInfo">0</p>
+                        </div>
+                        <div class="bg-green-100 p-4 rounded-xl">
+                            <svg class="w-8 h-8 text-green-600" fill="currentColor" viewBox="0 0 20 20">
+                                <path fill-rule="evenodd" d="M6.267 3.455a3.066 3.066 0 001.745-.723 3.066 3.066 0 013.976 0 3.066 3.066 0 001.745.723 3.066 3.066 0 012.812 2.812c.051.643.304 1.254.723 1.745a3.066 3.066 0 010 3.976 3.066 3.066 0 00-.723 1.745 3.066 3.066 0 01-2.812 2.812 3.066 3.066 0 00-1.745.723 3.066 3.066 0 01-3.976 0 3.066 3.066 0 00-1.745-.723 3.066 3.066 0 01-2.812-2.812 3.066 3.066 0 00-.723-1.745 3.066 3.066 0 010-3.976 3.066 3.066 0 00.723-1.745 3.066 3.066 0 012.812-2.812zm7.44 5.252a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/>
+                            </svg>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="bg-white rounded-2xl shadow-lg p-6 border-r-4 border-orange-500">
+                    <div class="flex items-center justify-between">
+                        <div>
+                            <p class="text-gray-600 text-sm font-medium">دانش آموزان گروه‌بندی شده</p>
+                            <p class="text-3xl font-bold text-gray-900 mt-2" id="studentsGrouped">0</p>
+                        </div>
+                        <div class="bg-orange-100 p-4 rounded-xl">
+                            <svg class="w-8 h-8 text-orange-600" fill="currentColor" viewBox="0 0 20 20">
+                                <path d="M2 6a2 2 0 012-2h5l2 2h5a2 2 0 012 2v6a2 2 0 01-2 2H4a2 2 0 01-2-2V6z"/>
+                            </svg>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Course & Status -->
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+                <!-- Course Name -->
+                <div class="bg-white rounded-2xl shadow-lg p-6">
+                    <h2 class="text-lg font-bold text-gray-900 mb-4 flex items-center gap-2">
+                        <svg class="w-6 h-6 text-blue-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M9 4.804A7.968 7.968 0 005.5 4c-1.255 0-2.443.29-3.5.804v10A7.969 7.969 0 015.5 14c1.669 0 3.218.51 4.5 1.385A7.962 7.962 0 0114.5 14c1.255 0 2.443.29 3.5.804v-10A7.968 7.968 0 0014.5 4c-1.255 0-2.443.29-3.5.804V12a1 1 0 11-2 0V4.804z"/>
+                        </svg>
+                        اطلاعات درس
+                    </h2>
+                    <form id="courseForm" onsubmit="saveCourse(event)" class="space-y-4">
+                        <div>
+                            <label for="courseNameInput" class="block text-sm font-semibold text-gray-700 mb-2">نام درس</label>
+                            <input 
+                                type="text" 
+                                id="courseNameInput" 
+                                placeholder="مثال: ریاضی، ادبیات، علوم"
+                                class="w-full p-3 border-2 border-gray-300 rounded-xl focus:border-blue-500 focus:ring-2 focus:ring-blue-200 outline-none transition-all"
+                                required
+                            >
+                        </div>
+                        <div class="flex justify-center">
+                            <button type="submit" class="w-full md:w-1/3 bg-blue-600 text-white py-3 rounded-xl font-semibold hover:bg-blue-700 transition-colors flex items-center justify-center gap-2">
+                                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7H5a2 2 0 00-2 2v9a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-3m-1 4l-3 3m0 0l-3-3m3 3V4"/>
+                                </svg>
+                                ذخیره نام درس
+                            </button>
+                        </div>
+                    </form>
+                </div>
+
+                <!-- Grouping Status -->
+                <div class="bg-white rounded-2xl shadow-lg p-6">
+                    <h2 class="text-lg font-bold text-gray-900 mb-4 flex items-center gap-2">
+                        <svg class="w-6 h-6 text-green-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M2 11a1 1 0 011-1h2a1 1 0 011 1v5a1 1 0 01-1 1H3a1 1 0 01-1-1v-5zM8 7a1 1 0 011-1h2a1 1 0 011 1v9a1 1 0 01-1 1H9a1 1 0 01-1-1V7zM14 4a1 1 0 011-1h2a1 1 0 011 1v12a1 1 0 01-1 1h-2a1 1 0 01-1-1V4z"/>
+                        </svg>
+                        وضعیت گروه‌بندی
+                    </h2>
+                    <div id="statusInfo" class="fade-in">
+                        <!-- Populated by JS -->
+                    </div>
+                </div>
+            </div>
+
+            <!-- Grouping Actions -->
+            <div class="bg-white rounded-2xl shadow-lg p-6">
+                <h2 class="text-lg font-bold text-gray-900 mb-4 flex items-center gap-2">
+                    <span class="text-2xl">⚙️</span>
+                    عملیات گروه‌بندی
+                </h2>
+                <div class="space-y-4">
+                    <div class="bg-blue-50 border border-blue-200 rounded-xl p-4">
+                        <h4 class="font-bold text-blue-900 mb-2 flex items-center gap-2">
+                            <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                                <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7-4a1 1 0 11-2 0 1 1 0 012 0zM9 9a1 1 0 000 2v3a1 1 0 001 1h1a1 1 0 100-2v-3a1 1 0 00-1-1H9z" clip-rule="evenodd"/>
+                            </svg>
+                            آماده گروه‌بندی
+                        </h4>
+                        <p class="text-gray-700 mb-2">
+                            <strong class="text-2xl text-blue-600" id="readyStudentsCount">0</strong> 
+                            دانش آموز آماده گروه‌بندی هستند.
+                        </p>
+                        <div class="text-sm text-gray-700 space-y-1 bg-white rounded-lg p-3 mt-2">
+                            <p class="font-semibold text-gray-800 mb-2">🎯 معیارهای گروه‌بندی علمی (سنین 15-16 سال، به ترتیب اولویت):</p>
+                            <div class="mr-4 space-y-1">
+                                <p><strong>1. بهینه‌سازی ZPD ناحیه رشد نزدیک (30%):</strong> ترکیب نمرات بالا با متوسط برای یادگیری همیاری و آموزش همتا-به-همتا</p>
+                                <p><strong>2. تکمیل MBTI (25%):</strong> ترکیب شخصیت‌های مکمل (نه مشابه) - مثال: ENFP+INTJ، ENTP+INFJ - تعادل درون‌گرا/برون‌گرا</p>
+                                <p><strong>3. تنوع VARK (20%):</strong> ترکیب سبک‌های یادگیری دیداری، شنیداری، خواندن/نوشتن و حرکتی در هر گروه</p>
+                                <p><strong>4. انگیزش تحصیلی - AMS (15%):</strong> توزیع دانش‌آموزان با انگیزه بالا (>140) در گروه‌ها برای الهام‌بخشی</p>
+                                <p><strong>5. مهارت همکاری (10%):</strong> دانش‌آموزان با مهارت همکاری بالا (>88) به عنوان تسهیل‌گر اجتماعی</p>
+                                <p><strong>6. ویژگی‌های درس:</strong> <span id="courseNameInCriteria">تطبیق با نیازهای درس (ریاضی: تفکر منطقی، ادبیات: احساسی)</span></p>
+                                <p class="text-orange-600 italic mt-1"><strong>7. ترجیحات دانش‌آموزان (5%):</strong> فقط اگر با معیارهای بالا تضاد نداشته باشد - نوجوانان از کار با افراد جدید رشد می‌کنند</p>
+                            </div>
+                        </div>
+                        <div class="bg-amber-50 border border-amber-300 rounded-lg p-3 mt-3">
+                            <p class="text-sm text-amber-800 font-medium">
+                                ⚡ نکته مهم: فقط دانش‌آموزانی که MBTI و سبک یادگیری خود را تکمیل کرده‌اند در گروه‌بندی شرکت می‌کنند. 
+                                اگر دانش‌آموزی دوستان خود را انتخاب کرده ولی آن دوستان فرم را تکمیل نکرده‌اند، این انتخاب در نظر گرفته نمی‌شود.
+                            </p>
+                        </div>
+                    </div>
+
+                    <div id="groupingActions" class="flex flex-col items-center gap-4">
+                        <button onclick="startGrouping()" id="startGroupingBtn"
+                                class="w-full md:w-1/3 bg-gradient-to-r from-green-600 to-green-700 text-white py-4 rounded-xl font-bold text-lg hover:from-green-700 hover:to-green-800 transform hover:scale-[1.02] active:scale-[0.98] transition-all shadow-lg flex items-center justify-center gap-2">
+                            <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"/>
+                            </svg>
+                            شروع فرآیند گروه‌بندی
+                        </button>
+                        
+                        <button onclick="handleResetGrouping()" id="resetGroupingBtn"
+                                class="hidden w-full md:w-1/3 bg-gray-600 text-white py-4 rounded-xl font-bold text-lg hover:bg-gray-700 transform hover:scale-[1.02] active:scale-[0.98] transition-all flex items-center justify-center gap-2">
+                            <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"/>
+                            </svg>
+                            بازنشانی گروه‌بندی
+                        </button>
+                        <button onclick="toggleVisibility()" id="toggleVisibilityBtn"
+                                class="hidden w-full md:w-1/3 bg-blue-600 text-white py-4 rounded-xl font-bold text-lg hover:bg-blue-700 transform hover:scale-[1.02] active:scale-[0.98] transition-all flex items-center justify-center gap-2">
+                            <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+                            </svg>
+                            <span id="visibilityButtonText">نمایش نتایج به دانش‌آموزان</span>
+                        </button>
+                    </div>
+
+                    <div id="groupingProgress" class="hidden text-center py-8">
+                        <div class="inline-block w-16 h-16 border-4 border-blue-600 border-t-transparent rounded-full animate-spin mb-4"></div>
+                        <p class="text-gray-700 font-semibold">در حال پردازش الگوریتم گروه‌بندی...</p>
+                        <p class="text-sm text-gray-500 mt-2">ممکن است چند لحظه طول بکشد</p>
+                    </div>
+
+                    <div id="groupingSuccess" class="hidden bg-green-50 border-r-4 border-green-500 p-4 rounded-lg">
+                        <p class="text-green-700 font-semibold flex items-center gap-2">
+                            <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
+                                <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/>
+                            </svg>
+                            گروه‌بندی با موفقیت انجام شد!
+                        </p>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Students List -->
+            <div class="bg-white rounded-2xl shadow-lg p-6">
+                <h2 class="text-lg font-bold text-gray-900 mb-4 flex items-center gap-2">
+                    <span class="text-2xl">📋</span>
+                    لیست تمام دانش آموزان
+                </h2>
+                
+                <div class="text-center mb-4 flex gap-3 justify-center">
+                    <button onclick="toggleStudentList()" id="toggleStudentBtn"
+                            class="bg-blue-600 text-white px-6 py-3 rounded-xl font-semibold hover:bg-blue-700 transition-colors">
+                        نمایش لیست دانش آموزان
+                    </button>
+                    <button onclick="downloadAllData()" 
+                            class="bg-green-600 text-white px-6 py-3 rounded-xl font-semibold hover:bg-green-700 transition-colors">
+                        📥 دانلود همه داده‌ها (JSON)
+                    </button>
+                </div>
+                <div id="studentListContainer" class="hidden">
+                    <div class="overflow-x-auto rounded-xl border border-gray-200">
+                        <table class="w-full">
+                            <thead class="bg-gray-100 sticky top-0">
+                                <tr class="border-b-2 border-blue-500">
+                                    <th class="p-3 text-right text-sm font-bold text-gray-700">شماره دانش آموز</th>
+                                    <th class="p-3 text-right text-sm font-bold text-gray-700">نام</th>
+                                    <th class="p-3 text-center text-sm font-bold text-gray-700">MBTI</th>
+                                    <th class="p-3 text-center text-sm font-bold text-gray-700">سبک یادگیری</th>
+                                    <th class="p-3 text-center text-sm font-bold text-gray-700">AMS</th>
+                                    <th class="p-3 text-center text-sm font-bold text-gray-700">Cooperative</th>
+                                    <th class="p-3 text-center text-sm font-bold text-gray-700">معدل</th>
+                                    <th class="p-3 text-center text-sm font-bold text-gray-700">گروه</th>
+                                    <th class="p-3 text-center text-sm font-bold text-gray-700">عملیات</th>
+                                </tr>
+                            </thead>
+                            <tbody id="studentTableBody">
+                                <!-- Populated by JS -->
+                            </tbody>
+                        </table>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Reset Data Section -->
+            <div class="bg-white rounded-2xl shadow-lg p-6 border-r-4 border-orange-500">
+                <div class="flex items-start gap-4">
+                    <div class="flex-shrink-0">
+                        <svg class="w-8 h-8 text-orange-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"/>
+                        </svg>
+                    </div>
+                    <div class="flex-1">
+                        <h3 class="text-lg font-bold text-gray-900 mb-2">بازنشانی داده‌ها</h3>
+                        <p class="text-sm text-gray-600 mb-4">
+                            این عملیات تمام اطلاعات سیستم را به حالت اولیه بازمی‌گرداند. همه 30 دانش‌آموز (S001 تا S030) بازگردانده می‌شوند، 
+                            تمام تغییرات و گروه‌بندی‌ها حذف می‌شوند و سیستم به حالت پیش‌فرض برمی‌گردد.
+                        </p>
+                        <button onclick="resetAllData()" class="bg-orange-600 hover:bg-orange-700 text-white py-3 px-6 rounded-xl font-semibold transition-colors flex items-center gap-2">
+                            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"/>
+                            </svg>
+                            بازنشانی داده‌ها
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Test Data Generator Section -->
+            <div class="bg-white rounded-2xl shadow-lg p-6 border-r-4 border-green-500">
+                <div class="flex items-start gap-4">
+                    <div class="flex-shrink-0">
+                        <svg class="w-8 h-8 text-green-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path d="M5 3a2 2 0 00-2 2v2a2 2 0 002 2h2a2 2 0 002-2V5a2 2 0 00-2-2H5zM5 11a2 2 0 00-2 2v2a2 2 0 002 2h2a2 2 0 002-2v-2a2 2 0 00-2-2H5zM11 5a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2V5zM14 11a1 1 0 011 1v1h1a1 1 0 110 2h-1v1a1 1 0 11-2 0v-1h-1a1 1 0 110-2h1v-1a1 1 0 011-1z"/>
+                        </svg>
+                    </div>
+                    <div class="flex-1">
+                        <h3 class="text-lg font-bold text-gray-900 mb-2">پر کردن داده‌های تست</h3>
+                        <p class="text-sm text-gray-600 mb-4">
+                            برای تست سیستم گروه‌بندی، 10 دانش‌آموز اول (S001 تا S010) را با داده‌های کامل و تصادفی پر کنید. 
+                            این شامل MBTI، VARK، نمرات AMS و Cooperative و ترجیحات دانش‌آموزی می‌شود.
+                        </p>
+                        <div class="flex gap-3">
+                            <button onclick="fillTestData()" id="fillTestDataBtn" class="bg-green-600 hover:bg-green-700 text-white py-3 px-6 rounded-xl font-semibold transition-colors flex items-center gap-2">
+                                <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                                    <path d="M5 3a2 2 0 00-2 2v2a2 2 0 002 2h2a2 2 0 002-2V5a2 2 0 00-2-2H5zM5 11a2 2 0 00-2 2v2a2 2 0 002 2h2a2 2 0 002-2v-2a2 2 0 00-2-2H5zM11 5a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2V5zM14 11a1 1 0 011 1v1h1a1 1 0 110 2h-1v1a1 1 0 11-2 0v-1h-1a1 1 0 110-2h1v-1a1 1 0 011-1z"/>
+                                </svg>
+                                پر کردن داده‌های تست
+                            </button>
+                            <div id="testDataProgress" class="hidden flex items-center gap-2 text-sm text-gray-600">
+                                <div class="inline-block w-5 h-5 border-2 border-green-600 border-t-transparent rounded-full animate-spin"></div>
+                                <span id="testDataProgressText">در حال پردازش...</span>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Import JSON Data Section -->
+            <div class="bg-white rounded-2xl shadow-lg p-6 border-r-4 border-blue-500">
+                <div class="flex items-start gap-4">
+                    <div class="flex-shrink-0">
+                        <svg class="w-8 h-8 text-blue-600" fill="currentColor" viewBox="0 0 20 20">
+                            <path fill-rule="evenodd" d="M3 17a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM6.293 6.707a1 1 0 010-1.414l3-3a1 1 0 011.414 0l3 3a1 1 0 01-1.414 1.414L11 5.414V13a1 1 0 11-2 0V5.414L7.707 6.707a1 1 0 01-1.414 0z" clip-rule="evenodd"/>
+                        </svg>
+                    </div>
+                    <div class="flex-1">
+                        <h3 class="text-lg font-bold text-gray-900 mb-2">وارد کردن داده‌ها از JSON</h3>
+                        <p class="text-sm text-gray-600 mb-4">
+                            یک فایل JSON حاوی اطلاعات دانش‌آموزان را انتخاب کنید. فایل باید شامل آرایه‌ای از دانش‌آموزان با فیلدهای 
+                            mbti، learningStyle، ams، cooperative و preferredStudents باشد.
+                        </p>
+                        <div class="flex gap-3 items-center">
+                            <input type="file" id="jsonFileInput" accept=".json" class="hidden">
+                            <button onclick="document.getElementById('jsonFileInput').click()" class="bg-blue-600 hover:bg-blue-700 text-white py-3 px-6 rounded-xl font-semibold transition-colors flex items-center gap-2">
+                                <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                                    <path fill-rule="evenodd" d="M3 17a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM6.293 6.707a1 1 0 010-1.414l3-3a1 1 0 011.414 0l3 3a1 1 0 01-1.414 1.414L11 5.414V13a1 1 0 11-2 0V5.414L7.707 6.707a1 1 0 01-1.414 0z" clip-rule="evenodd"/>
+                                </svg>
+                                انتخاب فایل JSON
+                            </button>
+                            <span id="jsonFileName" class="text-sm text-gray-600"></span>
+                            <div id="jsonImportProgress" class="hidden flex items-center gap-2 text-sm text-gray-600">
+                                <div class="inline-block w-5 h-5 border-2 border-blue-600 border-t-transparent rounded-full animate-spin"></div>
+                                <span id="jsonImportProgressText">در حال پردازش...</span>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Group Results -->
+            <div id="groupResultsCard" class="hidden bg-white rounded-2xl shadow-lg p-6">
+                <h2 class="text-lg font-bold text-gray-900 mb-4 flex items-center gap-2">
+                    <svg class="w-6 h-6 text-purple-600" fill="currentColor" viewBox="0 0 20 20">
+                        <path d="M9 6a3 3 0 11-6 0 3 3 0 016 0zM17 6a3 3 0 11-6 0 3 3 0 016 0zM12.93 17c.046-.327.07-.66.07-1a6.97 6.97 0 00-1.5-4.33A5 5 0 0119 16v1h-6.07zM6 11a5 5 0 015 5v1H1v-1a5 5 0 015-5z"/>
+                    </svg>
+                    نتایج گروه‌بندی
+                </h2>
+                <div id="groupResultsList" class="grid grid-cols-1 md:grid-cols-2 gap-4">
+                    <!-- Populated by JS -->
+                </div>
+            </div>
+
+            <!-- Footer -->
+            <footer class="bg-white border-t border-gray-200 mt-16">
+                <div class="max-w-7xl mx-auto px-4 py-6">
+                    <div class="text-center text-gray-600 text-sm">
+                        <p class="mb-2">نسخه 1.0.0 | آبان 1404</p>
+                        <p>© ۲۰۲۵ TalimBot - سیستم گروه‌بندی هوشمند دانش آموزان</p>
+                    </div>
+                </div>
+            </footer>
+        </div>
+    </div>
+
+    <script src="../assets/js/data.js"></script>
+    <script src="../assets/js/grouping.js"></script>
+    <script>
+        let isStudentListVisible = false;
+
+        // Check if user is authenticated as teacher
+        function checkAuth() {
+            const isTeacher = sessionStorage.getItem('isTeacher');
+            if (!isTeacher) {
+                window.location.href = 'login.html';
+                return false;
+            }
+            return true;
+        }
+
+        async function loadDashboard() {
+            if (!checkAuth()) return;
+
+            const stats = await getGroupingStats();
+            const courseName = await getCourseName();
+
+            document.getElementById('totalStudents').textContent = stats.totalStudents;
+            document.getElementById('studentsWithInfo').textContent = stats.studentsWithCompleteInfo;
+            document.getElementById('studentsGrouped').textContent = stats.studentsGrouped;
+            document.getElementById('readyStudentsCount').textContent = stats.studentsWithCompleteInfo;
+
+            if (courseName) {
+                document.getElementById('courseNameInput').value = courseName;
+                // Update the course name in the criteria description
+                const courseNameEl = document.getElementById('courseNameInCriteria');
+                if (courseNameEl) {
+                    courseNameEl.textContent = `انتخاب بر اساس نیاز درس "${courseName}"`;
+                }
+            }
+
+            await updateStatus(stats);
+            await updateStudentTable();
+        }
+
+        async function updateStatus(stats) {
+            const statusDiv = document.getElementById('statusInfo');
+            const toggleBtn = document.getElementById('toggleVisibilityBtn');
+            const toggleBtnText = document.getElementById('visibilityButtonText');
+
+            if (stats.groupingComplete) {
+                statusDiv.innerHTML = `
+                    <div class="bg-green-50 border-r-4 border-green-500 p-4 rounded-lg">
+                        <p class="font-bold text-green-700 mb-1 flex items-center gap-2">
+                            <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
+                                <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/>
+                            </svg>
+                            گروه‌بندی انجام شد!
+                        </p>
+                        <p class="text-sm text-green-600">${stats.studentsGrouped} دانش آموز در ${stats.groups.length} گروه برای درس <strong>${stats.courseName}</strong></p>
+                        ${stats.resultsVisible ? 
+                            '<p class="text-sm text-blue-600 mt-2">✅ نتایج برای دانش‌آموزان نمایش داده می‌شود</p>' : 
+                            '<p class="text-sm text-orange-600 mt-2">⚠️ نتایج هنوز برای دانش‌آموزان مخفی است</p>'}
+                    </div>
+                `;
+                document.getElementById('startGroupingBtn').classList.add('hidden');
+                document.getElementById('resetGroupingBtn').classList.remove('hidden');
+                toggleBtn.classList.remove('hidden');
+                
+                // Update button text based on visibility status
+                if (stats.resultsVisible) {
+                    toggleBtnText.textContent = 'مخفی کردن نتایج از دانش‌آموزان';
+                    toggleBtn.classList.remove('bg-blue-600', 'hover:bg-blue-700');
+                    toggleBtn.classList.add('bg-orange-600', 'hover:bg-orange-700');
+                } else {
+                    toggleBtnText.textContent = 'نمایش نتایج به دانش‌آموزان';
+                    toggleBtn.classList.remove('bg-orange-600', 'hover:bg-orange-700');
+                    toggleBtn.classList.add('bg-blue-600', 'hover:bg-blue-700');
+                }
+                
+                await displayGroupResults(stats.groups);
+            } else {
+                statusDiv.innerHTML = `
+                    <div class="bg-blue-50 border-r-4 border-blue-500 p-4 rounded-lg">
+                        <p class="font-bold text-blue-700 mb-1">ℹ️ آماده گروه‌بندی</p>
+                        <p class="text-sm text-blue-600">${stats.studentsWithCompleteInfo} دانش آموز آماده هستند</p>
+                    </div>
+                `;
+                document.getElementById('startGroupingBtn').classList.remove('hidden');
+                document.getElementById('resetGroupingBtn').classList.add('hidden');
+                toggleBtn.classList.add('hidden');
+                document.getElementById('groupResultsCard').classList.add('hidden');
+            }
+        }
+
+        function saveCourse(event) {
+            event.preventDefault();
+            const courseName = document.getElementById('courseNameInput').value.trim();
+            
+            if (courseName) {
+                setCourseName(courseName);
+                // Update the display immediately
+                const courseNameEl = document.getElementById('courseNameInCriteria');
+                if (courseNameEl) {
+                    courseNameEl.textContent = `انتخاب بر اساس نیاز درس "${courseName}"`;
+                }
+                alert('نام درس با موفقیت ذخیره شد!');
+            }
+        }
+
+        async function startGrouping() {
+            const courseName = document.getElementById('courseNameInput').value.trim();
+            
+            if (!courseName) {
+                alert('لطفاً ابتدا نام درس را وارد کنید!');
+                return;
+            }
+
+            const stats = await getGroupingStats();
+            
+            if (stats.studentsWithCompleteInfo === 0) {
+                alert('هیچ دانش آموزی پروفایل خود را تکمیل نکرده است!');
+                return;
+            }
+
+            const confirmed = confirm(`آماده گروه‌بندی ${stats.studentsWithCompleteInfo} دانش آموز؟`);
+            if (!confirmed) return;
+
+            document.getElementById('groupingActions').classList.add('hidden');
+            document.getElementById('groupingProgress').classList.remove('hidden');
+
+            try {
+                const groupingResult = await performGrouping(courseName);
+                
+                document.getElementById('groupingProgress').classList.add('hidden');
+                document.getElementById('groupingSuccess').classList.remove('hidden');
+                document.getElementById('groupingActions').classList.remove('hidden');
+                
+                setTimeout(() => {
+                    loadDashboard();
+                }, 2000);
+                
+            } catch (error) {
+                let errorMsg = 'خطا در گروه‌بندی: ' + error.message;
+                alert(errorMsg);
+                
+                document.getElementById('groupingProgress').classList.add('hidden');
+                document.getElementById('groupingActions').classList.remove('hidden');
+            }
+        }
+
+        async function handleResetGrouping() {
+            if (!confirm('آیا مطمئن هستید که می‌خواهید گروه‌بندی را بازنشانی کنید؟\n\n✓ گروه‌بندی‌های فعلی حذف می‌شوند\n✓ اطلاعات دانش‌آموزان (MBTI، VARK، AMS، Cooperative) حفظ می‌مانند\n✓ می‌توانید دوباره گروه‌بندی انجام دهید')) return;
+            
+            const password = prompt('لطفاً رمز عبور استاد را وارد کنید:');
+            if (!password) return;
+
+            try {
+                await resetGrouping(password);
+                // Hide success message
+                document.getElementById('groupingSuccess').classList.add('hidden');
+                alert('✅ گروه‌بندی با موفقیت بازنشانی شد!\n\nاطلاعات دانش‌آموزان حفظ شده و می‌توانید دوباره گروه‌بندی کنید.');
+                loadDashboard();
+            } catch (error) {
+                if (error.message.includes('Invalid password')) {
+                    alert('رمز عبور اشتباه است!');
+                } else {
+                    alert('خطا در بازنشانی: ' + error.message);
+                }
+            }
+        }
+
+        async function toggleVisibility() {
+            const password = prompt('لطفاً رمز عبور استاد را وارد کنید:');
+            if (!password) return;
+
+            try {
+                const result = await toggleResultsVisibility(password);
+                if (result.success) {
+                    const message = result.resultsVisible ? 
+                        'نتایج اکنون برای دانش‌آموزان قابل مشاهده است! ✅' : 
+                        'نتایج از دانش‌آموزان مخفی شد! 🔒';
+                    alert(message);
+                    loadDashboard();
+                } else {
+                    alert('خطا در تغییر وضعیت نمایش');
+                }
+            } catch (error) {
+                if (error.message.includes('Invalid password')) {
+                    alert('رمز عبور اشتباه است!');
+                } else {
+                    alert('خطا: ' + error.message);
+                }
+            }
+        }
+
+        async function displayGroupResults(groups) {
+            const card = document.getElementById('groupResultsCard');
+            const container = document.getElementById('groupResultsList');
+            
+            card.classList.remove('hidden');
+            container.innerHTML = '';
+
+            const allStudents = await getAllStudents();
+
+            groups.forEach(group => {
+                const groupDiv = document.createElement('div');
+                groupDiv.className = 'bg-gradient-to-br from-blue-50 to-blue-100 border-2 border-blue-300 rounded-xl p-4';
+                
+                let html = `<h3 class="font-bold text-blue-900 mb-3">گروه ${group.groupNumber} (${group.students.length} نفر)</h3>`;
+                
+                if (group.reasoning) {
+                    html += `<p class="text-xs text-blue-700 mb-3 italic">${group.reasoning}</p>`;
+                }
+                
+                html += '<ul class="space-y-1">';
+                group.students.forEach(studentNumber => {
+                    const student = allStudents.find(s => s.studentNumber === studentNumber);
+                    if (student) {
+                        html += `<li class="text-sm text-gray-700">👤 ${student.name} (${student.mbti || 'N/A'})</li>`;
+                    }
+                });
+                html += '</ul>';
+                
+                groupDiv.innerHTML = html;
+                container.appendChild(groupDiv);
+            });
+        }
+
+        function toggleStudentList() {
+            isStudentListVisible = !isStudentListVisible;
+            const container = document.getElementById('studentListContainer');
+            const btn = document.getElementById('toggleStudentBtn');
+            
+            container.classList.toggle('hidden', !isStudentListVisible);
+            btn.textContent = isStudentListVisible ? 'مخفی کردن لیست' : 'نمایش لیست دانش آموزان';
+        }
+
+        async function updateStudentTable() {
+            const tbody = document.getElementById('studentTableBody');
+            tbody.innerHTML = '';
+
+            const allStudents = await getAllStudents();
+
+            allStudents.forEach((student, index) => {
+                const tr = document.createElement('tr');
+                tr.className = index % 2 === 0 ? 'bg-gray-50' : 'bg-white';
+                tr.id = `row-${student.studentNumber}`;
+                tr.innerHTML = `
+                    <td class="p-3 text-sm">${student.studentNumber}</td>
+                    <td class="p-3 text-sm">
+                        <span class="view-mode">${student.name}</span>
+                        <input type="text" class="edit-mode hidden w-full p-1 border border-gray-300 rounded" value="${student.name}">
+                    </td>
+                    <td class="p-3 text-sm text-center">
+                        <span class="view-mode">${student.mbti || '-'}</span>
+                        <select class="edit-mode hidden w-full p-1 border border-gray-300 rounded text-xs">
+                            <option value="">انتخاب کنید</option>
+                            <option value="INTJ" ${student.mbti === 'INTJ' ? 'selected' : ''}>INTJ</option>
+                            <option value="INTP" ${student.mbti === 'INTP' ? 'selected' : ''}>INTP</option>
+                            <option value="ENTJ" ${student.mbti === 'ENTJ' ? 'selected' : ''}>ENTJ</option>
+                            <option value="ENTP" ${student.mbti === 'ENTP' ? 'selected' : ''}>ENTP</option>
+                            <option value="INFJ" ${student.mbti === 'INFJ' ? 'selected' : ''}>INFJ</option>
+                            <option value="INFP" ${student.mbti === 'INFP' ? 'selected' : ''}>INFP</option>
+                            <option value="ENFJ" ${student.mbti === 'ENFJ' ? 'selected' : ''}>ENFJ</option>
+                            <option value="ENFP" ${student.mbti === 'ENFP' ? 'selected' : ''}>ENFP</option>
+                            <option value="ISTJ" ${student.mbti === 'ISTJ' ? 'selected' : ''}>ISTJ</option>
+                            <option value="ISFJ" ${student.mbti === 'ISFJ' ? 'selected' : ''}>ISFJ</option>
+                            <option value="ESTJ" ${student.mbti === 'ESTJ' ? 'selected' : ''}>ESTJ</option>
+                            <option value="ESFJ" ${student.mbti === 'ESFJ' ? 'selected' : ''}>ESFJ</option>
+                            <option value="ISTP" ${student.mbti === 'ISTP' ? 'selected' : ''}>ISTP</option>
+                            <option value="ISFP" ${student.mbti === 'ISFP' ? 'selected' : ''}>ISFP</option>
+                            <option value="ESTP" ${student.mbti === 'ESTP' ? 'selected' : ''}>ESTP</option>
+                            <option value="ESFP" ${student.mbti === 'ESFP' ? 'selected' : ''}>ESFP</option>
+                        </select>
+                    </td>
+                    <td class="p-3 text-sm text-center">
+                        <span class="view-mode">${student.learningStyle || '-'}</span>
+                        <select class="edit-mode hidden w-full p-1 border border-gray-300 rounded text-xs">
+                            <option value="">انتخاب کنید</option>
+                            <option value="Visual" ${student.learningStyle === 'Visual' ? 'selected' : ''}>Visual (دیداری)</option>
+                            <option value="Aural" ${student.learningStyle === 'Aural' ? 'selected' : ''}>Aural (شنیداری)</option>
+                            <option value="Read/Write" ${student.learningStyle === 'Read/Write' ? 'selected' : ''}>Read/Write (خواندن/نوشتن)</option>
+                            <option value="Kinesthetic" ${student.learningStyle === 'Kinesthetic' ? 'selected' : ''}>Kinesthetic (حرکتی/عملی)</option>
+                        </select>
+                    </td>
+                    <td class="p-3 text-sm text-center">
+                        <span class="view-mode">${student.ams || '-'}</span>
+                        <input type="text" class="edit-mode hidden w-full p-1 border border-gray-300 rounded text-xs" value="${student.ams || ''}">
+                    </td>
+                    <td class="p-3 text-sm text-center">
+                        <span class="view-mode">${student.cooperative || '-'}</span>
+                        <input type="text" class="edit-mode hidden w-full p-1 border border-gray-300 rounded text-xs" value="${student.cooperative || ''}">
+                    </td>
+                    <td class="p-3 text-sm text-center font-semibold">
+                        <span class="view-mode">${student.grade}</span>
+                        <input type="number" class="edit-mode hidden w-20 p-1 border border-gray-300 rounded text-center" value="${student.grade}" min="0" max="20" step="0.1">
+                    </td>
+                    <td class="p-3 text-sm text-center text-blue-600 font-bold">${student.group || '-'}</td>
+                    <td class="p-3 text-center">
+                        <div class="flex gap-1 justify-center">
+                            <button onclick="editStudent('${student.studentNumber}')" class="view-mode bg-blue-600 text-white px-3 py-1 rounded-lg text-xs hover:bg-blue-700">
+                                ✏️ ویرایش
+                            </button>
+                            <button onclick="saveStudent('${student.studentNumber}')" class="edit-mode hidden bg-green-600 text-white px-3 py-1 rounded-lg text-xs hover:bg-green-700">
+                                ✓ ذخیره
+                            </button>
+                            <button onclick="cancelEdit('${student.studentNumber}')" class="edit-mode hidden bg-gray-600 text-white px-3 py-1 rounded-lg text-xs hover:bg-gray-700">
+                                ✕ لغو
+                            </button>
+                        </div>
+                    </td>
+                `;
+                tbody.appendChild(tr);
+            });
+        }
+
+        function editStudent(studentNumber) {
+            const row = document.getElementById(`row-${studentNumber}`);
+            row.querySelectorAll('.view-mode').forEach(el => el.classList.add('hidden'));
+            row.querySelectorAll('.edit-mode').forEach(el => el.classList.remove('hidden'));
+        }
+
+        function cancelEdit(studentNumber) {
+            const row = document.getElementById(`row-${studentNumber}`);
+            row.querySelectorAll('.edit-mode').forEach(el => el.classList.add('hidden'));
+            row.querySelectorAll('.view-mode').forEach(el => el.classList.remove('hidden'));
+        }
+
+        async function saveStudent(studentNumber) {
+            const row = document.getElementById(`row-${studentNumber}`);
+            
+            // Get specific input elements - order matters!
+            const textInputs = row.querySelectorAll('input[type="text"]');
+            const nameInput = textInputs[0];  // First text input is name
+            const amsInput = textInputs[1];   // Second text input is AMS
+            const cooperativeInput = textInputs[2];  // Third text input is cooperative
+            const mbtiSelect = row.querySelectorAll('select')[0];
+            const learningStyleSelect = row.querySelectorAll('select')[1];
+            const gradeInput = row.querySelector('input[type="number"]');
+            
+            // Build update object with only non-empty values to prevent overwriting existing data
+            const updatedData = {};
+            
+            const name = nameInput.value.trim();
+            const mbti = mbtiSelect.value;
+            const learningStyle = learningStyleSelect.value;
+            const ams = amsInput.value.trim();
+            const cooperative = cooperativeInput.value.trim();
+            const grade = gradeInput.value;
+
+            // Name is required
+            if (!name) {
+                alert('نام نمی‌تواند خالی باشد!');
+                return;
+            }
+            updatedData.name = name;
+
+            // Only include other fields if they have values
+            if (mbti) updatedData.mbti = mbti;
+            if (learningStyle) updatedData.learningStyle = learningStyle;
+            if (ams) updatedData.ams = ams;
+            if (cooperative) updatedData.cooperative = cooperative;
+            if (grade) updatedData.grade = parseFloat(grade);
+
+            // Update student using the proper data.js function
+            const success = await updateStudent(studentNumber, updatedData);
+            
+            if (success) {
+                alert('اطلاعات دانش آموز با موفقیت ذخیره شد!');
+                cancelEdit(studentNumber);
+                await updateStudentTable();
+                await loadDashboard();
+            } else {
+                alert('خطا در ذخیره اطلاعات!');
+            }
+        }
+
+        async function resetAllData() {
+            if (!confirm('⚠️ هشدار: این عملیات غیرقابل بازگشت است!\n\nآیا مطمئن هستید که می‌خواهید تمام داده‌ها را بازنشانی کنید؟\n\n• همه اطلاعات دانش‌آموزان (MBTI، VARK، AMS، Cooperative، ترجیحات) حذف می‌شوند\n• تمام گروه‌بندی‌ها پاک می‌شوند\n• نام درس حذف می‌شود\n• سیستم به حالت اولیه برمی‌گردد')) {
+                return;
+            }
+
+            const password = prompt('لطفاً رمز عبور استاد را وارد کنید:');
+            if (!password) return;
+
+            try {
+                const result = await fetch(`${API_BASE_URL}/data/reset-all`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ password })
+                });
+                
+                if (!result.ok) {
+                    const error = await result.json();
+                    throw new Error(error.detail || 'Reset failed');
+                }
+                
+                alert('✅ تمام داده‌ها با موفقیت بازنشانی شدند!\n\nسیستم به حالت اولیه بازگردانده شد.');
+                window.location.reload();
+            } catch (error) {
+                if (error.message.includes('Invalid password') || error.message.includes('403')) {
+                    alert('رمز عبور اشتباه است!');
+                } else {
+                    alert('خطا در بازنشانی: ' + error.message);
+                }
+            }
+        }
+
+        // Test data generator
+        async function fillTestData() {
+            if (!confirm('آیا می‌خواهید 10 دانش‌آموز اول (S001 تا S010) را با داده‌های تست کامل پر کنید؟\n\nاین عملیات داده‌های موجود این دانش‌آموزان را جایگزین می‌کند.')) {
+                return;
+            }
+
+            const MBTI_TYPES = ['INTJ', 'INTP', 'ENTJ', 'ENTP', 'INFJ', 'INFP', 'ENFJ', 'ENFP', 
+                               'ISTJ', 'ISFJ', 'ESTJ', 'ESFJ', 'ISTP', 'ISFP', 'ESTP', 'ESFP'];
+            const VARK_STYLES = ['Visual', 'Aural', 'Read/Write', 'Kinesthetic'];
+
+            function randomChoice(arr) {
+                return arr[Math.floor(Math.random() * arr.length)];
+            }
+
+            function randomInt(min, max) {
+                return Math.floor(Math.random() * (max - min + 1)) + min;
+            }
+
+            const btn = document.getElementById('fillTestDataBtn');
+            const progress = document.getElementById('testDataProgress');
+            const progressText = document.getElementById('testDataProgressText');
+
+            btn.disabled = true;
+            progress.classList.remove('hidden');
+
+            let successCount = 0;
+
+            try {
+                for (let i = 1; i <= 10; i++) {
+                    const studentId = `S${String(i).padStart(3, '0')}`;
+                    progressText.textContent = `در حال پردازش ${studentId}... (${successCount}/10)`;
+
+                    // Generate 2-3 random preferred students (excluding self)
+                    const allStudents = Array.from({length: 30}, (_, idx) => `S${String(idx + 1).padStart(3, '0')}`);
+                    const otherStudents = allStudents.filter(s => s !== studentId);
+                    const numPreferred = randomInt(2, 3);
+                    const preferred = [];
+                    for (let j = 0; j < numPreferred; j++) {
+                        const randomStudent = otherStudents[Math.floor(Math.random() * otherStudents.length)];
+                        if (!preferred.includes(randomStudent)) {
+                            preferred.push(randomStudent);
+                        }
+                    }
+
+                    const testData = {
+                        mbti: randomChoice(MBTI_TYPES),
+                        learningStyle: randomChoice(VARK_STYLES),
+                        ams: String(randomInt(80, 180)),
+                        cooperative: String(randomInt(60, 120)),
+                        preferredStudents: preferred
+                    };
+
+                    await updateStudent(studentId, testData);
+                    successCount++;
+                    progressText.textContent = `${studentId} انجام شد... (${successCount}/10)`;
+                }
+
+                progress.classList.add('hidden');
+                alert(`✅ موفق!\n\n10 دانش‌آموز با داده‌های تست پر شدند:\n• MBTI: تصادفی از 16 نوع\n• VARK: ${VARK_STYLES.join(', ')}\n• AMS: 80-180\n• Cooperative: 60-120\n• ترجیحات: 2-3 دانش‌آموز برای هر نفر\n\nحالا می‌توانید گروه‌بندی را تست کنید!`);
+                window.location.reload();
+            } catch (error) {
+                progress.classList.add('hidden');
+                alert('خطا در پر کردن داده‌های تست: ' + error.message);
+            } finally {
+                btn.disabled = false;
+            }
+        }
+
+        // JSON file import handler
+        document.getElementById('jsonFileInput').addEventListener('change', async function(event) {
+            const file = event.target.files[0];
+            if (!file) return;
+
+            document.getElementById('jsonFileName').textContent = file.name;
+
+            const reader = new FileReader();
+            reader.onload = async function(e) {
+                try {
+                    const jsonData = JSON.parse(e.target.result);
+                    
+                    // Accept both formats: direct array or {students: [...]} object
+                    let studentsArray;
+                    if (Array.isArray(jsonData)) {
+                        studentsArray = jsonData;
+                    } else if (jsonData.students && Array.isArray(jsonData.students)) {
+                        studentsArray = jsonData.students;
+                    } else {
+                        alert('خطا: فایل JSON باید شامل آرایه students باشد یا یک آرایه مستقیم از دانش‌آموزان.');
+                        return;
+                    }
+
+                    if (!confirm(`آیا می‌خواهید داده‌های ${studentsArray.length} دانش‌آموز را از فایل JSON وارد کنید؟\n\nاین عملیات داده‌های موجود را جایگزین می‌کند.`)) {
+                        return;
+                    }
+
+                    const progress = document.getElementById('jsonImportProgress');
+                    const progressText = document.getElementById('jsonImportProgressText');
+                    
+                    progress.classList.remove('hidden');
+                    let successCount = 0;
+                    let errorCount = 0;
+
+                    for (const student of studentsArray) {
+                        // Validate required field
+                        if (!student.studentNumber) {
+                            console.warn('Student missing studentNumber, skipping:', student);
+                            errorCount++;
+                            continue;
+                        }
+
+                        progressText.textContent = `در حال پردازش ${student.studentNumber}... (${successCount}/${studentsArray.length})`;
+
+                        // Build update object with only provided fields
+                        const updates = {};
+                        if (student.mbti) updates.mbti = student.mbti;
+                        if (student.learningStyle) updates.learningStyle = student.learningStyle;
+                        if (student.ams !== undefined && student.ams !== null) updates.ams = String(student.ams);
+                        if (student.cooperative !== undefined && student.cooperative !== null) updates.cooperative = String(student.cooperative);
+                        if (student.preferredStudents) updates.preferredStudents = student.preferredStudents;
+
+                        try {
+                            await updateStudent(student.studentNumber, updates);
+                            successCount++;
+                        } catch (error) {
+                            console.error(`Error updating ${student.studentNumber}:`, error);
+                            errorCount++;
+                        }
+                    }
+
+                    progress.classList.add('hidden');
+                    
+                    let message = `✅ موفق!\n\n${successCount} دانش‌آموز با موفقیت به‌روزرسانی شدند.`;
+                    if (errorCount > 0) {
+                        message += `\n\n⚠️ ${errorCount} دانش‌آموز دارای خطا بودند.`;
+                    }
+                    
+                    alert(message);
+                    window.location.reload();
+
+                } catch (error) {
+                    alert('خطا در خواندن فایل JSON: ' + error.message);
+                    document.getElementById('jsonImportProgress').classList.add('hidden');
+                }
+            };
+
+            reader.readAsText(file);
+        });
+
+        async function downloadAllData() {
+            try {
+                const response = await fetch(`${API_BASE_URL}/data/backup`);
+                if (!response.ok) {
+                    throw new Error('Failed to fetch data');
+                }
+                
+                const data = await response.json();
+                
+                // Create a blob with the JSON data
+                const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' });
+                
+                // Create download link
+                const url = window.URL.createObjectURL(blob);
+                const a = document.createElement('a');
+                a.href = url;
+                
+                // Generate filename with current date/time
+                const now = new Date();
+                const dateStr = now.toISOString().replace(/[:.]/g, '-').slice(0, -5);
+                a.download = `talimbot-data-${dateStr}.json`;
+                
+                // Trigger download
+                document.body.appendChild(a);
+                a.click();
+                
+                // Cleanup
+                window.URL.revokeObjectURL(url);
+                document.body.removeChild(a);
+                
+                alert('✅ داده‌ها با موفقیت دانلود شد!');
+            } catch (error) {
+                console.error('Download error:', error);
+                alert('❌ خطا در دانلود داده‌ها: ' + error.message);
+            }
+        }
+
+        window.onload = loadDashboard;
+    </script>
+</body>
+</html>
+
+

render.yaml

@@ -0,0 +1,7 @@
+# Render.com Deployment Configuration
+
+## Build Command:
+pip install -r backend/requirements.txt
+
+## Start Command:
+cd backend && uvicorn main:app --host 0.0.0.0 --port $PORT

requirements.txt

@@ -0,0 +1,6 @@
+fastapi==0.104.1
+uvicorn==0.24.0
+pydantic==2.5.0
+requests==2.31.0
+python-multipart==0.0.6
+python-dotenv==1.0.0

resources_references/DEPLOYMENT_CHECKLIST.md

@@ -0,0 +1,207 @@
+# ✅ Railway Deployment Checklist
+
+## Pre-Deployment Verification
+
+### ✅ Local Testing Complete
+- [x] Project restructured with `backend/static/` folder
+- [x] All frontend files copied to `backend/static/`
+- [x] `main.py` updated to serve static files
+- [x] `data.js` updated for Railway deployment
+- [x] Local server tested and working (`http://localhost:8000`)
+- [x] All pages accessible (index, login, dashboards, questionnaires)
+- [x] API endpoints working (grouping, data saving)
+
+### ✅ Git Repository Status
+- [x] `.env` file in `.gitignore` (API key NOT committed)
+- [x] All changes committed to Git
+- [x] Changes pushed to GitHub main branch
+- [x] Repository: `https://github.com/talimbot/talimbot`
+
+---
+
+## 🚂 Railway Deployment Steps
+
+### Step 1: Create Railway Account
+- [ ] Go to https://railway.app
+- [ ] Click "Start a New Project"
+- [ ] Sign in with GitHub account
+- [ ] Authorize Railway to access your repositories
+
+### Step 2: Deploy from GitHub
+- [ ] Click "Deploy from GitHub repo"
+- [ ] Select `talimbot/talimbot` repository
+- [ ] Railway auto-detects Python project
+- [ ] Deployment starts automatically
+
+### Step 3: Configure Environment Variables
+- [ ] Go to project dashboard
+- [ ] Click "Variables" tab
+- [ ] Click "+ New Variable"
+- [ ] Add variable:
+  - **Key**: `OPENROUTER_API_KEY`
+  - **Value**: `sk-or-v1-your-actual-key-here`
+- [ ] Click "Add"
+
+### Step 4: Generate Public URL
+- [ ] Go to "Settings" tab
+- [ ] Scroll to "Networking" section
+- [ ] Click "Generate Domain"
+- [ ] Copy your URL: `https://talimbot-production-xxxx.up.railway.app`
+
+### Step 5: Wait for Deployment
+- [ ] Monitor deployment in "Deployments" tab
+- [ ] Wait 2-3 minutes for build to complete
+- [ ] Look for "✅ Deployment successful" message
+
+---
+
+## 🧪 Post-Deployment Testing
+
+### Test All Features
+Visit your Railway URL and verify:
+
+#### Frontend Pages
+- [ ] Main page loads (`/`)
+- [ ] Login page works (`/pages/login.html`)
+- [ ] Student dashboard loads and functions
+- [ ] Teacher dashboard loads and functions
+- [ ] AMS questionnaire page works
+- [ ] Cooperative questionnaire page works
+- [ ] Group view page displays correctly
+
+#### Authentication & Navigation
+- [ ] Can login as student (use student number from data)
+- [ ] Can login as teacher (password: `teacher123`)
+- [ ] Navigation between pages works
+- [ ] Back buttons work correctly
+- [ ] Logout functionality works
+
+#### Student Features
+- [ ] MBTI test can be filled and saved
+- [ ] VARK test can be filled and saved
+- [ ] AMS questionnaire completes and auto-saves score
+- [ ] Cooperative questionnaire completes and auto-saves score
+- [ ] Preferred students selection works (max 4)
+- [ ] "Save All Data" button saves successfully
+- [ ] Data persists after page refresh
+- [ ] Can view assigned group
+
+#### Teacher Features
+- [ ] Can view all students in table
+- [ ] Can edit student information
+- [ ] Can add new students
+- [ ] Can delete students
+- [ ] Download data button works
+- [ ] Toggle visibility for students works
+- [ ] AI Grouping functionality works
+  - [ ] Can select course (Riazi, Faravari, etc.)
+  - [ ] Grouping completes successfully
+  - [ ] Groups are created and saved
+  - [ ] Students can see their groups
+- [ ] AMS and Cooperation columns display correctly
+
+#### API & Data Persistence
+- [ ] API calls complete without errors (check browser console)
+- [ ] Student data saves to backend
+- [ ] Data persists between sessions
+- [ ] Groups persist after creation
+- [ ] No 404 errors for API endpoints
+- [ ] No CORS errors in console
+
+---
+
+## 🔍 Troubleshooting Guide
+
+### If pages don't load:
+1. Check Railway deployment logs for errors
+2. Verify `backend/static/` folder contains all files
+3. Check browser console for 404 errors
+
+### If API calls fail:
+1. Verify environment variable `OPENROUTER_API_KEY` is set
+2. Check Railway logs for API errors
+3. Test API endpoints directly: `https://your-url.railway.app/api/students`
+
+### If grouping doesn't work:
+1. Verify OpenRouter API key is correct
+2. Check you have credits in OpenRouter account
+3. View Railway logs during grouping attempt
+4. Ensure request is reaching `/api/grouping` endpoint
+
+### If static files are missing:
+1. Verify files exist in `backend/static/` folder locally
+2. Ensure git committed and pushed all files
+3. Trigger manual redeploy in Railway
+4. Check file paths in HTML are correct (relative paths)
+
+---
+
+## 📊 Monitoring
+
+### Check Deployment Status
+- [ ] Railway dashboard shows "Active" status
+- [ ] Latest deployment timestamp is recent
+- [ ] No error messages in deployment logs
+
+### Monitor Usage
+- [ ] View usage in Railway "Usage" tab
+- [ ] Verify you're within free tier ($5/month)
+- [ ] Estimated usage: ~$2-3/month
+
+### View Logs
+- [ ] Real-time logs available in "Deployments" tab
+- [ ] Check logs for any errors or warnings
+- [ ] Monitor API request logs
+
+---
+
+## 🎯 Final Verification
+
+### Complete Success Criteria
+- [ ] Application is accessible from any device with internet
+- [ ] All features work identically to localhost version
+- [ ] No errors in browser console
+- [ ] No errors in Railway logs
+- [ ] Data persistence works correctly
+- [ ] AI grouping creates groups successfully
+- [ ] Teachers can manage students
+- [ ] Students can complete questionnaires
+
+### Share with Users
+- [ ] Copy Railway URL
+- [ ] Share URL with teacher
+- [ ] Provide login instructions:
+  - Teacher: Password is `teacher123`
+  - Students: Use their student number
+- [ ] Explain how to access from any device
+
+---
+
+## 🚀 You're Done!
+
+Once all checkboxes are checked, your TalimBot is:
+- ✅ **Fully deployed** on Railway
+- ✅ **Accessible from anywhere** via the internet
+- ✅ **Secure** (API key in environment variables)
+- ✅ **Free** (within Railway's $5/month credit)
+- ✅ **Professional** (real production website)
+
+**Your Live URL**: `https://your-project.up.railway.app`
+
+---
+
+## 📝 Next Steps
+
+1. **Bookmark your Railway dashboard** for monitoring
+2. **Keep your OpenRouter API key safe** (never share it)
+3. **Monitor Railway usage** to stay within free tier
+4. **Test from multiple devices** (phone, tablet, different computers)
+5. **Collect feedback** from teachers and students
+
+---
+
+## 🆘 Need Help?
+
+- **Railway Docs**: https://docs.railway.app
+- **Railway Discord**: https://discord.gg/railway
+- **Review**: `RAILWAY_SETUP_GUIDE.md` for detailed instructions

resources_references/RAILWAY_DEPLOYMENT.md

@@ -0,0 +1,126 @@
+# 🚂 Railway Deployment Guide for TalimBot
+
+## Quick Deploy to Railway.app
+
+### Step 1: Create Railway Account
+1. Go to: **https://railway.app**
+2. Click **"Login"** → **"Login with GitHub"**
+3. Authorize Railway to access your repositories
+
+### Step 2: Deploy from GitHub
+1. Click **"New Project"**
+2. Select **"Deploy from GitHub repo"**
+3. Choose your **"talimbot"** repository
+4. Railway will automatically detect it's a Python project!
+
+### Step 3: Add Environment Variable (IMPORTANT!)
+1. In your Railway project, click on your service
+2. Go to **"Variables"** tab
+3. Click **"New Variable"**
+4. Add:
+   - **Name:** `OPENROUTER_API_KEY`
+   - **Value:** `sk-or-v1-your-actual-key-here` (get from https://openrouter.ai)
+5. Click **"Add"**
+
+### Step 4: Configure Build (if needed)
+Railway usually auto-detects, but if it doesn't:
+1. Go to **"Settings"** tab
+2. **Build Command:** `pip install -r backend/requirements.txt`
+3. **Start Command:** `cd backend && uvicorn main:app --host 0.0.0.0 --port $PORT`
+
+### Step 5: Deploy!
+1. Railway deploys automatically
+2. Wait 2-3 minutes for build to complete
+3. You'll see "Active" when ready
+
+### Step 6: Get Your URL
+1. Click **"Settings"** tab
+2. Scroll to **"Networking"**
+3. Click **"Generate Domain"**
+4. You'll get: `https://talimbot-production-xxxx.up.railway.app`
+5. **Copy this URL!**
+
+### Step 7: Update Frontend
+Edit `assets/js/data.js` line 11:
+```javascript
+return 'https://talimbot-production-xxxx.up.railway.app/api';
+```
+
+### Step 8: Push to GitHub
+```bash
+git add assets/js/data.js
+git commit -m "Configure Railway backend URL"
+git push origin main
+```
+
+### Step 9: Test!
+Visit: `https://talimbot.github.io/talimbot/`
+
+---
+
+## Environment Variables Explained
+
+### Local Development (.env file)
+```
+OPENROUTER_API_KEY=sk-or-v1-your-key-here
+```
+
+### Railway (Variables tab in dashboard)
+- **Variable Name:** OPENROUTER_API_KEY
+- **Variable Value:** sk-or-v1-your-key-here
+
+**Important:** NEVER commit your .env file to GitHub! It's already in .gitignore.
+
+---
+
+## Cost
+
+Railway offers:
+- **$5 free credit per month** (renews monthly)
+- **$0.000463 per GB-hour** of RAM
+- Usually enough for small projects like this
+- Can upgrade to Developer plan ($5/month) for more resources
+
+---
+
+## Advantages over Render
+
+✅ **No sleep** - stays online 24/7  
+✅ **Faster deployments** - usually 1-2 minutes  
+✅ **Better free tier** - $5 credit (vs Render's sleep after 15min)  
+✅ **Auto-deploy** from GitHub on push  
+✅ **Easy environment variables** - simple UI  
+
+---
+
+## Troubleshooting
+
+### Build Fails
+- Check Logs tab for error messages
+- Verify `requirements.txt` has all dependencies
+- Make sure `python-dotenv` is included
+
+### "API key not configured" Error
+- Go to Variables tab
+- Verify OPENROUTER_API_KEY is set
+- Make sure there are no extra spaces
+- Redeploy after adding variable
+
+### Can't Access Backend
+- Check service is "Active" (not deploying/failed)
+- Verify you generated a domain in Settings → Networking
+- Try accessing: `https://your-url.up.railway.app/api/students`
+
+---
+
+## Next Steps
+
+After deployment:
+1. Test login from multiple devices
+2. Test grouping functionality
+3. Download JSON backup
+4. Share link with students!
+
+---
+
+**Your website is now live and independent!** 🎉

resources_references/RAILWAY_SETUP_GUIDE.md

@@ -0,0 +1,300 @@
+# 🚂 Railway Deployment Guide for TalimBot
+
+## 📋 Overview
+This guide will help you deploy your complete TalimBot application (Frontend + Backend) to Railway for free, making it accessible from anywhere.
+
+## ✅ What We've Done (Preparation Complete!)
+
+### 1. **Restructured the Project**
+- ✅ Created `backend/static/` folder
+- ✅ Moved all frontend files (HTML, CSS, JS, Icons) to `backend/static/`
+- ✅ Updated `main.py` to serve static files
+- ✅ Updated `data.js` to use relative API paths for Railway
+
+### 2. **Updated FastAPI Configuration**
+Your `backend/main.py` now:
+- Serves static files from `backend/static/` folder
+- Uses environment variable for OpenRouter API key
+- Handles both frontend (HTML pages) and backend (API endpoints) from the same server
+- Works seamlessly on Railway's deployment platform
+
+### 3. **Project Structure**
+```
+talimbot/
+├── .env                     # LOCAL ONLY - Contains your API key (NEVER commit this!)
+├── .env.example             # Template for environment variables
+├── .gitignore               # Ensures .env is not committed
+├── Procfile                 # Tells Railway how to start the server
+├── runtime.txt              # Specifies Python version
+├── README.md                
+├── RAILWAY_DEPLOYMENT.md    
+├── backend/
+│   ├── main.py              # ✅ UPDATED - Serves static files + API endpoints
+│   ├── grouping_logic.py    
+│   ├── requirements.txt     
+│   ├── data/
+│   │   └── students.json    
+│   └── static/              # ✅ NEW - All frontend files
+│       ├── index.html       
+│       ├── assets/          # CSS and JS files
+│       │   ├── css/
+│       │   │   └── styles.css
+│       │   └── js/
+│       │       ├── data.js  # ✅ UPDATED - Uses relative API paths
+│       │       └── grouping.js
+│       ├── pages/           # All HTML pages
+│       │   ├── login.html
+│       │   ├── student-dashboard.html
+│       │   ├── teacher-dashboard.html
+│       │   ├── ams-questionnaire.html
+│       │   ├── cooperative-questionnaire.html
+│       │   └── group-view.html
+│       └── Icons/           # Logo and icons
+```
+
+---
+
+## 🚀 Deployment Steps
+
+### **Step 1: Verify Local Setup**
+
+1. **Create `.env` file** (if you haven't already):
+   ```bash
+   # In the project root (talimbot/) folder
+   echo OPENROUTER_API_KEY=sk-or-v1-your-actual-key-here > .env
+   ```
+
+2. **Test locally**:
+   ```bash
+   cd backend
+   python main.py
+   ```
+   
+3. **Open browser** to `http://localhost:8000`
+   - You should see the index.html page
+   - All pages should work (login, dashboards, questionnaires)
+   - API calls should work (grouping, data saving)
+
+---
+
+### **Step 2: Commit Changes to GitHub**
+
+⚠️ **IMPORTANT**: Make sure `.env` is in `.gitignore` (it already is!)
+
+```bash
+# From the talimbot/ directory
+git add .
+git status  # Verify .env is NOT listed (should only see modified files)
+
+git commit -m "Restructure project for Railway deployment - serve frontend from backend"
+git push origin main
+```
+
+---
+
+### **Step 3: Deploy to Railway**
+
+#### A. **Sign Up / Log In**
+1. Go to [railway.app](https://railway.app)
+2. Click **"Start a New Project"**
+3. Sign in with your GitHub account
+
+#### B. **Create New Project**
+1. Click **"Deploy from GitHub repo"**
+2. Select your `talimbot` repository
+3. Railway will automatically detect it's a Python project
+
+#### C. **Configure Environment Variables**
+1. In the Railway dashboard, go to your project
+2. Click on the **"Variables"** tab
+3. Click **"+ New Variable"**
+4. Add:
+   - **Key**: `OPENROUTER_API_KEY`
+   - **Value**: `sk-or-v1-your-actual-openrouter-api-key`
+5. Click **"Add"**
+
+#### D. **Verify Deployment Settings**
+Railway auto-detects settings from your files:
+- ✅ **Build Command**: None needed (Python dependencies auto-installed)
+- ✅ **Start Command**: From `Procfile` → `cd backend && uvicorn main:app --host 0.0.0.0 --port $PORT`
+- ✅ **Python Version**: From `runtime.txt` → `python-3.11.0`
+
+#### E. **Deploy!**
+1. Click **"Deploy"**
+2. Wait 2-3 minutes for deployment
+3. Railway will show deployment logs
+4. When complete, you'll see: ✅ **"Deployment successful"**
+
+#### F. **Get Your URL**
+1. In Railway dashboard, click **"Settings"** tab
+2. Scroll to **"Networking"** section
+3. Click **"Generate Domain"**
+4. Copy your URL (e.g., `https://talimbot-production-abc123.up.railway.app`)
+
+---
+
+### **Step 4: Test Your Deployed Application**
+
+1. **Open your Railway URL** in a browser
+2. **Test all features**:
+   - ✅ Main page loads (`index.html`)
+   - ✅ Login page works (`/pages/login.html`)
+   - ✅ Student dashboard loads
+   - ✅ Teacher dashboard loads
+   - ✅ Questionnaires work (AMS, Cooperative)
+   - ✅ Grouping functionality works
+   - ✅ Data saves correctly
+
+---
+
+## 🔧 How It Works
+
+### **Single Server Architecture**
+Railway runs ONE server that handles BOTH:
+
+1. **Frontend (Static Files)**:
+   - `GET /` → Serves `index.html`
+   - `GET /pages/login.html` → Serves login page
+   - `GET /assets/css/styles.css` → Serves CSS
+   - `GET /assets/js/data.js` → Serves JavaScript
+
+2. **Backend (API Endpoints)**:
+   - `POST /api/grouping` → AI grouping logic
+   - `GET /api/students` → Get all students
+   - `PUT /api/students/{id}` → Update student
+   - All other API routes in `main.py`
+
+### **How Requests Are Routed**
+
+```
+User Browser → Railway URL
+              ↓
+        FastAPI Server (main.py)
+              ↓
+    ┌─────────┴─────────┐
+    ↓                   ↓
+  /api/*            Everything else
+(API Endpoints)     (Static Files)
+    ↓                   ↓
+grouping_logic.py   backend/static/
+OpenRouter API        (HTML/CSS/JS)
+```
+
+### **Environment Variable Flow**
+
+```
+Local Development:
+.env file → load_dotenv() → os.getenv("OPENROUTER_API_KEY")
+
+Railway Production:
+Railway Variables → os.getenv("OPENROUTER_API_KEY")
+```
+
+---
+
+## 📊 Monitoring & Management
+
+### **View Logs**
+1. Go to Railway dashboard
+2. Click on your project
+3. Click **"Deployments"** tab
+4. Click on the latest deployment
+5. View real-time logs
+
+### **Check Usage**
+- Railway free tier: **$5 credit/month**
+- Your app should use: **~$2-3/month**
+- Monitor usage in **"Usage"** tab
+
+### **Redeploy (After Code Changes)**
+1. Make changes locally
+2. Test locally (`python main.py`)
+3. Commit and push to GitHub:
+   ```bash
+   git add .
+   git commit -m "Your changes"
+   git push origin main
+   ```
+4. Railway **auto-deploys** within 1-2 minutes!
+
+---
+
+## 🆘 Troubleshooting
+
+### **Problem: API calls fail (404 errors)**
+**Solution**: API routes must start with `/api/`
+- ✅ Correct: `POST /api/grouping`
+- ❌ Wrong: `POST /grouping`
+
+### **Problem: Static files not loading (CSS/JS missing)**
+**Solution**: 
+1. Verify files are in `backend/static/` folder
+2. Check browser console for 404 errors
+3. Ensure paths in HTML are relative (e.g., `/assets/css/styles.css`)
+
+### **Problem: OpenRouter API errors**
+**Solution**:
+1. Verify API key is correct in Railway Variables
+2. Check you have credits in your OpenRouter account
+3. View logs in Railway to see exact error message
+
+### **Problem: Server won't start**
+**Solution**:
+1. Check Railway logs for error messages
+2. Verify `requirements.txt` has all dependencies
+3. Ensure `Procfile` command is correct
+
+---
+
+## 🎯 Success Checklist
+
+After deployment, verify:
+
+- [ ] Railway URL loads the main page
+- [ ] All navigation links work
+- [ ] Login system works (student/teacher)
+- [ ] Student dashboard loads
+- [ ] Teacher dashboard loads
+- [ ] AMS questionnaire works and saves
+- [ ] Cooperative questionnaire works and saves
+- [ ] AI grouping creates groups successfully
+- [ ] Student data persists after refresh
+- [ ] API calls complete without errors
+- [ ] No console errors in browser DevTools
+
+---
+
+## 💡 Next Steps
+
+Once deployed successfully:
+
+1. **Share the Railway URL** with your teacher
+2. **Test from different devices** (phone, tablet)
+3. **Monitor Railway dashboard** for any errors
+4. **Keep your OpenRouter API key secure**
+5. **Consider upgrading Railway plan** if you exceed free tier
+
+---
+
+## 📞 Support Resources
+
+- **Railway Docs**: https://docs.railway.app
+- **OpenRouter Docs**: https://openrouter.ai/docs
+- **FastAPI Docs**: https://fastapi.tiangolo.com
+- **Your Deployment Guide**: `RAILWAY_DEPLOYMENT.md`
+
+---
+
+## 🎉 Congratulations!
+
+Your TalimBot is now a **real, independent website** accessible from anywhere! 🚀
+
+**Your app URL**: `https://your-project.up.railway.app`
+
+Teachers and students can access it from:
+- ✅ Home computers
+- ✅ School computers
+- ✅ Phones (any device with internet)
+- ✅ Tablets
+
+No need for localhost, no need for running Python locally - it's fully online! 🌐

resources_references/README.md

@@ -0,0 +1,407 @@
+# TalimBot - سیستم گروه‌بندی هوشمند دانش‌آموزان
+
+A full-stack intelligent student grouping system using AI-powered analysis with FastAPI backend and GitHub Pages frontend.
+
+## 🎯 Overview
+
+TalimBot groups 30 real students based on MBTI personality types, learning styles, math grades, and peer preferences using AI (GPT-4o-mini via OpenRouter). Teachers control when students can view their group assignments.
+
+### Real Student Data
+- **30 Students** from class 1061 (دهم تجربی)
+- **Persian Names**: Full Persian names from actual class roster
+- **National Code Authentication**: Students login with their national ID
+- **Math Grades**: Real grades from student records
+
+---
+
+## 🚀 Quick Start (Local Development)
+
+### Prerequisites
+- Python 3.8+ installed
+- Modern web browser
+- Internet connection (for AI grouping)
+
+### Step 1: Start Backend (30 seconds)
+
+```powershell
+# Navigate to backend folder
+cd backend
+
+# Install dependencies (first time only)
+pip install -r requirements.txt
+
+# Start the server
+python main.py
+```
+
+**Server runs on:** `http://localhost:8000`
+
+**Keep this terminal running!**
+
+### Step 2: Open Frontend (10 seconds)
+
+**Option A - Direct Open (Easiest):**
+- Double-click `index.html` in File Explorer
+
+**Option B - Local Server (Recommended):**
+```powershell
+# In a NEW terminal window
+python -m http.server 3000
+```
+Then visit: `http://localhost:3000`
+
+---
+
+## 👥 Login Credentials
+
+### Students (30 students available)
+Login with:
+- **Student Number:** S001, S002, ..., S030
+- **National Code:** Each student's 10-digit national ID
+
+**Example:**
+- Student Number: `S001`
+- National Code: `929986644`
+- Name: آدینه پور - یاسمن
+
+### Teacher
+- **Password:** `teacher123`
+
+---
+
+## 📋 How It Works
+
+### For Students:
+
+1. **Login**
+   - Enter student number (S001-S030)
+   - Enter your 10-digit national code
+   - System displays your Persian name
+
+2. **Complete Profile**
+   - Take MBTI test (link provided)
+   - Take VARK learning style test (link provided)
+   - Fill out AMS and Cooperative preferences
+   - Select up to 4 preferred groupmates
+   - Save your information
+
+3. **View Group** (after teacher enables)
+   - See your group number
+   - View all group members
+   - Read AI reasoning in Persian
+
+### For Teachers:
+
+1. **Monitor Progress**
+   - View dashboard with statistics
+   - See which students completed profiles
+   - Check readiness for grouping
+
+2. **Perform Grouping**
+   - Enter course name
+   - Click "Start Grouping"
+   - AI analyzes all data (10-30 seconds)
+   - Review generated groups with Persian reasoning
+
+3. **Control Visibility**
+   - Groups are hidden by default
+   - Click "Show Results to Students"
+   - Toggle visibility on/off anytime
+
+4. **Manage Data**
+   - View all student information
+   - Edit student data if needed
+   - Reset grouping when necessary
+
+---
+
+## 🌐 Deployment to GitHub Pages
+
+### Part 1: Deploy Frontend to GitHub Pages
+
+1. **Create GitHub Repository**
+   ```bash
+   # Initialize git (if not already done)
+   git init
+   git add .
+   git commit -m "Initial commit with real student data"
+   
+   # Create repo on GitHub and push
+   git remote add origin https://github.com/talimbot/talimbot.git
+   git branch -M main
+   git push -u origin main
+   ```
+
+2. **Enable GitHub Pages**
+   - Go to repository Settings → Pages
+   - Source: Deploy from branch `main`
+   - Folder: `/ (root)`
+   - Click Save
+
+3. **Your site will be live at:**
+   `https://talimbot.github.io/talimbot/`
+
+### Part 2: Deploy Backend to Render.com (Free)
+
+1. **Create Render Account**
+   - Visit [render.com](https://render.com)
+   - Sign up with GitHub
+
+2. **Create New Web Service**
+   - Click "New +" → "Web Service"
+   - Connect your GitHub repository
+   - Settings:
+     - **Name:** `talimbot-backend`
+     - **Environment:** `Python 3`
+     - **Build Command:** `pip install -r backend/requirements.txt`
+     - **Start Command:** `cd backend && uvicorn main:app --host 0.0.0.0 --port $PORT`
+     - **Plan:** Free
+
+3. **Add Environment Variable**
+   - In Render dashboard → Environment
+   - Add: `OPENROUTER_API_KEY` = `your-api-key`
+   - Optionally: `TEACHER_PASSWORD` = `your-password`
+
+4. **Get Your Backend URL**
+   - Copy the URL (e.g., `https://talimbot-backend.onrender.com`)
+
+### Part 3: Update Frontend to Use Deployed Backend
+
+Update `API_BASE_URL` in BOTH files:
+- `assets/js/data.js`
+- `assets/js/grouping.js`
+
+```javascript
+// Change from:
+const API_BASE_URL = 'http://localhost:8000/api';
+
+// To:
+const API_BASE_URL = 'https://talimbot-backend.onrender.com/api';
+```
+
+Commit and push changes:
+```bash
+git add .
+git commit -m "Update API URL for production"
+git push
+```
+
+GitHub Pages will auto-deploy in ~1 minute.
+
+---
+
+## 🔧 Configuration
+
+### API Key (OpenRouter)
+Located in `backend/grouping_logic.py`:
+```python
+OPENROUTER_API_KEY = 'sk-or-v1-...'
+```
+
+### Teacher Password
+Located in `backend/main.py` (SystemData model):
+```python
+teacherPassword: str = "teacher123"
+```
+
+Change as needed for security.
+
+### Student Data
+Students are initialized in `backend/main.py` in the `load_data()` function.
+All 30 real students with Persian names and national codes are pre-loaded.
+
+---
+
+## 📁 Project Structure
+
+```
+talimbot/
+├── backend/
+│   ├── main.py              # FastAPI server with real student data
+│   ├── grouping_logic.py    # AI grouping with OpenRouter
+│   ├── requirements.txt     # Python dependencies
+│   ├── README.md            # Backend documentation
+│   └── data/
+│       └── students.json    # Auto-created data storage
+│
+├── assets/
+│   ├── css/
+│   │   └── styles.css
+│   └── js/
+│       ├── data.js          # API client for student data
+│       └── grouping.js      # API client for grouping
+│
+├── pages/
+│   ├── login.html           # Login with national code
+│   ├── student-dashboard.html
+│   ├── student-data.html
+│   ├── teacher-dashboard.html
+│   └── group-view.html
+│
+├── Icons/                   # UI icons
+├── index.html              # Redirects to login
+├── README.md               # This file
+├── .gitignore              # Git ignore rules
+└── start-backend.ps1       # Windows startup script
+```
+
+---
+
+## 🎯 Features
+
+### ✅ Implemented
+- **Real Student Data**: 30 actual students with Persian names
+- **National Code Authentication**: Secure login using national IDs  
+- **Persistent Storage**: JSON database on backend
+- **AI-Powered Grouping**: OpenRouter GPT-4o-mini integration
+- **Persian Language**: Full RTL support with Persian reasoning
+- **Teacher Controls**: Show/hide results, reset grouping
+- **Math Grades**: Real grades from class records
+- **MBTI & Learning Styles**: Comprehensive personality analysis
+- **Peer Preferences**: Students select preferred groupmates
+
+### 🎨 UI Features
+- Modern, responsive design with Tailwind CSS
+- Persian (RTL) interface
+- Real-time validation
+- Progress indicators
+
+---
+
+## 🐛 Troubleshooting
+
+### "Failed to fetch" errors
+**Problem:** Backend not running or wrong URL
+**Solution:**
+1. Check backend is running: Visit `http://localhost:8000`
+2. Should see: `{"message":"TalimBot API is running"}`
+3. Check `API_BASE_URL` in JS files matches backend
+
+### Students can't login
+**Problem:** Wrong national code
+**Solution:**
+- National code must be exactly 10 digits
+- Must match the code in backend database
+- Check `backend/main.py` for correct codes
+
+### Students can't see groups
+**Problem:** Teacher hasn't enabled visibility
+**Solution:**
+- Teacher must click "Show Results to Students"
+- Button appears after grouping is complete
+
+### Grouping fails
+**Problem:** API error or no internet
+**Solution:**
+1. Check internet connection
+2. Verify OpenRouter API key is valid
+3. Check backend logs for errors
+4. System has fallback random grouping if AI fails
+
+---
+
+## 📊 Student List (Sample)
+
+| # | Student Number | Name | National Code | Math Grade |
+|---|----------------|------|---------------|------------|
+| 1 | S001 | آدینه پور - یاسمن | 929986644 | 16.0 |
+| 2 | S002 | احمدزاده - پریا | 980085330 | 12.0 |
+| 3 | S003 | اکبرزاده - فاطمه | 970154550 | 11.0 |
+| 4 | S004 | الهی مهر - آناهیتا | 26425955 | 17.0 |
+| 5 | S005 | امیری - مریم | 980093341 | 18.0 |
+| ... | ... | ... | ... | ... |
+| 30 | S030 | وحدتی - باران | 929916913 | 12.0 |
+
+*Full list available in `backend/main.py`*
+
+---
+
+## 🔐 Security Notes
+
+### Current (Demo/Development):
+- ✅ Simple password authentication
+- ✅ CORS allows all origins
+- ✅ National codes as passwords
+
+### Recommended for Production:
+- 🔒 Use environment variables for secrets
+- 🔒 Implement JWT token authentication
+- 🔒 Enable HTTPS only
+- 🔒 Add rate limiting
+- 🔒 Use PostgreSQL instead of JSON
+- 🔒 Hash national codes
+- 🔒 Implement proper session management
+
+---
+
+## 📞 API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/` | GET | Health check |
+| `/api/students` | GET | Get all students |
+| `/api/student/{id}` | GET | Get one student |
+| `/api/student/{id}` | PUT | Update student |
+| `/api/auth/student` | POST | Authenticate student |
+| `/api/auth/teacher` | POST | Authenticate teacher |
+| `/api/grouping/perform` | POST | Run AI grouping |
+| `/api/grouping/status` | GET | Get stats |
+| `/api/grouping/toggle-visibility` | POST | Show/hide results |
+| `/api/grouping/reset` | POST | Clear grouping |
+| `/api/student/{id}/group` | GET | Get student's group |
+
+---
+
+## 🎓 Technologies Used
+
+### Backend
+- **FastAPI** - Modern Python web framework
+- **Uvicorn** - ASGI server
+- **Pydantic** - Data validation
+- **aiohttp** - Async HTTP client
+- **OpenRouter API** - AI integration
+
+### Frontend
+- **HTML5 / CSS3** - Structure and styling
+- **Tailwind CSS** - Utility-first CSS
+- **JavaScript (Async/Await)** - Modern JS
+- **Fetch API** - HTTP requests
+
+### Deployment
+- **GitHub Pages** - Frontend hosting (free)
+- **Render.com** - Backend hosting (free)
+
+---
+
+## 📝 License
+
+This project is for educational purposes.
+
+---
+
+## 🙏 Credits
+
+- Student data from class 1061 (دهم تجربی)
+- AI grouping powered by OpenRouter (GPT-4o-mini)
+
+---
+
+## ✅ Pre-Launch Checklist
+
+- [ ] Backend running locally
+- [ ] Students can login with national codes
+- [ ] Teacher can login with password
+- [ ] Grouping works with AI
+- [ ] Visibility toggle works
+- [ ] All 30 students load correctly
+- [ ] Persian names display properly
+- [ ] Math grades show correctly
+- [ ] Backend deployed to Render
+- [ ] Frontend deployed to GitHub Pages
+- [ ] API URLs updated for production
+
+---
+
+**Live URL:** `https://talimbot.github.io/talimbot/pages/login.html`
+
+**Last Updated:** December 2025

resources_references/TEST_RESULTS_AND_SOLUTION.md

@@ -0,0 +1,225 @@
+# ✅ SERVER ISSUE - FULLY DIAGNOSED & READY TO FIX
+
+## 🎯 Test Results (Just Ran)
+
+✅ **Server Status:** Running on port 8000  
+✅ **API Response:** Returns data successfully  
+✅ **Firewall Rules:** Properly configured for Python  
+✅ **Local Network:** Server IS accessible from 192.168.114.1  
+✅ **Deployment Files:** All created and ready  
+
+---
+
+## 🔍 Problem Diagnosis
+
+**Why GitHub Pages doesn't work:**
+```
+https://talimbot.github.io/talimbot/ 
+    ↓ tries to connect to
+http://localhost:8000 ← This doesn't exist on the internet!
+```
+
+**Why phone doesn't work:**
+Your phone tries to connect to "localhost" which means "this phone" not "your laptop"
+
+---
+
+## 🎯 TWO SOLUTIONS - Choose One
+
+### 📱 Solution A: Test on Phone NOW (Temporary)
+
+Your server **IS** accessible from local network!
+
+**On Your Phone:**
+1. Connect to **same Wi-Fi** as laptop
+2. Open browser and visit:
+   ```
+   http://192.168.114.1:8000/index.html
+   ```
+   Or just test API:
+   ```
+   http://192.168.114.1:8000/api/students
+   ```
+
+3. Should work! ✅
+
+**To make GitHub Pages work with your laptop server:**
+1. Edit `assets/js/data.js`
+2. Change:
+   ```javascript
+   const API_BASE_URL = 'http://localhost:8000/api';
+   ```
+   To:
+   ```javascript
+   const API_BASE_URL = 'http://192.168.114.1:8000/api';
+   ```
+3. Push to GitHub
+4. Now GitHub Pages will try to connect to your laptop
+5. **Only works when laptop is on and server is running!**
+
+⚠️ **Limitations:**
+- Only works on your Wi-Fi network
+- Laptop must be on with server running
+- If laptop IP changes, you need to update code
+- Not suitable for real deployment
+
+---
+
+### 🌐 Solution B: Deploy to Cloud (PERMANENT) ⭐ RECOMMENDED
+
+Make your backend accessible from anywhere!
+
+**5-Minute Render.com Deployment:**
+
+1. **Sign up:** https://render.com (use GitHub login)
+
+2. **New Web Service:**
+   - Click "New +" → "Web Service"
+   - Connect your `talimbot` repository
+   - Select the repo
+
+3. **Configure:**
+   ```
+   Name: talimbot-api
+   Build Command: pip install -r backend/requirements.txt
+   Start Command: cd backend && uvicorn main:app --host 0.0.0.0 --port $PORT
+   Instance Type: Free
+   ```
+
+4. **Deploy:** Click "Create Web Service"
+
+5. **Get URL:** Copy your URL (e.g., `https://talimbot-api.onrender.com`)
+
+6. **Update Frontend:**
+   Edit `assets/js/data.js`:
+   ```javascript
+   const API_BASE_URL = 'https://talimbot-api.onrender.com/api';
+   ```
+
+7. **Push to GitHub:**
+   ```bash
+   git add .
+   git commit -m "Update API URL for production"
+   git push
+   ```
+
+8. **Done!** Your site works from anywhere! 🎉
+
+✅ **Benefits:**
+- Works from anywhere in the world
+- Works on any device
+- No laptop needed
+- Professional setup
+- FREE tier available
+
+---
+
+## 📋 Files I Created for You
+
+| File | Purpose |
+|------|---------|
+| `DEPLOYMENT_GUIDE.md` | Complete deployment tutorial (Render/Railway/PythonAnywhere) |
+| `FIXING_SERVER_ERROR.md` | Troubleshooting guide |
+| `Procfile` | Tells Render how to start server |
+| `runtime.txt` | Specifies Python version |
+| `render.yaml` | Render configuration |
+| `setup-firewall.ps1` | Windows firewall setup (if needed) |
+| `THIS FILE` | Summary of everything |
+
+---
+
+## 🚀 WHAT TO DO NOW
+
+### For Quick Test (Next 5 Minutes):
+1. **On phone**, visit: `http://192.168.114.1:8000/api/students`
+2. Should see JSON data ✅
+3. This proves your server works!
+
+### For Real Deployment (Next 15 Minutes):
+1. **Go to:** https://render.com
+2. **Follow steps** in Solution B above
+3. **Read full guide:** `DEPLOYMENT_GUIDE.md`
+4. **Update code** with Render URL
+5. **Push to GitHub**
+6. **Your app works worldwide!** 🌍
+
+---
+
+## 📊 Current vs After Deployment
+
+**Current (localhost):**
+```
+✅ Laptop browser → Works
+❌ Phone → Doesn't work
+❌ GitHub Pages → Doesn't work
+❌ Other people → Can't access
+```
+
+**After Deployment:**
+```
+✅ Laptop browser → Works
+✅ Phone → Works
+✅ GitHub Pages → Works
+✅ Other people → Can access
+✅ From anywhere → Works
+```
+
+---
+
+## 💡 Quick Comparison
+
+| Method | Time | Cost | Works Everywhere | Reliable |
+|--------|------|------|------------------|----------|
+| **Localhost** | 0 min | Free | ❌ No | - |
+| **Local IP (192.168.x.x)** | 0 min | Free | ❌ Wi-Fi only | ❌ |
+| **Render.com** | 5 min | Free | ✅ Yes | ✅ |
+| **Railway.app** | 5 min | $5 credit | ✅ Yes | ✅ |
+| **PythonAnywhere** | 15 min | Free | ✅ Yes | ✅ |
+
+**Recommendation:** Render.com (easiest, fastest, free)
+
+---
+
+## 🎓 What You Learned
+
+1. **localhost = your computer only** (not accessible from internet)
+2. **192.168.x.x = local network only** (same Wi-Fi)
+3. **https://your-app.onrender.com = anywhere** (real internet URL)
+4. **GitHub Pages = frontend only** (needs backend somewhere else)
+5. **Backend must be deployed separately** from frontend
+
+---
+
+## ❓ Common Questions
+
+**Q: Can't I just use localhost?**  
+A: No, localhost doesn't exist on the internet.
+
+**Q: Why does it work on my laptop?**  
+A: Your laptop's browser can reach localhost because the server is running ON your laptop.
+
+**Q: Will phone work if I deploy?**  
+A: Yes! After deployment, phone/laptop/anyone can access it.
+
+**Q: Is Render really free?**  
+A: Yes, free tier available. Service sleeps after 15 min inactivity (wakes up in 30s on first request).
+
+**Q: What if Render is too slow?**  
+A: Try Railway ($5 free credit) or upgrade Render later.
+
+---
+
+## 🎯 Bottom Line
+
+**Your server works perfectly!** ✅  
+It's just not on the internet yet.
+
+**Two choices:**
+1. Quick test on phone: Use `http://192.168.114.1:8000` (same Wi-Fi)
+2. Real deployment: Deploy to Render (5 minutes, works everywhere)
+
+**I recommend:** Deploy to Render - then your project is truly online! 🚀
+
+---
+
+**All files are ready. All tests passed. Ready to deploy!** ✅