feat: 城市手册后端完成 - 用户/区域/内容/服务/审核系统

This commit is contained in:
root
2026-04-10 12:12:41 +00:00
committed by maoshen
parent c866e74ece
commit 432345c249
120 changed files with 3186 additions and 0 deletions

View File

View File

@@ -0,0 +1,57 @@
from django.contrib import admin
from .models import Article, Comment, Like, Rating, Favorite
@admin.register(Article)
class ArticleAdmin(admin.ModelAdmin):
list_display = ['title', 'region', 'content_type', 'author', 'moderator_status', 'ai_status', 'publish_status', 'created_at']
list_filter = ['content_type', 'moderator_status', 'ai_status', 'publish_status']
search_fields = ['title', 'content', 'author__username']
ordering = ['-created_at']
readonly_fields = ['moderator_reviewed_at', 'ai_reviewed_at']
@admin.register(Comment)
class CommentAdmin(admin.ModelAdmin):
list_display = ['author', 'get_object', 'ai_status', 'is_visible', 'created_at']
list_filter = ['ai_status', 'is_visible']
search_fields = ['content', 'author__username']
ordering = ['-created_at']
def get_object(self, obj):
return obj.article or obj.service
get_object.short_description = '对象'
@admin.register(Like)
class LikeAdmin(admin.ModelAdmin):
list_display = ['user', 'get_object', 'created_at']
search_fields = ['user__username']
ordering = ['-created_at']
def get_object(self, obj):
return obj.article or obj.service
get_object.short_description = '对象'
@admin.register(Rating)
class RatingAdmin(admin.ModelAdmin):
list_display = ['user', 'get_object', 'score', 'created_at']
list_filter = ['score']
search_fields = ['user__username', 'comment']
ordering = ['-created_at']
def get_object(self, obj):
return obj.region or obj.service
get_object.short_description = '对象'
@admin.register(Favorite)
class FavoriteAdmin(admin.ModelAdmin):
list_display = ['user', 'get_object', 'created_at']
search_fields = ['user__username']
ordering = ['-created_at']
def get_object(self, obj):
return obj.region or obj.service
get_object.short_description = '对象'

View File

@@ -0,0 +1,6 @@
from django.apps import AppConfig
class ContentConfig(AppConfig):
default_auto_field = 'django.db.models.BigAutoField'
name = 'content'

View File

@@ -0,0 +1,88 @@
# Generated by Django 4.2.11 on 2026-04-10 12:05
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name='Article',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('title', models.CharField(max_length=200, verbose_name='标题')),
('content', models.TextField(verbose_name='内容')),
('content_type', models.CharField(choices=[('city_info', '城市信息'), ('history', '历史'), ('culture', '文化'), ('practical', '实用信息'), ('life', '生活指南')], max_length=20, verbose_name='内容类型')),
('moderator_reviewed_at', models.DateTimeField(blank=True, null=True, verbose_name='版主审核时间')),
('moderator_status', models.CharField(choices=[('pending', '待审核'), ('approved', '通过'), ('rejected', '拒绝')], default='pending', max_length=20, verbose_name='版主审核状态')),
('moderator_comment', models.TextField(blank=True, verbose_name='版主审核意见')),
('ai_status', models.CharField(choices=[('pending', '待审核'), ('approved', '通过'), ('rejected', '拒绝')], default='pending', max_length=20, verbose_name='AI 审核状态')),
('ai_reviewed_at', models.DateTimeField(blank=True, null=True, verbose_name='AI 审核时间')),
('ai_comment', models.TextField(blank=True, verbose_name='AI 审核意见')),
('publish_status', models.CharField(choices=[('draft', '未发布'), ('published', '已发布')], default='draft', max_length=20, verbose_name='发布状态')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')),
],
options={
'verbose_name': '文章',
'verbose_name_plural': '文章',
'ordering': ['-created_at'],
},
),
migrations.CreateModel(
name='Comment',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('content', models.TextField(verbose_name='评论内容')),
('ai_status', models.CharField(choices=[('pending', '待审核'), ('approved', '通过'), ('rejected', '拒绝')], default='pending', max_length=20, verbose_name='AI 审核状态')),
('ai_reviewed_at', models.DateTimeField(blank=True, null=True, verbose_name='AI 审核时间')),
('is_visible', models.BooleanField(default=False, verbose_name='是否显示')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
],
options={
'verbose_name': '评论',
'verbose_name_plural': '评论',
'ordering': ['-created_at'],
},
),
migrations.CreateModel(
name='Favorite',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
],
options={
'verbose_name': '收藏',
'verbose_name_plural': '收藏',
},
),
migrations.CreateModel(
name='Like',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
],
options={
'verbose_name': '点赞',
'verbose_name_plural': '点赞',
},
),
migrations.CreateModel(
name='Rating',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('score', models.PositiveSmallIntegerField(choices=[(1, '1星'), (2, '2星'), (3, '3星'), (4, '4星'), (5, '5星')], verbose_name='评分')),
('comment', models.TextField(blank=True, verbose_name='评价')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
],
options={
'verbose_name': '评分',
'verbose_name_plural': '评分',
},
),
]

