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

@@ -0,0 +1,3 @@
#!/bin/bash
cd /root/.openclaw/workspace/city-manual/backend
python3 manage.py check

View File

@@ -0,0 +1,16 @@
"""
ASGI config for city_manual project.
It exposes the ASGI callable as a module-level variable named ``application``.
For more information on this file, see
https://docs.djangoproject.com/en/4.2/howto/deployment/asgi/
"""
import os
from django.core.asgi import get_asgi_application
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'city_manual.settings')
application = get_asgi_application()

View File

@@ -0,0 +1,162 @@
"""
Django settings for city_manual project.
Generated by 'django-admin startproject' using Django 4.2.11.
For more information on this file, see
https://docs.djangoproject.com/en/4.2/topics/settings/
For the full list of settings and their values, see
https://docs.djangoproject.com/en/4.2/ref/settings/
"""
from pathlib import Path
# Build paths inside the project like this: BASE_DIR / 'subdir'.
BASE_DIR = Path(__file__).resolve().parent.parent
# Quick-start development settings - unsuitable for production
# See https://docs.djangoproject.com/en/4.2/howto/deployment/checklist/
# SECURITY WARNING: keep the secret key used in production secret!
SECRET_KEY = 'django-insecure-vvuexg2$gadudvj18-24xf3m$7f=8+ugtl&o@r_vgso)@#^$l2'
# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True
ALLOWED_HOSTS = ['*']
# Application definition
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
# 第三方应用
'rest_framework',
'corsheaders',
# 城市手册应用
'users',
'regions',
'content',
'services',
]
MIDDLEWARE = [
'django.middleware.security.SecurityMiddleware',
'corsheaders.middleware.CorsMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.common.CommonMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
'django.middleware.clickjacking.XFrameOptionsMiddleware',
]
ROOT_URLCONF = 'city_manual.urls'
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
},
]
WSGI_APPLICATION = 'city_manual.wsgi.application'
# Database
# https://docs.djangoproject.com/en/4.2/ref/settings/#databases
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': BASE_DIR / 'db.sqlite3',
}
}
# Password validation
# https://docs.djangoproject.com/en/4.2/ref/settings/#auth-password-validators
AUTH_PASSWORD_VALIDATORS = [
{
'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
},
{
'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
},
{
'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
},
{
'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
},
]
# Internationalization
# https://docs.djangoproject.com/en/4.2/topics/i18n/
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'UTC'
USE_I18N = True
USE_TZ = True
# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/4.2/howto/static-files/
STATIC_URL = 'static/'
# Default primary key field type
# https://docs.djangoproject.com/en/4.2/ref/settings/#default-auto-field
DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
# 自定义用户模型
AUTH_USER_MODEL = 'users.User'
# 媒体文件
import os
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
# REST Framework 配置
REST_FRAMEWORK = {
'DEFAULT_AUTHENTICATION_CLASSES': [
'rest_framework_simplejwt.authentication.JWTAuthentication',
],
'DEFAULT_PERMISSION_CLASSES': [
'rest_framework.permissions.AllowAny',
],
'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
'PAGE_SIZE': 20,
}
# CORS 配置
CORS_ALLOW_ALL_ORIGINS = True
# JWT 配置
from datetime import timedelta
SIMPLE_JWT = {
'ACCESS_TOKEN_LIFETIME': timedelta(days=1),
'REFRESH_TOKEN_LIFETIME': timedelta(days=7),
}

View File

