refactor!: Migrate database from prisma to sqlmodel

.github/actions/setup-python/action.yml

@@ -13,10 +13,6 @@ inputs:
     description: Cache key suffix for differentiation
     required: false
     default: default
-  generate-prisma:
-    description: Whether to generate Prisma client
-    required: false
-    default: 'true'
 runs:
   using: composite
   steps:
@@ -51,16 +47,9 @@ runs:
     # Installs specified Poetry groups with CI-optimized settings
     - name: Install dependencies
       shell: bash
-      run: |
+      run: |-
         if [[ "${{ inputs.install-groups }}" == "main" ]]; then
           poetry install --only=main --no-interaction --no-ansi
         else
           poetry install --with=${{ inputs.install-groups }} --no-interaction --no-ansi
         fi
-
-    # CONDITIONAL PRISMA CLIENT GENERATION
-    # Generates Prisma database client when needed for database operations
-    - name: Generate Prisma client
-      if: ${{ inputs.generate-prisma == 'true' }}
-      shell: bash
-      run: poetry run prisma generate

.github/workflows/ci.yml

@@ -112,7 +112,6 @@ jobs:
           python-version: '3.13'
           install-groups: dev,types
           cache-suffix: ci
-          generate-prisma: 'true'
 
       # STATIC TYPE CHECKING
       # Pyright provides comprehensive type checking for Python

.github/workflows/security.yml

@@ -178,7 +178,6 @@ jobs:
           python-version: '3.13'
           install-groups: main
           cache-suffix: security
-          generate-prisma: 'false'
 
       # SECURITY VULNERABILITY SCANNING
       # Comprehensive security advisory checking with structured output

.github/workflows/tests.yml

@@ -124,7 +124,6 @@ jobs:
           python-version: ${{ matrix.python-version }}
           install-groups: dev,test,types
           cache-suffix: test
-          generate-prisma: 'true'
 
       # TEST ENVIRONMENT CONFIGURATION
       # Creates isolated test environment with SQLite for CI safety

.vscode/settings.json

@@ -11,7 +11,7 @@
       "source.organizeImports.ruff": "explicit"
     }
   },
-  "python.languageServer": "Pylance",
+  "python.languageServer": "None",
   "python.analysis.typeCheckingMode": "strict",
   "python.analysis.autoFormatStrings": true,
   "python.analysis.completeFunctionParens": true,

Dockerfile

@@ -183,7 +183,6 @@ COPY config/ ./config/
 
 # 2. Database schema files (change infrequently)
 # Prisma schema and migrations are relatively stable
-COPY prisma/ ./prisma/
 
 # 3. Main application code (changes more frequently)
 # The core bot code is most likely to change during development
@@ -269,13 +268,12 @@ USER nonroot
 # Install development dependencies and setup Prisma
 # DEVELOPMENT: These tools are needed for linting, testing, and development workflow
 RUN poetry install --only dev --no-root --no-directory && \
-    poetry run prisma py fetch && \
-    poetry run prisma generate
+    true
 
 # Development container startup command
 # WORKFLOW: Regenerates Prisma client and starts the bot in development mode
 # This ensures the database client is always up-to-date with schema changes
-CMD ["sh", "-c", "poetry run prisma generate && exec poetry run tux --dev start"]
+CMD ["sh", "-c", "exec poetry run tux --dev start"]
 
 # ==============================================================================
 # PRODUCTION STAGE - Minimal Runtime Environment
@@ -357,7 +355,6 @@ ENV VIRTUAL_ENV=/app/.venv \
 # EFFICIENCY: Only copies what's needed for runtime
 COPY --from=build --chown=nonroot:nonroot /app/.venv /app/.venv
 COPY --from=build --chown=nonroot:nonroot /app/tux /app/tux
-COPY --from=build --chown=nonroot:nonroot /app/prisma /app/prisma
 COPY --from=build --chown=nonroot:nonroot /app/config /app/config
 COPY --from=build --chown=nonroot:nonroot /app/pyproject.toml /app/pyproject.toml
 COPY --from=build --chown=nonroot:nonroot /app/VERSION /app/VERSION
@@ -385,8 +382,7 @@ RUN set -eux; \
 # SECURITY: Application runs with minimal privileges
 # RUNTIME: Ensures Prisma binaries and client are properly configured as nonroot user
 USER nonroot
-RUN /app/.venv/bin/python -m prisma py fetch && \
-    /app/.venv/bin/python -m prisma generate
+RUN true
 
 # Aggressive cleanup and optimization after Prisma setup
 # PERFORMANCE: Single RUN reduces layer count and enables atomic cleanup
@@ -404,18 +400,18 @@ RUN set -eux; \
     # Remove test directories from installed packages (but preserve prisma binaries)
     # These directories contain test files that are not needed in production
     for test_dir in tests testing "*test*"; do \
