"""
Django Admin configuration for core models.
"""
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
from django.utils.html import format_html
from django.urls import reverse
from django.db.models import Sum
from .models import (
User,
Conversation,
Message,
RAGCollection,
RAGSource,
Agent,
AgentSession,
)
# =========================================================
# USERS
# =========================================================
@admin.register(User)
class UserAdmin(BaseUserAdmin):
"""Enhanced User admin with statistics."""
list_display = [
'username',
'email',
'role',
'is_active',
'created_at',
'total_conversations_display'
]
list_filter = ['role', 'is_active', 'created_at']
search_fields = ['username', 'email']
readonly_fields = [
'created_at',
'total_conversations_display',
'total_tokens_display'
]
fieldsets = (
(None, {'fields': ('username', 'email', 'password')}),
('Permissions', {
'fields': (
'role',
'is_active',
'is_staff',
'is_superuser'
)
}),
('Statistics', {
'fields': (
'created_at',
'total_conversations_display',
'total_tokens_display'
)
}),
)
def total_conversations_display(self, obj):
count = Conversation.objects.filter(user=obj).count()
url = (
reverse('admin:core_conversation_changelist')
+ f'?user_id={obj.id}'
)
return format_html(
'{}',
url,
count
)
total_conversations_display.short_description = 'Conversations'
def total_tokens_display(self, obj):
total = Message.objects.filter(
conversation__user=obj
).aggregate(
total=Sum('total_tokens')
)['total'] or 0
return f"{total:,}"
total_tokens_display.short_description = 'Total Tokens'
# =========================================================
# CONVERSATIONS
# =========================================================
@admin.register(Conversation)
class ConversationAdmin(admin.ModelAdmin):
"""Conversation admin with user and message details."""
list_display = [
'id',
'title',
'user',
'model_name',
'message_count',
'created_at'
]
list_filter = ['model_name', 'created_at']
search_fields = ['title', 'id']
readonly_fields = [
'id',
'created_at',
'updated_at',
'message_count'
]
fieldsets = (
(None, {'fields': ('id', 'title', 'user_link')}),
('AI Configuration', {'fields': ('model_name', 'provider')}),
('Timestamps', {
'fields': (
'created_at',
'updated_at',
'message_count'
)
}),
)
def user_link(self, obj):
try:
user = User.objects.get(id=obj.user_id)
url = reverse(
'admin:core_user_change',
args=[user.id]
)
return format_html(
'{}',
url,
user.username
)
except User.DoesNotExist:
return f"User {obj.user_id} (deleted)"
user_link.short_description = 'User'
def message_count(self, obj):
count = Message.objects.filter(
conversation=obj
).count()
url = (
reverse('admin:core_message_changelist')
+ f'?conversation__id__exact={obj.id}'
)
return format_html(
'{} messages',
url,
count
)
message_count.short_description = 'Messages'
# =========================================================
# MESSAGES
# =========================================================
@admin.register(Message)
class MessageAdmin(admin.ModelAdmin):
"""Message admin with conversation details."""
list_display = [
'id',
'conversation',
'role',
'content_preview',
'prompt_tokens',
'completion_tokens',
'total_tokens'
]
list_filter = ['role', 'created_at']
search_fields = ['content']
readonly_fields = ['id', 'created_at']
date_hierarchy = 'created_at'
fieldsets = (
(None, {'fields': ('id', 'conversation_link', 'role')}),
('Content', {'fields': ('content',)}),
('Metrics', {'fields': ('total_tokens', 'created_at')}),
)
def lookup_allowed(self, lookup, value, request):
allowed = {
'conversation__id',
'conversation__id__exact',
}
return lookup in allowed or super().lookup_allowed(
lookup,
value,
request
)
def conversation_link(self, obj):
try:
conv = Conversation.objects.get(
id=obj.conversation_id
)
url = reverse(
'admin:core_conversation_change',
args=[conv.id]
)
return format_html(
'{}',
url,
conv.title or str(obj.conversation_id)
)
except Conversation.DoesNotExist:
return str(obj.conversation_id)
conversation_link.short_description = 'Conversation'
def content_preview(self, obj):
if len(obj.content) > 100:
return obj.content[:100] + '...'
return obj.content
content_preview.short_description = 'Content'
# =========================================================
# RAG SOURCES
# =========================================================
@admin.register(RAGSource)
class RAGSourceAdmin(admin.ModelAdmin):
"""RAG Source admin."""
list_display = [
'display_name',
'source_type',
'collection_name',
'last_sync_status',
'total_files',
'total_chunks',
'created_at',
]
list_filter = [
'source_type',
'last_sync_status',
'auto_sync',
'created_at',
]
search_fields = [
'display_name',
'source_identifier',
'collection_name',
]
readonly_fields = [
'created_at',
'updated_at',
'last_sync_at',
]
date_hierarchy = 'created_at'
ordering = ['-created_at']
fieldsets = (
(None, {
'fields': (
'collection_name',
'display_name',
'source_type',
'source_identifier',
)
}),
('Sync Settings', {
'fields': (
'auto_sync',
'sync_interval_hours',
)
}),
('Sync Status', {
'fields': (
'last_sync_status',
'last_sync_at',
'last_sync_error',
'last_commit_sha',
)
}),
('Statistics', {
'fields': (
'total_files',
'total_chunks',
)
}),
('Configuration', {
'fields': ('config',)
}),
('Timestamps', {
'fields': (
'created_at',
'updated_at',
)
}),
)
def source_identifier_display(self, obj):
value = obj.source_identifier or ''
if len(value) > 60:
return value[:60] + '...'
return value
source_identifier_display.short_description = 'Source'
# =========================================================
# AGENTS
# =========================================================
@admin.register(Agent)
class AgentAdmin(admin.ModelAdmin):
"""Agent admin with statistics."""
list_display = [
'name',
'agent_type',
'status',
'user',
'created_at'
]
list_filter = [
'agent_type',
'status',
'created_at'
]
search_fields = ['name', 'description']
readonly_fields = [
'created_at',
'updated_at',
'statistics_display'
]
fieldsets = (
(None, {
'fields': (
'name',
'agent_type',
'description',
'status',
'user'
)
}),
('Messages', {
'fields': (
'welcome_message',
'completion_message',
'error_message'
)
}),
('Configuration', {
'fields': (
'max_retries',
'timeout_minutes',
'enable_fallback_human',
'config'
)
}),
('Stats', {
'fields': ('statistics_display',)
}),
('Timestamps', {
'fields': (
'created_at',
'updated_at'
)
}),
)
def statistics_display(self, obj):
sessions = AgentSession.objects.filter(agent=obj)
total = sessions.count()
completed = sessions.filter(
status='completed'
).count()
abandoned = sessions.filter(
status='abandoned'
).count()
rate = (completed / total * 100) if total > 0 else 0
return format_html(
(
"Total: {} | "
"Completed: {} | "
"Abandoned: {} | "
"Rate: {:.1f}%"
),
total,
completed,
abandoned,
rate
)
statistics_display.short_description = 'Statistics'
# =========================================================
# AGENT SESSIONS
# =========================================================
@admin.register(AgentSession)
class AgentSessionAdmin(admin.ModelAdmin):
"""Agent Session admin."""
list_display = [
'id',
'agent',
'status',
'current_step',
'retry_count',
'started_at'
]
list_filter = [
'status',
'started_at'
]
readonly_fields = [
'started_at',
'last_activity_at',
'completed_at'
]
fieldsets = (
(None, {
'fields': (
'agent',
'conversation',
'user_id',
'status'
)
}),
('Progress', {
'fields': (
'current_step',
'collected_data',
'retry_count',
'metadata'
)
}),
('Timeline', {
'fields': (
'started_at',
'last_activity_at',
'completed_at'
)
}),
)
def agent_link(self, obj):
try:
agent = Agent.objects.get(id=obj.agent_id)
url = reverse(
'admin:core_agent_change',
args=[agent.id]
)
return format_html(
'{}',
url,
agent.name
)
except Agent.DoesNotExist:
return f"Agent {obj.agent_id} (deleted)"
agent_link.short_description = 'Agent'
def user_link(self, obj):
if not obj.user_id:
return "Anonymous"
try:
user = User.objects.get(id=obj.user_id)
url = reverse(
'admin:core_user_change',
args=[user.id]
)
return format_html(
'{}',
url,
user.username
)
except User.DoesNotExist:
return f"User {obj.user_id} (deleted)"
user_link.short_description = 'User'
def duration(self, obj):
if obj.completed_at:
delta = obj.completed_at - obj.started_at
minutes = delta.total_seconds() / 60
return f"{minutes:.1f} minutes"
return "In progress"
duration.short_description = 'Duration'