@@ -0,0 +1,31 @@
from django.contrib import admin
from django.urls import path, include
from django.conf import settings
from django.conf.urls.static import static
from rest_framework.routers import DefaultRouter
from rest_framework_simplejwt.views import TokenObtainPairView, TokenRefreshView
from regions.views import RegionViewSet, ModeratorApplicationViewSet
from users.views import UserViewSet, UserRegistrationView
from content.views import ArticleViewSet, CommentViewSet, RatingViewSet
from services.views import FeaturedServiceViewSet
router = DefaultRouter()
router.register(r'regions', RegionViewSet)
router.register(r'moderator-applications', ModeratorApplicationViewSet)
router.register(r'users', UserViewSet)
router.register(r'articles', ArticleViewSet)
router.register(r'comments', CommentViewSet)
router.register(r'ratings', RatingViewSet)
router.register(r'services', FeaturedServiceViewSet)
urlpatterns = [
path('admin/', admin.site.urls),
path('api/token/', TokenObtainPairView.as_view(), name='token_obtain_pair'),
path('api/token/refresh/', TokenRefreshView.as_view(), name='token_refresh'),
path('api/register/', UserRegistrationView.as_view(), name='user_register'),
path('api/', include(router.urls)),
]
if settings.DEBUG:
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

View File

@@ -0,0 +1,16 @@
"""
WSGI config for city_manual project.
It exposes the WSGI callable as a module-level variable named ``application``.
For more information on this file, see
https://docs.djangoproject.com/en/4.2/howto/deployment/wsgi/
"""
import os
from django.core.wsgi import get_wsgi_application
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'city_manual.settings')
application = get_wsgi_application()

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)

Binary file not shown.

22
city-manual/backend/manage.py Executable file
View File

@@ -0,0 +1,22 @@
#!/usr/bin/env python3
"""Django's command-line utility for administrative tasks."""
import os
import sys
def main():
"""Run administrative tasks."""
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'city_manual.settings')
try:
from django.core.management import execute_from_command_line
except ImportError as exc:
raise ImportError(
"Couldn't import Django. Are you sure it's installed and "
"available on your PYTHONPATH environment variable? Did you "
"forget to activate a virtual environment?"
) from exc
execute_from_command_line(sys.argv)
if __name__ == '__main__':
main()

View File

@@ -0,0 +1,6 @@
#!/bin/bash
cd /root/.openclaw/workspace/city-manual/backend
python3 manage.py makemigrations
python3 manage.py migrate
python3 manage.py createsuperuser --noinput --username admin --email admin@citymanual.com || true
echo "Done!"

View File

View File

@@ -0,0 +1,41 @@
from django.contrib import admin
from .models import Region, ModeratorApplication, ModeratorPermission, ModeratorSupport, PermissionRestriction
@admin.register(Region)
class RegionAdmin(admin.ModelAdmin):
list_display = ['name', 'level', 'parent', 'is_active', 'created_at']
list_filter = ['level', 'is_active']
search_fields = ['name']
ordering = ['level', 'name']
@admin.register(ModeratorApplication)
class ModeratorApplicationAdmin(admin.ModelAdmin):
list_display = ['applicant', 'region', 'status', 'support_count', 'required_support', 'deadline', 'created_at']
list_filter = ['status', 'region']
search_fields = ['applicant__username', 'region__name']
ordering = ['-created_at']
@admin.register(ModeratorPermission)
class ModeratorPermissionAdmin(admin.ModelAdmin):
list_display = ['moderator', 'region', 'rank', 'status', 'created_at']
list_filter = ['rank', 'status']
search_fields = ['moderator__username', 'region__name']
ordering = ['-created_at']
@admin.register(ModeratorSupport)
class ModeratorSupportAdmin(admin.ModelAdmin):
list_display = ['supporter', 'application', 'created_at']
search_fields = ['supporter__username', 'application__region__name']
ordering = ['-created_at']
@admin.register(PermissionRestriction)
class PermissionRestrictionAdmin(admin.ModelAdmin):
list_display = ['restricted_moderator', 'restriction_type', 'operator', 'started_at', 'ended_at']
list_filter = ['restriction_type']
search_fields = ['restricted_moderator__username', 'operator__username']
ordering = ['-started_at']

View File

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

View File

