245 lines
9.1 KiB
Python
245 lines
9.1 KiB
Python
# ===========================================
|
|
# 班级操行分管理系统 - 学期服务
|
|
#
|
|
# 开发者: Canglan
|
|
# 联系方式: admin@sea-studio.top
|
|
# 版权归属: Sea Network Technology Studio
|
|
# 许可证: MIT License
|
|
#
|
|
# 版权所有 © Sea Network Technology Studio
|
|
# ===========================================
|
|
|
|
from typing import Dict, Any, List, Optional
|
|
|
|
from models.semester import SemesterModel, SemesterArchiveModel
|
|
from models.student import StudentModel
|
|
from middleware.permission import PermissionChecker
|
|
from config import settings
|
|
from utils.logger import get_logger
|
|
from utils.database import execute_query
|
|
|
|
logger = get_logger(__name__)
|
|
|
|
|
|
class SemesterService:
|
|
"""学期管理服务"""
|
|
|
|
@staticmethod
|
|
async def list_semesters() -> Dict[str, Any]:
|
|
"""获取学期列表"""
|
|
try:
|
|
semesters = await SemesterModel.get_all()
|
|
return {
|
|
"success": True,
|
|
"semesters": semesters
|
|
}
|
|
except Exception as e:
|
|
logger.error(f"获取学期列表失败: {e}")
|
|
return {"success": False, "message": f"获取学期列表失败: {str(e)}"}
|
|
|
|
@staticmethod
|
|
async def create_semester(
|
|
semester_name: str,
|
|
start_date: str = None,
|
|
end_date: str = None,
|
|
operator_id: int = None
|
|
) -> Dict[str, Any]:
|
|
"""创建新学期"""
|
|
if not semester_name or not semester_name.strip():
|
|
return {"success": False, "message": "学期名称不能为空"}
|
|
|
|
try:
|
|
# 自动将之前的活跃学期设为非活跃
|
|
await SemesterModel.deactivate_all()
|
|
|
|
# 创建新学期并自动设为活跃
|
|
semester_id = await SemesterModel.create(
|
|
semester_name=semester_name.strip(),
|
|
start_date=start_date,
|
|
end_date=end_date
|
|
)
|
|
|
|
# 设为活跃学期
|
|
await SemesterModel.activate(semester_id)
|
|
|
|
logger.info(f"用户[{operator_id}] 创建了新学期: {semester_name}")
|
|
|
|
return {
|
|
"success": True,
|
|
"message": "学期创建成功",
|
|
"semester_id": semester_id
|
|
}
|
|
except Exception as e:
|
|
logger.error(f"创建学期失败: {e}")
|
|
return {"success": False, "message": f"创建学期失败: {str(e)}"}
|
|
|
|
@staticmethod
|
|
async def activate_semester(
|
|
semester_id: int,
|
|
operator_id: int = None
|
|
) -> Dict[str, Any]:
|
|
"""设为当前活跃学期"""
|
|
try:
|
|
# 检查学期是否存在
|
|
semester = await SemesterModel.get_by_id(semester_id)
|
|
if not semester:
|
|
return {"success": False, "message": "学期不存在"}
|
|
|
|
# 已归档的学期不能激活
|
|
if semester['is_archived']:
|
|
return {"success": False, "message": "已归档的学期不能设为当前学期"}
|
|
|
|
# 自动将之前的活跃学期设为非活跃
|
|
await SemesterModel.deactivate_all()
|
|
|
|
# 设为活跃
|
|
result = await SemesterModel.activate(semester_id)
|
|
|
|
if result:
|
|
logger.info(f"用户[{operator_id}] 激活了学期: {semester['semester_name']}")
|
|
return {"success": True, "message": "已设为当前学期"}
|
|
else:
|
|
return {"success": False, "message": "激活失败"}
|
|
except Exception as e:
|
|
logger.error(f"激活学期失败: {e}")
|
|
return {"success": False, "message": f"激活学期失败: {str(e)}"}
|
|
|
|
@staticmethod
|
|
async def archive_semester(
|
|
semester_id: int,
|
|
operator_id: int = None
|
|
) -> Dict[str, Any]:
|
|
"""归档学期"""
|
|
try:
|
|
# 检查学期是否存在
|
|
semester = await SemesterModel.get_by_id(semester_id)
|
|
if not semester:
|
|
return {"success": False, "message": "学期不存在"}
|
|
|
|
# 已归档的不能重复归档
|
|
if semester['is_archived']:
|
|
return {"success": False, "message": "该学期已归档"}
|
|
|
|
# 获取所有活跃学生及其当前分数
|
|
students = await StudentModel.get_all(include_disabled=False)
|
|
if not students:
|
|
return {"success": False, "message": "没有可归档的学生数据"}
|
|
|
|
total_students = len(students)
|
|
|
|
# 按分数降序排列以计算排名
|
|
sorted_students = sorted(students, key=lambda s: s['total_points'], reverse=True)
|
|
|
|
# 构建归档快照数据
|
|
archives_data = []
|
|
for rank, student in enumerate(sorted_students, 1):
|
|
archives_data.append({
|
|
'semester_id': semester_id,
|
|
'student_id': student['student_id'],
|
|
'student_no': student['student_no'],
|
|
'student_name': student['name'],
|
|
'final_points': student['total_points'],
|
|
'rank_position': rank,
|
|
'total_students': total_students
|
|
})
|
|
|
|
# 保存归档快照
|
|
await SemesterArchiveModel.batch_create(archives_data)
|
|
|
|
# 标记学期为已归档
|
|
await SemesterModel.archive(semester_id)
|
|
|
|
logger.info(
|
|
f"用户[{operator_id}] 归档了学期: {semester['semester_name']}, "
|
|
f"共 {total_students} 名学生"
|
|
)
|
|
|
|
return {
|
|
"success": True,
|
|
"message": f"学期归档成功，共归档 {total_students} 名学生数据"
|
|
}
|
|
except Exception as e:
|
|
logger.error(f"归档学期失败: {e}")
|
|
return {"success": False, "message": f"归档学期失败: {str(e)}"}
|
|
|
|
@staticmethod
|
|
async def get_archive_records(
|
|
semester_id: int,
|
|
page: int = 1,
|
|
page_size: int = 50
|
|
) -> Dict[str, Any]:
|
|
"""获取归档数据（只读）"""
|
|
try:
|
|
# 检查学期是否存在
|
|
semester = await SemesterModel.get_by_id(semester_id)
|
|
if not semester:
|
|
return {"success": False, "message": "学期不存在"}
|
|
|
|
archives = await SemesterArchiveModel.get_by_semester(semester_id)
|
|
|
|
total = len(archives)
|
|
offset = (page - 1) * page_size
|
|
paged_archives = archives[offset:offset + page_size]
|
|
|
|
return {
|
|
"success": True,
|
|
"data": {
|
|
"semester": {
|
|
"semester_id": semester['semester_id'],
|
|
"semester_name": semester['semester_name'],
|
|
"start_date": semester.get('start_date'),
|
|
"end_date": semester.get('end_date'),
|
|
"is_archived": bool(semester['is_archived'])
|
|
},
|
|
"archives": paged_archives,
|
|
"total": total,
|
|
"page": page,
|
|
"page_size": page_size,
|
|
"total_pages": (total + page_size - 1) // page_size
|
|
}
|
|
}
|
|
except Exception as e:
|
|
logger.error(f"获取归档数据失败: {e}")
|
|
return {"success": False, "message": f"获取归档数据失败: {str(e)}"}
|
|
|
|
@staticmethod
|
|
async def reset_student_points(initial_points: int = None) -> Dict[str, Any]:
|
|
"""重置所有学生的操行分为初始分"""
|
|
if initial_points is None:
|
|
initial_points = settings.STUDENT_INITIAL_POINTS
|
|
|
|
try:
|
|
from utils.database import execute_update
|
|
sql = "UPDATE students SET total_points = %s WHERE status = 1"
|
|
affected = await execute_update(sql, (initial_points,))
|
|
|
|
logger.info(f"已重置 {affected} 名学生的操行分为 {initial_points}")
|
|
return {
|
|
"success": True,
|
|
"message": f"已重置 {affected} 名学生的操行分为 {initial_points} 分",
|
|
"affected": affected
|
|
}
|
|
except Exception as e:
|
|
logger.error(f"重置学生分数失败: {e}")
|
|
return {"success": False, "message": f"重置学生分数失败: {str(e)}"}
|
|
|
|
@staticmethod
|
|
async def get_active_semester() -> Dict[str, Any]:
|
|
"""获取当前活跃学期"""
|
|
try:
|
|
active = await SemesterModel.get_active()
|
|
if active:
|
|
return {
|
|
"success": True,
|
|
"semester": active
|
|
}
|
|
else:
|
|
return {
|
|
"success": True,
|
|
"semester": None,
|
|
"message": "当前没有活跃学期"
|
|
}
|
|
except Exception as e:
|
|
logger.error(f"获取活跃学期失败: {e}")
|
|
return {"success": False, "message": f"获取活跃学期失败: {str(e)}"}
|