splent-feature-admin 1.0.0__tar.gz

splent_feature_admin-1.0.0/MANIFEST.in

@@ -0,0 +1,8 @@
+# Compiled frontend bundles
+recursive-include src/splent_io/splent_feature_admin/assets/dist *.js *.css *.map
+
+# Jinja templates (feature views + hook fragments)
+recursive-include src/splent_io/splent_feature_admin/templates *.html
+
+# Alembic migration config and scripts
+recursive-include src/splent_io/splent_feature_admin/migrations *.py *.ini *.mako

splent_feature_admin-1.0.0/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: splent_feature_admin
+Version: 1.0.0
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown

splent_feature_admin-1.0.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=80.3.1", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "splent_feature_admin"
+version = "1.0.0"
+readme = "README.md"
+requires-python = ">=3.13"
+
+dependencies = [
+
+]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["*.tests", "*.tests.*"]
+
+[tool.splent]
+cli_version = "1.4.5"
+
+# ── Feature Contract (auto-generated) ────────────────────────────────────────
+# Do not edit manually — re-run `splent feature:contract --write` to refresh.
+[tool.splent.contract]
+description = "Auto-generated CRUD admin panel for all product models"
+
+[tool.splent.contract.provides]
+routes     = ["/admin", "/admin/<model_name>", "/admin/<model_name>/<int:id>", "/admin/<model_name>/<int:id>/delete", "/admin/<model_name>/create"]
+blueprints = []
+models     = []
+commands   = []
+hooks      = ["layout.authenticated_sidebar"]
+services   = []
+signals    = []
+translations = []
+docker     = []
+
+[tool.splent.contract.requires]
+features = ["auth"]
+env_vars = []
+signals  = []
+
+[tool.splent.contract.extensible]
+services  = []
+templates = ["admin/dashboard.html", "admin/delete.html", "admin/form.html", "admin/list.html"]
+models    = []
+hooks     = ["layout.authenticated_sidebar"]
+routes    = false

splent_feature_admin-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

splent_feature_admin-1.0.0/src/splent_feature_admin.egg-info/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: splent_feature_admin
+Version: 1.0.0
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown

splent_feature_admin-1.0.0/src/splent_feature_admin.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+MANIFEST.in
+pyproject.toml
+src/splent_feature_admin.egg-info/PKG-INFO
+src/splent_feature_admin.egg-info/SOURCES.txt
+src/splent_feature_admin.egg-info/dependency_links.txt
+src/splent_feature_admin.egg-info/top_level.txt
+src/splent_io/splent_feature_admin/__init__.py
+src/splent_io/splent_feature_admin/config.py
+src/splent_io/splent_feature_admin/hooks.py
+src/splent_io/splent_feature_admin/routes.py
+src/splent_io/splent_feature_admin/seeders.py
+src/splent_io/splent_feature_admin/services.py
+src/splent_io/splent_feature_admin/migrations/alembic.ini
+src/splent_io/splent_feature_admin/migrations/env.py
+src/splent_io/splent_feature_admin/migrations/script.py.mako
+src/splent_io/splent_feature_admin/templates/admin/dashboard.html
+src/splent_io/splent_feature_admin/templates/admin/delete.html
+src/splent_io/splent_feature_admin/templates/admin/form.html
+src/splent_io/splent_feature_admin/templates/admin/list.html

splent_feature_admin-1.0.0/src/splent_feature_admin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

splent_feature_admin-1.0.0/src/splent_feature_admin.egg-info/top_level.txt

@@ -0,0 +1 @@
+splent_io

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/__init__.py

@@ -0,0 +1,14 @@
+from splent_framework.blueprints.base_blueprint import create_blueprint
+from splent_framework.services.service_locator import register_service
+
+from splent_io.splent_feature_admin.services import AdminService
+
+admin_bp = create_blueprint(__name__)
+
+
+def init_feature(app):
+    register_service(app, "AdminService", AdminService)
+
+
+def inject_context_vars(app):
+    return {}

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/config.py

@@ -0,0 +1,10 @@
+"""
+admin feature configuration.
+
+Injects environment variables into Flask app.config.
+To regenerate from source code: splent feature:inject-config splent_feature_admin
+"""
+
+
+def inject_config(app):
+    app.config.update({})

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/hooks.py