@@ -0,0 +1,93 @@
# 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 = [
]
operations = [
migrations.CreateModel(
name='ModeratorApplication',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('application_reason', models.TextField(blank=True, verbose_name='申请理由')),
('support_count', models.PositiveIntegerField(default=0, verbose_name='支持人数')),
('required_support', models.PositiveIntegerField(default=10, verbose_name='所需支持人数')),
('deadline', models.DateTimeField(verbose_name='截止时间')),
('status', models.CharField(choices=[('pending', '待审核'), ('approved', '已通过'), ('rejected', '已拒绝'), ('cancelled', '已取消')], default='pending', max_length=20, verbose_name='状态')),
('reviewed_at', models.DateTimeField(blank=True, null=True, verbose_name='审核时间')),
('review_comment', models.TextField(blank=True, verbose_name='审核意见')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='申请时间')),
],
options={
'verbose_name': '版主申请',
'verbose_name_plural': '版主申请',
'ordering': ['-created_at'],
},
),
migrations.CreateModel(
name='ModeratorPermission',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('rank', models.CharField(choices=[('general', '将军'), ('colonel', '校官'), ('lieutenant', '尉官'), ('soldier', '士兵')], max_length=20, verbose_name='军衔')),
('status', models.CharField(choices=[('active', '正常'), ('restricted', '限制'), ('revoked', '取消')], default='active', max_length=20, verbose_name='状态')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='授权时间')),
('restricted_until', models.DateTimeField(blank=True, null=True, verbose_name='限制截止时间')),
],
options={
'verbose_name': '版主权限',
'verbose_name_plural': '版主权限',
},
),
migrations.CreateModel(
name='ModeratorSupport',
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='PermissionRestriction',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('restriction_type', models.CharField(choices=[('partial', '部分限制'), ('full', '完全限制')], max_length=20, verbose_name='限制类型')),
('started_at', models.DateTimeField(auto_now_add=True, verbose_name='限制开始时间')),
('ended_at', models.DateTimeField(blank=True, null=True, verbose_name='限制结束时间')),
('reason', models.TextField(blank=True, verbose_name='限制原因')),
],
options={
'verbose_name': '权限限制',
'verbose_name_plural': '权限限制',
'ordering': ['-started_at'],
},
),
migrations.CreateModel(
name='Region',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('name', models.CharField(max_length=100, verbose_name='名称')),
('level', models.CharField(choices=[('province', '省级'), ('city', '市级'), ('county', '县级'), ('town', '镇级'), ('village', '村级')], max_length=20, verbose_name='级别')),
('code', models.CharField(blank=True, max_length=20, verbose_name='行政区划代码')),
('description', models.TextField(blank=True, verbose_name='描述')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')),
('is_active', models.BooleanField(default=True, verbose_name='是否启用')),
('parent', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='children', to='regions.region', verbose_name='上级区域')),
],
options={
'verbose_name': '区域',
'verbose_name_plural': '区域',
'ordering': ['level', 'name'],
},
),
]

View File

@@ -0,0 +1,71 @@
# 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'),
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
]
operations = [
migrations.AddField(
model_name='permissionrestriction',
name='operator',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='permission_restrictions_made', to=settings.AUTH_USER_MODEL, verbose_name='操作者'),
),
migrations.AddField(
model_name='permissionrestriction',
name='restricted_moderator',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='permission_restrictions', to=settings.AUTH_USER_MODEL, verbose_name='被限制版主'),
),
migrations.AddField(
model_name='moderatorsupport',
name='application',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='supports', to='regions.moderatorapplication', verbose_name='申请'),
),
migrations.AddField(
model_name='moderatorsupport',
name='supporter',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='moderator_supports', to=settings.AUTH_USER_MODEL, verbose_name='支持者'),
),
migrations.AddField(
model_name='moderatorpermission',
name='moderator',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='moderator_permissions', to=settings.AUTH_USER_MODEL, verbose_name='版主'),
),
migrations.AddField(
model_name='moderatorpermission',
name='region',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='moderator_permissions', to='regions.region', verbose_name='管辖区域'),
),
migrations.AddField(
model_name='moderatorapplication',
name='applicant',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='moderator_applications', to=settings.AUTH_USER_MODEL, verbose_name='申请者'),
),
migrations.AddField(
model_name='moderatorapplication',
name='region',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='moderator_applications', to='regions.region', verbose_name='申请区域'),
),
migrations.AddField(
model_name='moderatorapplication',
name='reviewer',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='reviewed_applications', to=settings.AUTH_USER_MODEL, verbose_name='审核人'),
),
migrations.AlterUniqueTogether(
name='moderatorsupport',
unique_together={('supporter', 'application')},
),
migrations.AlterUniqueTogether(
name='moderatorpermission',
unique_together={('moderator', 'region')},
),
]

