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

city-manual/backend/services/admin.py

@@ -0,0 +1,28 @@
+from django.contrib import admin
+from .models import FeaturedService
+
+
+@admin.register(FeaturedService)
+class FeaturedServiceAdmin(admin.ModelAdmin):
+    list_display = ['name', 'region', 'category', 'submitter', 'moderator_status', 'ai_status', 'publish_status', 'rating_average', 'created_at']
+    list_filter = ['category', 'moderator_status', 'ai_status', 'publish_status']
+    search_fields = ['name', 'description', 'submitter__username']
+    ordering = ['-created_at']
+    readonly_fields = ['moderator_reviewed_at', 'ai_reviewed_at', 'view_count', 'rating_average', 'rating_count']
+    
+    fieldsets = (
+        ('基本信息', {
+            'fields': ('name', 'description', 'region', 'category')
+        }),
+        ('详细信息', {
+            'fields': ('address', 'contact', 'website', 'price_range', 'opening_hours'),
+            'classes': ('collapse',)
+        }),
+        ('审核状态', {
+            'fields': ('submitter', 'moderator_reviewer', 'moderator_status', 'moderator_comment', 'moderator_reviewed_at', 'ai_status', 'ai_comment', 'ai_reviewed_at', 'publish_status')
+        }),
+        ('统计数据', {
+            'fields': ('view_count', 'rating_average', 'rating_count'),
+            'classes': ('collapse',)
+        }),
+    )

city-manual/backend/services/apps.py

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

city-manual/backend/services/migrations/0001_initial.py

@@ -0,0 +1,45 @@
+# 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='FeaturedService',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=200, verbose_name='服务名称')),
+                ('description', models.TextField(verbose_name='服务描述')),
+                ('category', models.CharField(choices=[('clothing', '衣'), ('food', '食'), ('housing', '住'), ('transportation', '行'), ('entertainment', '娱乐'), ('tourism', '旅游'), ('culture', '文化')], max_length=20, verbose_name='服务分类')),
+                ('address', models.CharField(blank=True, max_length=300, verbose_name='地址')),
+                ('contact', models.CharField(blank=True, max_length=100, verbose_name='联系方式')),
+                ('website', models.URLField(blank=True, verbose_name='网站')),
+                ('price_range', models.CharField(blank=True, max_length=50, verbose_name='价格区间')),
+                ('opening_hours', models.TextField(blank=True, 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='发布状态')),
+                ('view_count', models.PositiveIntegerField(default=0, verbose_name='浏览次数')),
+                ('rating_average', models.DecimalField(decimal_places=2, default=0, max_digits=3, verbose_name='平均评分')),
+                ('rating_count', models.PositiveIntegerField(default=0, 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'],
+            },
+        ),
+    ]

city-manual/backend/services/migrations/0002_initial.py

@@ -0,0 +1,34 @@
+# 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', '0002_initial'),
+        ('services', '0001_initial'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='featuredservice',
+            name='moderator_reviewer',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='reviewed_services', to=settings.AUTH_USER_MODEL, verbose_name='版主审核人'),
+        ),
+        migrations.AddField(
+            model_name='featuredservice',
+            name='region',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='featured_services', to='regions.region', verbose_name='所属区域'),
+        ),
+        migrations.AddField(
+            model_name='featuredservice',
+            name='submitter',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='submitted_services', to=settings.AUTH_USER_MODEL, verbose_name='提交者'),
+        ),
+    ]

city-manual/backend/services/models.py

