init. 初始化项目，并初步完成前端模板样式
This commit is contained in:
@@ -0,0 +1,138 @@
|
||||
from django.contrib import admin
|
||||
from django.utils.html import format_html
|
||||
|
||||
from article.models import NoticeReceipt, Notice, Article, Carousel, Section
|
||||
from users.models import User
|
||||
|
||||
|
||||
# —————— 板块 ——————
|
||||
@admin.register(Section)
|
||||
class SectionAdmin(admin.ModelAdmin):
|
||||
list_display = ('display_name', 'code', 'parent', 'is_enabled', 'order')
|
||||
list_filter = ('parent', 'enabled')
|
||||
search_fields = ('name', 'code')
|
||||
ordering = ('order', 'name')
|
||||
list_editable = ('order',)
|
||||
fieldsets = (
|
||||
('基本信息', {
|
||||
'fields': ('name', 'code', 'parent', 'enabled', 'order')
|
||||
}),
|
||||
)
|
||||
|
||||
def display_name(self, obj):
|
||||
"""在列表中显示层级缩进"""
|
||||
if obj.is_sub:
|
||||
return f" └─ {obj.name}" # 使用全角空格+符号模拟缩进
|
||||
return obj.name
|
||||
display_name.short_description = '板块名称'
|
||||
display_name.admin_order_field = 'name'
|
||||
|
||||
def is_enabled(self, obj):
|
||||
return obj.enabled
|
||||
is_enabled.boolean = True
|
||||
is_enabled.short_description = '启用'
|
||||
|
||||
def formfield_for_foreignkey(self, db_field, request, **kwargs):
|
||||
"""限制 parent 只能选择主板块（无父级的板块）"""
|
||||
if db_field.name == "parent":
|
||||
kwargs["queryset"] = Section.objects.filter(parent__isnull=True)
|
||||
return super().formfield_for_foreignkey(db_field, request, **kwargs)
|
||||
|
||||
def get_queryset(self, request):
|
||||
"""优化查询，避免 N+1"""
|
||||
return super().get_queryset(request).select_related('parent')
|
||||
|
||||
|
||||
# —————— 轮播图 ——————
|
||||
@admin.register(Carousel)
|
||||
class CarouselAdmin(admin.ModelAdmin):
|
||||
list_display = ('title', 'image_thumb', 'link_url', 'order', 'active')
|
||||
list_editable = ('order', 'active')
|
||||
ordering = ('order',)
|
||||
|
||||
def image_thumb(self, obj):
|
||||
if obj.image:
|
||||
return format_html('<image src="{}" width="60" height="auto" />', obj.image.url)
|
||||
return "无图"
|
||||
image_thumb.short_description = "预览"
|
||||
|
||||
|
||||
# —————— 文章 ——————
|
||||
@admin.register(Article)
|
||||
class ArticleAdmin(admin.ModelAdmin):
|
||||
list_display = ('title', 'section', 'author', 'is_published', 'created_at')
|
||||
list_filter = ('section', 'is_published', 'created_at')
|
||||
search_fields = ('title', 'content')
|
||||
date_hierarchy = 'created_at'
|
||||
autocomplete_fields = ('author',) # 需要 UserAdmin 支持搜索
|
||||
|
||||
fieldsets = (
|
||||
('基本信息', {'fields': ('title', 'section', 'cover')}),
|
||||
('内容', {'fields': ('content',)}),
|
||||
('发布设置', {'fields': ('is_published',)}),
|
||||
)
|
||||
|
||||
|
||||
# —————— 通知（带签收） ——————
|
||||
@admin.register(Notice)
|
||||
class NoticeAdmin(admin.ModelAdmin):
|
||||
list_display = (
|
||||
'title',
|
||||
'publisher',
|
||||
'require_sign',
|
||||
'is_published',
|
||||
'signed_count',
|
||||
'total_target_users',
|
||||
'created_at'
|
||||
)
|
||||
list_filter = ('require_sign', 'is_published', 'created_at', 'target_departments')
|
||||
search_fields = ('title', 'content')
|
||||
filter_horizontal = ('target_departments',)
|
||||
readonly_fields = ('created_at', 'updated_at', 'publisher')
|
||||
date_hierarchy = 'created_at'
|
||||
|
||||
fieldsets = (
|
||||
('基本信息', {
|
||||
'fields': ('title', 'content', 'is_published')
|
||||
}),
|
||||
('签收设置', {
|
||||
'fields': ('require_sign', 'target_departments'),
|
||||
'description': '勾选“是否需要签收”后，可指定接收部门。未指定则默认全员可见但不可签收。'
|
||||
}),
|
||||
('时间信息', {
|
||||
'fields': ('created_at', 'updated_at'),
|
||||
'classes': ('collapse',)
|
||||
}),
|
||||
)
|
||||
|
||||
def save_model(self, request, obj, form, change):
|
||||
if not change:
|
||||
obj.publisher = request.user
|
||||
super().save_model(request, obj, form, change)
|
||||
|
||||
def signed_count(self, obj):
|
||||
return obj.receipts.count()
|
||||
signed_count.short_description = "已签收人数"
|
||||
|
||||
def total_target_users(self, obj):
|
||||
if obj.target_departments.exists():
|
||||
count = User.objects.filter(
|
||||
dept__in=obj.target_departments.all(),
|
||||
is_active=True
|
||||
).count()
|
||||
else:
|
||||
count = User.objects.filter(is_active=True).count()
|
||||
return count
|
||||
total_target_users.short_description = "应签收人数"
|
||||
|
||||
|
||||
# —————— 签收记录 ——————
|
||||
@admin.register(NoticeReceipt)
|
||||
class NoticeReceiptAdmin(admin.ModelAdmin):
|
||||
list_display = ('notice', 'user', 'signed_at')
|
||||
list_filter = ('signed_at', 'notice__title')
|
||||
search_fields = ('user__cname', 'user__username', 'notice__title')
|
||||
readonly_fields = ('notice', 'user', 'signed_at')
|
||||
|
||||
def has_add_permission(self, request):
|
||||
return False # 禁止手动添加
|
||||
@@ -0,0 +1,6 @@
|
||||
from django.apps import AppConfig
|
||||
|
||||
|
||||
class ArticleConfig(AppConfig):
|
||||
name = 'article'
|
||||
verbose_name = '文章管理'
|
||||
@@ -0,0 +1,88 @@
|
||||
# Generated by Django 6.0.3 on 2026-03-24 10:31
|
||||
|
||||
import django_ckeditor_5.fields
|
||||
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', django_ckeditor_5.fields.CKEditor5Field(verbose_name='正文')),
|
||||
('cover', models.ImageField(blank=True, upload_to='articles/', verbose_name='封面图')),
|
||||
('is_published', models.BooleanField(default=True, 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': '文章管理',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='Carousel',
|
||||
fields=[
|
||||
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
|
||||
('title', models.CharField(max_length=100, verbose_name='轮播标题')),
|
||||
('image', models.ImageField(upload_to='carousel/', verbose_name='图片')),
|
||||
('link_url', models.URLField(blank=True, verbose_name='跳转链接')),
|
||||
('order', models.IntegerField(default=0, verbose_name='排序')),
|
||||
('active', models.BooleanField(default=True, verbose_name='启用')),
|
||||
],
|
||||
options={
|
||||
'verbose_name': '轮播图',
|
||||
'verbose_name_plural': '轮播管理',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='Notice',
|
||||
fields=[
|
||||
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
|
||||
('title', models.CharField(max_length=200, verbose_name='通知标题')),
|
||||
('content', django_ckeditor_5.fields.CKEditor5Field(verbose_name='通知内容')),
|
||||
('require_sign', models.BooleanField(default=False, verbose_name='是否需要签收')),
|
||||
('is_published', models.BooleanField(default=True, 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': '通知管理',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='NoticeReceipt',
|
||||
fields=[
|
||||
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
|
||||
('signed_at', models.DateTimeField(auto_now_add=True, verbose_name='签收时间')),
|
||||
],
|
||||
options={
|
||||
'verbose_name': '签收记录',
|
||||
'verbose_name_plural': '签收管理',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='Section',
|
||||
fields=[
|
||||
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
|
||||
('name', models.CharField(max_length=50, unique=True, verbose_name='板块名称')),
|
||||
('code', models.SlugField(help_text='用于模板识别，如 news, notice', unique=True, verbose_name='板块代码')),
|
||||
('description', models.TextField(blank=True, verbose_name='描述')),
|
||||
('order', models.IntegerField(default=0, verbose_name='排序')),
|
||||
('enabled', models.BooleanField(default=True, verbose_name='启用')),
|
||||
],
|
||||
options={
|
||||
'verbose_name': '板块',
|
||||
'verbose_name_plural': '板块管理',
|
||||
},
|
||||
),
|
||||
]
|
||||
@@ -0,0 +1,53 @@
|
||||
# Generated by Django 6.0.3 on 2026-03-24 10:31
|
||||
|
||||
import django.db.models.deletion
|
||||
from django.conf import settings
|
||||
from django.db import migrations, models
|
||||
|
||||
|
||||
class Migration(migrations.Migration):
|
||||
|
||||
initial = True
|
||||
|
||||
dependencies = [
|
||||
('article', '0001_initial'),
|
||||
('users', '0001_initial'),
|
||||
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
|
||||
]
|
||||
|
||||
operations = [
|
||||
migrations.AddField(
|
||||
model_name='article',
|
||||
name='author',
|
||||
field=models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, to=settings.AUTH_USER_MODEL, verbose_name='作者'),
|
||||
),
|
||||
migrations.AddField(
|
||||
model_name='notice',
|
||||
name='publisher',
|
||||
field=models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, to=settings.AUTH_USER_MODEL, verbose_name='发布人'),
|
||||
),
|
||||
migrations.AddField(
|
||||
model_name='notice',
|
||||
name='target_departments',
|
||||
field=models.ManyToManyField(blank=True, to='users.department', verbose_name='接收部门'),
|
||||
),
|
||||
migrations.AddField(
|
||||
model_name='noticereceipt',
|
||||
name='notice',
|
||||
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='receipts', to='article.notice'),
|
||||
),
|
||||
migrations.AddField(
|
||||
model_name='noticereceipt',
|
||||
name='user',
|
||||
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='签收人'),
|
||||
),
|
||||
migrations.AddField(
|
||||
model_name='article',
|
||||
name='section',
|
||||
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='article.section', verbose_name='所属板块'),
|
||||
),
|
||||
migrations.AlterUniqueTogether(
|
||||
name='noticereceipt',
|
||||
unique_together={('notice', 'user')},
|
||||
),
|
||||
]
|
||||
@@ -0,0 +1,47 @@
|
||||
# Generated by Django 6.0.3 on 2026-03-24 13:24
|
||||
|
||||
import django.db.models.deletion
|
||||
from django.db import migrations, models
|
||||
|
||||
|
||||
class Migration(migrations.Migration):
|
||||
|
||||
dependencies = [
|
||||
('article', '0002_initial'),
|
||||
]
|
||||
|
||||
operations = [
|
||||
migrations.AlterModelOptions(
|
||||
name='section',
|
||||
options={'ordering': ('order', 'name'), 'verbose_name': '板块', 'verbose_name_plural': '板块管理'},
|
||||
),
|
||||
migrations.RemoveField(
|
||||
model_name='section',
|
||||
name='description',
|
||||
),
|
||||
migrations.AddField(
|
||||
model_name='section',
|
||||
name='parent',
|
||||
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='subsections', to='article.section', verbose_name='所属主板块'),
|
||||
),
|
||||
migrations.AlterField(
|
||||
model_name='section',
|
||||
name='code',
|
||||
field=models.SlugField(help_text='用于模板或URL识别，建议英文', unique=True, verbose_name='唯一标识'),
|
||||
),
|
||||
migrations.AlterField(
|
||||
model_name='section',
|
||||
name='enabled',
|
||||
field=models.BooleanField(default=True, verbose_name='启用状态'),
|
||||
),
|
||||
migrations.AlterField(
|
||||
model_name='section',
|
||||
name='name',
|
||||
field=models.CharField(max_length=100, unique=True, verbose_name='板块名称'),
|
||||
),
|
||||
migrations.AlterField(
|
||||
model_name='section',
|
||||
name='order',
|
||||
field=models.PositiveSmallIntegerField(default=0, verbose_name='排序权重'),
|
||||
),
|
||||
]
|
||||
@@ -0,0 +1,116 @@
|
||||
from django.db import models
|
||||
from django_ckeditor_5.fields import CKEditor5Field
|
||||
|
||||
from users.models import User, Department
|
||||
|
||||
|
||||
# Create your models here.
|
||||
|
||||
from django.db import models
|
||||
from django.core.exceptions import ValidationError
|
||||
|
||||
class Section(models.Model):
|
||||
name = models.CharField('板块名称', max_length=100, unique=True)
|
||||
code = models.SlugField('唯一标识', max_length=50, unique=True, help_text='用于模板或URL识别，建议英文')
|
||||
parent = models.ForeignKey(
|
||||
'self',
|
||||
on_delete=models.CASCADE,
|
||||
null=True,
|
||||
blank=True,
|
||||
related_name='subsections',
|
||||
verbose_name='所属主板块'
|
||||
)
|
||||
order = models.PositiveSmallIntegerField('排序权重', default=0)
|
||||
enabled = models.BooleanField('启用状态', default=True)
|
||||
|
||||
class Meta:
|
||||
verbose_name = '板块'
|
||||
verbose_name_plural = '板块管理'
|
||||
ordering = ('order', 'name')
|
||||
|
||||
def __str__(self):
|
||||
if self.parent:
|
||||
return f"{self.parent.name} → {self.name}"
|
||||
return self.name
|
||||
|
||||
def clean(self):
|
||||
super().clean()
|
||||
# 禁止子板块再设父级（即最多两级）
|
||||
if self.parent and self.parent.parent:
|
||||
raise ValidationError('子板块不能再设置子级，最多只允许一级嵌套。')
|
||||
# 防止自引用
|
||||
if self.pk and self.parent and self.parent.pk == self.pk:
|
||||
raise ValidationError('板块不能以自身为父级。')
|
||||
|
||||
@property
|
||||
def is_sub(self):
|
||||
"""是否为子板块"""
|
||||
return self.parent is not None
|
||||
|
||||
@property
|
||||
def is_main(self):
|
||||
"""是否为主板块（无父级）"""
|
||||
return self.parent is None
|
||||
|
||||
|
||||
class Carousel(models.Model):
|
||||
title = models.CharField("轮播标题", max_length=100)
|
||||
image = models.ImageField("图片", upload_to='carousel/')
|
||||
link_url = models.URLField("跳转链接", blank=True)
|
||||
order = models.IntegerField("排序", default=0)
|
||||
active = models.BooleanField("启用", default=True)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "轮播图"
|
||||
verbose_name_plural = "轮播管理"
|
||||
|
||||
|
||||
class Article(models.Model):
|
||||
title = models.CharField("标题", max_length=200)
|
||||
section = models.ForeignKey(Section, on_delete=models.CASCADE, verbose_name="所属板块")
|
||||
author = models.ForeignKey(User, on_delete=models.SET_NULL, null=True, verbose_name="作者")
|
||||
content = CKEditor5Field("正文") # 需安装 django-ckeditor
|
||||
cover = models.ImageField("封面图", upload_to='articles/', blank=True)
|
||||
is_published = models.BooleanField("已发布", default=True)
|
||||
created_at = models.DateTimeField("创建时间", auto_now_add=True)
|
||||
updated_at = models.DateTimeField("更新时间", auto_now=True)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "文章"
|
||||
verbose_name_plural = "文章管理"
|
||||
|
||||
def __str__(self):
|
||||
return self.title
|
||||
|
||||
|
||||
class Notice(models.Model):
|
||||
title = models.CharField("通知标题", max_length=200)
|
||||
content = CKEditor5Field("通知内容")
|
||||
publisher = models.ForeignKey(User, on_delete=models.SET_NULL, null=True, verbose_name="发布人")
|
||||
target_departments = models.ManyToManyField(Department, blank=True, verbose_name="接收部门") # 可指定发给哪些部门
|
||||
require_sign = models.BooleanField("是否需要签收", default=False)
|
||||
is_published = models.BooleanField("已发布", default=True)
|
||||
created_at = models.DateTimeField("发布时间", auto_now_add=True)
|
||||
updated_at = models.DateTimeField("更新时间", auto_now=True)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "通知"
|
||||
verbose_name_plural = "通知管理"
|
||||
|
||||
def __str__(self):
|
||||
return self.title
|
||||
|
||||
|
||||
class NoticeReceipt(models.Model):
|
||||
"""签收记录"""
|
||||
notice = models.ForeignKey(Notice, on_delete=models.CASCADE, related_name='receipts')
|
||||
user = models.ForeignKey(User, on_delete=models.CASCADE, verbose_name="签收人")
|
||||
signed_at = models.DateTimeField("签收时间", auto_now_add=True)
|
||||
|
||||
class Meta:
|
||||
unique_together = ('notice', 'user') # 防止重复签收
|
||||
verbose_name = "签收记录"
|
||||
verbose_name_plural = "签收管理"
|
||||
|
||||
def __str__(self):
|
||||
return f"{self.user.cname} 已签收《{self.notice.title}》"
|
||||
@@ -0,0 +1,3 @@
|
||||
from django.test import TestCase
|
||||
|
||||
# Create your tests here.
|
||||
@@ -0,0 +1,20 @@
|
||||
from django.http import HttpResponseForbidden
|
||||
from django.shortcuts import render
|
||||
|
||||
from article.models import Article
|
||||
from utils.permission import user_has_permission
|
||||
|
||||
from ninja import Router
|
||||
|
||||
# Create your views here.
|
||||
|
||||
# Create your views here.
|
||||
router = Router(tags=['content'])
|
||||
|
||||
|
||||
@router.get('/article', description="获取文章列表")
|
||||
def article_list(request):
|
||||
if not user_has_permission(request.user, 'article', 'view'):
|
||||
return HttpResponseForbidden("无权访问")
|
||||
articles = Article.objects.all()
|
||||
return render(request, 'articles/list.html', {'articles': articles})
|
||||
Reference in New Issue
Block a user