View File

@@ -0,0 +1,214 @@
from django.db import models
from django.utils import timezone
class Region(models.Model):
"""版块/区域表 - 省市区乡镇村层级结构"""
LEVEL_CHOICES = [
('province', '省级'),
('city', '市级'),
('county', '县级'),
('town', '镇级'),
('village', '村级'),
]
name = models.CharField('名称', max_length=100)
level = models.CharField('级别', max_length=20, choices=LEVEL_CHOICES)
parent = models.ForeignKey(
'self',
null=True,
blank=True,
on_delete=models.CASCADE,
related_name='children',
verbose_name='上级区域'
)
code = models.CharField('行政区划代码', max_length=20, blank=True)
description = models.TextField('描述', blank=True)
created_at = models.DateTimeField('创建时间', auto_now_add=True)
updated_at = models.DateTimeField('更新时间', auto_now=True)
is_active = models.BooleanField('是否启用', default=True)
class Meta:
verbose_name = '区域'
verbose_name_plural = '区域'
ordering = ['level', 'name']
def __str__(self):
return f"{self.name} ({self.get_level_display()})"
def get_full_path(self):
"""获取完整路径"""
path = [self.name]
current = self.parent
while current:
path.append(current.name)
current = current.parent
return ' > '.join(reversed(path))
class ModeratorApplication(models.Model):
"""版主申请表"""
STATUS_CHOICES = [
('pending', '待审核'),
('approved', '已通过'),
('rejected', '已拒绝'),
('cancelled', '已取消'),
]
applicant = models.ForeignKey(
'users.User',
on_delete=models.CASCADE,
related_name='moderator_applications',
verbose_name='申请者'
)
region = models.ForeignKey(
Region,
on_delete=models.CASCADE,
related_name='moderator_applications',
verbose_name='申请区域'
)
application_reason = models.TextField('申请理由', blank=True)
support_count = models.PositiveIntegerField('支持人数', default=0)
required_support = models.PositiveIntegerField('所需支持人数', default=10)
deadline = models.DateTimeField('截止时间')
status = models.CharField('状态', max_length=20, choices=STATUS_CHOICES, default='pending')
reviewer = models.ForeignKey(
'users.User',
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name='reviewed_applications',
verbose_name='审核人'
)
reviewed_at = models.DateTimeField('审核时间', null=True, blank=True)
review_comment = models.TextField('审核意见', blank=True)
created_at = models.DateTimeField('申请时间', auto_now_add=True)
class Meta:
verbose_name = '版主申请'
verbose_name_plural = '版主申请'
ordering = ['-created_at']
def __str__(self):
return f"{self.applicant.username} 申请 {self.region.name} 版主"
def is_expired(self):
return timezone.now() > self.deadline
def auto_cancel_if_failed(self):
"""如果截止且支持人数不足,自动取消"""
if self.is_expired() and self.status == 'pending' and self.support_count < self.required_support:
self.status = 'cancelled'
self.save()
return True
return False
class ModeratorSupport(models.Model):
"""版主申请支持表"""
supporter = models.ForeignKey(
'users.User',
on_delete=models.CASCADE,
related_name='moderator_supports',
verbose_name='支持者'
)
application = models.ForeignKey(
ModeratorApplication,
on_delete=models.CASCADE,
related_name='supports',
verbose_name='申请'
)
created_at = models.DateTimeField('支持时间', auto_now_add=True)
class Meta:
verbose_name = '支持记录'
verbose_name_plural = '支持记录'
unique_together = ['supporter', 'application']
def __str__(self):
return f"{self.supporter.username} 支持 {self.application}"
class ModeratorPermission(models.Model):
"""版主权限表"""
RANK_CHOICES = [
('general', '将军'), # 省级
('colonel', '校官'), # 市级
('lieutenant', '尉官'), # 县级
('soldier', '士兵'), # 镇村级
]
STATUS_CHOICES = [
('active', '正常'),
('restricted', '限制'),
('revoked', '取消'),
]
moderator = models.ForeignKey(
'users.User',
on_delete=models.CASCADE,
related_name='moderator_permissions',
verbose_name='版主'
)
region = models.ForeignKey(
Region,
on_delete=models.CASCADE,
related_name='moderator_permissions',
verbose_name='管辖区域'
)
rank = models.CharField('军衔', max_length=20, choices=RANK_CHOICES)
status = models.CharField('状态', max_length=20, choices=STATUS_CHOICES, default='active')
created_at = models.DateTimeField('授权时间', auto_now_add=True)
restricted_until = models.DateTimeField('限制截止时间', null=True, blank=True)
class Meta:
verbose_name = '版主权限'
verbose_name_plural = '版主权限'
unique_together = ['moderator', 'region']
def __str__(self):
return f"{self.moderator.username} - {self.region.name} ({self.get_rank_display()})"
def can_moderate(self, content_region):
"""判断是否可以审核某个区域的内容"""
if self.status != 'active':
return False
# 检查是否在管辖范围内
current = content_region
while current:
if current.id == self.region.id:
return True
current = current.parent
return False
class PermissionRestriction(models.Model):
"""权限限制表"""
operator = models.ForeignKey(
'users.User',
on_delete=models.CASCADE,
related_name='permission_restrictions_made',
verbose_name='操作者'
)
restricted_moderator = models.ForeignKey(
'users.User',
on_delete=models.CASCADE,
related_name='permission_restrictions',
verbose_name='被限制版主'
)
restriction_type = models.CharField('限制类型', max_length=20, choices=[
('partial', '部分限制'),
('full', '完全限制'),
])
started_at = models.DateTimeField('限制开始时间', auto_now_add=True)
ended_at = models.DateTimeField('限制结束时间', null=True, blank=True)
reason = models.TextField('限制原因', blank=True)
class Meta:
verbose_name = '权限限制'
verbose_name_plural = '权限限制'
ordering = ['-started_at']
def __str__(self):
return f"{self.restricted_moderator.username} 被限制 ({self.restriction_type})"

