# api/blog/models.py

class Post(models.Model):
    """文章模型"""
    STATUS_CHOICES = (
        ('draft', '草稿'),
        ('published', '已發布'),
        ('archived', '已歸檔'),
    )

    title = models.CharField(max_length=200, verbose_name="標題")
    slug = models.SlugField(max_length=200, unique=True, verbose_name="URL別名")
    content = models.TextField(verbose_name="內容")
    ...

    # 一對多關係（文章只屬於一個分類）
    category = models.ForeignKey(Category, on_delete=models.CASCADE, related_name='posts', verbose_name="分類")
    # 多對多關係（文章可以有多個標籤）
    tags = models.ManyToManyField(Tag, through='PostTag', related_name='posts', verbose_name="標籤")

    class Meta:
        verbose_name = "文章"
        verbose_name_plural = "文章"
        ordering = ['-published_at', '-created_at']

    def __str__(self):
        return self.
        def save(self, *args, **kwargs):
        # 當文章從草稿狀態變為已發布狀態時，設置發布時間
        if self.status == 'published' and not self.published_at:
            self.published_at = timezone.now()
        super().save(*args, **kwargs)
...
class PostTag(models.Model):
    """文章-標籤 關聯模型"""
    post = models.ForeignKey(Post, on_delete=models.CASCADE, verbose_name="文章")
    tag = models.ForeignKey(Tag, on_delete=models.CASCADE, verbose_name="標籤")

    class Meta:
        verbose_name = "文章標籤關聯"
        verbose_name_plural = "文章標籤關聯"
        unique_together = ('post', 'tag')  # 確保一篇文章不會重複關聯同一個標籤
    ...

# api/blog/admin.py
from django.contrib import admin
from .models import *

admin.site.register(Post)
...

# api/blog/serializers.py
class CategorySerializer(serializers.ModelSerializer):
    class Meta:
        model = Category
        fields = ['id', 'name', 'description', 'sort_order']

class PostListSerializer(serializers.ModelSerializer):
    category_name = serializers.CharField(source='category.name', read_only=True)
    tags = TagSerializer(many=True, read_only=True)

    class Meta:
        model = Post
        fields = [
            'id', 'title', 'slug', 'summary', 'thumbnail_url',
            'published_at', 'status', 'view_count', 'category',
            'category_name', 'tags'
        ]
...
class PostDetailSerializer(serializers.ModelSerializer):
    category = CategorySerializer(read_only=True)
    tags = TagSerializer(many=True, read_only=True)

    class Meta:
        model = Post
        fields = [
            'id', 'title', 'slug', 'content', 'summary', 'thumbnail_url',
            'meta_title', 'meta_description', 'created_at', 'updated_at',
            'published_at', 'status', 'view_count', 'category', 'tags'
        ]

class PostListCreateView(ListCreateAPIView):
    queryset = Post.objects.all()
    filterset_fields = ['category', 'status', 'tags'] # 允許按分類、狀態和標籤過濾
    search_fields = ['title', 'content', 'summary'] # 允許在標題、內容和摘要中搜索
    ordering_fields = ['published_at', 'created_at', 'view_count', 'title'] # 允許按發布時間、創建時間、瀏覽次數和標題排序

    def get_serializer_class(self):
        if self.request.method == 'POST':
            return PostCreateUpdateSerializer
        return PostListSerializer

    def get_queryset(self):
        # 非管理員只能查看已發布的文章
        if self.request.user.is_staff:
            return Post.objects.all()
        return Post.objects.filter(status='published')

# api/blog/urls.py
urlpatterns = [
    ...
    # 文章相關 URLs
    path('posts/', PostListCreateView.as_view(), name='post-list'),
]

# backend/urls.py
urlpatterns = [
    path('admin/', admin.site.urls),
    ...
    path('api/products/', include('api.products.urls')),  # 產品 API
    path('api/blog/', include('api.blog.urls')),  # 部落格 API
]