Initial commit: React + Django 城市手册项目
- Django 4.2 + DRF + JWT + GraphQL - React 18 + MobX + styled-components - PostgreSQL 数据库 - Docker + Docker Compose + Nginx - 完整的功能模块（用户、版块、文章、服务、交互、版主管理） - 完整的文档（需求、部署、测试）
This commit is contained in:
mashen
1
backend/apps/articles/__init__.py
Normal file
1
backend/apps/articles/__init__.py
Normal file
@@ -0,0 +1 @@
|
||||
# Articles app
|
||||
7
backend/apps/articles/apps.py
Normal file
7
backend/apps/articles/apps.py
Normal file
@@ -0,0 +1,7 @@
|
||||
from django.apps import AppConfig
|
||||
|
||||
|
||||
class ArticlesConfig(AppConfig):
|
||||
default_auto_field = 'django.db.models.BigAutoField'
|
||||
name = 'apps.articles'
|
||||
verbose_name = '文章管理'
|
||||
144
backend/apps/articles/models.py
Normal file
144
backend/apps/articles/models.py
Normal file
@@ -0,0 +1,144 @@
|
||||
from django.db import models
|
||||
from django.conf import settings
|
||||
from apps.regions.models import Region
|
||||
|
||||
|
||||
class Article(models.Model):
|
||||
"""Model for articles."""
|
||||
|
||||
ARTICLE_TYPE_CHOICES = [
|
||||
('basic', '城市信息'),
|
||||
('history', '历史'),
|
||||
('culture', '文化'),
|
||||
('practical', '实用'),
|
||||
('life', '生活'),
|
||||
]
|
||||
|
||||
STATUS_CHOICES = [
|
||||
('draft', '草稿'),
|
||||
('pending_moderator', '待版主审核'),
|
||||
('pending_ai', '待AI审核'),
|
||||
('published', '已发布'),
|
||||
('rejected', '已拒绝'),
|
||||
]
|
||||
|
||||
MODERATOR_STATUS_CHOICES = [
|
||||
('pending', '待审核'),
|
||||
('approved', '通过'),
|
||||
('rejected', '拒绝'),
|
||||
]
|
||||
|
||||
AI_STATUS_CHOICES = [
|
||||
('pending', '待审核'),
|
||||
('approved', '通过'),
|
||||
('rejected', '拒绝'),
|
||||
]
|
||||
|
||||
title = models.CharField(max_length=200, verbose_name='标题')
|
||||
content = models.TextField(verbose_name='内容')
|
||||
region = models.ForeignKey(
|
||||
Region,
|
||||
on_delete=models.CASCADE,
|
||||
related_name='articles',
|
||||
verbose_name='所属版块'
|
||||
)
|
||||
article_type = models.CharField(
|
||||
max_length=20,
|
||||
choices=ARTICLE_TYPE_CHOICES,
|
||||
verbose_name='内容类型'
|
||||
)
|
||||
author = models.ForeignKey(
|
||||
settings.AUTH_USER_MODEL,
|
||||
on_delete=models.CASCADE,
|
||||
related_name='articles',
|
||||
verbose_name='提交者'
|
||||
)
|
||||
|
||||
# Moderator review
|
||||
moderator_reviewer = models.ForeignKey(
|
||||
settings.AUTH_USER_MODEL,
|
||||
on_delete=models.SET_NULL,
|
||||
null=True,
|
||||
blank=True,
|
||||
related_name='moderated_articles',
|
||||
verbose_name='版主审核人'
|
||||
)
|
||||
moderator_status = models.CharField(
|
||||
max_length=20,
|
||||
choices=MODERATOR_STATUS_CHOICES,
|
||||
default='pending',
|
||||
verbose_name='版主审核状态'
|
||||
)
|
||||
moderator_reviewed_at = models.DateTimeField(null=True, blank=True, verbose_name='版主审核时间')
|
||||
moderator_rejection_reason = models.TextField(null=True, blank=True, verbose_name='版主拒绝原因')
|
||||
|
||||
# AI review
|
||||
ai_status = models.CharField(
|
||||
max_length=20,
|
||||
choices=AI_STATUS_CHOICES,
|
||||
default='pending',
|
||||
verbose_name='AI审核状态'
|
||||
)
|
||||
ai_reviewed_at = models.DateTimeField(null=True, blank=True, verbose_name='AI审核时间')
|
||||
ai_rejection_reason = models.TextField(null=True, blank=True, verbose_name='AI拒绝原因')
|
||||
|
||||
# Publish status
|
||||
publish_status = models.CharField(
|
||||
max_length=20,
|
||||
choices=STATUS_CHOICES,
|
||||
default='draft',
|
||||
verbose_name='发布状态'
|
||||
)
|
||||
published_at = models.DateTimeField(null=True, blank=True, verbose_name='发布时间')
|
||||
|
||||
created_at = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
|
||||
updated_at = models.DateTimeField(auto_now=True, verbose_name='更新时间')
|
||||
|
||||
class Meta:
|
||||
db_table = 'articles'
|
||||
verbose_name = '文章'
|
||||
verbose_name_plural = '文章'
|
||||
ordering = ['-created_at']
|
||||
|
||||
def __str__(self):
|
||||
return self.title
|
||||
|
||||
def submit_for_review(self):
|
||||
"""Submit article for moderator review."""
|
||||
self.publish_status = 'pending_moderator'
|
||||
self.save()
|
||||
|
||||
def approve_moderator(self, reviewer, reason=''):
|
||||
"""Approve article by moderator."""
|
||||
self.moderator_status = 'approved'
|
||||
self.moderator_reviewer = reviewer
|
||||
self.moderator_reviewed_at = timezone.now()
|
||||
self.moderator_rejection_reason = reason
|
||||
self.publish_status = 'pending_ai'
|
||||
self.save()
|
||||
|
||||
def reject_moderator(self, reviewer, reason):
|
||||
"""Reject article by moderator."""
|
||||
self.moderator_status = 'rejected'
|
||||
self.moderator_reviewer = reviewer
|
||||
self.moderator_reviewed_at = timezone.now()
|
||||
self.moderator_rejection_reason = reason
|
||||
self.publish_status = 'rejected'
|
||||
self.save()
|
||||
|
||||
def approve_ai(self, reason=''):
|
||||
"""Approve article by AI."""
|
||||
self.ai_status = 'approved'
|
||||
self.ai_reviewed_at = timezone.now()
|
||||
self.ai_rejection_reason = reason
|
||||
self.publish_status = 'published'
|
||||
self.published_at = timezone.now()
|
||||
self.save()
|
||||
|
||||
def reject_ai(self, reason):
|
||||
"""Reject article by AI."""
|
||||
self.ai_status = 'rejected'
|
||||
self.ai_reviewed_at = timezone.now()
|
||||
self.ai_rejection_reason = reason
|
||||
self.publish_status = 'rejected'
|
||||
self.save()
|
||||
65
backend/apps/articles/serializers.py
Normal file
65
backend/apps/articles/serializers.py
Normal file
@@ -0,0 +1,65 @@
|
||||
from rest_framework import serializers
|
||||
from .models import Article
|
||||
|
||||
|
||||
class ArticleSerializer(serializers.ModelSerializer):
|
||||
"""Serializer for Article model."""
|
||||
|
||||
article_type_display = serializers.CharField(source='get_article_type_display', read_only=True)
|
||||
status_display = serializers.CharField(source='get_publish_status_display', read_only=True)
|
||||
moderator_status_display = serializers.CharField(source='get_moderator_status_display', read_only=True)
|
||||
ai_status_display = serializers.CharField(source='get_ai_status_display', read_only=True)
|
||||
author_username = serializers.CharField(source='author.username', read_only=True)
|
||||
region_name = serializers.CharField(source='region.name', read_only=True)
|
||||
|
||||
class Meta:
|
||||
model = Article
|
||||
fields = ('id', 'title', 'content', 'region', 'region_name', 'article_type', 'article_type_display',
|
||||
'author', 'author_username', 'moderator_status', 'moderator_status_display',
|
||||
'moderator_reviewer', 'moderator_reviewed_at', 'moderator_rejection_reason',
|
||||
'ai_status', 'ai_status_display', 'ai_reviewed_at', 'ai_rejection_reason',
|
||||
'publish_status', 'status_display', 'published_at', 'created_at', 'updated_at')
|
||||
read_only_fields = ('id', 'author', 'moderator_reviewer', 'moderator_reviewed_at',
|
||||
'ai_reviewed_at', 'published_at', 'created_at', 'updated_at')
|
||||
|
||||
|
||||
class ArticleCreateSerializer(serializers.ModelSerializer):
|
||||
"""Serializer for creating articles."""
|
||||
|
||||
class Meta:
|
||||
model = Article
|
||||
fields = ('title', 'content', 'region', 'article_type')
|
||||
|
||||
def create(self, validated_data):
|
||||
validated_data['author'] = self.context['request'].user
|
||||
return super().create(validated_data)
|
||||
|
||||
|
||||
class ArticleUpdateSerializer(serializers.ModelSerializer):
|
||||
"""Serializer for updating articles."""
|
||||
|
||||
class Meta:
|
||||
model = Article
|
||||
fields = ('title', 'content', 'article_type')
|
||||
|
||||
|
||||
class ArticleReviewSerializer(serializers.Serializer):
|
||||
"""Serializer for article review actions."""
|
||||
|
||||
action = serializers.ChoiceField(choices=['approve', 'reject'])
|
||||
reason = serializers.CharField(required=False, allow_blank=True)
|
||||
|
||||
|
||||
class ArticleListSerializer(serializers.ModelSerializer):
|
||||
"""Simplified serializer for article list."""
|
||||
|
||||
article_type_display = serializers.CharField(source='get_article_type_display', read_only=True)
|
||||
author_username = serializers.CharField(source='author.username', read_only=True)
|
||||
region_name = serializers.CharField(source='region.name', read_only=True)
|
||||
|
||||
class Meta:
|
||||
model = Article
|
||||
fields = ('id', 'title', 'article_type', 'article_type_display',
|
||||
'author', 'author_username', 'region', 'region_name',
|
||||
'publish_status', 'created_at')
|
||||
read_only_fields = ('id', 'created_at')
|
||||
10
backend/apps/articles/urls.py
Normal file
10
backend/apps/articles/urls.py
Normal file
@@ -0,0 +1,10 @@
|
||||
from django.urls import path, include
|
||||
from rest_framework.routers import DefaultRouter
|
||||
from .views import ArticleViewSet
|
||||
|
||||
router = DefaultRouter()
|
||||
router.register(r'articles', ArticleViewSet, basename='article')
|
||||
|
||||
urlpatterns = [
|
||||
path('', include(router.urls)),
|
||||
]
|
||||
204
backend/apps/articles/views.py
Normal file
204
backend/apps/articles/views.py
Normal file
@@ -0,0 +1,204 @@
|
||||
from rest_framework import viewsets, permissions, status, filters
|
||||
from rest_framework.decorators import action
|
||||
from rest_framework.response import Response
|
||||
from django.utils import timezone
|
||||
from django.db.models import Q
|
||||
from .models import Article
|
||||
from .serializers import (
|
||||
ArticleSerializer,
|
||||
ArticleCreateSerializer,
|
||||
ArticleUpdateSerializer,
|
||||
ArticleReviewSerializer,
|
||||
ArticleListSerializer
|
||||
)
|
||||
|
||||
|
||||
class ArticleViewSet(viewsets.ModelViewSet):
|
||||
"""ViewSet for Article model."""
|
||||
|
||||
permission_classes = [permissions.IsAuthenticatedOrReadOnly]
|
||||
filter_backends = [filters.SearchFilter, filters.OrderingFilter, filters.DjangoFilterBackend]
|
||||
search_fields = ['title', 'content']
|
||||
filterset_fields = ['article_type', 'region', 'publish_status']
|
||||
ordering_fields = ['created_at', 'updated_at', 'published_at']
|
||||
ordering = ['-created_at']
|
||||
|
||||
def get_queryset(self):
|
||||
queryset = Article.objects.select_related('author', 'region', 'moderator_reviewer')
|
||||
|
||||
# Only show published articles to non-authenticated users
|
||||
if not self.request.user.is_authenticated:
|
||||
return queryset.filter(publish_status='published')
|
||||
|
||||
# Show all for admins
|
||||
if self.request.user.is_admin():
|
||||
return queryset
|
||||
|
||||
# Show own articles + published articles for regular users
|
||||
return queryset.filter(
|
||||
Q(author=self.request.user) |
|
||||
Q(publish_status='published')
|
||||
).distinct()
|
||||
|
||||
def get_serializer_class(self):
|
||||
if self.action == 'create':
|
||||
return ArticleCreateSerializer
|
||||
elif self.action in ['update', 'partial_update']:
|
||||
return ArticleUpdateSerializer
|
||||
elif self.action == 'list':
|
||||
return ArticleListSerializer
|
||||
elif self.action in ['approve', 'reject', 'submit']:
|
||||
return ArticleReviewSerializer
|
||||
return ArticleSerializer
|
||||
|
||||
def perform_create(self, serializer):
|
||||
serializer.save(author=self.request.user)
|
||||
|
||||
def perform_update(self, serializer):
|
||||
# Only allow updating own articles or by admin
|
||||
if (not self.request.user.is_admin() and
|
||||
str(serializer.instance.author.id) != str(self.request.user.id)):
|
||||
from rest_framework.exceptions import PermissionDenied
|
||||
raise PermissionDenied("You can only update your own articles")
|
||||
serializer.save()
|
||||
|
||||
def perform_destroy(self, instance):
|
||||
# Only allow deleting own articles or by admin
|
||||
if (not self.request.user.is_admin() and
|
||||
str(instance.author.id) != str(self.request.user.id)):
|
||||
from rest_framework.exceptions import PermissionDenied
|
||||
raise PermissionDenied("You can only delete your own articles")
|
||||
instance.delete()
|
||||
|
||||
@action(detail=True, methods=['post'])
|
||||
def submit(self, request, pk=None):
|
||||
"""Submit article for review."""
|
||||
article = self.get_object()
|
||||
if article.author != request.user:
|
||||
return Response(
|
||||
{'detail': 'You can only submit your own articles'},
|
||||
status=status.HTTP_403_FORBIDDEN
|
||||
)
|
||||
article.submit_for_review()
|
||||
return Response({'message': 'Article submitted for review'})
|
||||
|
||||
@action(detail=True, methods=['post'])
|
||||
def approve(self, request, pk=None):
|
||||
"""Approve article (moderator only)."""
|
||||
article = self.get_object()
|
||||
serializer = self.get_serializer(data=request.data)
|
||||
|
||||
if not serializer.is_valid():
|
||||
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
if not request.user.is_moderator():
|
||||
return Response(
|
||||
{'detail': 'Only moderators can approve articles'},
|
||||
status=status.HTTP_403_FORBIDDEN
|
||||
)
|
||||
|
||||
# Check if moderator has permission for this region
|
||||
from apps.moderation.models import ModeratorPermission
|
||||
has_permission = ModeratorPermission.objects.filter(
|
||||
moderator=request.user,
|
||||
region=article.region,
|
||||
status='active'
|
||||
).exists()
|
||||
|
||||
if not has_permission:
|
||||
return Response(
|
||||
{'detail': 'You do not have permission to approve articles in this region'},
|
||||
status=status.HTTP_403_FORBIDDEN
|
||||
)
|
||||
|
||||
article.approve_moderator(
|
||||
reviewer=request.user,
|
||||
reason=serializer.validated_data.get('reason', '')
|
||||
)
|
||||
return Response({'message': 'Article approved'})
|
||||
|
||||
@action(detail=True, methods=['post'])
|
||||
def reject(self, request, pk=None):
|
||||
"""Reject article (moderator only)."""
|
||||
article = self.get_object()
|
||||
serializer = self.get_serializer(data=request.data)
|
||||
|
||||
if not serializer.is_valid():
|
||||
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
if not request.user.is_moderator():
|
||||
return Response(
|
||||
{'detail': 'Only moderators can reject articles'},
|
||||
status=status.HTTP_403_FORBIDDEN
|
||||
)
|
||||
|
||||
# Check if moderator has permission for this region
|
||||
from apps.moderation.models import ModeratorPermission
|
||||
has_permission = ModeratorPermission.objects.filter(
|
||||
moderator=request.user,
|
||||
region=article.region,
|
||||
status='active'
|
||||
).exists()
|
||||
|
||||
if not has_permission:
|
||||
return Response(
|
||||
{'detail': 'You do not have permission to reject articles in this region'},
|
||||
status=status.HTTP_403_FORBIDDEN
|
||||
)
|
||||
|
||||
article.reject_moderator(
|
||||
reviewer=request.user,
|
||||
reason=serializer.validated_data.get('reason', 'Required reason')
|
||||
)
|
||||
return Response({'message': 'Article rejected'})
|
||||
|
||||
@action(detail=True, methods=['get'])
|
||||
def comments(self, request, pk=None):
|
||||
"""Get comments for an article."""
|
||||
article = self.get_object()
|
||||
from apps.interactions.serializers import CommentSerializer
|
||||
from apps.interactions.models import Comment
|
||||
comments = Comment.objects.filter(
|
||||
target_type='article',
|
||||
target_id=article.id,
|
||||
ai_status='approved'
|
||||
)
|
||||
serializer = CommentSerializer(comments, many=True)
|
||||
return Response(serializer.data)
|
||||
|
||||
@action(detail=True, methods=['post'])
|
||||
def like(self, request, pk=None):
|
||||
"""Like or unlike an article."""
|
||||
article = self.get_object()
|
||||
from apps.interactions.models import Like
|
||||
|
||||
like, created = Like.objects.get_or_create(
|
||||
user=request.user,
|
||||
target_type='article',
|
||||
target_id=article.id
|
||||
)
|
||||
|
||||
if not created:
|
||||
like.delete()
|
||||
return Response({'message': 'Unliked', 'liked': False})
|
||||
|
||||
return Response({'message': 'Liked', 'liked': True})
|
||||
|
||||
@action(detail=True, methods=['get'])
|
||||
def stats(self, request, pk=None):
|
||||
"""Get article statistics."""
|
||||
article = self.get_object()
|
||||
from apps.interactions.models import Like, Comment, Rating
|
||||
|
||||
return Response({
|
||||
'likes_count': Like.objects.filter(
|
||||
target_type='article',
|
||||
target_id=article.id
|
||||
).count(),
|
||||
'comments_count': Comment.objects.filter(
|
||||
target_type='article',
|
||||
target_id=article.id,
|
||||
ai_status='approved'
|
||||
).count(),
|
||||
'views_count': getattr(article, 'views_count', 0),
|
||||
})
|
||||
Reference in New Issue
Block a user