View File

@@ -0,0 +1,63 @@
from rest_framework import serializers
from .models import Region, ModeratorApplication, ModeratorPermission
from users.serializers import UserSerializer
class RegionSerializer(serializers.ModelSerializer):
parent = serializers.PrimaryKeyRelatedField(read_only=True)
children_count = serializers.SerializerMethodField()
class Meta:
model = Region
fields = [
'id', 'name', 'level', 'parent', 'code', 'description',
'is_active', 'created_at', 'children_count'
]
read_only_fields = ['created_at']
def get_children_count(self, obj):
return obj.children.count()
class RegionDetailSerializer(serializers.ModelSerializer):
parent = RegionSerializer(read_only=True)
children = RegionSerializer(many=True, read_only=True)
articles_count = serializers.SerializerMethodField()
services_count = serializers.SerializerMethodField()
class Meta:
model = Region
fields = [
'id', 'name', 'level', 'parent', 'children', 'code', 'description',
'is_active', 'created_at', 'articles_count', 'services_count'
]
def get_articles_count(self, obj):
return obj.articles.filter(publish_status='published').count()
def get_services_count(self, obj):
return obj.featured_services.filter(publish_status='published').count()
class ModeratorApplicationSerializer(serializers.ModelSerializer):
applicant = UserSerializer(read_only=True)
region = RegionSerializer(read_only=True)
class Meta:
model = ModeratorApplication
fields = [
'id', 'applicant', 'region', 'application_reason',
'support_count', 'required_support', 'deadline',
'status', 'created_at'
]
read_only_fields = ['applicant', 'support_count', 'status', 'created_at']
class ModeratorPermissionSerializer(serializers.ModelSerializer):
moderator = UserSerializer(read_only=True)
region = RegionSerializer(read_only=True)
class Meta:
model = ModeratorPermission
fields = ['id', 'moderator', 'region', 'rank', 'status', 'created_at']
read_only_fields = ['created_at']

