Update app.py

app.py

@@ -13,7 +13,7 @@ from werkzeug.exceptions import HTTPException
 from sqlalchemy import create_engine, Column, Integer, String, Boolean, Float, DateTime, ForeignKey, Text, and_, or_, text, inspect
 from sqlalchemy.orm import relationship, sessionmaker, declarative_base, Session
 
-# مدیریت ایمن کتابخانه‌های امنیتی و احراز هویت
+# مدیریت ایمن لود کتابخانه‌های امنیت و توکن JWT
 try:
     from jose import JWTError, jwt
 except ImportError:
@@ -28,7 +28,7 @@ import bcrypt
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger("production_backend")
 
-# کلید پردازش‌های ابری هوشمند (Secrets)
+# کلیدهای پردازش ابری هوشمند
 AI_CORE_KEY = os.getenv("GEMINI_API_KEY") or os.getenv("SECRET")
 
 try:
@@ -38,7 +38,7 @@ except ImportError:
     logger.warning("The 'google-genai' package is not installed. AI features will fallback.")
 
 # =========================================================================
-# بخش ۲: اتصال پایگاه داده و ساختار بومی دیتابیس
+# بخش ۲: اتصال پایگاه داده Neon.tech و ساختار دیتابیس
 # =========================================================================
 DATABASE_URL = os.getenv(
     "DATABASE_URL", 
@@ -66,11 +66,10 @@ except Exception as db_init_err:
 SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
 Base = declarative_base()
 
-# تعریف تابع زمان بومی سرور
 def get_now():
     return datetime.now(timezone.utc).replace(tzinfo=None)
 
-# فرمول مبدل تقویم میلادی به شمسی (Jalali Converter) جهت لاگ دقیق تاریخ‌های ایران (بند ۱۱)
+# فرمول مبدل تقویم میلادی به شمسی بومی (بند ۱۱)
 def gregorian_to_jalali(g_y, g_m, g_d):
     g_days_in_month = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
     j_days_in_month = [31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 29]
@@ -127,13 +126,6 @@ KNOWLEDGE_BASE = [
         "minimum_rank_r1": 100,
         "minimum_rank_r2": 200
     },
-    {
-        "university": "دانشگاه صنعتی امیرکبیر",
-        "ranking_tier": "ب",
-        "fields": ["صنایع", "عمران", "شیمی"],
-        "minimum_rank_r1": 1000,
-        "minimum_rank_r2": 1500
-    },
     {
         "university": "دانشگاه علوم پزشکی تهران",
         "ranking_tier": "الف",
@@ -153,15 +145,15 @@ class User(Base):
     email = Column(String, unique=True, index=True, nullable=False)
     hashed_password = Column(String, nullable=False)
     role = Column(String, default="student")  # 'student', 'counselor', 'school_representative'
-    name = Column(String, nullable=True)  # نام و نام خانوادگی کاربر (بند ۶)
+    name = Column(String, nullable=True)  # نام کاربری واقعی (بند ۶)
     is_verified = Column(Boolean, default=False)
     balance = Column(Float, default=0.0)
-    rating = Column(Float, default=5.0)
+    rating = Column(Float, default=0.0)  # مقدار اولیه بر اساس صفر است (امتیازی نیست در شروع - بند ۱۰)
     phone_number = Column(String, nullable=True)
-    city = Column(String, nullable=True)
-    grade = Column(String, nullable=True)  # مقطع تحصیلی (ششم تا دوازدهم)
-    major = Column(String, nullable=True)  # رشته تحصیلی داوطلب
-    profile_pic = Column(Text, nullable=True)  # عکس پروفایل به فرم Base64
+    city = Column(String, nullable=True)  # منطقه ثبت‌نامی (بند ۳)
+    grade = Column(String, nullable=True)
+    major = Column(String, nullable=True)
+    profile_pic = Column(Text, nullable=True)
 
     counselor_profile = relationship("CounselorProfile", back_populates="user", uselist=False, cascade="all, delete-orphan")
     school_profile = relationship("SchoolProfile", back_populates="user", uselist=False, cascade="all, delete-orphan")
@@ -172,9 +164,9 @@ class CounselorProfile(Base):
     id = Column(Integer, primary_key=True, index=True)
     user_id = Column(Integer, ForeignKey("users.id"))
     specialty = Column(String, nullable=True)
-    resume = Column(Text, nullable=True)  # آپلود مدرک رزومه (بیس ۶۴ تا سقف ۲۰ مگابایت)
+    resume = Column(Text, nullable=True)
     bio = Column(Text, nullable=True)
-    hourly_rate = Column(Float, default=120000.0)
+    hourly_rate = Column(Float, default=150000.0)
     deactivated_days_json = Column(Text, default="[]")  # روزهای غیرفعال شده توسط مشاور (بند ۷)
 
     user = relationship("User", back_populates="counselor_profile")
@@ -191,8 +183,8 @@ class SchoolProfile(Base):
     address = Column(Text, nullable=True)
     phone_number = Column(String, nullable=True)
     founding_year = Column(Integer, nullable=True)
-    rating = Column(Float, default=5.0)
-    profile_pic = Column(Text, nullable=True)  # بیس ۶۴ تصویر آموزشگاه
+    rating = Column(Float, default=0.0)  # مقدار امتیاز آموزشگاه در شروع صفر است (بند ۱۰)
+    profile_pic = Column(Text, nullable=True)
 
     user = relationship("User", back_populates="school_profile")
     courses = relationship("SchoolCourse", back_populates="school", cascade="all, delete-orphan")
@@ -241,16 +233,17 @@ class Booking(Base):
     slot_id = Column(Integer, ForeignKey("time_slots.id"))
     student_id = Column(Integer, ForeignKey("users.id"))
     counselor_id = Column(Integer, ForeignKey("users.id"))
-    status = Column(String, default="active") # active, cancelled
-    payment_status = Column(String, default="paid") # paid, pending_payment, expired
+    status = Column(String, default="active")  # active, cancelled
+    payment_status = Column(String, default="paid")  # paid, pending_payment, expired
     payment_due_until = Column(DateTime, nullable=True)
     cost = Column(Float, default=0.0)
+    created_at = Column(DateTime, default=get_now)
 
 
 class CustomQuiz(Base):
     __tablename__ = "custom_quizzes"
     id = Column(Integer, primary_key=True, index=True)
-    counselor_id = Column(Integer, ForeignKey("users.id"), nullable=True)  # نال برای کوئیزهای پیش‌فرض سیستم
+    counselor_id = Column(Integer, ForeignKey("users.id"), nullable=True)
     title = Column(String, nullable=False)
     questions_json = Column(Text, nullable=False)
 
@@ -298,7 +291,7 @@ class Review(Base):
     __tablename__ = "reviews"
     id = Column(Integer, primary_key=True, index=True)
     student_id = Column(Integer, ForeignKey("users.id"))
-    booking_id = Column(Integer, ForeignKey("bookings.id"), nullable=True) # مجاز به نال برای امتیازدهی مستقیم به آموزشگاه (بند ۱۴)
+    booking_id = Column(Integer, ForeignKey("bookings.id"), nullable=True)
     counselor_id = Column(Integer, ForeignKey("users.id"), nullable=True)
     school_id = Column(Integer, ForeignKey("school_profiles.id"), nullable=True)
     rating = Column(Float, default=5.0)
@@ -316,7 +309,7 @@ class Notification(Base):
     created_at = Column(DateTime, default=get_now)
 
 
-# مدل جدید جهت مدیریت تسویه حساب‌های پلتفرم (بند ۴ و ۵)
+# مدل تسویه حساب‌های پلتفرم (بند ۴ و ۵)
 class SettlementRequest(Base):
     __tablename__ = "settlement_requests"
     id = Column(Integer, primary_key=True, index=True)
@@ -326,7 +319,7 @@ class SettlementRequest(Base):
     created_at = Column(DateTime, default=get_now)
 
 
-# مدل جدید جهت ردیابی بازدید آموزشگاه بر اساس حساب کاربری (بند ۹)
+# مدل ردیابی بازدید واقعی آموزشگاه بر اساس حساب کاربری (بند ۹)
 class PageView(Base):
     __tablename__ = "page_views"
     id = Column(Integer, primary_key=True, index=True)
@@ -528,114 +521,7 @@ def seed_initial_data(db: Session):
                 new_quiz = CustomQuiz(counselor_id=None, title=gq["title"], questions_json=gq["questions"])
                 db.add(new_quiz)
         db.commit()
-
-        seed_users = [
-            {"email": "student@demo.com", "password": "demo1234", "role": "student", "balance": 950000.0, "phone": "09121111111", "city": "تهران", "name": "امیرحسین رضایی", "grade": "یازدهم", "major": "علوم تجربی"},
-            {"email": "student@test.com", "password": "student123", "role": "student", "balance": 650000.0, "phone": "09122222222", "city": "تهران", "name": "کیان کریمی", "grade": "دهم", "major": "ریاضی فیزیک"},
-            {"email": "counselor1@demo.com", "password": "demo1234", "role": "counselor", "rating": 4.8, "city": "تهران", "name": "استاد محمدی"},
-            {"email": "counselor2@demo.com", "password": "demo1234", "role": "counselor", "rating": 4.5, "city": "شیراز", "name": "استاد کرمی"},
-            {"email": "counselor@test.com", "password": "counselor123", "role": "counselor", "rating": 2.8, "city": "تهران", "name": "دکتر حسینی"}, # نمونه امتیاز زیر ۳ برای پپ لود اخطار انضباطی
-            {"email": "school@demo.com", "password": "demo1234", "role": "school_representative", "city": "اصفهان", "name": "مهندس نوری"},
-            {"email": "school@test.com", "password": "school123", "role": "school_representative", "city": "تهران", "name": "آکادمی اندیشه"}
-        ]
-        
-        for u_data in seed_users:
-            try:
-                existing = db.query(User).filter(User.email == u_data["email"]).first()
-                hashed_pwd = get_password_hash(u_data["password"])
-                
-                if existing:
-                    existing.hashed_password = hashed_pwd
-                    existing.role = u_data["role"]
-                    existing.is_verified = True
-                    existing.name = u_data.get("name", existing.name)
-                    existing.grade = u_data.get("grade", existing.grade)
-                    existing.major = u_data.get("major", existing.major)
-                    if "balance" in u_data:
-                        existing.balance = u_data["balance"]
-                    if "rating" in u_data:
-                        existing.rating = u_data["rating"]
-                    if "phone" in u_data:
-                        existing.phone_number = u_data["phone"]
-                    if "city" in u_data:
-                        existing.city = u_data["city"]
-                else:
-                    new_user = User(
-                        email=u_data["email"],
-                        hashed_password=hashed_pwd,
-                        role=u_data["role"],
-                        name=u_data.get("name"),
-                        is_verified=True,
-                        balance=u_data.get("balance", 0.0),
-                        rating=u_data.get("rating", 5.0),
-                        phone_number=u_data.get("phone"),
-                        city=u_data.get("city"),
-                        grade=u_data.get("grade"),
-                        major=u_data.get("major")
-                    )
-                    db.add(new_user)
-                db.commit()
-                
-                current_user = db.query(User).filter(User.email == u_data["email"]).first()
-                if not current_user:
-                    continue
-
-                if u_data["role"] == "counselor":
-                    p = db.query(CounselorProfile).filter(CounselorProfile.user_id == current_user.id).first()
-                    if not p:
-                        p = CounselorProfile(
-                            user_id=current_user.id,
-                            specialty="برنامه‌ریزی کنکور و هدایت تحصیلی",
-                            resume="مدرک تایید شده بستر تراز تحصیلی بومی تاپ دانش",
-                            bio="متخصص افزایش راندمان مطالعه داوطلب با تکیه بر تحلیل مستمر سبک‌های یادگیری",
-                            hourly_rate=150000.0,
-                            deactivated_days_json="[]"
-                        )
-                        db.add(p)
-                        
-                    now = get_now()
-                    has_slot = db.query(TimeSlot).filter(TimeSlot.counselor_id == current_user.id, TimeSlot.is_booked == False).first()
-                    if not has_slot:
-                        slot = TimeSlot(
-                            counselor_id=current_user.id,
-                            start_time=now + timedelta(days=1, hours=10),
-                            end_time=now + timedelta(days=1, hours=11),
-                            is_booked=False
-                        )
-                        db.add(slot)
-                        
-                elif u_data["role"] == "school_representative":
-                    s = db.query(SchoolProfile).filter(SchoolProfile.user_id == current_user.id).first()
-                    if not s:
-                        s = SchoolProfile(
-                            user_id=current_user.id,
-                            name=u_data.get("name"),
-                            subscription_active_until=get_now() + timedelta(days=60),
-                            is_sponsored=True,
-                            bio="برترین آکادمی تستی کنکور با کادر اساتید برجسته",
-                            address="خیابان ولیعصر، پلاک ۱۲",
-                            phone_number="02122222222",
-                            founding_year=1395,
-                            rating=5.0
-                        )
-                        db.add(s)
-                        db.flush()
-                        
-                    course = db.query(SchoolCourse).filter(SchoolCourse.school_id == s.id).first()
-                    if not course:
-                        course = SchoolCourse(
-                            school_id=s.id,
-                            course_name="ریاضی جامع کنکور",
-                            teacher_name="استاد احمدی",
-                            teaching_style="روش‌های محاسباتی تستی و تشریحی"
-                        )
-                        db.add(course)
-                db.commit()
-            except Exception as item_err:
-                db.rollback()
-                logger.warning(f"Seeding skipped for {u_data['email']}: {item_err}")
-                
-        logger.info("Forced Check-Seeding completed.")
+        logger.info("Database base check completed.")
     except Exception as e:
         logger.error(f"Seeding process crashed completely: {e}", exc_info=True)
         db.rollback()
@@ -679,11 +565,11 @@ with flask_app.app_context():
         try:
             seed_initial_data(db)
         except Exception as seed_err:
-            logger.error(f"Error seeding database: {seed_err}", exc_info=True)
+            logger.error(f"Error seeding database during startup: {seed_err}", exc_info=True)
         finally:
             db.close()
     except Exception as startup_db_err:
-        logger.warning(f"Database setup error: {startup_db_err}")
+        logger.warning(f"Database setup or seeding skipped: {startup_db_err}")
 
 
 @flask_app.errorhandler(Exception)
@@ -694,7 +580,7 @@ def global_exception_handler(exc):
     return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً چند لحظه دیگر مجدداً تلاش کنید."}), 500
 
 # ==========================================
-# بخش ۹: کلیه آدرس‌های APIها
+# بخش ۹: آدرس‌های API مربوط به احراز هویت و حساب کاربری
 # ==========================================
 
 @flask_app.route("/api/auth/register", methods=["POST"])
@@ -751,7 +637,7 @@ def auth_register():
         elif role == "school_representative":
             s_prof = SchoolProfile(
                 user_id=new_user.id,
-                name=name or "آموزشگاه جدید",
+                name=name or "آموزشگاه جدید ثبت‌شده",
                 subscription_active_until=get_now(),
                 profile_pic=profile_pic
             )
@@ -784,16 +670,16 @@ def auth_login():
         if not user or not verify_password(password, user.hashed_password):
             return jsonify({"detail": "ایمیل یا رمز عبور اشتباه است."}), 400
             
-        # سیستم ثبت اعلان هوشمند یکباره ورود (بند ۲)
+        # بررسی و ثبت فقط یک‌باره اعلان ورود موفقیت‌آمیز داوطلب (بند ۲)
         existing_login_notif = db.query(Notification).filter(
             Notification.user_id == user.id,
-            Notification.text.like("%ورود موفقیت‌آمیز به سامانه%")
+            Notification.text.like("%ورود موفقیت‌آمیز به حساب کاربری%")
         ).first()
         
         if not existing_login_notif:
             notif = Notification(
                 user_id=user.id,
-                text=f"ورود موفقیت‌آمیز به سامانه در تاریخ {get_shamsi_date_str(get_now())}",
+                text=f"ورود موفقیت‌آمیز به حساب کاربری در تاریخ {get_shamsi_date_str(get_now())}",
                 role=user.role,
                 is_read=False
             )
@@ -817,18 +703,17 @@ def auth_login():
 @login_required
 def get_user_profile():
     current_user = g.current_user
-    db = get_db()
     
-    # تعیین انضباطی یا تعلیق بر اساس میانگین امتیاز (بند ۱۱)
+    # هشدار انضباطی امتیازات زیر ۳ ستاره (بند ۱۱)
     requires_rating_warning = False
-    if current_user.role == "counselor" and current_user.rating < 3.0:
+    if current_user.role == "counselor" and current_user.rating < 3.0 and current_user.rating > 0.0:
         requires_rating_warning = True
         
     return jsonify({
         "id": current_user.id,
         "email": current_user.email,
         "role": current_user.role,
-        "name": current_user.name or current_user.email.split("@")[0], # برگرداندن نام به عنوان شاخص اصلی (بند ۶)
+        "name": current_user.name or current_user.email.split("@")[0], # نمایش اولویت بر اساس نام کاربر (بند ۶)
         "balance": current_user.balance,
         "rating": current_user.rating,
         "phone_number": current_user.phone_number,
@@ -889,7 +774,7 @@ def update_user_profile():
         return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
 
 # ==========================================
-# دایرکتوری مشاوران با فیلتر بومی هوشمند (بند ۳)
+# بخش ۱۰: دایرکتوری مشاوران و فیلتر منطقه‌ای هوشمند (بند ۳)
 # ==========================================
 
 @flask_app.route("/api/counselors", methods=["GET"])
@@ -897,20 +782,19 @@ def list_active_counselors():
     db = get_db()
     name = request.args.get("name")
     city = request.args.get("city")
-    student_city = request.args.get("student_city") # برای اعمال اتوماتیک فیلترینگ منطقه‌ای
+    student_city = request.args.get("student_city") # موقعیت جغرافیایی کاربر برای اعمال فیلتر بومی
 
     try:
         query = db.query(User).filter(User.role == "counselor", User.is_verified == True)
         
-        # ۱. فیلترینگ هوشمند منطقه‌ای (بند ۳)
         target_city = city or student_city
         is_fallback = False
         
+        # در صورت نبود مشاور در منطقه داوطلب، فال‌بک به نمایش سایر مناطق اجرا می‌شود (بند ۳)
         if target_city:
             regional_query = query.filter(User.city.ilike(f"%{target_city}%"))
             counselors = regional_query.all()
             if not counselors:
-                # در صورت عدم وجود مشاور در منطقه، سایر مشاوران به صورت فال‌بک برگردانده می‌شوند
                 is_fallback = True
                 counselors = query.all()
         else:
@@ -965,7 +849,7 @@ def list_counselor_available_slots(counselor_id):
         return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
 
 # ==========================================
-# رزرو جلسات با کسر ۷ درصد کارمزد پلتفرم (بند ۴)
+# بخش ۱۱: فرآیند تراکنش رزرو با کسر ۷٪ کارمزد پلتفرم (بند ۴)
 # ==========================================
 
 @flask_app.route("/api/bookings", methods=["POST"])
@@ -995,7 +879,7 @@ def book_session():
         if current_user.balance < cost:
             return jsonify({"detail": "موجودی حساب کافی نیست. لطفاً کیف پول خود را شارژ نمایید."}), 400
             
-        # محاسبه کسر سهم و کارمزد ۷٪ پلتفرم به صورت پویا (بند ۴)
+        # کسر کارمزد ۷٪ پلتفرم به صورت خودکار (بند ۴)
         platform_fee = cost * 0.07
         net_to_counselor = cost - platform_fee
         
@@ -1016,7 +900,7 @@ def book_session():
         db.commit()
         
         return jsonify({
-            "message": "رزرو جلسه با موفقیت انجام شد.",
+            "message": "رزرو جلسه با موفقیت تایید و سهم مشاور به کیف پول واریز شد.",
             "remaining_balance": current_user.balance,
             "session_start": slot.start_time.isoformat()
         }), 200
@@ -1025,8 +909,95 @@ def book_session():
         db.rollback()
         return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
 
+
+@flask_app.route("/api/student/bookings", methods=["GET"])
+@login_required
+def get_student_bookings():
+    db = get_db()
+    current_user = g.current_user
+    
+    try:
+        if current_user.role != "student":
+            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
+            
+        bookings = db.query(Booking).filter(
+            Booking.student_id == current_user.id,
+            Booking.status == "active"
+        ).order_by(Booking.id.desc()).all()
+        
+        output = []
+        for b in bookings:
+            counselor = db.query(User).filter(User.id == b.counselor_id).first()
+            slot = db.query(TimeSlot).filter(TimeSlot.id == b.slot_id).first()
+            output.append({
+                "id": b.id,
+                "counselor_name": counselor.name if counselor else "مشاور تحصیلی",
+                "date": get_shamsi_date_str(slot.start_time) if slot else get_shamsi_date_str(b.created_at),
+                "time": slot.start_time.strftime("%H:%M") if slot else "۱۶:۰۰",
+                "amount": b.cost,
+                "status": "موفق"
+            })
+        return jsonify(output), 200
+    except Exception as e:
+        logger.error(f"Error fetching student bookings: {e}")
+        return jsonify({"detail": "خطا در دریافت لیست نوبت‌های داوطلب."}), 500
+
+
+@flask_app.route("/api/bookings/<int:booking_id>/cancel-by-counselor", methods=["POST"])
+@login_required
+def cancel_session_by_counselor(booking_id):
+    db = get_db()
+    current_user = g.current_user
+    try:
+        if current_user.role != "counselor":
+            return jsonify({"detail": "تنها مشاوران مجاز به استفاده از این متد هستند."}), 403
+            
+        booking = db.query(Booking).filter(
+            Booking.id == booking_id,
+            Booking.counselor_id == current_user.id
+        ).first()
+        
+        if not booking or booking.status == "cancelled":
+            return jsonify({"detail": "این رزرو قبلاً لغو شده یا وجود ندارد."}), 404
+            
+        student = db.query(User).filter(User.id == booking.student_id).first()
+        counselor = current_user
+        
+        if student:
+            student.balance += booking.cost
+            student_notif = Notification(
+                user_id=student.id,
+                text=f"پیام سیستم: جلسه مشاوره شما با مشاور {counselor.name} لغو گردید و کل مبلغ {booking.cost:,.0f} ریال به کیف پول شما عودت داده شد.",
+                role="student"
+            )
+            db.add(student_notif)
+            
+        # جریمه انضباطی ۱۰ درصدی لغو یک‌طرفه مشاور بر اساس قوانین پلتفرم (بند ۴)
+        penalty_fee = booking.cost * 0.10
+        counselor.balance = counselor.balance - (booking.cost + penalty_fee)
+        
+        counselor_notif = Notification(
+            user_id=counselor.id,
+            text=f"پیام سیستم: رزرو شماره {booking.id} توسط شما لغو گردید و جریمه ۱۰ درصدی ({penalty_fee:,.0f} ریال) در حساب شما ثبت شد.",
+            role="counselor"
+        )
+        db.add(counselor_notif)
+        
+        slot = db.query(TimeSlot).filter(TimeSlot.id == booking.slot_id).first()
+        if slot:
+            slot.is_booked = False
+            slot.booked_by_student_id = None
+            
+        booking.status = "cancelled"
+        db.commit()
+        return jsonify({"message": "جلسه مشاوره لغو، مبالغ عودت و جریمه کسر گردید."}), 200
+    except Exception as e:
+        logger.error(f"Error cancelling booking by counselor: {e}", exc_info=True)
+        db.rollback()
+        return jsonify({"detail": "خطا در فرآیند لغو رزرو مشاور."}), 500
+
 # ========================================================
-# سیستم تسویه حساب مشاوران (بند ۴)
+# بخش ۱۲: درگاه‌های مدیریت تسویه حساب و کیف پول (بند ۴)
 # ========================================================
 
 @flask_app.route("/api/counselor/request-settlement", methods=["POST"])
@@ -1040,7 +1011,7 @@ def counselor_request_settlement():
             return jsonify({"detail": "دسترسی غیرمجاز"}), 403
             
         if current_user.balance <= 0:
-            return jsonify({"detail": "موجودی کیف پول شما صفر یا منفی است و امکان تسویه وجود ندارد."}), 400
+            return jsonify({"detail": "موجودی قابل تسویه وجود ندارد."}), 400
             
         req = SettlementRequest(
             user_id=current_user.id,
@@ -1049,18 +1020,18 @@ def counselor_request_settlement():
         )
         db.add(req)
         
-        # قفل موقت تراز مالی کلاینت تا زمان تایید نهایی توسط ادمین
+        # قفل تراز مالی مشاور تا زمان تایید درخواست توسط ادمین در پایگاه داده
         current_user.balance = 0.0
         db.commit()
         
-        return jsonify({"message": "درخواست تسویه حساب شما با موفقیت ثبت شد و در صف تایید نهایی ادمین قرار گرفت."}), 200
+        return jsonify({"message": "درخواست تسویه با موفقیت ثبت شد."}), 200
     except Exception as e:
         logger.error(f"Error requesting settlement: {e}")
         db.rollback()
-        return jsonify({"detail": "بروز خطا در سرور مالی."}), 500
+        return jsonify({"detail": "بروز خطا در ثبت تسویه مالی."}), 500
 
 # ========================================================
-# مدیریت مالی سه‌گانه داوطلبان، مشاوران و آموزشگاه‌ها (بند ۵)
+# بخش ۱۳: گزارش مالی و تفکیک محاسباتی سه‌گانه (بند ۵)
 # ========================================================
 
 @flask_app.route("/api/financial/summary", methods=["GET"])
@@ -1111,9 +1082,8 @@ def get_role_financial_summary():
             }), 200
             
         elif current_user.role == "school_representative":
-            # آموزشگاه‌ها هزینه‌های عودت وجه یا پرداخت‌های اسپانسری دارند
             spent_ads = db.query(text("SUM(amount)")).from_statement(
-                text("SELECT amount FROM settlement_requests WHERE user_id = :uid") # فرض شبیه‌سازی فاکتورهای پلتفرم
+                text("SELECT amount FROM settlement_requests WHERE user_id = :uid")
             ).params(uid=current_user.id).scalar() or 0.0
             
             return jsonify({
@@ -1124,10 +1094,10 @@ def get_role_financial_summary():
             
     except Exception as e:
         logger.error(f"Error building financial summary: {e}")
-        return jsonify({"detail": "خطا در استخراج آمارهای مالی."}), 500
+        return jsonify({"detail": "خطا در دریافت وضعیت تراز مالی."}), 500
 
 # ========================================================
-# ردیابی بازدید آموزشگاه بر اساس شناسه کاربری (بند ۹)
+# بخش ۱۴: ردیابی ترافیک و آمار بازدید آموزشگاه (بند ۹)
 # ========================================================
 
 @flask_app.route("/api/schools/<int:school_id>/visit", methods=["POST"])
@@ -1137,7 +1107,7 @@ def track_school_page_view(school_id):
     current_user = g.current_user
     
     try:
-        # جلوگیری از ثبت مکرر بازدید توسط یک کاربر خاص در بازه‌های کوتاه
+        # جلوگیری از شمارش مکرر بازدید بر اساس اکانت و زمان (نه IP - بند ۹)
         recent = db.query(PageView).filter(
             PageView.school_id == school_id,
             PageView.student_id == current_user.id,
@@ -1156,7 +1126,7 @@ def track_school_page_view(school_id):
     except Exception as e:
         logger.error(f"Error tracking visit: {e}")
         db.rollback()
-        return jsonify({"detail": "خطا در ثبت ترافیک پلتفرم."}), 500
+        return jsonify({"detail": "خطا در ثبت آمار ترافیک."}), 500
 
 
 @flask_app.route("/api/schools/<int:school_id>/analytics", methods=["GET"])
@@ -1166,11 +1136,9 @@ def get_school_analytics_metrics(school_id):
     
     try:
         total_views = db.query(PageView).filter(PageView.school_id == school_id).count()
-        
-        # گرفتن توزیع دقیق امتیازات (بند ۹)
         reviews = db.query(Review).filter(Review.school_id == school_id).all()
-        distribution = [0, 0, 0, 0, 0] # ستاره ۱ تا ۵
-        avg_rating = 5.0
+        distribution = [0, 0, 0, 0, 0]
+        avg_rating = 0.0
         
         if reviews:
             for r in reviews:
@@ -1185,11 +1153,11 @@ def get_school_analytics_metrics(school_id):
             "ratings_distribution": distribution
         }), 200
     except Exception as e:
-        logger.error(f"Error fetching analytics: {e}")
-        return jsonify({"detail": "خطا در لود اطلاعات."}), 500
+        logger.error(f"Error fetching school analytics: {e}")
+        return jsonify({"detail": "خطا در بارگذاری اطلاعات آموزشگاه."}), 500
 
 # ========================================================
-# ماژول بررسی نوبت‌های منقضی نشده ۲۴ ساعته جهت امتیازدهی (بند ۱۰)
+# بخش ۱۵: امتیازدهی اتوماتیک ۲۴ ساعت پس از نوبت (بند ۱۰)
 # ========================================================
 
 @flask_app.route("/api/student/pending-reviews", methods=["GET"])
@@ -1200,9 +1168,8 @@ def get_student_pending_reviews_for_counselors():
     
     try:
         if current_user.role != "student":
-            return jsonify({"detail": "مخصوص داوطلبان"}), 403
+            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
             
-        # فیلتر جلساتی که از شروع آن‌ها ۲۴ ساعت گذشته و هنوز فاقد رکورد امتیازدهی هستند
         boundary_time = get_now() - timedelta(hours=24)
         
         bookings = db.query(Booking).join(TimeSlot).filter(
@@ -1229,7 +1196,7 @@ def get_student_pending_reviews_for_counselors():
         return jsonify({"detail": "خطا در ارزیابی نوبت‌های فعال داوطلب."}), 500
 
 # ==========================================
-# دایرکتوری آموزشگاه‌ها با فیلتر بومی هوشمند (بند ۳)
+# بخش ۱۶: دایرکتوری آموزشگاه‌های فعال با فیلتر بومی (بند ۳)
 # ==========================================
 
 @flask_app.route("/api/schools", methods=["GET"])
@@ -1246,6 +1213,7 @@ def list_and_filter_schools():
         target_city = city or student_city
         is_fallback = False
         
+        # فال‌بک دایرکتوری به سایر شهرها در صورت نبود موسسه در منطقه داوطلب (بند ۳)
         if target_city:
             regional_query = query.join(User, User.id == SchoolProfile.user_id).filter(User.city.ilike(f"%{target_city}%"))
             schools = regional_query.all()
@@ -1283,9 +1251,6 @@ def list_and_filter_schools():
         logger.error(f"Error querying schools: {e}")
         return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
 
-# ========================================================
-# سیستم امتیازدهی یکپارچه به مشاوران و آموزشگاه‌ها (بند ۱۰ و ۱۴)
-# ========================================================
 
 @flask_app.route("/api/reviews", methods=["POST"])
 @login_required
@@ -1313,394 +1278,23 @@ def create_session_review():
         )
         db.add(review)
         
-        # به‌روزرسانی زنده برآیند امتیازات (بند ۱۰ و ۱۴)
+        # محاسبه پویای میانگین امتیاز پس از درج نظر نهایی (بند ۱۰ و ۱۴)
         if counselor_id:
             counselor = db.query(User).filter(User.id == counselor_id).first()
             if counselor:
-                counselor.rating = (counselor.rating + rating) / 2.0
+                counselor.rating = (counselor.rating + rating) / 2.0 if counselor.rating > 0.0 else rating
         elif school_id:
             school = db.query(SchoolProfile).filter(SchoolProfile.id == school_id).first()
             if school:
-                school.rating = (school.rating + rating) / 2.0
+                school.rating = (school.rating + rating) / 2.0 if school.rating > 0.0 else rating
                 
         db.commit()
-        return jsonify({"message": "امتیاز و نظر شما با موفقیت ثبت شد."}), 200
+        return jsonify({"message": "امتیاز با موفقیت در دیتابیس ثبت شد."}), 200
     except Exception as e:
         logger.error(f"Error creating review: {e}")
         db.rollback()
         return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
 
-# ==========================================
-# کارتابل مشاوران و داوطلبان (بند ۱۲ و ۱۳)
-# ==========================================
-
-@flask_app.route("/api/counselor/students", methods=["GET"])
-@login_required
-def get_counselor_dash_clients():
-    db = get_db()
-    current_user = g.current_user
-    try:
-        if current_user.role != "counselor":
-            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
-            
-        booked_slots = db.query(TimeSlot).filter(
-            TimeSlot.counselor_id == current_user.id,
-            TimeSlot.is_booked == True
-        ).all()
-        
-        student_ids = list(set([s.booked_by_student_id for s in booked_slots if s.booked_by_student_id]))
-        results = []
-        for s_id in student_ids:
-            student_user = db.query(User).filter(User.id == s_id).first()
-            if not student_user:
-                continue
-                
-            tests = db.query(TestResult).filter(TestResult.student_id == s_id, TestResult.counselor_id == current_user.id).all()
-            selections = db.query(MajorSelection).filter(MajorSelection.student_id == s_id, MajorSelection.counselor_id == current_user.id).all()
-            
-            parsed_selections = []
-            for sel in selections:
-                try:
-                    gen_list = json.loads(sel.generated_list) if sel.generated_list else []
-                    fin_list = json.loads(sel.finalized_list) if sel.finalized_list else []
-                except Exception:
-                    gen_list, fin_list = sel.generated_list, sel.finalized_list
-                    
-                parsed_selections.append({
-                    "selection_id": sel.id,
-                    "status": sel.status,
-                    "ai_generated_list": gen_list,
-                    "counselor_finalized_list": fin_list
-                })
-                
-            results.append({
-                "student_id": s_id,
-                "student_email": student_user.email,
-                "student_name": student_user.name or student_user.email.split("@")[0],
-                "grade": student_user.grade or "یازدهم", # ارسال مشخصات کامل مقطع (بند ۱۲)
-                "major": student_user.major or "علوم تجربی", # ارسال مشخصات کامل رشته (بند ۱۲)
-                "tests": [{"test_id": t.id, "answers": t.answers, "ai_analysis": t.ai_analysis_summary} for t in tests],
-                "selections": parsed_selections
-            })
-            
-        return jsonify(results), 200
-    except Exception as e:
-        logger.error(f"Error fetching dashboard clients: {e}", exc_info=True)
-        return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
-
-
-@flask_app.route("/api/student/my-visited-counselors", methods=["GET"])
-@login_required
-def get_student_visited_counselors():
-    db = get_db()
-    current_user = g.current_user
-    
-    try:
-        if current_user.role != "student":
-            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
-            
-        bookings = db.query(Booking).filter(
-            Booking.student_id == current_user.id,
-            Booking.status == "active"
-        ).all()
-        
-        c_ids = list(set([b.counselor_id for b in bookings]))
-        results = []
-        for cid in c_ids:
-            c = db.query(User).filter(User.id == cid).first()
-            if c:
-                results.append({
-                    "counselor_id": c.id,
-                    "name": c.name or c.email.split("@")[0],
-                    "specialty": c.counselor_profile.specialty if c.counselor_profile else "کنکور سراسری",
-                    "rating": c.rating,
-                    "city": c.city or "تهران"
-                })
-        return jsonify(results), 200
-    except Exception as e:
-        logger.error(f"Error getting visited counselors: {e}")
-        return jsonify({"detail": "خطا در لود مشاوران داوطلب."}), 500
-
-# ==========================================
-# آدرس‌های باقی‌مانده و اصلی وب‌سرویس
-# ==========================================
-
-@flask_app.route("/api/bookings/<int:booking_id>/cancel-by-counselor", methods=["POST"])
-@login_required
-def cancel_session_by_counselor(booking_id):
-    db = get_db()
-    current_user = g.current_user
-    try:
-        if current_user.role != "counselor":
-            return jsonify({"detail": "تنها مشاوران مجاز به استفاده از این متد هستند."}), 403
-            
-        booking = db.query(Booking).filter(
-            Booking.id == booking_id,
-            Booking.counselor_id == current_user.id
-        ).first()
-        
-        if not booking or booking.status == "cancelled":
-            return jsonify({"detail": "این رزرو قبلاً لغو شده یا وجود ندارد."}), 404
-            
-        student = db.query(User).filter(User.id == booking.student_id).first()
-        counselor = current_user
-        
-        if student:
-            student.balance += booking.cost
-            student_notif = Notification(
-                user_id=student.id,
-                text=f"پیام سیستم: جلسه مشاوره شما لغو گردید و کل مبلغ {booking.cost:,.0f} ریال به حساب عودت داده شد.",
-                role="student"
-            )
-            db.add(student_notif)
-            
-        # کسر ۱۰٪ جریمه لغو یک‌طرفه بر مبنای بندهای انضباطی
-        penalty_fee = booking.cost * 0.10
-        counselor.balance = counselor.balance - (booking.cost + penalty_fee)
-        
-        counselor_notif = Notification(
-            user_id=counselor.id,
-            text=f"پیام سیستم: رزرو شماره {booking.id} لغو گردید و جریمه ۱۰ درصدی ({penalty_fee:,.0f} ریال) از اولین واریزی بعدی کسر می‌شود.",
-            role="counselor"
-        )
-        db.add(counselor_notif)
-        
-        slot = db.query(TimeSlot).filter(TimeSlot.id == booking.slot_id).first()
-        if slot:
-            slot.is_booked = False
-            slot.booked_by_student_id = None
-            
-        booking.status = "cancelled"
-        db.commit()
-        return jsonify({"message": "جلسه مشاوره با موفقیت لغو شد، تراز عودت داده شد و جریمه ثبت گردید."}), 200
-    except Exception as e:
-        logger.error(f"Error cancelling booking by counselor: {e}", exc_info=True)
-        db.rollback()
-        return jsonify({"detail": "خطا در پردازش سرور."}), 500
-
-
-@flask_app.route("/api/selection/select", methods=["POST"])
-@login_required
-def submit_konkur_rag_data():
-    db = get_db()
-    current_user = g.current_user
-    data = request.get_json() or {}
-    rank = data.get("rank")
-    quota = data.get("quota")
-    favorite_cities = data.get("favorite_cities")
-    counselor_id = data.get("counselor_id")
-
-    if rank is None or not quota or not favorite_cities:
-        return jsonify({"detail": "وارد کردن تمامی فیلدهای رتبه، سهمیه و شهرهای انتخابی الزامی است."}), 400
-
-    try:
-        if current_user.role != "student":
-            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
-            
-        konkur = db.query(KonkurDetails).filter(KonkurDetails.student_id == current_user.id).first()
-        if konkur:
-            konkur.rank = rank
-            konkur.quota = quota
-            konkur.favorite_cities = favorite_cities
-        else:
-            konkur = KonkurDetails(
-                student_id=current_user.id,
-                rank=rank,
-                quota=quota,
-                favorite_cities=favorite_cities
-            )
-            db.add(konkur)
-            
-        selection_list_raw = core_selection_engine(rank, quota, favorite_cities)
-        
-        selection = db.query(MajorSelection).filter(
-            MajorSelection.student_id == current_user.id,
-            MajorSelection.counselor_id == counselor_id
-        ).first()
-        
-        if selection:
-            selection.generated_list = selection_list_raw
-            selection.finalized_list = selection_list_raw
-            selection.status = "draft"
-        else:
-            selection = MajorSelection(
-                student_id=current_user.id,
-                counselor_id=counselor_id,
-                generated_list=selection_list_raw,
-                finalized_list=selection_list_raw,
-                status="draft"
-            )
-            db.add(selection)
-            
-        db.commit()
-        
-        try:
-            parsed_selections = json.loads(selection_list_raw)
-        except Exception:
-            parsed_selections = selection_list_raw
-            
-        return jsonify({
-            "message": "پیش‌نویس اولیه آماده و ارسال شد.",
-            "selections": parsed_selections,
-            "selection_id": selection.id
-        }), 200
-    except Exception as e:
-        logger.error(f"Error submitting konkur details: {e}", exc_info=True)
-        db.rollback()
-        return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
-
-
-@flask_app.route("/api/selection/<int:selection_id>/approve", methods=["PUT"])
-@login_required
-def edit_and_approve_selection_list(selection_id):
-    db = get_db()
-    current_user = g.current_user
-    data = request.get_json() or {}
-    finalized_list_json = data.get("finalized_list_json")
-
-    if not finalized_list_json:
-        return jsonify({"detail": "ساختار نهایی انتخاب‌ها الزامی است."}), 400
-
-    try:
-        if current_user.role != "counselor":
-            return jsonify({"detail": "تنها مشاوران مجاز به اعمال ویرایش هستند."}), 403
-            
-        selection = db.query(MajorSelection).filter(
-            MajorSelection.id == selection_id,
-            MajorSelection.counselor_id == current_user.id
-        ).first()
-        
-        if not selection:
-            return jsonify({"detail": "لیست پیش‌نویس مورد نظر یافت نشد."}), 404
-            
-        selection.finalized_list = finalized_list_json
-        selection.status = "approved_by_counselor"
-        db.commit()
-        
-        return jsonify({"message": "لیست نهایی داوطلب ویرایش و تایید گردید."}), 200
-    except Exception as e:
-        logger.error(f"Error during counselor list approval: {e}", exc_info=True)
-        db.rollback()
-        return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
-
-
-@flask_app.route("/api/student/major-selection", methods=["GET"])
-@login_required
-def get_student_selection_finalized_status():
-    db = get_db()
-    current_user = g.current_user
-    try:
-        if current_user.role != "student":
-            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
-            
-        selection = db.query(MajorSelection).filter(MajorSelection.student_id == current_user.id).order_by(MajorSelection.id.desc()).first()
-        if not selection:
-            return jsonify({"detail": "پیش‌نویسی ثبت نشده است."}), 404
-            
-        try:
-            generated = json.loads(selection.generated_list) if selection.generated_list else []
-            finalized = json.loads(selection.finalized_list) if selection.finalized_list else []
-        except Exception:
-            generated = selection.generated_list
-            finalized = selection.finalized_list
-            
-        return jsonify({
-            "selection_id": selection.id,
-            "status": selection.status,
-            "ai_generated_list": generated,
-            "counselor_finalized_list": finalized,
-            "finalized_list": finalized
-        }), 200
-    except Exception as e:
-        logger.error(f"Error fetching student selection list: {e}", exc_info=True)
-        return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
-
-
-@flask_app.route("/api/schools/request-counselor", methods=["POST"])
-@login_required
-def school_request_counselor_link():
-    db = get_db()
-    current_user = g.current_user
-    data = request.get_json() or {}
-    counselor_id = data.get("counselor_id")
-
-    if not counselor_id:
-        return jsonify({"detail": "شناسه مشاور الزامی است."}), 400
-
-    try:
-        if current_user.role != "school_representative":
-            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
-        
-        school_prof = current_user.school_profile
-        if not school_prof:
-            return jsonify({"detail": "پروفایل آموزشگاهی ثبت نشده است."}), 404
-            
-        assoc = SchoolCounselorAssociation(
-            school_id=school_prof.id,
-            counselor_id=counselor_id,
-            status="pending"
-        )
-        db.add(assoc)
-        db.commit()
-        return jsonify({"message": "درخواست همبستگی با موفقیت ارسال گردید."}), 200
-    except Exception as e:
-        logger.error(f"Error requesting link: {e}")
-        db.rollback()
-        return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
-
-
-@flask_app.route("/api/counselor/extract-bio", methods=["POST"])
-@login_required
-def extract_bio_from_resume_text():
-    db = get_db()
-    current_user = g.current_user
-    data = request.get_json() or {}
-    resume_text = data.get("resume_text")
-
-    if not resume_text:
-        return jsonify({"detail": "متن رزومه برای استخراج الزامی است."}), 400
-
-    try:
-        if current_user.role != "counselor":
-            return jsonify({"detail": "مخصوص مشاوران"}), 403
-            
-        extracted_bio = core_bio_extraction(resume_text)
-        profile = current_user.counselor_profile
-        if profile:
-            profile.bio = extracted_bio
-            profile.resume = resume_text
-            db.commit()
-            
-        return jsonify({
-            "message": "بیوگرافی بهینه بر اساس رزومه استخراج شد.",
-            "extracted_bio": extracted_bio
-        }), 200
-    except Exception as e:
-        logger.error(f"Error extracting bio: {e}")
-        db.rollback()
-        return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
-
-
-@flask_app.route("/api/schools/purchase-ad", methods=["POST"])
-@login_required
-def purchase_school_premium_ad():
-    db = get_db()
-    current_user = g.current_user
-    try:
-        if current_user.role != "school_representative":
-            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
-        profile = current_user.school_profile
-        if not profile:
-            return jsonify({"detail": "پروفایل آموزشگاه یافت نشد."}), 404
-            
-        profile.is_sponsored = True
-        db.commit()
-        return jsonify({"message": "تبلیغات ویژه با موفقیت خریداری شد."}), 200
-    except Exception as e:
-        logger.error(f"Error purchasing school ad: {e}")
-        db.rollback()
-        return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
-
 
 @flask_app.route("/api/schools/update", methods=["POST"])
 @login_required
@@ -1903,32 +1497,92 @@ def create_time_slots():
         return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
 
 
-@flask_app.route("/api/notifications", methods=["GET"])
+@flask_app.route("/api/counselor/students", methods=["GET"])
 @login_required
-def get_user_notifications():
+def get_counselor_dash_clients():
     db = get_db()
     current_user = g.current_user
     try:
-        notifs = db.query(Notification).filter(
-            or_(
-                Notification.user_id == current_user.id,
-                Notification.role == "all",
-                Notification.role == current_user.role
-            )
-        ).order_by(Notification.id.desc()).all()
+        if current_user.role != "counselor":
+            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
+            
+        booked_slots = db.query(TimeSlot).filter(
+            TimeSlot.counselor_id == current_user.id,
+            TimeSlot.is_booked == True
+        ).all()
         
-        output = []
-        for n in notifs:
-            output.append({
-                "id": n.id,
-                "text": n.text,
-                "role": n.role,
-                "is_read": n.is_read
+        student_ids = list(set([s.booked_by_student_id for s in booked_slots if s.booked_by_student_id]))
+        results = []
+        for s_id in student_ids:
+            student_user = db.query(User).filter(User.id == s_id).first()
+            if not student_user:
+                continue
+                
+            tests = db.query(TestResult).filter(TestResult.student_id == s_id, TestResult.counselor_id == current_user.id).all()
+            selections = db.query(MajorSelection).filter(MajorSelection.student_id == s_id, MajorSelection.counselor_id == current_user.id).all()
+            
+            parsed_selections = []
+            for sel in selections:
+                try:
+                    gen_list = json.loads(sel.generated_list) if sel.generated_list else []
+                    fin_list = json.loads(sel.finalized_list) if sel.finalized_list else []
+                except Exception:
+                    gen_list, fin_list = sel.generated_list, sel.finalized_list
+                    
+                parsed_selections.append({
+                    "selection_id": sel.id,
+                    "status": sel.status,
+                    "ai_generated_list": gen_list,
+                    "counselor_finalized_list": fin_list
+                })
+                
+            results.append({
+                "student_id": s_id,
+                "student_email": student_user.email,
+                "student_name": student_user.name or student_user.email.split("@")[0],
+                "grade": student_user.grade or "یازدهم", # فیلد مقطع تحصیلی داوطلب (بند ۱۲)
+                "major": student_user.major or "علوم تجربی", # فیلد رشته تحصیلی داوطلب (بند ۱۲)
+                "tests": [{"test_id": t.id, "answers": t.answers, "ai_analysis": t.ai_analysis_summary} for t in tests],
+                "selections": parsed_selections
             })
-        return jsonify(output), 200
+            
+        return jsonify(results), 200
+    except Exception as e:
+        logger.error(f"Error fetching dashboard clients: {e}", exc_info=True)
+        return jsonify({"detail": "سرور موقتاً شلوغ است. لطفاً بعداً تلاش کنید."}), 503
+
+
+@flask_app.route("/api/student/my-visited-counselors", methods=["GET"])
+@login_required
+def get_student_visited_counselors():
+    db = get_db()
+    current_user = g.current_user
+    
+    try:
+        if current_user.role != "student":
+            return jsonify({"detail": "دسترسی غیرمجاز"}), 403
+            
+        bookings = db.query(Booking).filter(
+            Booking.student_id == current_user.id,
+            Booking.status == "active"
+        ).all()
+        
+        c_ids = list(set([b.counselor_id for b in bookings]))
+        results = []
+        for cid in c_ids:
+            c = db.query(User).filter(User.id == cid).first()
+            if c:
+                results.append({
+                    "counselor_id": c.id,
+                    "name": c.name or c.email.split("@")[0],
+                    "specialty": c.counselor_profile.specialty if c.counselor_profile else "کنکور سراسری",
+                    "rating": c.rating,
+                    "city": c.city or "تهران"
+                })
+        return jsonify(results), 200
     except Exception as e:
-        logger.error(f"Error fetching notifications: {e}")
-        return jsonify({"detail": "خطا در دریافت اعلان‌ها."}), 500
+        logger.error(f"Error getting visited counselors: {e}")
+        return jsonify({"detail": "خطا در دریافت لیست مشاوران من."}), 500
 
 
 @flask_app.route("/api/notifications/<int:notif_id>/read", methods=["POST"])
@@ -1951,7 +1605,7 @@ def mark_single_notification_as_read(notif_id):
             return jsonify({"status": "success"}), 200
         return jsonify({"detail": "اعلان یافت نشد."}), 404
     except Exception as e:
-        logger.error(f"Error marking single notification as read: {e}")
+        logger.error(f"Error marking notification: {e}")
         db.rollback()
         return jsonify({"detail": "خطا در به‌روزرسانی اعلان."}), 500
 
@@ -1979,11 +1633,67 @@ def mark_notifications_as_read():
         return jsonify({"detail": "خطا در به‌روزرسانی اعلان‌ها."}), 500
 
 
+@flask_app.route("/api/counselor/create-manual-booking", methods=["POST"])
+@login_required
+def create_manual_booking_by_counselor():
+    db = get_db()
+    current_user = g.current_user
+    data = request.get_json() or {}
+    student_id = data.get("student_id")
+    start_time_str = data.get("start_time")
+    end_time_str = data.get("end_time")
+    cost = data.get("cost")
+
+    if not student_id or not start_time_str or not end_time_str or cost is None:
+        return jsonify({"detail": "تمام فیلدها الزامی است."}), 400
+
+    try:
+        if current_user.role != "counselor":
+            return jsonify({"detail": "تنها مشاوران مجاز به ثبت نوبت هستند."}), 403
+            
+        try:
+            start_time = datetime.fromisoformat(start_time_str)
+            end_time = datetime.fromisoformat(end_time_str)
+        except ValueError:
+            return jsonify({"detail": "فرمت تاریخ نامعتبر است."}), 400
+
+        slot = TimeSlot(
+            counselor_id=current_user.id,
+            start_time=start_time,
+            end_time=end_time,
+            is_booked=True,
+            booked_by_student_id=student_id
+        )
+        db.add(slot)
+        db.flush()
+        
+        due_time = get_now() + timedelta(hours=24)
+        booking = Booking(
+            slot_id=slot.id,
+            student_id=student_id,
+            counselor_id=current_user.id,
+            status="active",
+            payment_status="pending_payment",
+            payment_due_until=due_time,
+            cost=cost
+        )
+        db.add(booking)
+        db.commit()
+        
+        return jsonify({
+            "message": "نوبت صادر و فاکتور ۲۴ ساعته ارسال گردید.",
+            "booking_id": booking.id
+        }), 200
+    except Exception as e:
+        logger.error(f"Error manual booking: {e}")
+        db.rollback()
+        return jsonify({"detail": "خطا در ایجاد نوبت دستی."}), 503
+
+
 @flask_app.route("/")
 def home_webview():
     return flask_app.send_static_file("index.html")
 
-# تبدیل ساختار فلاسک WSGI به هندلرهای کارآمد ASGI
 app = WsgiToAsgi(flask_app)
 
 if __name__ == "__main__":