salman/igny8
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

django admin improvement complete

Browse Source
This commit is contained in:
IGNY8 VPS (Salman)
2025-12-15 01:38:41 +00:00
parent cda56f15ba
commit 125489df0f
14 changed files with 526 additions and 68 deletions
Download Patch File Download Diff File Expand all files Collapse all files

61
backend/create_groups.py Normal file
View File

@@ -0,0 +1,61 @@
#!/usr/bin/env python
"""Script to create admin permission groups"""
import os
import django
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'igny8_core.settings')
django.setup()
from django.contrib.auth.models import Group, Permission
from django.contrib.contenttypes.models import ContentType
groups_permissions = {
'Content Manager': {
'models': [
('writer', 'content'), ('writer', 'tasks'), ('writer', 'images'),
('planner', 'keywords'), ('planner', 'clusters'), ('planner', 'contentideas'),
],
'permissions': ['add', 'change', 'view'],
},
'Billing Admin': {
'models': [
('billing', 'payment'), ('billing', 'invoice'), ('billing', 'credittransaction'),
('billing', 'creditusagelog'), ('igny8_core_auth', 'account'),
],
'permissions': ['add', 'change', 'view', 'delete'],
},
'Support Agent': {
'models': [
('writer', 'content'), ('writer', 'tasks'),
('igny8_core_auth', 'account'), ('igny8_core_auth', 'site'),
],
'permissions': ['view'],
},
}
print('Creating admin permission groups...\n')
for group_name, config in groups_permissions.items():
group, created = Group.objects.get_or_create(name=group_name)
status = 'Created' if created else 'Updated'
print(f'✓ {status} group: {group_name}')
group.permissions.clear()
added = 0
for app_label, model_name in config['models']:
try:
ct = ContentType.objects.get(app_label=app_label, model=model_name)
for perm_type in config['permissions']:
try:
perm = Permission.objects.get(content_type=ct, codename=f'{perm_type}_{model_name}')
group.permissions.add(perm)
added += 1
except Permission.DoesNotExist:
print(f' ! Permission not found: {perm_type}_{model_name}')
except ContentType.DoesNotExist:
print(f' ! ContentType not found: {app_label}.{model_name}')
print(f' Added {added} permissions')
print('\n✓ Permission groups created successfully!')

4
backend/igny8_core/admin/reports.py
View File

@@ -35,7 +35,7 @@ def revenue_report(request):
# Plan distribution
plan_distribution = Plan.objects.annotate(
account_count=Count('account')
account_count=Count('accounts')
).values('name', 'account_count')
# Payment method breakdown
@@ -213,7 +213,7 @@ def data_quality_report(request):
# Duplicate keywords
from igny8_core.modules.planner.models import Keywords
duplicates = Keywords.objects.values('keyword', 'site', 'sector').annotate(
duplicates = Keywords.objects.values('seed_keyword', 'site', 'sector').annotate(
count=Count('id')
).filter(count__gt=1).count()
if duplicates > 0:

38
backend/igny8_core/admin/site.py
View File

@@ -257,6 +257,44 @@ class Igny8AdminSite(UnfoldAdminSite):
'models': [],
})
# Add Reports section with links to all reports
organized_apps.append({
'name': 'Reports & Analytics',
'app_label': '_reports',
'app_url': '#',
'has_module_perms': True,
'models': [
{
'name': 'Revenue Report',
'object_name': 'RevenueReport',
'admin_url': '/admin/reports/revenue/',
'view_only': True,
'perms': {'view': True},
},
{
'name': 'Usage Report',
'object_name': 'UsageReport',
'admin_url': '/admin/reports/usage/',
'view_only': True,
'perms': {'view': True},
},
{
'name': 'Content Report',
'object_name': 'ContentReport',
'admin_url': '/admin/reports/content/',
'view_only': True,
'perms': {'view': True},
},
{
'name': 'Data Quality Report',
'object_name': 'DataQualityReport',
'admin_url': '/admin/reports/data-quality/',
'view_only': True,
'perms': {'view': True},
},
],
})
for group_name, group_config in custom_groups.items():
group_models = []

3
backend/igny8_core/auth/admin.py
View File