View File

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

View File

@@ -0,0 +1,107 @@
from rest_framework import viewsets, permissions, status
from rest_framework.response import Response
from rest_framework.decorators import action
from django.utils import timezone
from .models import Region, ModeratorApplication, ModeratorPermission, ModeratorSupport
from .serializers import RegionSerializer, RegionDetailSerializer, ModeratorApplicationSerializer, ModeratorPermissionSerializer
class RegionViewSet(viewsets.ModelViewSet):
queryset = Region.objects.filter(is_active=True)
serializer_class = RegionSerializer
permission_classes = [permissions.AllowAny]
def get_serializer_class(self):
if self.action == 'retrieve':
return RegionDetailSerializer
return RegionSerializer
@action(detail=False, methods=['get'])
def provinces(self, request):
provinces = Region.objects.filter(level='province', is_active=True)
serializer = self.get_serializer(provinces, many=True)
return Response(serializer.data)
@action(detail=True, methods=['get'])
def children(self, request, pk=None):
region = self.get_object()
children = region.children.filter(is_active=True)
serializer = self.get_serializer(children, many=True)
return Response(serializer.data)
class ModeratorApplicationViewSet(viewsets.ModelViewSet):
queryset = ModeratorApplication.objects.all()
serializer_class = ModeratorApplicationSerializer
permission_classes = [permissions.IsAuthenticatedOrReadOnly]
def perform_create(self, serializer):
application = serializer.save(applicant=self.request.user)
# 设置默认截止时间为 7 天后
application.deadline = timezone.now() + timezone.timedelta(days=7)
application.save()
@action(detail=True, methods=['post'])
def support(self, request, pk=None):
application = self.get_object()
user = request.user
# 检查是否已经支持过
if ModeratorSupport.objects.filter(supporter=user, application=application).exists():
return Response({'detail': '已经支持过该申请'}, status=status.HTTP_400_BAD_REQUEST)
# 创建支持记录
ModeratorSupport.objects.create(supporter=user, application=application)
application.support_count += 1
application.save()
return Response({'support_count': application.support_count})
@action(detail=True, methods=['post'])
def approve(self, request, pk=None):
application = self.get_object()
user = request.user
# 检查权限
if not user.is_staff:
return Response({'detail': '没有权限'}, status=status.HTTP_403_FORBIDDEN)
application.status = 'approved'
application.reviewer = user
application.reviewed_at = timezone.now()
application.save()
# 创建版主权限
ModeratorPermission.objects.create(
moderator=application.applicant,
region=application.region,
rank=self._get_rank_by_level(application.region.level)
)
return Response({'detail': '申请已批准'})
@action(detail=True, methods=['post'])
def reject(self, request, pk=None):
application = self.get_object()
user = request.user
if not user.is_staff:
return Response({'detail': '没有权限'}, status=status.HTTP_403_FORBIDDEN)
application.status = 'rejected'
application.reviewer = user
application.reviewed_at = timezone.now()
application.review_comment = request.data.get('comment', '')
application.save()
return Response({'detail': '申请已拒绝'})
def _get_rank_by_level(self, level):
rank_map = {
'province': 'general',
'city': 'colonel',
'county': 'lieutenant',
'town': 'soldier',
'village': 'soldier',
}
return rank_map.get(level, 'soldier')

