初始提交:企业级日报系统完整代码
功能特性: - JWT用户认证系统 - 日报CRUD管理 - 三级权限控制 - 多维度搜索过滤 - 统计分析功能 - 评论互动系统 - 响应式Cool Admin界面 - 暗色主题支持 技术栈: - 后端:Django 4.2.7 + DRF + SimpleJWT - 前端:Vue 3 + Element Plus + Pinia - 数据库:SQLite/PostgreSQL - 部署:Docker + Nginx 包含内容: - 完整的后端API代码 - 现代化前端界面 - 数据库迁移文件 - 部署脚本和文档 - 演示页面和测试工具
This commit is contained in:
1
backend/daily_report/__init__.py
Normal file
1
backend/daily_report/__init__.py
Normal file
@@ -0,0 +1 @@
|
||||
# 日报管理应用
|
96
backend/daily_report/admin.py
Normal file
96
backend/daily_report/admin.py
Normal file
@@ -0,0 +1,96 @@
|
||||
from django.contrib import admin
|
||||
from django.utils.html import format_html
|
||||
from .models import DailyReport, ReportComment
|
||||
|
||||
|
||||
@admin.register(DailyReport)
|
||||
class DailyReportAdmin(admin.ModelAdmin):
|
||||
"""日报管理"""
|
||||
list_display = (
|
||||
'id', 'user_info', 'report_date', 'work_summary_short',
|
||||
'next_day_plan_short', 'is_draft', 'created_at'
|
||||
)
|
||||
list_filter = ('is_draft', 'report_date', 'created_at')
|
||||
search_fields = ('user__username', 'user__first_name', 'user__last_name',
|
||||
'work_summary', 'next_day_plan')
|
||||
date_hierarchy = 'report_date'
|
||||
ordering = ('-report_date', '-created_at')
|
||||
readonly_fields = ('created_at', 'updated_at')
|
||||
|
||||
fieldsets = (
|
||||
('基本信息', {
|
||||
'fields': ('user', 'report_date', 'is_draft')
|
||||
}),
|
||||
('日报内容', {
|
||||
'fields': ('work_summary', 'next_day_plan', 'difficulties', 'suggestions')
|
||||
}),
|
||||
('时间信息', {
|
||||
'fields': ('created_at', 'updated_at'),
|
||||
'classes': ('collapse',)
|
||||
}),
|
||||
)
|
||||
|
||||
def user_info(self, obj):
|
||||
"""显示用户信息"""
|
||||
return format_html(
|
||||
'<strong>{}</strong><br><small>{} | {}</small>',
|
||||
obj.user.username,
|
||||
obj.user.department or '未设置部门',
|
||||
obj.user.position or '未设置职位'
|
||||
)
|
||||
user_info.short_description = '用户信息'
|
||||
|
||||
def work_summary_short(self, obj):
|
||||
"""工作总结简短显示"""
|
||||
return obj.work_summary[:50] + '...' if len(obj.work_summary) > 50 else obj.work_summary
|
||||
work_summary_short.short_description = '工作总结'
|
||||
|
||||
def next_day_plan_short(self, obj):
|
||||
"""明日计划简短显示"""
|
||||
return obj.next_day_plan[:50] + '...' if len(obj.next_day_plan) > 50 else obj.next_day_plan
|
||||
next_day_plan_short.short_description = '明日计划'
|
||||
|
||||
def get_queryset(self, request):
|
||||
"""优化查询"""
|
||||
return super().get_queryset(request).select_related('user')
|
||||
|
||||
|
||||
@admin.register(ReportComment)
|
||||
class ReportCommentAdmin(admin.ModelAdmin):
|
||||
"""日报评论管理"""
|
||||
list_display = ('id', 'report_info', 'user', 'content_short', 'created_at')
|
||||
list_filter = ('created_at', 'user')
|
||||
search_fields = ('user__username', 'content', 'report__user__username')
|
||||
ordering = ('-created_at',)
|
||||
readonly_fields = ('created_at', 'updated_at')
|
||||
|
||||
fieldsets = (
|
||||
('基本信息', {
|
||||
'fields': ('report', 'user')
|
||||
}),
|
||||
('评论内容', {
|
||||
'fields': ('content',)
|
||||
}),
|
||||
('时间信息', {
|
||||
'fields': ('created_at', 'updated_at'),
|
||||
'classes': ('collapse',)
|
||||
}),
|
||||
)
|
||||
|
||||
def report_info(self, obj):
|
||||
"""显示日报信息"""
|
||||
return format_html(
|
||||
'<strong>{}</strong><br><small>{}</small>',
|
||||
f'{obj.report.user.username} - {obj.report.report_date}',
|
||||
obj.report.work_summary[:30] + '...' if len(obj.report.work_summary) > 30 else obj.report.work_summary
|
||||
)
|
||||
report_info.short_description = '关联日报'
|
||||
|
||||
def content_short(self, obj):
|
||||
"""评论内容简短显示"""
|
||||
return obj.content[:50] + '...' if len(obj.content) > 50 else obj.content
|
||||
content_short.short_description = '评论内容'
|
||||
|
||||
def get_queryset(self, request):
|
||||
"""优化查询"""
|
||||
return super().get_queryset(request).select_related('user', 'report__user')
|
7
backend/daily_report/apps.py
Normal file
7
backend/daily_report/apps.py
Normal file
@@ -0,0 +1,7 @@
|
||||
from django.apps import AppConfig
|
||||
|
||||
|
||||
class DailyReportConfig(AppConfig):
|
||||
default_auto_field = 'django.db.models.BigAutoField'
|
||||
name = 'daily_report'
|
||||
verbose_name = '日报管理'
|
104
backend/daily_report/filters.py
Normal file
104
backend/daily_report/filters.py
Normal file
@@ -0,0 +1,104 @@
|
||||
import django_filters
|
||||
from django.contrib.auth import get_user_model
|
||||
from django.db import models
|
||||
from .models import DailyReport
|
||||
|
||||
User = get_user_model()
|
||||
|
||||
|
||||
class DailyReportFilter(django_filters.FilterSet):
|
||||
"""日报过滤器"""
|
||||
|
||||
# 日期范围过滤
|
||||
report_date_start = django_filters.DateFilter(
|
||||
field_name='report_date',
|
||||
lookup_expr='gte',
|
||||
label='开始日期'
|
||||
)
|
||||
report_date_end = django_filters.DateFilter(
|
||||
field_name='report_date',
|
||||
lookup_expr='lte',
|
||||
label='结束日期'
|
||||
)
|
||||
|
||||
# 用户过滤(仅管理员可用)
|
||||
user = django_filters.ModelChoiceFilter(
|
||||
queryset=User.objects.filter(is_active=True),
|
||||
label='提交人'
|
||||
)
|
||||
|
||||
# 用户名搜索
|
||||
user_username = django_filters.CharFilter(
|
||||
field_name='user__username',
|
||||
lookup_expr='icontains',
|
||||
label='用户名'
|
||||
)
|
||||
|
||||
# 姓名搜索
|
||||
user_name = django_filters.CharFilter(
|
||||
method='filter_user_name',
|
||||
label='姓名'
|
||||
)
|
||||
|
||||
# 部门过滤
|
||||
department = django_filters.CharFilter(
|
||||
field_name='user__department',
|
||||
lookup_expr='icontains',
|
||||
label='部门'
|
||||
)
|
||||
|
||||
# 工作总结搜索
|
||||
work_summary = django_filters.CharFilter(
|
||||
field_name='work_summary',
|
||||
lookup_expr='icontains',
|
||||
label='工作总结'
|
||||
)
|
||||
|
||||
# 明日计划搜索
|
||||
next_day_plan = django_filters.CharFilter(
|
||||
field_name='next_day_plan',
|
||||
lookup_expr='icontains',
|
||||
label='明日计划'
|
||||
)
|
||||
|
||||
# 草稿状态过滤
|
||||
is_draft = django_filters.BooleanFilter(
|
||||
field_name='is_draft',
|
||||
label='草稿状态'
|
||||
)
|
||||
|
||||
# 年月过滤
|
||||
year = django_filters.NumberFilter(
|
||||
field_name='report_date__year',
|
||||
label='年份'
|
||||
)
|
||||
month = django_filters.NumberFilter(
|
||||
field_name='report_date__month',
|
||||
label='月份'
|
||||
)
|
||||
|
||||
class Meta:
|
||||
model = DailyReport
|
||||
fields = []
|
||||
|
||||
def filter_user_name(self, queryset, name, value):
|
||||
"""按用户姓名过滤"""
|
||||
if not value:
|
||||
return queryset
|
||||
|
||||
return queryset.filter(
|
||||
models.Q(user__first_name__icontains=value) |
|
||||
models.Q(user__last_name__icontains=value) |
|
||||
models.Q(user__username__icontains=value)
|
||||
)
|
||||
|
||||
def __init__(self, *args, **kwargs):
|
||||
request = kwargs.pop('request', None)
|
||||
super().__init__(*args, **kwargs)
|
||||
|
||||
# 如果不是管理员,移除用户相关的过滤字段
|
||||
if request and not request.user.is_staff:
|
||||
self.filters.pop('user', None)
|
||||
self.filters.pop('user_username', None)
|
||||
self.filters.pop('user_name', None)
|
||||
self.filters.pop('department', None)
|
70
backend/daily_report/migrations/0001_initial.py
Normal file
70
backend/daily_report/migrations/0001_initial.py
Normal file
@@ -0,0 +1,70 @@
|
||||
# Generated by Django 4.2.7 on 2025-09-13 05:47
|
||||
|
||||
from django.conf import settings
|
||||
import django.core.validators
|
||||
from django.db import migrations, models
|
||||
import django.db.models.deletion
|
||||
|
||||
|
||||
class Migration(migrations.Migration):
|
||||
|
||||
initial = True
|
||||
|
||||
dependencies = [
|
||||
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
|
||||
]
|
||||
|
||||
operations = [
|
||||
migrations.CreateModel(
|
||||
name='DailyReport',
|
||||
fields=[
|
||||
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
|
||||
('work_summary', models.TextField(validators=[django.core.validators.MinLengthValidator(10, message='工作总结至少需要10个字符')], verbose_name='工作总结')),
|
||||
('next_day_plan', models.TextField(validators=[django.core.validators.MinLengthValidator(10, message='明日计划至少需要10个字符')], verbose_name='明日计划')),
|
||||
('difficulties', models.TextField(blank=True, help_text='可选:描述工作中遇到的问题或困难', null=True, verbose_name='遇到的困难')),
|
||||
('suggestions', models.TextField(blank=True, help_text='可选:对工作或团队的建议', null=True, verbose_name='建议或意见')),
|
||||
('report_date', models.DateField(help_text='填写日报对应的日期', verbose_name='日报日期')),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='提交时间')),
|
||||
('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')),
|
||||
('is_draft', models.BooleanField(default=False, help_text='是否为草稿', verbose_name='草稿状态')),
|
||||
('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='daily_reports', to=settings.AUTH_USER_MODEL, verbose_name='提交人')),
|
||||
],
|
||||
options={
|
||||
'verbose_name': '日报',
|
||||
'verbose_name_plural': '日报',
|
||||
'ordering': ['-report_date', '-created_at'],
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='ReportComment',
|
||||
fields=[
|
||||
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
|
||||
('content', models.TextField(verbose_name='评论内容')),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='评论时间')),
|
||||
('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')),
|
||||
('report', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='comments', to='daily_report.dailyreport', verbose_name='关联日报')),
|
||||
('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='评论人')),
|
||||
],
|
||||
options={
|
||||
'verbose_name': '日报评论',
|
||||
'verbose_name_plural': '日报评论',
|
||||
'ordering': ['-created_at'],
|
||||
},
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='dailyreport',
|
||||
index=models.Index(fields=['user', 'report_date'], name='daily_repor_user_id_f18440_idx'),
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='dailyreport',
|
||||
index=models.Index(fields=['report_date'], name='daily_repor_report__ee6559_idx'),
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='dailyreport',
|
||||
index=models.Index(fields=['-created_at'], name='daily_repor_created_005929_idx'),
|
||||
),
|
||||
migrations.AlterUniqueTogether(
|
||||
name='dailyreport',
|
||||
unique_together={('user', 'report_date')},
|
||||
),
|
||||
]
|
0
backend/daily_report/migrations/__init__.py
Normal file
0
backend/daily_report/migrations/__init__.py
Normal file
89
backend/daily_report/models.py
Normal file
89
backend/daily_report/models.py
Normal file
@@ -0,0 +1,89 @@
|
||||
from django.db import models
|
||||
from django.contrib.auth import get_user_model
|
||||
from django.core.validators import MinLengthValidator
|
||||
|
||||
User = get_user_model()
|
||||
|
||||
|
||||
class DailyReport(models.Model):
|
||||
"""日报模型"""
|
||||
user = models.ForeignKey(
|
||||
User,
|
||||
on_delete=models.CASCADE,
|
||||
verbose_name="提交人",
|
||||
related_name='daily_reports'
|
||||
)
|
||||
work_summary = models.TextField(
|
||||
"工作总结",
|
||||
validators=[MinLengthValidator(10, message="工作总结至少需要10个字符")]
|
||||
)
|
||||
next_day_plan = models.TextField(
|
||||
"明日计划",
|
||||
validators=[MinLengthValidator(10, message="明日计划至少需要10个字符")]
|
||||
)
|
||||
difficulties = models.TextField(
|
||||
"遇到的困难",
|
||||
blank=True,
|
||||
null=True,
|
||||
help_text="可选:描述工作中遇到的问题或困难"
|
||||
)
|
||||
suggestions = models.TextField(
|
||||
"建议或意见",
|
||||
blank=True,
|
||||
null=True,
|
||||
help_text="可选:对工作或团队的建议"
|
||||
)
|
||||
report_date = models.DateField("日报日期", help_text="填写日报对应的日期")
|
||||
created_at = models.DateTimeField("提交时间", auto_now_add=True)
|
||||
updated_at = models.DateTimeField("更新时间", auto_now=True)
|
||||
is_draft = models.BooleanField("草稿状态", default=False, help_text="是否为草稿")
|
||||
|
||||
class Meta:
|
||||
verbose_name = "日报"
|
||||
verbose_name_plural = verbose_name
|
||||
ordering = ['-report_date', '-created_at']
|
||||
unique_together = [['user', 'report_date']] # 每个用户每天只能有一份日报
|
||||
indexes = [
|
||||
models.Index(fields=['user', 'report_date']),
|
||||
models.Index(fields=['report_date']),
|
||||
models.Index(fields=['-created_at']),
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return f'{self.user.username} - {self.report_date}'
|
||||
|
||||
@property
|
||||
def work_summary_preview(self):
|
||||
"""工作总结预览(前100个字符)"""
|
||||
return self.work_summary[:100] + '...' if len(self.work_summary) > 100 else self.work_summary
|
||||
|
||||
@property
|
||||
def next_day_plan_preview(self):
|
||||
"""明日计划预览(前100个字符)"""
|
||||
return self.next_day_plan[:100] + '...' if len(self.next_day_plan) > 100 else self.next_day_plan
|
||||
|
||||
|
||||
class ReportComment(models.Model):
|
||||
"""日报评论模型"""
|
||||
report = models.ForeignKey(
|
||||
DailyReport,
|
||||
on_delete=models.CASCADE,
|
||||
related_name='comments',
|
||||
verbose_name="关联日报"
|
||||
)
|
||||
user = models.ForeignKey(
|
||||
User,
|
||||
on_delete=models.CASCADE,
|
||||
verbose_name="评论人"
|
||||
)
|
||||
content = models.TextField("评论内容")
|
||||
created_at = models.DateTimeField("评论时间", auto_now_add=True)
|
||||
updated_at = models.DateTimeField("更新时间", auto_now=True)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "日报评论"
|
||||
verbose_name_plural = verbose_name
|
||||
ordering = ['-created_at']
|
||||
|
||||
def __str__(self):
|
||||
return f'{self.user.username} 评论了 {self.report}'
|
65
backend/daily_report/permissions.py
Normal file
65
backend/daily_report/permissions.py
Normal file
@@ -0,0 +1,65 @@
|
||||
from rest_framework import permissions
|
||||
|
||||
|
||||
class IsOwnerOrStaff(permissions.BasePermission):
|
||||
"""
|
||||
自定义权限:只有日报的创建者或管理员才能访问
|
||||
"""
|
||||
|
||||
def has_object_permission(self, request, view, obj):
|
||||
# 读取权限:管理员可以查看所有日报,普通用户只能查看自己的日报
|
||||
if request.method in permissions.SAFE_METHODS:
|
||||
return obj.user == request.user or request.user.is_staff
|
||||
|
||||
# 写入权限:只有创建者或管理员可以修改/删除
|
||||
return obj.user == request.user or request.user.is_staff
|
||||
|
||||
|
||||
class IsOwnerOrStaffReadOnly(permissions.BasePermission):
|
||||
"""
|
||||
自定义权限:管理员可以查看所有日报,普通用户只能查看自己的日报
|
||||
管理员对他人日报只有只读权限
|
||||
"""
|
||||
|
||||
def has_object_permission(self, request, view, obj):
|
||||
# 如果是日报创建者,拥有完全权限
|
||||
if obj.user == request.user:
|
||||
return True
|
||||
|
||||
# 如果是管理员,只有读取权限
|
||||
if request.user.is_staff:
|
||||
return request.method in permissions.SAFE_METHODS
|
||||
|
||||
# 其他情况拒绝访问
|
||||
return False
|
||||
|
||||
|
||||
class IsCommentOwnerOrStaff(permissions.BasePermission):
|
||||
"""
|
||||
评论权限:只有评论创建者或管理员可以修改/删除评论
|
||||
"""
|
||||
|
||||
def has_object_permission(self, request, view, obj):
|
||||
# 读取权限:所有认证用户都可以查看评论
|
||||
if request.method in permissions.SAFE_METHODS:
|
||||
return True
|
||||
|
||||
# 写入权限:只有评论创建者或管理员可以修改/删除
|
||||
return obj.user == request.user or request.user.is_staff
|
||||
|
||||
|
||||
class CanViewReports(permissions.BasePermission):
|
||||
"""
|
||||
日报查看权限:管理员可以查看所有日报,普通用户只能查看自己的日报
|
||||
"""
|
||||
|
||||
def has_permission(self, request, view):
|
||||
return request.user and request.user.is_authenticated
|
||||
|
||||
def has_object_permission(self, request, view, obj):
|
||||
# 管理员可以查看所有日报
|
||||
if request.user.is_staff:
|
||||
return True
|
||||
|
||||
# 普通用户只能查看自己的日报
|
||||
return obj.user == request.user
|
131
backend/daily_report/serializers.py
Normal file
131
backend/daily_report/serializers.py
Normal file
@@ -0,0 +1,131 @@
|
||||
from rest_framework import serializers
|
||||
from django.contrib.auth import get_user_model
|
||||
from .models import DailyReport, ReportComment
|
||||
|
||||
User = get_user_model()
|
||||
|
||||
|
||||
class UserSimpleSerializer(serializers.ModelSerializer):
|
||||
"""用户简单信息序列化器"""
|
||||
full_name = serializers.SerializerMethodField()
|
||||
|
||||
class Meta:
|
||||
model = User
|
||||
fields = ('id', 'username', 'full_name', 'department', 'position')
|
||||
|
||||
def get_full_name(self, obj):
|
||||
return f'{obj.first_name} {obj.last_name}'.strip() or obj.username
|
||||
|
||||
|
||||
class ReportCommentSerializer(serializers.ModelSerializer):
|
||||
"""日报评论序列化器"""
|
||||
user = UserSimpleSerializer(read_only=True)
|
||||
|
||||
class Meta:
|
||||
model = ReportComment
|
||||
fields = ('id', 'user', 'content', 'created_at', 'updated_at')
|
||||
read_only_fields = ('id', 'created_at', 'updated_at')
|
||||
|
||||
def create(self, validated_data):
|
||||
validated_data['user'] = self.context['request'].user
|
||||
return super().create(validated_data)
|
||||
|
||||
|
||||
class DailyReportListSerializer(serializers.ModelSerializer):
|
||||
"""日报列表序列化器"""
|
||||
user = UserSimpleSerializer(read_only=True)
|
||||
work_summary_preview = serializers.ReadOnlyField()
|
||||
next_day_plan_preview = serializers.ReadOnlyField()
|
||||
comments_count = serializers.SerializerMethodField()
|
||||
|
||||
class Meta:
|
||||
model = DailyReport
|
||||
fields = (
|
||||
'id', 'user', 'work_summary_preview', 'next_day_plan_preview',
|
||||
'report_date', 'created_at', 'updated_at', 'is_draft', 'comments_count'
|
||||
)
|
||||
|
||||
def get_comments_count(self, obj):
|
||||
return obj.comments.count()
|
||||
|
||||
|
||||
class DailyReportDetailSerializer(serializers.ModelSerializer):
|
||||
"""日报详情序列化器"""
|
||||
user = UserSimpleSerializer(read_only=True)
|
||||
comments = ReportCommentSerializer(many=True, read_only=True)
|
||||
can_edit = serializers.SerializerMethodField()
|
||||
can_delete = serializers.SerializerMethodField()
|
||||
|
||||
class Meta:
|
||||
model = DailyReport
|
||||
fields = (
|
||||
'id', 'user', 'work_summary', 'next_day_plan', 'difficulties',
|
||||
'suggestions', 'report_date', 'created_at', 'updated_at',
|
||||
'is_draft', 'comments', 'can_edit', 'can_delete'
|
||||
)
|
||||
|
||||
def get_can_edit(self, obj):
|
||||
request = self.context.get('request')
|
||||
if not request or not request.user:
|
||||
return False
|
||||
return obj.user == request.user or request.user.is_staff
|
||||
|
||||
def get_can_delete(self, obj):
|
||||
request = self.context.get('request')
|
||||
if not request or not request.user:
|
||||
return False
|
||||
return obj.user == request.user or request.user.is_staff
|
||||
|
||||
|
||||
class DailyReportCreateUpdateSerializer(serializers.ModelSerializer):
|
||||
"""日报创建和更新序列化器"""
|
||||
|
||||
class Meta:
|
||||
model = DailyReport
|
||||
fields = (
|
||||
'work_summary', 'next_day_plan', 'difficulties',
|
||||
'suggestions', 'report_date', 'is_draft'
|
||||
)
|
||||
|
||||
def validate_report_date(self, value):
|
||||
"""验证日报日期"""
|
||||
request = self.context.get('request')
|
||||
if not request:
|
||||
return value
|
||||
|
||||
# 检查是否已存在该日期的日报(更新时排除当前记录)
|
||||
queryset = DailyReport.objects.filter(
|
||||
user=request.user,
|
||||
report_date=value
|
||||
)
|
||||
|
||||
# 如果是更新操作,排除当前记录
|
||||
if self.instance:
|
||||
queryset = queryset.exclude(id=self.instance.id)
|
||||
|
||||
if queryset.exists():
|
||||
raise serializers.ValidationError(f'您已在 {value} 提交过日报,每天只能提交一份日报。')
|
||||
|
||||
return value
|
||||
|
||||
def create(self, validated_data):
|
||||
validated_data['user'] = self.context['request'].user
|
||||
return super().create(validated_data)
|
||||
|
||||
|
||||
class DailyReportStatsSerializer(serializers.Serializer):
|
||||
"""日报统计序列化器"""
|
||||
total_reports = serializers.IntegerField()
|
||||
this_month_reports = serializers.IntegerField()
|
||||
this_week_reports = serializers.IntegerField()
|
||||
draft_reports = serializers.IntegerField()
|
||||
completion_rate = serializers.FloatField()
|
||||
|
||||
|
||||
class UserReportStatsSerializer(serializers.Serializer):
|
||||
"""用户日报统计序列化器"""
|
||||
user = UserSimpleSerializer()
|
||||
total_reports = serializers.IntegerField()
|
||||
this_month_reports = serializers.IntegerField()
|
||||
last_report_date = serializers.DateField()
|
||||
completion_rate = serializers.FloatField()
|
19
backend/daily_report/urls.py
Normal file
19
backend/daily_report/urls.py
Normal file
@@ -0,0 +1,19 @@
|
||||
from django.urls import path
|
||||
from . import views
|
||||
|
||||
app_name = 'daily_report'
|
||||
|
||||
urlpatterns = [
|
||||
# 日报相关URL
|
||||
path('reports/', views.DailyReportListCreateView.as_view(), name='report-list-create'),
|
||||
path('reports/<int:pk>/', views.DailyReportDetailView.as_view(), name='report-detail'),
|
||||
path('reports/<int:pk>/toggle-draft/', views.toggle_draft_status, name='toggle-draft'),
|
||||
|
||||
# 评论相关URL
|
||||
path('reports/<int:report_id>/comments/', views.ReportCommentListCreateView.as_view(), name='comment-list-create'),
|
||||
path('comments/<int:pk>/', views.ReportCommentDetailView.as_view(), name='comment-detail'),
|
||||
|
||||
# 统计相关URL
|
||||
path('stats/', views.report_stats, name='report-stats'),
|
||||
path('stats/users/', views.user_report_stats, name='user-report-stats'),
|
||||
]
|
205
backend/daily_report/views.py
Normal file
205
backend/daily_report/views.py
Normal file
@@ -0,0 +1,205 @@
|
||||
from rest_framework import generics, status, permissions
|
||||
from rest_framework.decorators import api_view, permission_classes
|
||||
from rest_framework.response import Response
|
||||
from django.db.models import Count, Q
|
||||
from django.utils import timezone
|
||||
from datetime import datetime, timedelta
|
||||
from django.contrib.auth import get_user_model
|
||||
from .models import DailyReport, ReportComment
|
||||
from .serializers import (
|
||||
DailyReportListSerializer,
|
||||
DailyReportDetailSerializer,
|
||||
DailyReportCreateUpdateSerializer,
|
||||
ReportCommentSerializer,
|
||||
DailyReportStatsSerializer,
|
||||
UserReportStatsSerializer
|
||||
)
|
||||
from .permissions import IsOwnerOrStaff, IsOwnerOrStaffReadOnly, IsCommentOwnerOrStaff
|
||||
from .filters import DailyReportFilter
|
||||
|
||||
User = get_user_model()
|
||||
|
||||
|
||||
class DailyReportListCreateView(generics.ListCreateAPIView):
|
||||
"""日报列表和创建视图"""
|
||||
permission_classes = [permissions.IsAuthenticated]
|
||||
filterset_class = DailyReportFilter
|
||||
search_fields = ['work_summary', 'next_day_plan', 'user__username', 'user__first_name', 'user__last_name']
|
||||
ordering_fields = ['report_date', 'created_at', 'updated_at']
|
||||
ordering = ['-report_date', '-created_at']
|
||||
|
||||
def get_queryset(self):
|
||||
"""根据用户权限返回不同的查询集"""
|
||||
user = self.request.user
|
||||
if user.is_staff:
|
||||
# 管理员可以查看所有日报
|
||||
return DailyReport.objects.select_related('user').prefetch_related('comments')
|
||||
else:
|
||||
# 普通用户只能查看自己的日报
|
||||
return DailyReport.objects.filter(user=user).select_related('user').prefetch_related('comments')
|
||||
|
||||
def get_serializer_class(self):
|
||||
if self.request.method == 'POST':
|
||||
return DailyReportCreateUpdateSerializer
|
||||
return DailyReportListSerializer
|
||||
|
||||
def get_filterset_kwargs(self, filterset_class):
|
||||
"""传递request给过滤器"""
|
||||
kwargs = super().get_filterset_kwargs(filterset_class)
|
||||
kwargs['request'] = self.request
|
||||
return kwargs
|
||||
|
||||
|
||||
class DailyReportDetailView(generics.RetrieveUpdateDestroyAPIView):
|
||||
"""日报详情、更新和删除视图"""
|
||||
permission_classes = [permissions.IsAuthenticated, IsOwnerOrStaffReadOnly]
|
||||
|
||||
def get_queryset(self):
|
||||
"""根据用户权限返回不同的查询集"""
|
||||
user = self.request.user
|
||||
if user.is_staff:
|
||||
return DailyReport.objects.select_related('user').prefetch_related('comments__user')
|
||||
else:
|
||||
return DailyReport.objects.filter(user=user).select_related('user').prefetch_related('comments__user')
|
||||
|
||||
def get_serializer_class(self):
|
||||
if self.request.method in ['PUT', 'PATCH']:
|
||||
return DailyReportCreateUpdateSerializer
|
||||
return DailyReportDetailSerializer
|
||||
|
||||
|
||||
class ReportCommentListCreateView(generics.ListCreateAPIView):
|
||||
"""日报评论列表和创建视图"""
|
||||
serializer_class = ReportCommentSerializer
|
||||
permission_classes = [permissions.IsAuthenticated]
|
||||
|
||||
def get_queryset(self):
|
||||
report_id = self.kwargs.get('report_id')
|
||||
return ReportComment.objects.filter(
|
||||
report_id=report_id
|
||||
).select_related('user', 'report')
|
||||
|
||||
def perform_create(self, serializer):
|
||||
report_id = self.kwargs.get('report_id')
|
||||
# 验证用户是否有权限查看该日报
|
||||
try:
|
||||
report = DailyReport.objects.get(id=report_id)
|
||||
if not (report.user == self.request.user or self.request.user.is_staff):
|
||||
raise permissions.PermissionDenied("您没有权限评论此日报")
|
||||
except DailyReport.DoesNotExist:
|
||||
raise generics.NotFound("日报不存在")
|
||||
|
||||
serializer.save(user=self.request.user, report_id=report_id)
|
||||
|
||||
|
||||
class ReportCommentDetailView(generics.RetrieveUpdateDestroyAPIView):
|
||||
"""日报评论详情、更新和删除视图"""
|
||||
serializer_class = ReportCommentSerializer
|
||||
permission_classes = [permissions.IsAuthenticated, IsCommentOwnerOrStaff]
|
||||
|
||||
def get_queryset(self):
|
||||
return ReportComment.objects.select_related('user', 'report')
|
||||
|
||||
|
||||
@api_view(['GET'])
|
||||
@permission_classes([permissions.IsAuthenticated])
|
||||
def report_stats(request):
|
||||
"""获取日报统计信息"""
|
||||
user = request.user
|
||||
|
||||
if user.is_staff:
|
||||
# 管理员查看全局统计
|
||||
queryset = DailyReport.objects.all()
|
||||
else:
|
||||
# 普通用户查看个人统计
|
||||
queryset = DailyReport.objects.filter(user=user)
|
||||
|
||||
now = timezone.now()
|
||||
this_month_start = now.replace(day=1, hour=0, minute=0, second=0, microsecond=0)
|
||||
this_week_start = now - timedelta(days=now.weekday())
|
||||
this_week_start = this_week_start.replace(hour=0, minute=0, second=0, microsecond=0)
|
||||
|
||||
total_reports = queryset.count()
|
||||
this_month_reports = queryset.filter(report_date__gte=this_month_start.date()).count()
|
||||
this_week_reports = queryset.filter(report_date__gte=this_week_start.date()).count()
|
||||
draft_reports = queryset.filter(is_draft=True).count()
|
||||
|
||||
# 计算完成率(本月)
|
||||
days_in_month = (now.replace(month=now.month+1, day=1) - timedelta(days=1)).day if now.month < 12 else 31
|
||||
current_day = now.day
|
||||
expected_reports = current_day if not user.is_staff else User.objects.filter(is_active=True).count() * current_day
|
||||
completion_rate = (this_month_reports / expected_reports * 100) if expected_reports > 0 else 0
|
||||
|
||||
stats = {
|
||||
'total_reports': total_reports,
|
||||
'this_month_reports': this_month_reports,
|
||||
'this_week_reports': this_week_reports,
|
||||
'draft_reports': draft_reports,
|
||||
'completion_rate': round(completion_rate, 2)
|
||||
}
|
||||
|
||||
serializer = DailyReportStatsSerializer(stats)
|
||||
return Response(serializer.data)
|
||||
|
||||
|
||||
@api_view(['GET'])
|
||||
@permission_classes([permissions.IsAuthenticated])
|
||||
def user_report_stats(request):
|
||||
"""获取用户日报统计信息(仅管理员)"""
|
||||
if not request.user.is_staff:
|
||||
return Response({'error': '权限不足'}, status=status.HTTP_403_FORBIDDEN)
|
||||
|
||||
users = User.objects.filter(is_active=True).annotate(
|
||||
total_reports=Count('daily_reports'),
|
||||
this_month_reports=Count(
|
||||
'daily_reports',
|
||||
filter=Q(daily_reports__report_date__gte=timezone.now().replace(day=1).date())
|
||||
)
|
||||
).prefetch_related('daily_reports')
|
||||
|
||||
stats_list = []
|
||||
for user in users:
|
||||
last_report = user.daily_reports.first()
|
||||
last_report_date = last_report.report_date if last_report else None
|
||||
|
||||
# 计算完成率
|
||||
current_day = timezone.now().day
|
||||
completion_rate = (user.this_month_reports / current_day * 100) if current_day > 0 else 0
|
||||
|
||||
stats_list.append({
|
||||
'user': user,
|
||||
'total_reports': user.total_reports,
|
||||
'this_month_reports': user.this_month_reports,
|
||||
'last_report_date': last_report_date,
|
||||
'completion_rate': round(completion_rate, 2)
|
||||
})
|
||||
|
||||
# 按完成率排序
|
||||
stats_list.sort(key=lambda x: x['completion_rate'], reverse=True)
|
||||
|
||||
serializer = UserReportStatsSerializer(stats_list, many=True)
|
||||
return Response(serializer.data)
|
||||
|
||||
|
||||
@api_view(['POST'])
|
||||
@permission_classes([permissions.IsAuthenticated])
|
||||
def toggle_draft_status(request, pk):
|
||||
"""切换日报的草稿状态"""
|
||||
try:
|
||||
report = DailyReport.objects.get(pk=pk)
|
||||
|
||||
# 检查权限
|
||||
if report.user != request.user and not request.user.is_staff:
|
||||
return Response({'error': '权限不足'}, status=status.HTTP_403_FORBIDDEN)
|
||||
|
||||
report.is_draft = not report.is_draft
|
||||
report.save()
|
||||
|
||||
status_text = '草稿' if report.is_draft else '已发布'
|
||||
return Response({
|
||||
'message': f'日报状态已更新为:{status_text}',
|
||||
'is_draft': report.is_draft
|
||||
})
|
||||
|
||||
except DailyReport.DoesNotExist:
|
||||
return Response({'error': '日报不存在'}, status=status.HTTP_404_NOT_FOUND)
|
Reference in New Issue
Block a user