View File

@@ -0,0 +1,22 @@
# Generated by Django 4.2.11 on 2026-04-10 12:05
from django.db import migrations, models
import django.db.models.deletion
class Migration(migrations.Migration):
initial = True
dependencies = [
('regions', '0001_initial'),
('content', '0001_initial'),
]
operations = [
migrations.AddField(
model_name='rating',
name='region',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='ratings', to='regions.region'),
),
]

View File

@@ -0,0 +1,22 @@
# Generated by Django 4.2.11 on 2026-04-10 12:05
from django.db import migrations, models
import django.db.models.deletion
class Migration(migrations.Migration):
initial = True
dependencies = [
('services', '0001_initial'),
('content', '0002_initial'),
]
operations = [
migrations.AddField(
model_name='rating',
name='service',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='ratings', to='services.featuredservice'),
),
]

View File

@@ -0,0 +1,97 @@
# Generated by Django 4.2.11 on 2026-04-10 12:05
from django.conf import settings
from django.db import migrations, models
import django.db.models.deletion
class Migration(migrations.Migration):
initial = True
dependencies = [
('regions', '0001_initial'),
('services', '0001_initial'),
('content', '0003_initial'),
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
]
operations = [
migrations.AddField(
model_name='rating',
name='user',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='ratings', to=settings.AUTH_USER_MODEL),
),
migrations.AddField(
model_name='like',
name='article',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='likes', to='content.article'),
),
migrations.AddField(
model_name='like',
name='service',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='likes', to='services.featuredservice'),
),
migrations.AddField(
model_name='like',
name='user',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='likes', to=settings.AUTH_USER_MODEL),
),
migrations.AddField(
model_name='favorite',
name='region',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='favorited_by', to='regions.region'),
),
migrations.AddField(
model_name='favorite',
name='service',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='favorited_by', to='services.featuredservice'),
),
migrations.AddField(
model_name='favorite',
name='user',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='favorites', to=settings.AUTH_USER_MODEL),
),
migrations.AddField(
model_name='comment',
name='article',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='comments', to='content.article', verbose_name='文章'),
),
migrations.AddField(
model_name='comment',
name='author',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='comments', to=settings.AUTH_USER_MODEL, verbose_name='评论者'),
),
migrations.AddField(
model_name='comment',
name='service',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='comments', to='services.featuredservice', verbose_name='特色服务'),
),
migrations.AddField(
model_name='article',
name='author',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='articles', to=settings.AUTH_USER_MODEL, verbose_name='作者'),
),
migrations.AddField(
model_name='article',
name='moderator_reviewer',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='reviewed_articles', to=settings.AUTH_USER_MODEL, verbose_name='版主审核人'),
),
migrations.AddField(
model_name='article',
name='region',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='articles', to='regions.region', verbose_name='所属区域'),
),
migrations.AlterUniqueTogether(
name='rating',
unique_together={('user', 'region', 'service')},
),
migrations.AlterUniqueTogether(
name='like',
unique_together={('user', 'article', 'service')},
),
migrations.AlterUniqueTogether(
name='favorite',
unique_together={('user', 'region', 'service')},
),
]

View File