-        find /app/.venv -name "$test_dir" -type d -not -path "*/prisma*" -exec rm -rf {} + 2>/dev/null || true; \
+        find /app/.venv -name "$test_dir" -type d -exec rm -rf {} + 2>/dev/null || true; \
     done; \
     \
-    # Remove documentation files from installed packages (but preserve prisma docs)
+    # Remove documentation files from installed packages
     # These files take up significant space and are not needed in production
     for doc_pattern in "*.md" "*.txt" "*.rst" "LICENSE*" "NOTICE*" "COPYING*" "CHANGELOG*" "README*" "HISTORY*" "AUTHORS*" "CONTRIBUTORS*"; do \
-        find /app/.venv -name "$doc_pattern" -not -path "*/prisma*" -delete 2>/dev/null || true; \
+        find /app/.venv -name "$doc_pattern" -delete 2>/dev/null || true; \
     done; \
     \
     # Remove large development packages that are not needed in production
     # These packages (pip, setuptools, wheel) are only needed for installing packages
-    # NOTE: Preserving packages that Prisma might need
+    # NOTE: Cleanup complete
     for pkg in setuptools wheel pkg_resources; do \
         rm -rf /app/.venv/lib/python3.13/site-packages/${pkg}* 2>/dev/null || true; \
         rm -rf /app/.venv/bin/${pkg}* 2>/dev/null || true; \

alembic.ini

@@ -0,0 +1,35 @@
+[alembic]
+script_location = alembic
+sqlalchemy.url = env:DATABASE_URL
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s

alembic/__init__.py

@@ -0,0 +1 @@
+# Alembic package

alembic/env.py

@@ -0,0 +1,104 @@
+"""Alembic environment script auto-generated for SQLModel metadata.
+
+This file wires Alembic to the *runtime* SQLModel metadata defined in
+`tux.database.models` so that `alembic revision --autogenerate` correctly
+reflects changes to the declarative models.
+"""
+
+from __future__ import annotations
+
+import os
+from logging.config import fileConfig
+from typing import Any
+
+from sqlalchemy import engine_from_config, pool
+from sqlmodel import SQLModel
+
+from alembic import context
+
+# Import models so their metadata is registered.
+from tux.database import models as _models  # noqa: F401  # pylint: disable=unused-import
+
+# --------------------------------------------------------
+# Alembic configuration
+# --------------------------------------------------------
+
+config = context.config  # type: ignore[attr-defined]
+
+# Interpret the config file for Python logging.
+fileConfig(config.config_file_name)  # type: ignore[arg-type]
+
+# Target metadata for 'autogenerate' support.
+# We rely on SQLModel which stores all tables in SQLModel.metadata.
+
+target_metadata = SQLModel.metadata  # type: ignore[attr-defined]
+
+# Database URL: use env or alembic.ini → sqlalchemy.url
+
+DATABASE_URL = os.getenv("DATABASE_URL", config.get_main_option("sqlalchemy.url"))
+
+if DATABASE_URL.startswith("postgresql://") and "+asyncpg" not in DATABASE_URL:
+    # Autogenerate uses *sync* engine - strip async driver if present.
+    DATABASE_URL = DATABASE_URL.replace("postgresql://", "postgresql+psycopg2://", 1)
+
+
+# --------------------------------------------------------
+# Helper functions
+# --------------------------------------------------------
+
+
+def get_engine_config(overrides: dict[str, Any] | None = None) -> dict[str, Any]:
+    """Return the SQLAlchemy Engine configuration for Alembic."""
+
+    cfg = config.get_section(config.config_ini_section)  # type: ignore[arg-type]
+    assert cfg is not None
+    cfg = dict(cfg)
+    cfg["sqlalchemy.url"] = DATABASE_URL
+    if overrides:
+        cfg.update(overrides)
+    return cfg
+
+
+# --------------------------------------------------------
+# Offline / online migration runners
+# --------------------------------------------------------
+
+
+def run_migrations_offline() -> None:
+    """Run migrations without an Engine (generates SQL scripts)."""
+
+    context.configure(
+        url=DATABASE_URL,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    """Run migrations in `online` mode with a live DB connection."""
+
+    connectable = engine_from_config(
+        get_engine_config({"sqlalchemy.echo": "False"}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata)
+
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+# --------------------------------------------------------
+# Entrypoint
+# --------------------------------------------------------
+
+if context.is_offline_mode():  # type: ignore[attr-defined]
+    run_migrations_offline()
+else:
+    run_migrations_online()

alembic/script.py.mako

@@ -0,0 +1,29 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+import sqlmodel
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, Sequence[str], None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    ${downgrades if downgrades else "pass"}