feat: configure Alembic env.py to dynamically load settings database URL and metadata

alembic/env.py

@@ -1,5 +1,7 @@
 import asyncio
+import sys
 from logging.config import fileConfig
+from pathlib import Path
 
 from sqlalchemy import pool
 from sqlalchemy.engine import Connection
@@ -7,39 +9,29 @@ from sqlalchemy.ext.asyncio import async_engine_from_config
 
 from alembic import context
 
+# 1. Add the project root to Python Path to allow imports from backend
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from backend.app.config.settings import settings
+from backend.app.database.models import Base
+
 # this is the Alembic Config object, which provides
 # access to the values within the .ini file in use.
 config = context.config
 
+# 2. Inject our dynamic database URL from settings into Alembic's configuration
+config.set_main_option("sqlalchemy.url", settings.database_url_async)
+
 # Interpret the config file for Python logging.
-# This line sets up loggers basically.
 if config.config_file_name is not None:
     fileConfig(config.config_file_name)
 
-# add your model's MetaData object here
-# for 'autogenerate' support
-# from myapp import mymodel
-# target_metadata = mymodel.Base.metadata
-target_metadata = None
-
-# other values from the config, defined by the needs of env.py,
-# can be acquired:
-# my_important_option = config.get_main_option("my_important_option")
-# ... etc.
+# 3. Hook up our SQLAlchemy Base metadata to enable schema autogeneration
+target_metadata = Base.metadata
 
 
 def run_migrations_offline() -> None:
-    """Run migrations in 'offline' mode.
-
-    This configures the context with just a URL
-    and not an Engine, though an Engine is acceptable
-    here as well.  By skipping the Engine creation
-    we don't even need a DBAPI to be available.
-
-    Calls to context.execute() here emit the given string to the
-    script output.
-
-    """
+    """Run migrations in 'offline' mode."""
     url = config.get_main_option("sqlalchemy.url")
     context.configure(
         url=url,
@@ -62,9 +54,7 @@ def do_run_migrations(connection: Connection) -> None:
 async def run_async_migrations() -> None:
     """In this scenario we need to create an Engine
     and associate a connection with the context.
-
     """
-
     connectable = async_engine_from_config(
         config.get_section(config.config_ini_section, {}),
         prefix="sqlalchemy.",
@@ -79,11 +69,10 @@ async def run_async_migrations() -> None:
 
 def run_migrations_online() -> None:
     """Run migrations in 'online' mode."""
-
     asyncio.run(run_async_migrations())
 
 
 if context.is_offline_mode():
     run_migrations_offline()
 else:
-    run_migrations_online()
+    run_migrations_online()

backend/app/config/settings.py

@@ -11,13 +11,18 @@ class Settings(BaseSettings):
     GEMINI_API_KEY: str
     
     # Optional Razorpay Credentials (defaults to empty string if not set)
-    RAZORPAY_KEY_ID: str= Field(default="")
-    RAZORPAY_KEY_SECRET: str= Field(default="")
-    RAZORPAY_WEBHOOK_SECRET: str= Field(default="")
+    RAZORPAY_KEY_ID: str = Field(default="")
+    RAZORPAY_KEY_SECRET: str = Field(default="")
+    RAZORPAY_WEBHOOK_SECRET: str = Field(default="")
+    
+    # Optional Cloudinary Credentials (defaults to empty string if not set)
+    CLOUDINARY_CLOUD_NAME: str = Field(default="")
+    CLOUDINARY_API_KEY: str = Field(default="")
+    CLOUDINARY_API_SECRET: str = Field(default="")
     
     # Auth configuration
-    SECRET_KEY: str= Field(default="supersecretkeychangeinproduction")
-    ACCESS_TOKEN_EXPIRE_MINUTES: int= 60*24*8 
+    SECRET_KEY: str = Field(default="supersecretkeychangeinproduction")
+    ACCESS_TOKEN_EXPIRE_MINUTES: int = 60 * 24 * 8 
     
     @property
     def database_url_async(self) -> str:

pyproject.toml

@@ -21,4 +21,5 @@ dependencies = [
     "prometheus-fastapi-instrumentator>=7.0.0",
     "razorpay>=1.4.1",
     "httpx>=0.27.0",
+    "cloudinary>=1.38.0",
 ]

uv.lock

@@ -305,6 +305,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c7/0d/67e5b4109ea4a837e80daa87c2c696711955e40449a97e8926672534def2/click-8.4.1-py3-none-any.whl", hash = "sha256:482be17c6991b8c19c5429a1e995d9b0efdbb63172824c41f99965dc0ade8ec2", size = 116639, upload-time = "2026-05-22T04:08:35.26Z" },
 ]
 
+[[package]]
+name = "cloudinary"
+version = "1.44.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "six" },
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0c/1b/ae48dbbe3c2ff81b94816dd6645af2d609e135cea4fcd65b1a8a61672cea/cloudinary-1.44.2.tar.gz", hash = "sha256:bc9139c68f2ef6996ba62a5d0300e63c711d4f6564644c0c82aa31bf641ef3c7", size = 188389, upload-time = "2026-04-16T08:18:19.92Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b2/8b/0da00a22362c89ef53f9d64af29546d24aba8533ffdb7bbcb19631c7f636/cloudinary-1.44.2-py3-none-any.whl", hash = "sha256:6624d06014c33f50c0c9e740fde1dfe4579d03311025d8bb7183824b7443aa09", size = 147805, upload-time = "2026-04-16T08:18:18.84Z" },
+]
+
 [[package]]
 name = "colorama"
 version = "0.4.6"
@@ -1507,6 +1521,7 @@ source = { virtual = "." }
 dependencies = [
     { name = "alembic" },
     { name = "asyncpg" },
+    { name = "cloudinary" },
     { name = "fastapi" },
     { name = "google-generativeai" },
     { name = "httpx" },
@@ -1528,6 +1543,7 @@ dependencies = [
 requires-dist = [
     { name = "alembic", specifier = ">=1.13.1" },
     { name = "asyncpg", specifier = ">=0.29.0" },
+    { name = "cloudinary", specifier = ">=1.38.0" },
     { name = "fastapi", specifier = ">=0.110.0" },
     { name = "google-generativeai", specifier = ">=0.4.1" },
     { name = "httpx", specifier = ">=0.27.0" },