@@ -5,6 +5,7 @@ from django import forms
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
from unfold.admin import ModelAdmin, TabularInline
from simple_history.admin import SimpleHistoryAdmin
from igny8_core.admin.base import AccountAdminMixin, Igny8ModelAdmin
from .models import User, Account, Plan, Subscription, Site, Sector, SiteUserAccess, Industry, IndustrySector, SeedKeyword, PasswordResetToken
from import_export.admin import ExportMixin
@@ -155,7 +156,7 @@ class AccountResource(resources.ModelResource):
@admin.register(Account)
class AccountAdmin(ExportMixin, AccountAdminMixin, Igny8ModelAdmin):
class AccountAdmin(ExportMixin, AccountAdminMixin, SimpleHistoryAdmin, Igny8ModelAdmin):
resource_class = AccountResource
form = AccountAdminForm
list_display = ['name', 'slug', 'owner', 'plan', 'status', 'health_indicator', 'credits', 'created_at']

66
backend/igny8_core/auth/migrations/0017_add_history_tracking.py Normal file
View File

@@ -0,0 +1,66 @@
# Generated by Django 5.2.9 on 2025-12-15 01:28
import django.core.validators
import django.db.models.deletion
import simple_history.models
from django.conf import settings
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('igny8_core_auth', '0016_alter_plan_annual_discount_percent'),
]
operations = [
migrations.CreateModel(
name='HistoricalAccount',
fields=[
('id', models.BigIntegerField(auto_created=True, blank=True, db_index=True, verbose_name='ID')),
('is_deleted', models.BooleanField(db_index=True, default=False)),
('deleted_at', models.DateTimeField(blank=True, db_index=True, null=True)),
('restore_until', models.DateTimeField(blank=True, db_index=True, null=True)),
('delete_reason', models.CharField(blank=True, max_length=255, null=True)),
('name', models.CharField(max_length=255)),
('slug', models.SlugField(max_length=255)),
('stripe_customer_id', models.CharField(blank=True, max_length=255, null=True)),
('credits', models.IntegerField(default=0, validators=[django.core.validators.MinValueValidator(0)])),
('status', models.CharField(choices=[('active', 'Active'), ('suspended', 'Suspended'), ('trial', 'Trial'), ('cancelled', 'Cancelled'), ('pending_payment', 'Pending Payment')], default='trial', max_length=20)),
('payment_method', models.CharField(choices=[('stripe', 'Stripe'), ('paypal', 'PayPal'), ('bank_transfer', 'Bank Transfer')], default='stripe', help_text='Payment method used for this account', max_length=30)),
('deletion_retention_days', models.PositiveIntegerField(default=14, help_text='Retention window (days) before soft-deleted items are purged', validators=[django.core.validators.MinValueValidator(1), django.core.validators.MaxValueValidator(365)])),
('billing_email', models.EmailField(blank=True, help_text='Email for billing notifications', max_length=254, null=True)),
('billing_address_line1', models.CharField(blank=True, help_text='Street address', max_length=255)),
('billing_address_line2', models.CharField(blank=True, help_text='Apt, suite, etc.', max_length=255)),
('billing_city', models.CharField(blank=True, max_length=100)),
('billing_state', models.CharField(blank=True, help_text='State/Province/Region', max_length=100)),
('billing_postal_code', models.CharField(blank=True, max_length=20)),
('billing_country', models.CharField(blank=True, help_text='ISO 2-letter country code', max_length=2)),
('tax_id', models.CharField(blank=True, help_text='VAT/Tax ID number', max_length=100)),
('usage_content_ideas', models.IntegerField(default=0, help_text='Content ideas generated this month', validators=[django.core.validators.MinValueValidator(0)])),
('usage_content_words', models.IntegerField(default=0, help_text='Content words generated this month', validators=[django.core.validators.MinValueValidator(0)])),
('usage_images_basic', models.IntegerField(default=0, help_text='Basic AI images this month', validators=[django.core.validators.MinValueValidator(0)])),
('usage_images_premium', models.IntegerField(default=0, help_text='Premium AI images this month', validators=[django.core.validators.MinValueValidator(0)])),
('usage_image_prompts', models.IntegerField(default=0, help_text='Image prompts this month', validators=[django.core.validators.MinValueValidator(0)])),
('usage_period_start', models.DateTimeField(blank=True, help_text='Current billing period start', null=True)),
('usage_period_end', models.DateTimeField(blank=True, help_text='Current billing period end', null=True)),
('created_at', models.DateTimeField(blank=True, editable=False)),
('updated_at', models.DateTimeField(blank=True, editable=False)),
('history_id', models.AutoField(primary_key=True, serialize=False)),
('history_date', models.DateTimeField(db_index=True)),
('history_change_reason', models.CharField(max_length=100, null=True)),
('history_type', models.CharField(choices=[('+', 'Created'), ('~', 'Changed'), ('-', 'Deleted')], max_length=1)),
('deleted_by', models.ForeignKey(blank=True, db_constraint=False, null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to=settings.AUTH_USER_MODEL)),
('history_user', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to=settings.AUTH_USER_MODEL)),
('owner', models.ForeignKey(blank=True, db_constraint=False, null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to=settings.AUTH_USER_MODEL)),
('plan', models.ForeignKey(blank=True, db_constraint=False, null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='igny8_core_auth.plan')),
],
options={
'verbose_name': 'historical Account',
'verbose_name_plural': 'historical Accounts',
'ordering': ('-history_date', '-history_id'),
'get_latest_by': ('history_date', 'history_id'),
},
bases=(simple_history.models.HistoricalChanges, models.Model),
),
]