@@ -0,0 +1,276 @@
from django.db import models
from django.conf import settings
from django.utils import timezone
class Article(models.Model):
"""文章内容表"""
CONTENT_TYPE_CHOICES = [
('city_info', '城市信息'),
('history', '历史'),
('culture', '文化'),
('practical', '实用信息'),
('life', '生活指南'),
]
AUDIT_STATUS_CHOICES = [
('pending', '待审核'),
('approved', '通过'),
('rejected', '拒绝'),
]
PUBLISH_STATUS_CHOICES = [
('draft', '未发布'),
('published', '已发布'),
]
title = models.CharField('标题', max_length=200)
content = models.TextField('内容')
region = models.ForeignKey(
'regions.Region',
on_delete=models.CASCADE,
related_name='articles',
verbose_name='所属区域'
)
content_type = models.CharField('内容类型', max_length=20, choices=CONTENT_TYPE_CHOICES)
author = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.CASCADE,
related_name='articles',
verbose_name='作者'
)
# 版主审核
moderator_reviewer = models.ForeignKey(
settings.AUTH_USER_MODEL,
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name='reviewed_articles',
verbose_name='版主审核人'
)
moderator_reviewed_at = models.DateTimeField('版主审核时间', null=True, blank=True)
moderator_status = models.CharField('版主审核状态', max_length=20, choices=AUDIT_STATUS_CHOICES, default='pending')
moderator_comment = models.TextField('版主审核意见', blank=True)
# AI 审核
ai_status = models.CharField('AI 审核状态', max_length=20, choices=AUDIT_STATUS_CHOICES, default='pending')
ai_reviewed_at = models.DateTimeField('AI 审核时间', null=True, blank=True)
ai_comment = models.TextField('AI 审核意见', blank=True)
# 发布状态
publish_status = models.CharField('发布状态', max_length=20, choices=PUBLISH_STATUS_CHOICES, default='draft')
created_at = models.DateTimeField('创建时间', auto_now_add=True)
updated_at = models.DateTimeField('更新时间', auto_now=True)
class Meta:
verbose_name = '文章'
verbose_name_plural = '文章'
ordering = ['-created_at']
def __str__(self):
return self.title
def submit_for_moderator_review(self):
"""提交版主审核"""
self.moderator_status = 'pending'
self.save()
def approve_by_moderator(self, moderator, comment=''):
"""版主审核通过"""
self.moderator_reviewer = moderator
self.moderator_status = 'approved'
self.moderator_comment = comment
self.moderator_reviewed_at = timezone.now()
self.save()
# 自动提交到 AI 审核
self.submit_for_ai_review()
def reject_by_moderator(self, moderator, comment=''):
"""版主审核拒绝"""
self.moderator_reviewer = moderator
self.moderator_status = 'rejected'
self.moderator_comment = comment
self.moderator_reviewed_at = timezone.now()
self.publish_status = 'draft'
self.save()
def submit_for_ai_review(self):
"""提交 AI 审核(版主通过后自动调用)"""
if self.moderator_status == 'approved':
self.ai_status = 'pending'
self.save()
def approve_by_ai(self, comment=''):
"""AI 审核通过"""
self.ai_status = 'approved'
self.ai_comment = comment
self.ai_reviewed_at = timezone.now()
self.publish_status = 'published'
self.save()
def reject_by_ai(self, comment=''):
"""AI 审核拒绝"""
self.ai_status = 'rejected'
self.ai_comment = comment
self.ai_reviewed_at = timezone.now()
self.publish_status = 'draft'
self.save()
class Comment(models.Model):
"""评论表"""
AUDIT_STATUS_CHOICES = [
('pending', '待审核'),
('approved', '通过'),
('rejected', '拒绝'),
]
content = models.TextField('评论内容')
article = models.ForeignKey(
Article,
on_delete=models.CASCADE,
related_name='comments',
verbose_name='文章',
null=True,
blank=True
)
service = models.ForeignKey(
'services.FeaturedService',
on_delete=models.CASCADE,
related_name='comments',
verbose_name='特色服务',
null=True,
blank=True
)
author = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.CASCADE,
related_name='comments',
verbose_name='评论者'
)
ai_status = models.CharField('AI 审核状态', max_length=20, choices=AUDIT_STATUS_CHOICES, default='pending')
ai_reviewed_at = models.DateTimeField('AI 审核时间', null=True, blank=True)
is_visible = models.BooleanField('是否显示', default=False)
created_at = models.DateTimeField('创建时间', auto_now_add=True)
class Meta:
verbose_name = '评论'
verbose_name_plural = '评论'
ordering = ['-created_at']
def __str__(self):
return f"{self.author.username} 的评论"
def approve_by_ai(self):
"""AI 审核通过"""
self.ai_status = 'approved'
self.ai_reviewed_at = timezone.now()
self.is_visible = True
self.save()
def reject_by_ai(self):
"""AI 审核拒绝"""
self.ai_status = 'rejected'
self.ai_reviewed_at = timezone.now()
self.is_visible = False
self.save()
class Like(models.Model):
"""点赞表"""
user = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.CASCADE,
related_name='likes'
)
article = models.ForeignKey(
Article,
on_delete=models.CASCADE,
related_name='likes',
null=True,
blank=True
)
service = models.ForeignKey(
'services.FeaturedService',
on_delete=models.CASCADE,
related_name='likes',
null=True,
blank=True
)
created_at = models.DateTimeField('创建时间', auto_now_add=True)
class Meta:
verbose_name = '点赞'
verbose_name_plural = '点赞'
unique_together = ['user', 'article', 'service']
def __str__(self):
return f"{self.user.username} 点赞"
class Rating(models.Model):
"""评分表"""
user = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.CASCADE,
related_name='ratings'
)
region = models.ForeignKey(
'regions.Region',
on_delete=models.CASCADE,
related_name='ratings',
null=True,
blank=True
)
service = models.ForeignKey(
'services.FeaturedService',
on_delete=models.CASCADE,
related_name='ratings',
null=True,
blank=True
)
score = models.PositiveSmallIntegerField('评分', choices=[(i, f'{i}') for i in range(1, 6)])
comment = models.TextField('评价', blank=True)
created_at = models.DateTimeField('创建时间', auto_now_add=True)
class Meta:
verbose_name = '评分'
verbose_name_plural = '评分'
unique_together = ['user', 'region', 'service']
def __str__(self):
return f"{self.user.username} 评分 {self.score}"
class Favorite(models.Model):
"""收藏表"""
user = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.CASCADE,
related_name='favorites'
)
region = models.ForeignKey(
'regions.Region',
on_delete=models.CASCADE,
related_name='favorited_by',
null=True,
blank=True
)
service = models.ForeignKey(
'services.FeaturedService',
on_delete=models.CASCADE,
related_name='favorited_by',
null=True,
blank=True
)
created_at = models.DateTimeField('创建时间', auto_now_add=True)
class Meta:
verbose_name = '收藏'
verbose_name_plural = '收藏'
unique_together = ['user', 'region', 'service']
def __str__(self):
return f"{self.user.username} 收藏"