@@ -0,0 +1,143 @@
+from django.db import models
+from django.conf import settings
+from django.utils import timezone
+
+
+class FeaturedService(models.Model):
+    """特色服务表"""
+    CATEGORY_CHOICES = [
+        ('clothing', '衣'),
+        ('food', '食'),
+        ('housing', '住'),
+        ('transportation', '行'),
+        ('entertainment', '娱乐'),
+        ('tourism', '旅游'),
+        ('culture', '文化'),
+    ]
+    
+    AUDIT_STATUS_CHOICES = [
+        ('pending', '待审核'),
+        ('approved', '通过'),
+        ('rejected', '拒绝'),
+    ]
+    
+    PUBLISH_STATUS_CHOICES = [
+        ('draft', '未发布'),
+        ('published', '已发布'),
+    ]
+    
+    name = models.CharField('服务名称', max_length=200)
+    description = models.TextField('服务描述')
+    region = models.ForeignKey(
+        'regions.Region',
+        on_delete=models.CASCADE,
+        related_name='featured_services',
+        verbose_name='所属区域'
+    )
+    category = models.CharField('服务分类', max_length=20, choices=CATEGORY_CHOICES)
+    
+    # 详细信息
+    address = models.CharField('地址', max_length=300, blank=True)
+    contact = models.CharField('联系方式', max_length=100, blank=True)
+    website = models.URLField('网站', blank=True)
+    price_range = models.CharField('价格区间', max_length=50, blank=True)
+    opening_hours = models.TextField('营业时间', blank=True)
+    
+    # 提交者
+    submitter = models.ForeignKey(
+        settings.AUTH_USER_MODEL,
+        on_delete=models.CASCADE,
+        related_name='submitted_services',
+        verbose_name='提交者'
+    )
+    
+    # 版主审核
+    moderator_reviewer = models.ForeignKey(
+        settings.AUTH_USER_MODEL,
+        null=True,
+        blank=True,
+        on_delete=models.SET_NULL,
+        related_name='reviewed_services',
+        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')
+    
+    # 统计数据
+    view_count = models.PositiveIntegerField('浏览次数', default=0)
+    rating_average = models.DecimalField('平均评分', max_digits=3, decimal_places=2, default=0)
+    rating_count = models.PositiveIntegerField('评分次数', default=0)
+    
+    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.name
+    
+    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()
+    
+    def update_rating(self):
+        """更新平均评分"""
+        ratings = self.ratings.all()
+        if ratings.exists():
+            self.rating_average = sum(r.score for r in ratings) / ratings.count()
+            self.rating_count = ratings.count()
+            self.save()

city-manual/backend/services/serializers.py

@@ -0,0 +1,34 @@
+from rest_framework import serializers
+from .models import FeaturedService
+from users.serializers import UserSerializer
+from regions.serializers import RegionSerializer
+
+
+class FeaturedServiceSerializer(serializers.ModelSerializer):
+    submitter = 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 = FeaturedService
+        fields = [
+            'id', 'name', 'description', 'region', 'region_id', 'category',
+            'address', 'contact', 'website', 'price_range', 'opening_hours',
+            'submitter', 'moderator_status', 'ai_status', 'publish_status',
+            'view_count', 'rating_average', 'rating_count',
+            'created_at', 'updated_at'
+        ]
+        read_only_fields = [
+            'submitter', 'moderator_status', 'ai_status', 'publish_status',
+            'view_count', 'rating_average', 'rating_count', 'created_at', 'updated_at'
+        ]
+    
+    def create(self, validated_data):
+        service = super().create(validated_data)
+        service.submit_for_moderator_review()
+        return service

city-manual/backend/services/tests.py

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

city-manual/backend/services/views.py

@@ -0,0 +1,25 @@
+from rest_framework import viewsets, permissions
+from .models import FeaturedService
+from .serializers import FeaturedServiceSerializer
+
+
+class FeaturedServiceViewSet(viewsets.ModelViewSet):
+    queryset = FeaturedService.objects.filter(publish_status='published')
+    serializer_class = FeaturedServiceSerializer
+    permission_classes = [permissions.AllowAny]
+    
+    def get_queryset(self):
+        queryset = FeaturedService.objects.all()
+        region_id = self.request.query_params.get('region')
+        category = self.request.query_params.get('category')
+        
+        if region_id:
+            queryset = queryset.filter(region_id=region_id)
+        if category:
+            queryset = queryset.filter(category=category)
+        
+        return queryset
+    
+    def perform_create(self, serializer):
+        service = serializer.save(submitter=self.request.user)
+        service.submit_for_moderator_review()