如何在其他App的ModelAdmin中显示Inline值及优化地址管理

一、简化地址模型结构 #

首先清理冗余的模型定义，将ManageAddress和AssignAddress合并为单一的Address模型，通过通用外键关联到任意模型（包括Customer）：

# address_reports/models.py
from django.db import models
from django.contrib.contenttypes.models import ContentType
from django.contrib.contenttypes.fields import GenericForeignKey
from django_countries.fields import CountryField

from accounts.models import Customer


class AddressManager(models.Manager):
    def get_for_object(self, obj):
        content_type = ContentType.objects.get_for_model(obj)
        return self.filter(content_type=content_type, object_id=obj.pk)


class Address(models.Model):
    objects = AddressManager()
    apartment_or_suite = models.CharField(max_length=255, blank=True, null=True)
    street = models.CharField(max_length=255)
    city = models.CharField(max_length=255, null=True)
    postal_code = models.CharField(max_length=20, blank=True)
    country = CountryField()
    
    # 通用外键关联
    content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE)
    object_id = models.PositiveIntegerField()
    content_object = GenericForeignKey('content_type', 'object_id')

    def __str__(self):
        return f"{self.street}, {self.city}, {self.country.name}"

二、在CustomerAdmin中显示地址字段 #

修改core/admin.py，为CustomerAdmin添加自定义方法来获取地址信息，并加入列表显示：

# core/admin.py
from django.contrib import admin
from django.contrib.contenttypes.admin import GenericStackedInline

from accounts.models import Customer
from accounts.admin import CustomerAdmin
from address_reports.models import Address


class AddressInline(GenericStackedInline):
    model = Address
    extra = 1  # 默认显示1个空地址表单
    fields = ('street', 'apartment_or_suite', 'city', 'postal_code', 'country')  # 自定义字段顺序


class CustomCustomerAdmin(CustomerAdmin):
    inlines = [AddressInline]
    # 扩展原有列表显示，加入地址字段
    list_display = CustomerAdmin.list_display + ('get_street', 'get_city', 'get_country')

    def get_street(self, obj):
        # 获取第一个地址的街道（多地址场景可调整为拼接显示）
        address = Address.objects.get_for_object(obj).first()
        return address.street if address else "-"
    get_street.short_description = '街道'

    def get_city(self, obj):
        address = Address.objects.get_for_object(obj).first()
        return address.city if address else "-"
    get_city.short_description = '城市'

    def get_country(self, obj):
        address = Address.objects.get_for_object(obj).first()
        return address.country.name if address else "-"
    get_country.short_description = '国家'


admin.site.unregister(Customer)
admin.site.register(Customer, CustomCustomerAdmin)

三、在address_reports中管理特定客户地址 #

修改address_reports/admin.py，添加客户筛选和关联显示，方便在地址管理页面快速定位特定客户的地址：

# address_reports/admin.py
from django.contrib import admin
from django.contrib.contenttypes.admin import RelatedOnlyFieldListFilter

from address_reports.models import Address
from accounts.models import Customer


@admin.register(Address)
class AddressAdmin(admin.ModelAdmin):
    search_fields = ['street', 'city', 'postal_code', 'country']
    list_display = ['street', 'city', 'postal_code', 'country', 'get_customer']
    # 添加客户筛选器
    list_filter = (
        ('content_object', RelatedOnlyFieldListFilter),
    )

    def get_customer(self, obj):
        # 显示地址所属的客户（非客户地址显示"-"）
        if isinstance(obj.content_object, Customer):
            return obj.content_object
        return "-"
    get_customer.short_description = '关联客户'

关键改进点 #

1. 消除冗余模型：合并重复的地址定义，减少维护成本和数据冗余
2. 列表视图直接展示地址：无需进入详情页即可查看客户的核心地址信息
3. 双向地址管理：既可以在客户详情页编辑地址，也可以在地址管理页面通过筛选快速定位特定客户的地址进行维护
4. 通用外键保持灵活性：保留了地址关联任意模型的能力，后续扩展其他模型的地址功能无需修改基础结构

内容的提问来源于stack exchange，提问作者Sesshōmaru