v1.2版本更新发布

backend/routes/semester.py

@@ -0,0 +1,151 @@
+# ===========================================
+# 班级操行分管理系统 - 学期管理路由
+# 
+# 开发者: Canglan
+# 联系方式: admin@sea-studio.top
+# 版权归属: Sea Network Technology Studio
+# 许可证: MIT License
+# 
+# 版权所有 © Sea Network Technology Studio
+# ===========================================
+
+from fastapi import APIRouter, Request, Query
+from typing import Optional
+
+from middleware.permission import (
+    get_current_user,
+    PermissionChecker
+)
+from services.semester_service import SemesterService
+from services.log_service import LogService
+from schemas.semester import CreateSemesterRequest
+from utils.response import success_response, error_response
+from utils.logger import get_logger
+
+router = APIRouter()
+logger = get_logger(__name__)
+
+
+@router.get("/list")
+async def list_semesters(request: Request):
+    """获取学期列表（仅班主任）"""
+    user = await get_current_user(request)
+    is_teacher = await PermissionChecker.check_is_teacher(user["user_id"])
+    if not is_teacher:
+        return error_response(message="仅班主任可查看学期列表", code=403)
+    result = await SemesterService.list_semesters()
+    if result["success"]:
+        return success_response(data=result["semesters"])
+    else:
+        return error_response(message=result["message"])
+
+
+@router.get("/active")
+async def get_active_semester(request: Request):
+    """获取当前活跃学期"""
+    user = await get_current_user(request)
+    result = await SemesterService.get_active_semester()
+    if result["success"]:
+        return success_response(data=result.get("semester"))
+    else:
+        return error_response(message=result["message"])
+
+
+@router.post("/create")
+async def create_semester(request: Request, req: CreateSemesterRequest):
+    """创建学期（班主任）"""
+    user = await get_current_user(request)
+    is_teacher = await PermissionChecker.check_is_teacher(user["user_id"])
+    if not is_teacher:
+        return error_response(message="仅班主任可创建学期", code=403)
+    
+    result = await SemesterService.create_semester(
+        semester_name=req.semester_name,
+        start_date=req.start_date,
+        end_date=req.end_date,
+        operator_id=user["user_id"]
+    )
+    if result["success"]:
+        await LogService.write_operation_log(
+            operator_id=user["user_id"], operator_name=user["username"],
+            operator_role="班主任", operation_type="create_semester",
+            target_type="semester", target_id=result.get("semester_id"),
+            details=f"创建学期: {req.semester_name}",
+            ip=request.client.host
+        )
+        return success_response(data=result, message="学期创建成功")
+    else:
+        return error_response(message=result["message"])
+
+
+@router.put("/activate/{semester_id}")
+async def activate_semester(request: Request, semester_id: int):
+    """设为当前学期（班主任）"""
+    user = await get_current_user(request)
+    is_teacher = await PermissionChecker.check_is_teacher(user["user_id"])
+    if not is_teacher:
+        return error_response(message="仅班主任可设置当前学期", code=403)
+    
+    result = await SemesterService.activate_semester(
+        semester_id=semester_id,
+        operator_id=user["user_id"]
+    )
+    if result["success"]:
+        await LogService.write_operation_log(
+            operator_id=user["user_id"], operator_name=user["username"],
+            operator_role="班主任", operation_type="activate_semester",
+            target_type="semester", target_id=semester_id,
+            details=f"激活学期ID: {semester_id}",
+            ip=request.client.host
+        )
+        return success_response(message=result["message"])
+    else:
+        return error_response(message=result["message"])
+
+
+@router.post("/archive/{semester_id}")
+async def archive_semester(request: Request, semester_id: int):
+    """归档学期（班主任）"""
+    user = await get_current_user(request)
+    is_teacher = await PermissionChecker.check_is_teacher(user["user_id"])
+    if not is_teacher:
+        return error_response(message="仅班主任可归档学期", code=403)
+    
+    result = await SemesterService.archive_semester(
+        semester_id=semester_id,
+        operator_id=user["user_id"]
+    )
+    if result["success"]:
+        await LogService.write_operation_log(
+            operator_id=user["user_id"], operator_name=user["username"],
+            operator_role="班主任", operation_type="archive_semester",
+            target_type="semester", target_id=semester_id,
+            details=f"归档学期ID: {semester_id}",
+            ip=request.client.host
+        )
+        return success_response(message=result["message"])
+    else:
+        return error_response(message=result["message"])
+
+
+@router.get("/archive/{semester_id}/records")
+async def get_archive_records(
+    request: Request,
+    semester_id: int,
+    page: int = Query(1, ge=1),
+    page_size: int = Query(50, ge=1, le=200)
+):
+    """查看归档数据（仅班主任）"""
+    user = await get_current_user(request)
+    is_teacher = await PermissionChecker.check_is_teacher(user["user_id"])
+    if not is_teacher:
+        return error_response(message="仅班主任可查看归档数据", code=403)
+    result = await SemesterService.get_archive_records(
+        semester_id=semester_id,
+        page=page,
+        page_size=page_size
+    )
+    if result["success"]:
+        return success_response(data=result["data"])
+    else:
+        return error_response(message=result["message"])