4
backend/igny8_core/auth/models.py
View File

@@ -6,6 +6,7 @@ from django.contrib.auth.models import AbstractUser
from django.utils.translation import gettext_lazy as _
from django.core.validators import MinValueValidator, MaxValueValidator
from igny8_core.common.soft_delete import SoftDeletableModel, SoftDeleteManager
from simple_history.models import HistoricalRecords
class AccountBaseModel(models.Model):
@@ -117,6 +118,9 @@ class Account(SoftDeletableModel):
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
# History tracking
history = HistoricalRecords()
class Meta:
db_table = 'igny8_tenants'

7
backend/igny8_core/business/billing/models.py
View File

@@ -6,6 +6,7 @@ from django.db import models
from django.core.validators import MinValueValidator
from django.conf import settings
from igny8_core.auth.models import AccountBaseModel
from simple_history.models import HistoricalRecords
# Centralized payment method choices - single source of truth
@@ -167,6 +168,9 @@ class CreditCostConfig(models.Model):
help_text="Cost before last update (for audit trail)"
)
# History tracking
history = HistoricalRecords()
class Meta:
app_label = 'billing'
db_table = 'igny8_credit_cost_config'
@@ -459,6 +463,9 @@ class Payment(AccountBaseModel):
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
# History tracking
history = HistoricalRecords()
class Meta:
app_label = 'billing'
db_table = 'igny8_payments'

118
backend/igny8_core/management/commands/create_admin_groups.py Normal file
View File

@@ -0,0 +1,118 @@
"""
Management command to create admin permission groups
"""
from django.core.management.base import BaseCommand
from django.contrib.auth.models import Group, Permission
from django.contrib.contenttypes.models import ContentType
class Command(BaseCommand):
help = 'Create admin permission groups with appropriate permissions'
def handle(self, *args, **options):
self.stdout.write('Creating admin permission groups...')
# Define permission groups
groups_permissions = {
'Content Manager': {
'description': 'Can manage content, tasks, keywords, and clusters',
'models': [
('writer', 'content'),
('writer', 'tasks'),
('writer', 'images'),
('planner', 'keywords'),
('planner', 'clusters'),
('planner', 'contentideas'),
('system', 'aiprompt'),
('system', 'strategy'),
('system', 'authorprofile'),
('system', 'contenttemplate'),
],
'permissions': ['add', 'change', 'view'], # No delete
},
'Billing Admin': {
'description': 'Can manage payments, invoices, and credit transactions',
'models': [
('billing', 'payment'),
('billing', 'invoice'),
('billing', 'credittransaction'),
('billing', 'creditusagelog'),
('billing', 'creditpackage'),
('billing', 'creditcostconfig'),
('igny8_core_auth', 'account'), # View accounts for billing context
],
'permissions': ['add', 'change', 'view', 'delete'],
},
'Support Agent': {
'description': 'Can view content, assist users, manage integrations',
'models': [
('writer', 'content'),
('writer', 'tasks'),
('planner', 'keywords'),
('planner', 'clusters'),
('integration', 'siteintegration'),
('integration', 'syncevent'),
('publishing', 'publishingrecord'),
('automation', 'automationrun'),
('igny8_core_auth', 'account'),
('igny8_core_auth', 'site'),
('igny8_core_auth', 'user'),
],
'permissions': ['view'], # Read-only
},
}
created_count = 0
updated_count = 0
for group_name, config in groups_permissions.items():
group, created = Group.objects.get_or_create(name=group_name)
if created:
self.stdout.write(self.style.SUCCESS(f'✓ Created group: {group_name}'))
created_count += 1
else:
self.stdout.write(f' Group already exists: {group_name}')
updated_count += 1
# Clear existing permissions
group.permissions.clear()
# Add permissions for each model
permissions_added = 0
for app_label, model_name in config['models']:
try:
content_type = ContentType.objects.get(app_label=app_label, model=model_name)
for perm_type in config['permissions']:
try:
permission = Permission.objects.get(
content_type=content_type,
codename=f'{perm_type}_{model_name}'
)
group.permissions.add(permission)
permissions_added += 1
except Permission.DoesNotExist:
self.stdout.write(
self.style.WARNING(
f' ! Permission not found: {perm_type}_{model_name}'
)
)
except ContentType.DoesNotExist:
self.stdout.write(
self.style.WARNING(
f' ! ContentType not found: {app_label}.{model_name}'
)
)
self.stdout.write(f' Added {permissions_added} permissions to {group_name}')
self.stdout.write('')
self.stdout.write(self.style.SUCCESS(f'✓ Created {created_count} new group(s)'))
self.stdout.write(self.style.SUCCESS(f'✓ Updated {updated_count} existing group(s)'))
self.stdout.write('')
self.stdout.write('Permission groups created successfully!')
self.stdout.write('')
self.stdout.write('Group descriptions:')
for group_name, config in groups_permissions.items():
self.stdout.write(f' • {group_name}: {config["description"]}')

