Update app.py

app.py

@@ -18,18 +18,18 @@ from jose import JWTError, jwt
 from google import genai
 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")
 
-# ==========================================
-# بخش دوم: اتصال پایگاه داده Neon.tech و ساختار پایه
-# ==========================================
+# =========================================================================
+# بخش ۲: اتصال پایگاه داده Neon.tech و ساختار بومی دیتابیس
+# =========================================================================
 DATABASE_URL = os.getenv("DATABASE_URL", "sqlite:///./test.db")
 if DATABASE_URL.startswith("postgres://"):
     DATABASE_URL = DATABASE_URL.replace("postgres://", "postgresql://", 1)
@@ -56,9 +56,9 @@ Base = declarative_base()
 def get_now():
     return datetime.now(timezone.utc).replace(tzinfo=None)
 
-# ==========================================
-# بخش سوم: مدل‌های دیتابیس (SQLAlchemy Models)
-# ==========================================
+# =========================================================================
+# بخش ۳: مدل‌های دیتابیس (SQLAlchemy Models)
+# =========================================================================
 
 class User(Base):
     __tablename__ = "users"
@@ -211,9 +211,9 @@ class Review(Base):
     rating = Column(Float, default=5.0)
     comment = Column(Text, nullable=True)
 
-# ==========================================
-# بخش چهارم: توابع کمکی امنیتی و رمزنگاری
-# ==========================================
+# =========================================================================
+# بخش ۴: توابع کمکی امنیتی و رمزنگاری
+# =========================================================================
 
 def get_password_hash(password: str) -> str:
     salt = bcrypt.gensalt()
@@ -230,9 +230,9 @@ SECRET_KEY = os.getenv("JWT_SECRET", "8c12fa4870a23049102c89eeffb8a719280abdc029
 ALGORITHM = "HS256"
 security = HTTPBearer()
 
-# ==========================================
-# بخش پنجم: توابع وابستگی تزریق پایگاه داده و احراز هویت
-# ==========================================
+# =========================================================================
+# بخش ۵: توابع وابستگی تزریق پایگاه داده و احراز هویت
+# =========================================================================
 
 def clean_expired_bookings(db: Session):
     try:
@@ -283,9 +283,9 @@ def get_current_user(db: Session = Depends(get_db), credentials: HTTPAuthorizati
         raise credentials_exception
     return user
 
-# ==========================================
-# بخش ششم: توابع پردازش ابری هوشمند بومی تاپ دانش
-# ==========================================
+# =========================================================================
+# بخش ۶: توابع پردازش ابری هوشمند بومی تاپ دانش
+# =========================================================================
 
 def _execute_native_matrix_processing(prompt: str, model_type: str = "fast") -> str:
     if not AI_CORE_KEY:
@@ -322,7 +322,7 @@ def core_selection_engine(rank: int, quota: str, favorite_cities: str) -> str:
     پایگاه داده دانشگاه‌ها:
     {context_str}
 
-    یک سناریوی پیشنهادی شامل حداکثر 8 انتخاب خوش‌بینانه و منطقی به زبان کاملاً ساده، روان، صمیمی و دانشجویی تولید کنید.
+    یک سناریوی پیشنهادی شامل حداکثر 8 انتخاب خوش‌بینانه و منطقی به زبان کاملاً ساده, روان, صمیمی و دانشجویی تولید کنید.
     خروجی را صرفاً و بدون هیچگونه متن توضیحی اضافه در قالب یک آرایه معتبر JSON و فاقد کدهای مارک‌داون برگردانید:
     [
       {{
@@ -367,9 +367,9 @@ def core_bio_extraction(resume_text: str) -> str:
         return "کارشناس تحصیلی با سابقه رتبه‌پروری در کنکور و برنامه‌ریزی تخصصی داوطلبان گروه علوم تجربی و ریاضی."
     return result
 
-# ==========================================
-# بخش هفتم: کلاس‌های ورودی Pydantic (صحت‌سنجی)
-# ==========================================
+# =========================================================================
+# بخش ۷: کلاس‌های ورودی Pydantic (صحت‌سنجی)
+# =========================================================================
 
 class RegisterRequest(BaseModel):
     email: EmailStr
@@ -467,40 +467,9 @@ class UpdateProfileRequest(BaseModel):
     phone_number: Optional[str] = None
     city: Optional[str] = None
 
-# ==========================================
-# بخش هشتم: راه‌اندازی و اجرای وب‌سرور FastAPI
-# ==========================================
-
-@asynccontextmanager
-async def lifespan(app: FastAPI):
-    Base.metadata.create_all(bind=engine)
-    db = SessionLocal()
-    try:
-        seed_initial_data(db)
-    except Exception as seed_err:
-        logger.error(f"Error seeding database during startup: {seed_err}", exc_info=True)
-    finally:
-        db.close()
-    yield
-
-app = FastAPI(
-    title="پلتفرم خدمات هوشمند تحصیلی تاپ دانش",
-    description="سیستم محاسباتی و ارزیابی تراز تحصیلی بومی",
-    version="1.3.0",
-    lifespan=lifespan
-)
-
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=["*"],
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
-
-# ==========================================
-# بخش نهم: همگام‌سازی اجباری کلمه‌های عبور (Forced Check-Seeding)
-# ==========================================
+# =========================================================================
+# بخش ۸: لایه همگام‌سازی داده‌های تستی و دمو (Check-Seeding)
+# =========================================================================
 
 def seed_initial_data(db: Session):
     try:
@@ -604,9 +573,38 @@ def seed_initial_data(db: Session):
         logger.error(f"Seeding process crashed: {e}", exc_info=True)
         db.rollback()
 
-# =======================================================
-# سیستم مدیریت استثناهای گلوبال (پنهان‌سازی کدهای خطا از کاربر)
-# =======================================================
+# =========================================================================
+# بخش ۹: راه‌اندازی و اجرای وب‌سرور FastAPI
+# =========================================================================
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    Base.metadata.create_all(bind=engine)
+    db = SessionLocal()
+    try:
+        seed_initial_data(db)
+    except Exception as seed_err:
+        logger.error(f"Error seeding database during startup: {seed_err}", exc_info=True)
+    finally:
+        db.close()
+    yield
+
+app = FastAPI(
+    title="پلتفرم خدمات هوشمند تحصیلی تاپ دانش",
+    description="سیستم محاسباتی و ارزیابی تراز تحصیلی بومی",
+    version="1.3.0",
+    lifespan=lifespan
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
 @app.exception_handler(Exception)
 async def global_exception_handler(request: Request, exc: Exception):
     logger.error(f"Internal Crash logged on {request.url.path}: {exc}", exc_info=True)
@@ -616,7 +614,7 @@ async def global_exception_handler(request: Request, exc: Exception):
     )
 
 # ==========================================
-# بخش دهم: کلیه آدرس‌های APIها (مراحل ۱ تا ۴)
+# بخش ۱۰: کلیه آدرس‌های APIها (مراحل ۱ تا ۴)
 # ==========================================
 
 @app.post("/api/auth/register")