@@ -0,0 +1,17 @@
+from splent_framework.hooks.template_hooks import register_template_hook
+from flask import request, url_for
+
+
+def admin_sidebar_link():
+    active = "active" if request.endpoint and request.endpoint.startswith("admin.") else ""
+    return (
+        f'<li class="sidebar-item {active}">'
+        f'<a class="sidebar-link" href="{url_for("admin.dashboard")}">'
+        '<i class="align-middle" data-feather="settings"></i> '
+        '<span class="align-middle">Admin</span>'
+        "</a>"
+        "</li>"
+    )
+
+
+register_template_hook("layout.authenticated_sidebar", admin_sidebar_link)

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/migrations/alembic.ini

@@ -0,0 +1,36 @@
+[alembic]
+script_location = migrations
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[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
+datefmt = %H:%M:%S

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/migrations/env.py

@@ -0,0 +1,9 @@
+"""Alembic migration environment for splent_feature_admin."""
+
+from splent_io.splent_feature_admin import models  # noqa
+from splent_framework.migrations.feature_env import run_feature_migrations
+
+FEATURE_NAME = "splent_feature_admin"
+FEATURE_TABLES = set()
+
+run_feature_migrations(FEATURE_NAME, FEATURE_TABLES)

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/migrations/script.py.mako

@@ -0,0 +1,24 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision = ${repr(up_revision)}
+down_revision = ${repr(down_revision)}
+branch_labels = ${repr(branch_labels)}
+depends_on = ${repr(depends_on)}
+
+
+def upgrade():
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade():
+    ${downgrades if downgrades else "pass"}

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/routes.py

@@ -0,0 +1,121 @@
+from flask import flash, render_template, redirect, url_for, request
+from flask_login import login_required
+
+from splent_io.splent_feature_admin import admin_bp
+from splent_io.splent_feature_admin.services import AdminService
+
+
+@admin_bp.route("/admin", methods=["GET"])
+@login_required
+def dashboard():
+    models = AdminService.get_models()
+    model_stats = []
+    for name, cls in sorted(models.items()):
+        model_stats.append({
+            "name": name,
+            "count": AdminService.count_records(cls),
+            "columns": len(AdminService.get_columns(cls)),
+        })
+    return render_template("admin/dashboard.html", models=model_stats)
+
+
+@admin_bp.route("/admin/<model_name>", methods=["GET"])
+@login_required
+def model_list(model_name):
+    model = AdminService.get_model(model_name)
+    if model is None:
+        flash(f"Model '{model_name}' not found.", "danger")
+        return redirect(url_for("admin.dashboard"))
+
+    page = request.args.get("page", 1, type=int)
+    pagination = AdminService.get_records(model, page=page)
+    columns = AdminService.get_list_columns(model)
+
+    return render_template(
+        "admin/list.html",
+        model_name=model_name,
+        columns=columns,
+        pagination=pagination,
+        records=pagination.items,
+    )
+
+
+@admin_bp.route("/admin/<model_name>/create", methods=["GET", "POST"])
+@login_required
+def create(model_name):
+    model = AdminService.get_model(model_name)
+    if model is None:
+        flash(f"Model '{model_name}' not found.", "danger")
+        return redirect(url_for("admin.dashboard"))
+
+    columns = AdminService.get_editable_columns(model)
+
+    if request.method == "POST":
+        AdminService.create_record(model, request.form.to_dict())
+        flash(f"{model_name} created successfully.", "success")
+        return redirect(url_for("admin.model_list", model_name=model_name))
+
+    return render_template(
+        "admin/form.html",
+        model_name=model_name,
+        columns=columns,
+        record=None,
+        action="Create",
+    )
+
+
+@admin_bp.route("/admin/<model_name>/<int:id>", methods=["GET", "POST"])
+@login_required
+def edit(model_name, id):
+    model = AdminService.get_model(model_name)
+    if model is None:
+        flash(f"Model '{model_name}' not found.", "danger")
+        return redirect(url_for("admin.dashboard"))
+
+    record = AdminService.get_record(model, id)
+    if record is None:
+        flash(f"{model_name} with id {id} not found.", "danger")
+        return redirect(url_for("admin.model_list", model_name=model_name))
+
+    columns = AdminService.get_editable_columns(model)
+
+    if request.method == "POST":
+        AdminService.update_record(record, request.form.to_dict(), model)
+        flash(f"{model_name} updated successfully.", "success")
+        return redirect(url_for("admin.model_list", model_name=model_name))
+
+    return render_template(
+        "admin/form.html",
+        model_name=model_name,
+        columns=columns,
+        record=record,
+        action="Edit",
+    )
+
+
+@admin_bp.route("/admin/<model_name>/<int:id>/delete", methods=["GET", "POST"])
+@login_required
+def delete(model_name, id):
+    model = AdminService.get_model(model_name)
+    if model is None:
+        flash(f"Model '{model_name}' not found.", "danger")
+        return redirect(url_for("admin.dashboard"))
+
+    record = AdminService.get_record(model, id)
+    if record is None:
+        flash(f"{model_name} with id {id} not found.", "danger")
+        return redirect(url_for("admin.model_list", model_name=model_name))
+
+    if request.method == "POST":
+        AdminService.delete_record(record)
+        flash(f"{model_name} deleted successfully.", "success")
+        return redirect(url_for("admin.model_list", model_name=model_name))
+
+    columns = AdminService.get_columns(model)
+
+    return render_template(
+        "admin/delete.html",
+        model_name=model_name,
+        columns=columns,
+        record=record,
+    )

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/seeders.py

@@ -0,0 +1,10 @@
+from splent_io.splent_feature_auth.models import User
+from splent_framework.seeders.BaseSeeder import BaseSeeder
+
+
+class AdminSeeder(BaseSeeder):
+    priority = 0  # Run before other seeders
+
+    def run(self):
+        admin = User(email="admin@admin.com", password="admin", active=True)
+        self.seed([admin])

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/services.py

@@ -0,0 +1,119 @@
+from sqlalchemy import inspect as sa_inspect
+
+from splent_framework.db import db
+
+
+# Column types to skip in list views (too verbose for table display)
+_SKIP_TYPES_IN_LIST = {"TEXT", "BLOB", "JSON", "LONGTEXT", "MEDIUMTEXT"}
+
+# Maximum columns shown in the list view
+_MAX_LIST_COLUMNS = 7
+
+
+class AdminService:
+    """Service for auto-generated CRUD operations on all registered models."""
+
+    # ── Model discovery ──────────────────────────────────────────────────
+
+    @staticmethod
+    def get_models() -> dict[str, type]:
+        """Return all registered SQLAlchemy model classes keyed by name."""
+        return {cls.__name__: cls for cls in db.Model.__subclasses__()}
+
+    @staticmethod
+    def get_model(name: str) -> type | None:
+        """Return a single model class by name, or None."""
+        models = AdminService.get_models()
+        return models.get(name)
+
+    # ── Column introspection ─────────────────────────────────────────────
+
+    @staticmethod
+    def get_columns(model: type) -> list[dict]:
+        """Return column metadata for a model via SQLAlchemy inspect."""
+        mapper = sa_inspect(model)
+        cols = []
+        for col in mapper.columns:
+            fk = None
+            if col.foreign_keys:
+                fk = str(list(col.foreign_keys)[0].target_fullname)
+            cols.append({
+                "name": col.name,
+                "type": str(col.type),
+                "primary_key": col.primary_key,
+                "nullable": col.nullable,
+                "foreign_key": fk,
+            })
+        return cols
+
+    @staticmethod
+    def get_list_columns(model: type) -> list[dict]:
+        """Return columns suitable for the list view (filtered and capped)."""
+        cols = AdminService.get_columns(model)
+        filtered = [
+            c for c in cols
+            if c["type"].upper().split("(")[0] not in _SKIP_TYPES_IN_LIST
+        ]
+        return filtered[:_MAX_LIST_COLUMNS]
+
+    @staticmethod
+    def get_editable_columns(model: type) -> list[dict]:
+        """Return columns that can be edited (excludes primary keys)."""
+        return [c for c in AdminService.get_columns(model) if not c["primary_key"]]
+
+    # ── CRUD operations ──────────────────────────────────────────────────
+
+    @staticmethod
+    def get_record(model: type, record_id: int):
+        """Fetch a single record by primary key."""
+        return db.session.get(model, record_id)
+
+    @staticmethod
+    def get_records(model: type, page: int = 1, per_page: int = 20):
+        """Return a paginated query for the given model."""
+        return model.query.paginate(page=page, per_page=per_page, error_out=False)
+
+    @staticmethod
+    def count_records(model: type) -> int:
+        """Return the total number of records for a model."""
+        return model.query.count()
+
+    @staticmethod
+    def create_record(model: type, form_data: dict):
+        """Create a new record from form data."""
+        editable = {c["name"] for c in AdminService.get_editable_columns(model)}
+        nullable = {c["name"] for c in AdminService.get_columns(model) if c["nullable"]}
+
+        data = {}
+        for key, value in form_data.items():
+            if key in editable:
+                if value == "" and key in nullable:
+                    data[key] = None
+                else:
+                    data[key] = value
+
+        record = model(**data)
+        db.session.add(record)
+        db.session.commit()
+        return record
+
+    @staticmethod
+    def update_record(record, form_data: dict, model: type):
+        """Update an existing record from form data."""
+        editable = {c["name"] for c in AdminService.get_editable_columns(model)}
+        nullable = {c["name"] for c in AdminService.get_columns(model) if c["nullable"]}
+
+        for key, value in form_data.items():
+            if key in editable:
+                if value == "" and key in nullable:
+                    setattr(record, key, None)
+                else:
+                    setattr(record, key, value)
+
+        db.session.commit()
+
+    @staticmethod
+    def delete_record(record):
+        """Delete a record from the database."""
+        db.session.delete(record)
+        db.session.commit()

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/templates/admin/dashboard.html

@@ -0,0 +1,49 @@
+{% extends "base_template.html" %}
+
+{% block title %}Admin Dashboard{% endblock %}
+
+{% block content %}
+
+<div class="d-flex justify-content-between align-items-center mb-4">
+    <h1 class="h2 mb-0"><b>Admin Dashboard</b></h1>
+    <span class="badge bg-secondary fs-6">{{ models|length }} model{{ 's' if models|length != 1 }}</span>
+</div>
+
+{% with messages = get_flashed_messages(with_categories=true) %}
+    {% if messages %}
+        {% for category, message in messages %}
+            <div class="alert alert-{{ category }} alert-dismissible fade show" role="alert">
+                {{ message }}
+                <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
+            </div>
+        {% endfor %}
+    {% endif %}
+{% endwith %}
+
+{% if models %}
+<div class="row row-cols-1 row-cols-md-2 row-cols-lg-3 g-4">
+    {% for model in models %}
+    <div class="col">
+        <div class="card h-100 shadow-sm">
+            <div class="card-body d-flex flex-column">
+                <h5 class="card-title mb-1">{{ model.name }}</h5>
+                <p class="text-muted small mb-3">{{ model.columns }} column{{ 's' if model.columns != 1 }}</p>
+                <div class="mt-auto d-flex justify-content-between align-items-center">
+                    <span class="badge bg-primary rounded-pill fs-6">{{ model.count }}</span>
+                    <div>
+                        <a href="{{ url_for('admin.model_list', model_name=model.name) }}" class="btn btn-sm btn-outline-primary">Browse</a>
+                        <a href="{{ url_for('admin.create', model_name=model.name) }}" class="btn btn-sm btn-outline-success">+ New</a>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+    {% endfor %}
+</div>
+{% else %}
+<div class="alert alert-info">
+    No models discovered. Make sure your features are loaded and have SQLAlchemy models defined.
+</div>
+{% endif %}
+
+{% endblock %}

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/templates/admin/delete.html

@@ -0,0 +1,50 @@
+{% extends "base_template.html" %}
+
+{% block title %}Delete {{ model_name }} - Admin{% endblock %}
+
+{% block breadcrumb %}
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="{{ url_for('admin.dashboard') }}">Admin</a></li>
+        <li class="breadcrumb-item"><a href="{{ url_for('admin.model_list', model_name=model_name) }}">{{ model_name }}</a></li>
+        <li class="breadcrumb-item active">Delete</li>
+    </ol>
+</nav>
+{% endblock %}
+
+{% block content %}
+
+<h1 class="h2 mb-4"><b>Delete {{ model_name }}</b></h1>
+
+<div class="card border-danger shadow-sm">
+    <div class="card-body">
+        <p class="card-text mb-3">
+            You are about to permanently delete this <strong>{{ model_name }}</strong> record. This action cannot be undone.
+        </p>
+
+        <table class="table table-sm mb-4">
+            <tbody>
+                {% for col in columns %}
+                <tr>
+                    <th class="text-muted" style="width: 200px;">{{ col.name }}</th>
+                    <td>
+                        {% set val = record.__dict__.get(col.name, '') %}
+                        {% if val is none %}
+                            <span class="text-muted fst-italic">null</span>
+                        {% else %}
+                            {{ val }}
+                        {% endif %}
+                    </td>
+                </tr>
+                {% endfor %}
+            </tbody>
+        </table>
+
+        <form method="POST" class="d-inline">
+            <button type="submit" class="btn btn-danger">Confirm Delete</button>
+            <a href="{{ url_for('admin.model_list', model_name=model_name) }}" class="btn btn-outline-secondary ms-2">Cancel</a>
+        </form>
+    </div>
+</div>
+
+{% endblock %}

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/templates/admin/form.html

@@ -0,0 +1,88 @@
+{% extends "base_template.html" %}
+
+{% block title %}{{ action }} {{ model_name }} - Admin{% endblock %}
+
+{% block breadcrumb %}
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="{{ url_for('admin.dashboard') }}">Admin</a></li>
+        <li class="breadcrumb-item"><a href="{{ url_for('admin.model_list', model_name=model_name) }}">{{ model_name }}</a></li>
+        <li class="breadcrumb-item active">{{ action }}</li>
+    </ol>
+</nav>
+{% endblock %}
+
+{% block content %}
+
+<h1 class="h2 mb-4"><b>{{ action }} {{ model_name }}</b></h1>
+
+{% with messages = get_flashed_messages(with_categories=true) %}
+    {% if messages %}
+        {% for category, message in messages %}
+            <div class="alert alert-{{ category }} alert-dismissible fade show" role="alert">
+                {{ message }}
+                <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
+            </div>
+        {% endfor %}
+    {% endif %}
+{% endwith %}
+
+<form method="POST">
+    <div class="row">
+        {% for col in columns %}
+        <div class="col-md-6 mb-3">
+            <label for="{{ col.name }}" class="form-label fw-semibold">
+                {{ col.name }}
+                <span class="text-muted fw-normal small">({{ col.type }})</span>
+                {% if col.foreign_key %}
+                    <span class="badge bg-info text-dark">FK: {{ col.foreign_key }}</span>
+                {% endif %}
+                {% if not col.nullable %}
+                    <span class="text-danger">*</span>
+                {% endif %}
+            </label>
+
+            {% set col_type = col.type.upper().split('(')[0] %}
+            {% if col_type in ('TEXT', 'LONGTEXT', 'MEDIUMTEXT') %}
+                <textarea
+                    id="{{ col.name }}"
+                    name="{{ col.name }}"
+                    class="form-control"
+                    rows="4"
+                    {{ 'required' if not col.nullable }}
+                >{{ record[col.name] if record and record.__dict__.get(col.name) is not none else '' }}</textarea>
+            {% elif col_type == 'BOOLEAN' or col_type == 'TINYINT' %}
+                <div class="form-check form-switch mt-2">
+                    <input
+                        type="checkbox"
+                        id="{{ col.name }}"
+                        name="{{ col.name }}"
+                        value="1"
+                        class="form-check-input"
+                        {{ 'checked' if record and record.__dict__.get(col.name) }}
+                    >
+                </div>
+            {% else %}
+                <input
+                    type="{{ 'number' if col_type in ('INTEGER', 'INT', 'BIGINT', 'SMALLINT', 'FLOAT', 'DECIMAL', 'NUMERIC', 'DOUBLE') else 'text' }}"
+                    id="{{ col.name }}"
+                    name="{{ col.name }}"
+                    class="form-control"
+                    value="{{ record.__dict__.get(col.name, '') if record and record.__dict__.get(col.name) is not none else '' }}"
+                    {{ 'required' if not col.nullable }}
+                    {{ 'step=any' if col_type in ('FLOAT', 'DECIMAL', 'NUMERIC', 'DOUBLE') }}
+                >
+            {% endif %}
+        </div>
+        {% endfor %}
+    </div>
+
+    <div class="mt-3">
+        <button type="submit" class="btn btn-primary">
+            {{ 'Save changes' if action == 'Edit' else 'Create' }}
+        </button>
+        <a href="{{ url_for('admin.model_list', model_name=model_name) }}" class="btn btn-outline-secondary ms-2">Cancel</a>
+    </div>
+</form>
+
+{% endblock %}

splent_feature_admin-1.0.0/src/splent_io/splent_feature_admin/templates/admin/list.html

@@ -0,0 +1,101 @@
+{% extends "base_template.html" %}
+
+{% block title %}{{ model_name }} - Admin{% endblock %}
+
+{% block breadcrumb %}
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="{{ url_for('admin.dashboard') }}">Admin</a></li>
+        <li class="breadcrumb-item active">{{ model_name }}</li>
+    </ol>
+</nav>
+{% endblock %}
+
+{% block content %}
+
+<div class="d-flex justify-content-between align-items-center mb-4">
+    <h1 class="h2 mb-0"><b>{{ model_name }}</b></h1>
+    <a href="{{ url_for('admin.create', model_name=model_name) }}" class="btn btn-success">+ New {{ model_name }}</a>
+</div>
+
+{% with messages = get_flashed_messages(with_categories=true) %}
+    {% if messages %}
+        {% for category, message in messages %}
+            <div class="alert alert-{{ category }} alert-dismissible fade show" role="alert">
+                {{ message }}
+                <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
+            </div>
+        {% endfor %}
+    {% endif %}
+{% endwith %}
+
+{% if records %}
+<div class="table-responsive">
+    <table class="table table-striped table-hover align-middle">
+        <thead class="table-dark">
+            <tr>
+                {% for col in columns %}
+                <th>
+                    {{ col.name }}
+                    {% if col.primary_key %}<span class="badge bg-warning text-dark">PK</span>{% endif %}
+                    {% if col.foreign_key %}<span class="badge bg-info text-dark">FK</span>{% endif %}
+                </th>
+                {% endfor %}
+                <th class="text-end">Actions</th>
+            </tr>
+        </thead>
+        <tbody>
+            {% for record in records %}
+            <tr>
+                {% for col in columns %}
+                <td>
+                    {% set val = record.__dict__.get(col.name, '') %}
+                    {% if val is none %}
+                        <span class="text-muted fst-italic">null</span>
+                    {% elif val|string|length > 80 %}
+                        {{ val|string|truncate(80) }}
+                    {% else %}
+                        {{ val }}
+                    {% endif %}
+                </td>
+                {% endfor %}
+                <td class="text-end text-nowrap">
+                    <a href="{{ url_for('admin.edit', model_name=model_name, id=record.id) }}" class="btn btn-sm btn-outline-primary">Edit</a>
+                    <a href="{{ url_for('admin.delete', model_name=model_name, id=record.id) }}" class="btn btn-sm btn-outline-danger">Delete</a>
+                </td>
+            </tr>
+            {% endfor %}
+        </tbody>
+    </table>
+</div>
+
+{% if pagination.pages > 1 %}
+<nav aria-label="Pagination">
+    <ul class="pagination justify-content-center">
+        <li class="page-item {{ 'disabled' if not pagination.has_prev }}">
+            <a class="page-link" href="{{ url_for('admin.model_list', model_name=model_name, page=pagination.prev_num) }}">Previous</a>
+        </li>
+        {% for p in pagination.iter_pages(left_edge=1, right_edge=1, left_current=2, right_current=2) %}
+            {% if p %}
+                <li class="page-item {{ 'active' if p == pagination.page }}">
+                    <a class="page-link" href="{{ url_for('admin.model_list', model_name=model_name, page=p) }}">{{ p }}</a>
+                </li>
+            {% else %}
+                <li class="page-item disabled"><span class="page-link">...</span></li>
+            {% endif %}
+        {% endfor %}
+        <li class="page-item {{ 'disabled' if not pagination.has_next }}">
+            <a class="page-link" href="{{ url_for('admin.model_list', model_name=model_name, page=pagination.next_num) }}">Next</a>
+        </li>
+    </ul>
+</nav>
+{% endif %}
+
+{% else %}
+<div class="alert alert-info">
+    No records found for <strong>{{ model_name }}</strong>.
+    <a href="{{ url_for('admin.create', model_name=model_name) }}">Create the first one.</a>
+</div>
+{% endif %}
+
+{% endblock %}