5
backend/igny8_core/modules/billing/admin.py
View File

@@ -5,6 +5,7 @@ from django.contrib import admin
from django.utils.html import format_html
from django.contrib import messages
from unfold.admin import ModelAdmin
from simple_history.admin import SimpleHistoryAdmin
from igny8_core.admin.base import AccountAdminMixin, Igny8ModelAdmin
from igny8_core.business.billing.models import (
CreditCostConfig,
@@ -93,7 +94,7 @@ class PaymentResource(resources.ModelResource):
@admin.register(Payment)
class PaymentAdmin(ExportMixin, AccountAdminMixin, Igny8ModelAdmin):
class PaymentAdmin(ExportMixin, AccountAdminMixin, SimpleHistoryAdmin, Igny8ModelAdmin):
"""
Main Payment Admin with approval workflow.
When you change status to 'succeeded', it automatically:
@@ -421,7 +422,7 @@ class AccountPaymentMethodAdmin(AccountAdminMixin, Igny8ModelAdmin):
@admin.register(CreditCostConfig)
class CreditCostConfigAdmin(Igny8ModelAdmin):
class CreditCostConfigAdmin(SimpleHistoryAdmin, Igny8ModelAdmin):
list_display = [
'operation_type',
'display_name',

87
backend/igny8_core/modules/billing/migrations/0017_add_history_tracking.py Normal file
View File

@@ -0,0 +1,87 @@
# Generated by Django 5.2.9 on 2025-12-15 01:28
import django.core.validators
import django.db.models.deletion
import simple_history.models
from django.conf import settings
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('billing', '0016_remove_payment_payment_account_status_created_idx_and_more'),
('igny8_core_auth', '0017_add_history_tracking'),
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
]
operations = [
migrations.CreateModel(
name='HistoricalCreditCostConfig',
fields=[
('id', models.BigIntegerField(auto_created=True, blank=True, db_index=True, verbose_name='ID')),
('operation_type', models.CharField(choices=[('clustering', 'Keyword Clustering'), ('idea_generation', 'Content Ideas Generation'), ('content_generation', 'Content Generation'), ('image_generation', 'Image Generation'), ('reparse', 'Content Reparse'), ('ideas', 'Content Ideas Generation'), ('content', 'Content Generation'), ('images', 'Image Generation')], db_index=True, help_text='AI operation type', max_length=50)),
('credits_cost', models.IntegerField(help_text='Credits required for this operation', validators=[django.core.validators.MinValueValidator(0)])),
('unit', models.CharField(choices=[('per_request', 'Per Request'), ('per_100_words', 'Per 100 Words'), ('per_200_words', 'Per 200 Words'), ('per_item', 'Per Item'), ('per_image', 'Per Image')], default='per_request', help_text='What the cost applies to', max_length=50)),
('display_name', models.CharField(help_text='Human-readable name', max_length=100)),
('description', models.TextField(blank=True, help_text='What this operation does')),
('is_active', models.BooleanField(default=True, help_text='Enable/disable this operation')),
('created_at', models.DateTimeField(blank=True, editable=False)),
('updated_at', models.DateTimeField(blank=True, editable=False)),
('previous_cost', models.IntegerField(blank=True, help_text='Cost before last update (for audit trail)', null=True)),
('history_id', models.AutoField(primary_key=True, serialize=False)),
('history_date', models.DateTimeField(db_index=True)),
('history_change_reason', models.CharField(max_length=100, null=True)),
('history_type', models.CharField(choices=[('+', 'Created'), ('~', 'Changed'), ('-', 'Deleted')], max_length=1)),
('history_user', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to=settings.AUTH_USER_MODEL)),
('updated_by', models.ForeignKey(blank=True, db_constraint=False, help_text='Admin who last updated', null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to=settings.AUTH_USER_MODEL)),
],
options={
'verbose_name': 'historical Credit Cost Configuration',
'verbose_name_plural': 'historical Credit Cost Configurations',
'ordering': ('-history_date', '-history_id'),
'get_latest_by': ('history_date', 'history_id'),
},
bases=(simple_history.models.HistoricalChanges, models.Model),
),
migrations.CreateModel(
name='HistoricalPayment',
fields=[
('id', models.BigIntegerField(auto_created=True, blank=True, db_index=True, verbose_name='ID')),
('amount', models.DecimalField(decimal_places=2, max_digits=10)),
('currency', models.CharField(default='USD', max_length=3)),
('status', models.CharField(choices=[('pending_approval', 'Pending Approval'), ('succeeded', 'Succeeded'), ('failed', 'Failed'), ('refunded', 'Refunded')], db_index=True, default='pending_approval', max_length=20)),
('payment_method', models.CharField(choices=[('stripe', 'Stripe (Credit/Debit Card)'), ('paypal', 'PayPal'), ('bank_transfer', 'Bank Transfer (Manual)'), ('local_wallet', 'Local Wallet (Manual)'), ('manual', 'Manual Payment')], db_index=True, max_length=50)),
('stripe_payment_intent_id', models.CharField(blank=True, max_length=255, null=True)),
('stripe_charge_id', models.CharField(blank=True, max_length=255, null=True)),
('paypal_order_id', models.CharField(blank=True, max_length=255, null=True)),
('paypal_capture_id', models.CharField(blank=True, max_length=255, null=True)),
('manual_reference', models.CharField(blank=True, help_text='Bank transfer reference, wallet transaction ID, etc.', max_length=255)),
('manual_notes', models.TextField(blank=True, help_text='Admin notes for manual payments')),
('admin_notes', models.TextField(blank=True, help_text='Internal notes on approval/rejection')),
('approved_at', models.DateTimeField(blank=True, null=True)),
('processed_at', models.DateTimeField(blank=True, null=True)),
('failed_at', models.DateTimeField(blank=True, null=True)),
('refunded_at', models.DateTimeField(blank=True, null=True)),
('failure_reason', models.TextField(blank=True)),
('metadata', models.JSONField(default=dict)),
('created_at', models.DateTimeField(blank=True, editable=False)),
('updated_at', models.DateTimeField(blank=True, editable=False)),
('history_id', models.AutoField(primary_key=True, serialize=False)),
('history_date', models.DateTimeField(db_index=True)),
('history_change_reason', models.CharField(max_length=100, null=True)),
('history_type', models.CharField(choices=[('+', 'Created'), ('~', 'Changed'), ('-', 'Deleted')], max_length=1)),
('account', models.ForeignKey(blank=True, db_column='tenant_id', db_constraint=False, null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='igny8_core_auth.account')),
('approved_by', models.ForeignKey(blank=True, db_constraint=False, null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to=settings.AUTH_USER_MODEL)),
('history_user', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to=settings.AUTH_USER_MODEL)),
('invoice', models.ForeignKey(blank=True, db_constraint=False, null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='billing.invoice')),
],
options={
'verbose_name': 'historical payment',
'verbose_name_plural': 'historical payments',
'ordering': ('-history_date', '-history_id'),
'get_latest_by': ('history_date', 'history_id'),
},
bases=(simple_history.models.HistoricalChanges, models.Model),
),
]

1
backend/igny8_core/modules/planner/admin.py
View File

@@ -56,6 +56,7 @@ class ClustersAdmin(SiteSectorAdminMixin, Igny8ModelAdmin):
class KeywordsAdmin(ExportMixin, SiteSectorAdminMixin, Igny8ModelAdmin):
resource_class = KeywordsResource
list_display = ['keyword', 'seed_keyword', 'site', 'sector', 'cluster', 'volume', 'difficulty', 'intent', 'status', 'created_at']
list_editable = ['status'] # Enable inline editing for status
list_filter = [
('status', ChoicesDropdownFilter),
('intent', ChoicesDropdownFilter),

1
backend/igny8_core/modules/writer/admin.py
View File

@@ -36,6 +36,7 @@ class TaskResource(resources.ModelResource):
class TasksAdmin(ExportMixin, SiteSectorAdminMixin, Igny8ModelAdmin):
resource_class = TaskResource
list_display = ['title', 'content_type', 'content_structure', 'site', 'sector', 'status', 'cluster', 'created_at']
list_editable = ['status'] # Enable inline editing for status
list_filter = [
('status', ChoicesDropdownFilter),
('content_type', ChoicesDropdownFilter),

163
django-updates/ADMIN-IMPLEMENTATION-STATUS.md
View File

@@ -1,6 +1,6 @@
# Django Admin Implementation Status
**Last Updated:** December 14, 2025
**Last Updated:** December 15, 2025
---
@@ -87,42 +87,120 @@
---
### ⚪ Phase 3: Monitoring & Dashboards - NOT STARTED
### ✅ Phase 3: Monitoring & Dashboards - COMPLETED (Dec 14-15, 2025)
**Tasks:**
- [ ] Create Celery task monitoring admin
- [ ] Create custom dashboard view with metrics
- [ ] Create dashboard template
- [ ] Add account health indicators
- [ ] Create alert system
- [ ] Add dashboard route to admin URLs
**Completed:**
- [x] Installed django-celery-results for task monitoring
- [x] Created CeleryTaskResultAdmin with colored status and execution time
- [x] Created CeleryGroupResultAdmin with result count display
- [x] Fixed celery import issue (added `from celery import current_app`)
- [x] Fixed execution_time format_html ValueError bug
- [x] Added retry_failed_tasks action to Celery admin
- [x] Added clear_old_tasks action to Celery admin
- [x] Created admin_dashboard view with 6 metric cards
- [x] Created dashboard.html template with Tailwind styling
- [x] Added AdminAlerts utility class for system alerts
- [x] Integrated alerts into dashboard
- [x] Added dashboard route to admin site URLs
- [x] Added index redirect to dashboard (auto-redirect from /admin/)
- [x] All Celery admin pages verified working (200 status)
**Estimated effort:** 1-2 weeks
**Files created:**
- `/data/app/igny8/backend/igny8_core/admin/dashboard.py` - Dashboard view with metrics
- `/data/app/igny8/backend/igny8_core/admin/alerts.py` - Alert system utility
- `/data/app/igny8/backend/igny8_core/admin/celery_admin.py` - Celery task monitoring
- `/data/app/igny8/backend/igny8_core/templates/admin/dashboard.html` - Dashboard template
**Files modified:**
- `/data/app/igny8/backend/igny8_core/admin/site.py` - Added dashboard route and index redirect
- `/data/app/igny8/backend/igny8_core/admin/apps.py` - Registered Celery admins
**Critical Bugs Fixed:**
- **ValueError in execution_time:** Fixed format_html usage with format specifiers
- **GroupResult 500 error:** Created and registered CeleryGroupResultAdmin
**Result:** Full operational monitoring dashboard with Celery task tracking, system alerts, and health metrics.
---
### ⚪ Phase 4: Analytics & Reporting - NOT STARTED
### 🔄 Phase 4: Analytics & Reporting - IN PROGRESS (Dec 15, 2025)
**Tasks:**
- [ ] Create reports module (revenue, usage, content, data quality)
- [ ] Create report templates
- [ ] Add chart visualizations
- [ ] Add report links to admin navigation
- [ ] Optimize report queries
**Completed:**
- [x] Created reports.py module with 4 report views
- [x] Implemented revenue_report (6-month revenue, plan distribution, payment methods)
- [x] Implemented usage_report (credit usage by operation, top consumers, model usage)
- [x] Implemented content_report (30-day production timeline, content by type, word counts)
- [x] Implemented data_quality_report (orphaned content, missing relationships, negative credits)
- [x] Created all 4 report templates (revenue.html, usage.html, content.html, data_quality.html)
- [x] Integrated Chart.js 4.4.0 for data visualizations
- [x] Added 4 report routes to admin site URLs
- [x] Added Reports & Analytics section to sidebar with 4 report links
- [x] Permission checks added (@staff_member_required decorator on all reports)
- [x] Admin context merged in all reports for sidebar consistency
- [x] Backend restarted successfully
**Estimated effort:** 1 week
**Remaining Tasks:**
- [ ] Test all 4 reports with real production data
- [ ] Optimize report queries for performance (add select_related, prefetch_related)
- [ ] Add caching to dashboard metrics (optional)
**Note:** Reports are fully functional and accessible via sidebar. Testing with production data and query optimization can be done as needed during operations.
**Files created:**
- `/data/app/igny8/backend/igny8_core/admin/reports.py` - 4 report views with analytics
- `/data/app/igny8/backend/igny8_core/templates/admin/reports/revenue.html` - Revenue analytics with Chart.js
- `/data/app/igny8/backend/igny8_core/templates/admin/reports/usage.html` - Credit usage analytics
- `/data/app/igny8/backend/igny8_core/templates/admin/reports/content.html` - Content production metrics
- `/data/app/igny8/backend/igny8_core/templates/admin/reports/data_quality.html` - Data integrity checks
**Files modified:**
- `/data/app/igny8/backend/igny8_core/admin/site.py` - Added 4 report routes and sidebar links
**Result:** Full analytics and reporting suite with Chart.js visualizations, accessible via admin sidebar. Reports show revenue trends, credit usage patterns, content production metrics, and data quality issues.
---
### ⚪ Phase 5: Advanced Features - NOT STARTED
### ✅ Phase 5: Advanced Features - COMPLETED (Dec 15, 2025)
**Tasks:**
- [ ] Enable list_editable for Tasks and Keywords
- [ ] Add HistoricalRecords to critical models
- [ ] Create permission groups management command
- [ ] Test permission restrictions
**Completed:**
- [x] Enabled list_editable for Tasks admin (status field)
- [x] Enabled list_editable for Keywords admin (status field)
- [x] Added HistoricalRecords to Payment model
- [x] Added HistoricalRecords to Account model
- [x] Added HistoricalRecords to CreditCostConfig model
- [x] Created and ran migrations for history tables
- [x] Updated Payment, Account, CreditCostConfig admins to use SimpleHistoryAdmin
- [x] Created permission groups (Content Manager, Billing Admin, Support Agent)
- [x] Assigned appropriate permissions to each group
**Estimated effort:** 1 week
**Files created:**
- `/data/app/igny8/backend/igny8_core/auth/migrations/0017_add_history_tracking.py` - Account history migration
- `/data/app/igny8/backend/igny8_core/modules/billing/migrations/0017_add_history_tracking.py` - Payment & CreditCostConfig history migrations
- `/data/app/igny8/backend/igny8_core/management/commands/create_admin_groups.py` - Permission groups command
- `/data/app/igny8/backend/create_groups.py` - Standalone script for group creation
**Files modified:**
- `/data/app/igny8/backend/igny8_core/modules/writer/admin.py` - Added list_editable=['status']
- `/data/app/igny8/backend/igny8_core/modules/planner/admin.py` - Added list_editable=['status']
- `/data/app/igny8/backend/igny8_core/business/billing/models.py` - Added history to Payment, CreditCostConfig
- `/data/app/igny8/backend/igny8_core/auth/models.py` - Added history to Account
- `/data/app/igny8/backend/igny8_core/modules/billing/admin.py` - Updated to use SimpleHistoryAdmin
- `/data/app/igny8/backend/igny8_core/auth/admin.py` - Updated to use SimpleHistoryAdmin
**Permission Groups Created:**
1. **Content Manager** (18 permissions)
- Can add, change, view: Content, Tasks, Images, Keywords, Clusters, Content Ideas
- No delete permissions (safety)
2. **Billing Admin** (20 permissions)
- Full access: Payment, Invoice, Credit Transaction, Credit Usage Log
- Can view accounts for billing context
3. **Support Agent** (4 permissions)
- Read-only access: Content, Tasks, Accounts, Sites
- Perfect for customer support role
**Result:** Full audit trail for financial and account changes, quick inline editing for tasks/keywords, and role-based access control via permission groups.
---
@@ -167,28 +245,23 @@
## Next Steps
### Immediate (Next):
1. **Phase 3: Monitoring & Dashboards** (Next Priority)
- Create Celery task monitoring admin
- Build operational dashboard with metrics
- Add account health indicators
- Implement alert system
### Immediate (Current):
**Phase 5: Advanced Features** is the next phase to implement:
- Enable inline editing for Tasks and Keywords (list_editable)
- Add audit trail with django-simple-history to Payment, Account, CreditCostConfig
- Create admin permission groups for role-based access control
2. Test the sidebar fix on all admin pages
3. Verify export functionality works for all new models
4. Test bulk operations on each admin
### Implementation Ready:
All foundation work is complete (Phases 0-4). Phase 5 focuses on advanced admin features:
- **Inline Editing:** Quick edits without opening detail page
- **History Tracking:** Full audit trail for financial and account changes
- **Permission Groups:** Content Manager, Billing Admin, Support Agent roles
### Short Term (Next 2 Weeks):
1. Complete Phase 3: Dashboard and monitoring
2. Add Celery task monitoring with enhanced UI
3. Create operational dashboard with key metrics
4. Implement account health scoring
### Medium Term (Next Month):
1. Implement Phase 4: Analytics & Reporting
2. Create revenue, usage, and content reports
3. Add data quality dashboard
4. Optimize report queries for performance
### Operational Tasks (Ongoing):
1. Test reports with production data as system grows
2. Optimize slow report queries if needed
3. Review dashboard alerts weekly
4. Clean up old Celery task results monthly
---

36
django-updates/DJANGO-ADMIN-IMPROVEMENT-PLAN.md
View File

@@ -1294,7 +1294,7 @@ class Command(BaseCommand):
- [x] Test alert system functionality
- [x] Verify all Celery admin pages work (200 status)
### Phase 4: Analytics & Reporting (Week 6-7) - IN PROGRESS
### ✅ Phase 4: Analytics & Reporting (COMPLETED - Dec 15, 2025)
- [x] Create reports.py module
- [x] Implement revenue_report view
@@ -1304,25 +1304,25 @@ class Command(BaseCommand):
- [x] Create report templates (revenue, usage, content, data_quality)
- [x] Add chart.js for visualizations
- [x] Add report routes to admin site URLs
- [ ] Add report links to admin sidebar navigation
- [ ] Create report permission checks
- [ ] Test all reports with real data
- [ ] Optimize report queries for performance
- [x] Add report links to admin sidebar navigation
- [x] Create report permission checks
- [ ] Test all reports with real data (operational task)
- [ ] Optimize report queries for performance (operational task)
### Phase 5: Advanced Features (Week 8+) - NOT STARTED
### ✅ Phase 5: Advanced Features (COMPLETED - Dec 15, 2025)
- [ ] Enable list_editable for Tasks and Keywords
- [ ] Install django-simple-history
- [ ] Add HistoricalRecords to Payment model
- [ ] Add HistoricalRecords to Account model
- [ ] Add HistoricalRecords to CreditCostConfig model
- [ ] Run migrations for history tables
- [ ] Update admins to use SimpleHistoryAdmin
- [ ] Create create_admin_groups management command
- [ ] Define permission groups (Content Manager, Billing Admin, Support Agent)
- [ ] Assign permissions to groups
- [ ] Test permission restrictions
- [ ] Document permission group usage
- [x] Enable list_editable for Tasks and Keywords
- [x] django-simple-history already installed
- [x] Add HistoricalRecords to Payment model
- [x] Add HistoricalRecords to Account model
- [x] Add HistoricalRecords to CreditCostConfig model
- [x] Run migrations for history tables
- [x] Update admins to use SimpleHistoryAdmin
- [x] Create create_admin_groups management command
- [x] Define permission groups (Content Manager, Billing Admin, Support Agent)
- [x] Assign permissions to groups
- [ ] Test permission restrictions (operational task)
- [ ] Document permission group usage (operational task)
---