View File

@@ -0,0 +1,5 @@
Django>=4.2
djangorestframework
djangorestframework-simplejwt
django-cors-headers
Pillow

View File

@@ -0,0 +1,3 @@
#!/bin/bash
cd /root/.openclaw/workspace/city-manual/backend
python3 manage.py runserver 0.0.0.0:8000

View File

View File

@@ -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',)
}),
)

View File

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

View File

@@ -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'],
},
),
]

View File

@@ -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='提交者'),
),
]

View File

@@ -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()

View File

@@ -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

View File

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

View File

@@ -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()

View File

@@ -0,0 +1,7 @@
#!/bin/bash
cd /root/.openclaw/workspace/city-manual/backend
python3 manage.py startapp regions
python3 manage.py startapp users
python3 manage.py startapp content
python3 manage.py startapp services
ls -la

View File

View File

@@ -0,0 +1,17 @@
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
from .models import User
@admin.register(User)
class UserAdmin(BaseUserAdmin):
list_display = ['username', 'email', 'role', 'is_verified', 'created_at']
list_filter = ['role', 'is_verified', 'is_staff']
search_fields = ['username', 'email']
ordering = ['-created_at']
fieldsets = BaseUserAdmin.fieldsets + (
('额外信息', {
'fields': ('role', 'phone', 'avatar', 'bio', 'is_verified')
}),
)

View File

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

View File

@@ -0,0 +1,50 @@
# Generated by Django 4.2.11 on 2026-04-10 12:05
import django.contrib.auth.models
import django.contrib.auth.validators
from django.db import migrations, models
import django.utils.timezone
class Migration(migrations.Migration):
initial = True
dependencies = [
('auth', '0012_alter_user_first_name_max_length'),
]
operations = [
migrations.CreateModel(
name='User',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('password', models.CharField(max_length=128, verbose_name='password')),
('last_login', models.DateTimeField(blank=True, null=True, verbose_name='last login')),
('is_superuser', models.BooleanField(default=False, help_text='Designates that this user has all permissions without explicitly assigning them.', verbose_name='superuser status')),
('username', models.CharField(error_messages={'unique': 'A user with that username already exists.'}, help_text='Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.', max_length=150, unique=True, validators=[django.contrib.auth.validators.UnicodeUsernameValidator()], verbose_name='username')),
('first_name', models.CharField(blank=True, max_length=150, verbose_name='first name')),
('last_name', models.CharField(blank=True, max_length=150, verbose_name='last name')),
('is_staff', models.BooleanField(default=False, help_text='Designates whether the user can log into this admin site.', verbose_name='staff status')),
('is_active', models.BooleanField(default=True, help_text='Designates whether this user should be treated as active. Unselect this instead of deleting accounts.', verbose_name='active')),
('date_joined', models.DateTimeField(default=django.utils.timezone.now, verbose_name='date joined')),
('email', models.EmailField(blank=True, max_length=254, verbose_name='邮箱')),
('phone', models.CharField(blank=True, max_length=20, verbose_name='手机号')),
('avatar', models.ImageField(blank=True, null=True, upload_to='avatars/', verbose_name='头像')),
('role', models.CharField(choices=[('user', '普通用户'), ('moderator', '版主'), ('admin', '管理员')], default='user', max_length=20, verbose_name='角色')),
('bio', models.TextField(blank=True, verbose_name='个人简介')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')),
('is_verified', models.BooleanField(default=False, verbose_name='是否已验证')),
('groups', models.ManyToManyField(blank=True, help_text='The groups this user belongs to. A user will get all permissions granted to each of their groups.', related_name='user_set', related_query_name='user', to='auth.group', verbose_name='groups')),
('user_permissions', models.ManyToManyField(blank=True, help_text='Specific permissions for this user.', related_name='user_set', related_query_name='user', to='auth.permission', verbose_name='user permissions')),
],
options={
'verbose_name': '用户',
'verbose_name_plural': '用户',
},
managers=[
('objects', django.contrib.auth.models.UserManager()),
],
),
]