View File

@@ -0,0 +1,65 @@
from rest_framework import serializers
from .models import Article, Comment, Like, Rating, Favorite
from users.serializers import UserSerializer
from regions.serializers import RegionSerializer
class ArticleSerializer(serializers.ModelSerializer):
author = UserSerializer(read_only=True)
region = RegionSerializer(read_only=True)
region_id = serializers.PrimaryKeyRelatedField(
queryset='regions.Region.objects.all()',
source='region',
write_only=True,
required=False
)
class Meta:
model = Article
fields = [
'id', 'title', 'content', 'region', 'region_id', 'content_type',
'author', 'moderator_status', 'ai_status', 'publish_status',
'created_at', 'updated_at'
]
read_only_fields = ['author', 'moderator_status', 'ai_status', 'publish_status', 'created_at', 'updated_at']
class CommentSerializer(serializers.ModelSerializer):
author = UserSerializer(read_only=True)
class Meta:
model = Comment
fields = [
'id', 'content', 'article', 'service', 'author',
'ai_status', 'is_visible', 'created_at'
]
read_only_fields = ['author', 'ai_status', 'is_visible', 'created_at']
class LikeSerializer(serializers.ModelSerializer):
user = UserSerializer(read_only=True)
class Meta:
model = Like
fields = ['id', 'user', 'article', 'service', 'created_at']
read_only_fields = ['user', 'created_at']
class RatingSerializer(serializers.ModelSerializer):
user = UserSerializer(read_only=True)
region = RegionSerializer(read_only=True)
class Meta:
model = Rating
fields = ['id', 'user', 'region', 'service', 'score', 'comment', 'created_at']
read_only_fields = ['user', 'created_at']
class FavoriteSerializer(serializers.ModelSerializer):
user = UserSerializer(read_only=True)
region = RegionSerializer(read_only=True)
class Meta:
model = Favorite
fields = ['id', 'user', 'region', 'service', 'created_at']
read_only_fields = ['user', 'created_at']

View File

@@ -0,0 +1,3 @@
from django.test import TestCase
# Create your tests here.

View File

@@ -0,0 +1,49 @@
from django.shortcuts import render
from rest_framework import viewsets, permissions, status
from rest_framework.response import Response
from rest_framework.decorators import action
from django.contrib.contenttypes.models import ContentType
from .models import Article, Comment, Like, Rating, Favorite
from .serializers import ArticleSerializer, CommentSerializer, RatingSerializer
class ArticleViewSet(viewsets.ModelViewSet):
queryset = Article.objects.filter(publish_status='published')
serializer_class = ArticleSerializer
permission_classes = [permissions.AllowAny]
def get_queryset(self):
queryset = Article.objects.all()
region_id = self.request.query_params.get('region')
content_type = self.request.query_params.get('type')
if region_id:
queryset = queryset.filter(region_id=region_id)
if content_type:
queryset = queryset.filter(content_type=content_type)
return queryset
def perform_create(self, serializer):
article = serializer.save(author=self.request.user)
article.submit_for_moderator_review()
class CommentViewSet(viewsets.ModelViewSet):
queryset = Comment.objects.filter(is_visible=True)
serializer_class = CommentSerializer
permission_classes = [permissions.AllowAny]
def perform_create(self, serializer):
comment = serializer.save(author=self.request.user)
# 提交 AI 审核
comment.save()
class RatingViewSet(viewsets.ModelViewSet):
queryset = Rating.objects.all()
serializer_class = RatingSerializer
permission_classes = [permissions.IsAuthenticatedOrReadOnly]
def perform_create(self, serializer):
serializer.save(user=self.request.user)