Django Admin से आ रहे हैं

अगर आप Django Admin जानते हैं, तो starlette-admin आपको जाना-पहचाना लगेगा। दोनों declarative, प्रति-मॉडल कॉन्फ़िगरेशन से एडमिन इंटरफ़ेस जनरेट करते हैं, और दोनों इनलाइन एडिटिंग, बैच एक्शन और per-request अनुमतियाँ सपोर्ट करते हैं।

फ़र्क़ संरचनात्मक हैं। starlette-admin को Django की ज़रूरत नहीं है और वह किसी भी ASGI ऐप्लिकेशन पर चलता है, कई ORMs के साथ काम करता है, और इनबिल्ट user model थोपने के बजाय आपको अपना प्रमाणीकरण प्लग करने देता है।

यह guide हर प्रमुख ModelAdmin concept को उसके starlette-admin समकक्ष से मैप करती है, side-by-side कोड के साथ।

मानसिक मॉडल

मॉडल रजिस्टर करना

from django.contrib import admin
from .models import Post


@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    list_display = ["title", "published", "created_at"]
    search_fields = ["title", "content"]

from starlette_admin.contrib.sqla import Admin, ModelView


class PostView(ModelView):
    fields = ["id", "title", "content", "published", "created_at"]
    exclude_fields_from_list = ["content"]
    searchable_fields = ["title", "content"]


admin = Admin(engine, title="Blog Admin", secret_key="change-me")
admin.add_view(PostView(Post, icon="fa fa-newspaper"))
admin.mount_to(app)  # app is your FastAPI or Starlette instance

दो संरचनात्मक फ़र्क़ साफ़ दिखते हैं:

1. एक फ़ील्ड लिस्ट हर पेज को सँभालती है। fields एकमात्र source of truth है। फिर प्रति-पेज variations के लिए आप exclude_fields_from_list, exclude_fields_from_detail, exclude_fields_from_create, और exclude_fields_from_edit उपयोग करते हैं।
2. Admin इंस्टेंस के पास database engine होता है। आप हर view को session पास नहीं करते।

लिस्ट पेज के विकल्प

फ़ॉर्म

Fieldsets उदाहरण

class PostAdmin(admin.ModelAdmin):
    fieldsets = [
        ("Content", {"fields": ["title", "body"]}),
        ("Publication", {"fields": ["published", "created_at"]}),
    ]

from starlette_admin import FieldsetWidget


class PostView(ModelView):
    fields = ["id", "title", "body", "published", "created_at"]
    form_layout = [
        FieldsetWidget(legend="Content", children=["title", "body"]),
        FieldsetWidget(legend="Publication", children=["published", "created_at"]),
    ]

form_layout fieldsets से भी आगे जाता है: आप tabs, responsive grids और nested layouts बना सकते हैं। Form Layout देखें।

Inlines

class CommentInline(admin.TabularInline):
    model = Comment
    extra = 1


class ArticleAdmin(admin.ModelAdmin):
    inlines = [CommentInline]

from starlette_admin.contrib.sqla import InlineModelView, ModelView


class CommentInline(InlineModelView):
    model = Comment
    fields = ["author", "body"]


class ArticleView(ModelView):
    inlines = [CommentInline]

starlette-admin foreign key तब detect कर लेता है जब वह unambiguous हो, और composite foreign keys सपोर्ट करता है। Advanced configurations के लिए Inline Forms देखें।

एक्शन

@admin.action(description="Mark selected articles as published")
def make_published(modeladmin, request, queryset):
    queryset.update(published=True)


class ArticleAdmin(admin.ModelAdmin):
    actions = [make_published]

from starlette_admin import ActionSelection, action, flash


class ArticleView(ModelView):
    actions = ["make_published", "delete"]

    @action(
        name="make_published",
        text="Mark selected articles as published",
        confirmation="Publish the selected articles?",
    )
    async def make_published(
        self, request: Request, selection: ActionSelection
    ) -> None:
        for article in await selection.rows():
            article.published = True
        flash(request, "Articles published")

जहाँ Django Admin QuerySet पास करता है, वहीं starlette-admin handler को एक ActionSelection object मिलता है। वह rows, primary keys और active filters lazily resolve करता है, और जब user सभी matching records select करता है तब भी इसी तरह व्यवहार करता है।

एक्शन confirmation dialog के अंदर कस्टम HTML फ़ॉर्म भी render कर सकते हैं, जो Django Admin में intermediate page बनाने जितना काम है। प्रति-पंक्ति operations के लिए @row_action और @link_row_action उपयोग करें, जिनका Django Admin में कोई समकक्ष नहीं है।

अनुमतियाँ और प्रमाणीकरण

Django Admin काम django.contrib.auth को सौंप देता है। starlette-admin इस समस्या को दो हिस्सों में बाँटता है: AuthProvider 'यह user कौन है' का जवाब देता है, और per-view methods 'वह क्या कर सकता है' का।

निम्नलिखित view deletion को admin role वाले users तक सीमित करता है:

class ArticleView(ModelView):
    def can_delete(self, request: Request) -> bool:
        return "admin" in request.state.admin_user.roles

हर can_* method को request मिलती है, इसलिए आपके authorization निर्णय current user, HTTP headers या request पर मौजूद किसी भी चीज़ को पढ़ सकते हैं।

सेव हुक और signals

साइट-व्यापी कॉन्फ़िगरेशन

बदलने से आपको क्या मिलता है

• End-to-end async: Handlers, lifecycle हुक और widget callbacks — सभी coroutines हो सकते हैं जो आपके existing event loop पर, आपके FastAPI एंडपॉइंट के साथ चलते हैं।
• Database flexibility: चाहे आप SQLAlchemy, SQLModel, MongoEngine या Beanie के ज़रिए MongoDB, या Tortoise ORM उपयोग करें, एक ही एडमिन कॉन्फ़िगरेशन लागू होता है।
• इनबिल्ट एक्सपोर्ट और इंपोर्ट: CSV, JSON और PDF, साथ ही tablib के ज़रिए Excel और अन्य formats। Records सीधे एक्सपोर्ट करें, या preview-first wizard के ज़रिए bulk data इंपोर्ट करें जो row-level सत्यापन लागू करता है और optional primary key upserts सपोर्ट करता है। Export और Import देखें।
• डैशबोर्ड विजेट: Stat cards, ApexCharts और layout grids मिलकर index pages और custom views बनाते हैं, इसलिए dashboard बनाने के लिए किसी external theme package की ज़रूरत नहीं। Custom Views और Widgets देखें।
• आधुनिक user interface: Tabler (Bootstrap 5) आपको डिफ़ॉल्ट रूप से डार्क मोड, column visibility toggles और search highlighting देता है।

जो आपको ख़ुद लाना होगा

• प्रमाणीकरण: कोई bundled user model या permission database नहीं है। अपने ऐप्लिकेशन के existing data store के आधार पर AuthProvider.authenticate() implement करें।
• Audit logging: starlette-admin कोई LogEntry table generate नहीं करता। event system को अपनी audit table से जोड़ें।
• Model-level UI कॉन्फ़िगरेशन: Model-level choices, verbose_name और validators जैसी Django सुविधाएँ transfer नहीं होतीं। इन्हें इसकी जगह starlette-admin field पर declare करें, EnumField, label= और validators= के साथ।