View File

@@ -0,0 +1,40 @@
from django.contrib.auth.models import AbstractUser
from django.db import models
class User(AbstractUser):
"""用户表 - 扩展 Django 内置用户模型"""
ROLE_CHOICES = [
('user', '普通用户'),
('moderator', '版主'),
('admin', '管理员'),
]
email = models.EmailField('邮箱', blank=True)
phone = models.CharField('手机号', max_length=20, blank=True)
avatar = models.ImageField('头像', upload_to='avatars/', blank=True, null=True)
role = models.CharField('角色', max_length=20, choices=ROLE_CHOICES, default='user')
bio = models.TextField('个人简介', blank=True)
created_at = models.DateTimeField('创建时间', auto_now_add=True)
updated_at = models.DateTimeField('更新时间', auto_now=True)
is_verified = models.BooleanField('是否已验证', default=False)
class Meta:
verbose_name = '用户'
verbose_name_plural = '用户'
def __str__(self):
return self.username
def is_moderator(self):
"""是否是版主"""
return self.role == 'moderator' or self.moderator_permissions.filter(status='active').exists()
def is_admin(self):
"""是否是管理员"""
return self.role == 'admin' or self.is_superuser
def get_moderator_regions(self):
"""获取管辖的区域列表"""
return [perm.region for perm in self.moderator_permissions.filter(status='active')]

View File

@@ -0,0 +1,30 @@
from rest_framework import serializers
from django.contrib.auth import get_user_model
from .models import User
class UserSerializer(serializers.ModelSerializer):
class Meta:
model = User
fields = [
'id', 'username', 'email', 'role', 'avatar', 'bio',
'is_verified', 'created_at'
]
read_only_fields = ['is_verified', 'created_at']
class UserRegistrationSerializer(serializers.ModelSerializer):
password = serializers.CharField(write_only=True, min_length=6)
class Meta:
model = User
fields = ['username', 'email', 'password', 'phone']
def create(self, validated_data):
user = User.objects.create_user(
username=validated_data['username'],
email=validated_data.get('email', ''),
password=validated_data['password'],
phone=validated_data.get('phone', '')
)
return user

View File

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

View File

@@ -0,0 +1,42 @@
from rest_framework import viewsets, permissions, status
from rest_framework.response import Response
from rest_framework.views import APIView
from rest_framework.decorators import action
from django.contrib.auth import get_user_model
from .models import User
from .serializers import UserSerializer, UserRegistrationSerializer
User = get_user_model()
class UserViewSet(viewsets.ModelViewSet):
queryset = User.objects.all()
serializer_class = UserSerializer
permission_classes = [permissions.AllowAny]
def get_queryset(self):
if self.action == 'retrieve':
return User.objects.all()
return User.objects.none()
@action(detail=False, methods=['get'])
def me(self, request):
if request.user.is_authenticated:
serializer = self.get_serializer(request.user)
return Response(serializer.data)
return Response({'detail': 'Not authenticated'}, status=status.HTTP_401_UNAUTHORIZED)
class UserRegistrationView(APIView):
permission_classes = [permissions.AllowAny]
def post(self, request):
serializer = UserRegistrationSerializer(data=request.data)
if serializer.is_valid():
user = serializer.save()
return Response({
'id': user.id,
'username': user.username,
'message': '用户创建成功'
}, status=status.HTTP_201_CREATED)
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)