From 45757588120302ddf99d71ca8e7a734ba72de352 Mon Sep 17 00:00:00 2001
From: biss <bishsh2006@outlook.com>
Date: Fri, 14 Aug 2026 19:45:19 +0800
Subject: [PATCH] =?UTF-8?q?=E8=AF=BE=E7=A8=8B=E4=BF=AE=E8=AF=BB=E5=90=8D?=
 =?UTF-8?q?=E5=8D=95=E5=AF=BC=E5=87=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Controllers/CourseSelectionsController.cs | 140 ++++++++++++++++
 web/src/layouts/AdminLayout.vue               |   4 +
 web/src/router/index.ts                       |   6 +
 .../views/CourseEnrollmentManagementView.vue  | 150 ++++++++++++++++++
 web/src/views/PersonnelView.vue               |  47 +-----
 5 files changed, 301 insertions(+), 46 deletions(-)
 create mode 100644 web/src/views/CourseEnrollmentManagementView.vue

diff --git a/src/Jiaowu.Api/Controllers/CourseSelectionsController.cs b/src/Jiaowu.Api/Controllers/CourseSelectionsController.cs
index 15194e5..a149529 100644
--- a/src/Jiaowu.Api/Controllers/CourseSelectionsController.cs
+++ b/src/Jiaowu.Api/Controllers/CourseSelectionsController.cs
@@ -1,5 +1,6 @@
 using System.ComponentModel.DataAnnotations;
 using System.Data;
+using Jiaowu.Api.Contracts;
 using Jiaowu.Api.Domain.Academic;
 using Jiaowu.Api.Domain.Identity;
 using Jiaowu.Api.Infrastructure.Auth;
@@ -37,6 +38,51 @@ public sealed class CourseSelectionsController(
         OfferingManagers + "," +
         SystemRoles.Teacher;
 
+    [HttpGet("enrollments")]
+    [Authorize(Roles = OfferingManagers)]
+    public async Task<ActionResult> GetEnrollments(
+        [FromQuery] CourseEnrollmentQuery query,
+        CancellationToken cancellationToken)
+    {
+        var source = ApplyEnrollmentFilters(ScopedEnrollments(), query);
+        var total = await source.CountAsync(cancellationToken);
+        var page = Math.Max(1, query.Page);
+        var pageSize = Math.Clamp(query.PageSize, 1, 100);
+        var items = await ProjectEnrollments(source)
+            .OrderByDescending(x => x.TermStartDate)
+            .ThenBy(x => x.CourseCode)
+            .ThenBy(x => x.StudentNumber)
+            .Skip((page - 1) * pageSize)
+            .Take(pageSize)
+            .ToListAsync(cancellationToken);
+        return Ok(new PagedResult<object>(items.Cast<object>().ToList(), total, page, pageSize));
+    }
+
+    [HttpGet("enrollments/export.xlsx")]
+    [Authorize(Roles = OfferingManagers)]
+    public async Task<ActionResult> ExportEnrollments(
+        [FromQuery] CourseEnrollmentQuery query,
+        CancellationToken cancellationToken)
+    {
+        var items = await ProjectEnrollments(ApplyEnrollmentFilters(ScopedEnrollments(), query))
+            .OrderByDescending(x => x.TermStartDate)
+            .ThenBy(x => x.CourseCode)
+            .ThenBy(x => x.StudentNumber)
+            .ToListAsync(cancellationToken);
+        var rows = items.Select(x => (IReadOnlyList<object?>)[
+            x.TermName, x.CollegeName, x.CourseCode, x.CourseName, x.TaskNumber,
+            x.StudentNumber, x.StudentName, x.MajorName, x.ClassName, x.Grade,
+            x.Status.ToString(), x.EnrollmentType.ToString(), x.EnrolledAt,
+            x.WithdrawnAt, x.ExemptionStatus?.ToString() ?? "—"
+        ]).ToList();
+        var bytes = ExcelWorkbookHelper.Create("修读课程名单", [
+            "学期", "开课院系", "课程代码", "课程名称", "教学班", "学号", "姓名",
+            "专业", "行政班", "年级", "修读状态", "修读类型", "选入时间", "退选时间", "免修审批"
+        ], rows);
+        return File(bytes, ExcelWorkbookHelper.ContentType,
+            $"修读课程名单-{DateTime.Now:yyyyMMdd-HHmm}.xlsx");
+    }
+
     [HttpGet("rounds")]
     [Authorize(Roles = SelectionUsers)]
     public async Task<ActionResult> GetRounds(
@@ -2225,6 +2271,71 @@ public sealed class CourseSelectionsController(
             : result;
     }
 
+    private IQueryable<CourseEnrollment> ScopedEnrollments()
+    {
+        var source = db.CourseEnrollments.AsNoTracking();
+        var scope = currentUserDataScope.Current;
+        return scope.Scope == DataScope.All
+            ? source
+            : source.Where(x =>
+                x.CourseSelectionOffering!.TeachingTask!.Course!.CollegeId ==
+                scope.RestrictedCollegeId);
+    }
+
+    private static IQueryable<CourseEnrollment> ApplyEnrollmentFilters(
+        IQueryable<CourseEnrollment> source,
+        CourseEnrollmentQuery query)
+    {
+        if (query.AcademicTermId.HasValue)
+            source = source.Where(x => x.CourseSelectionOffering!.CourseSelectionRound!
+                .AcademicTermId == query.AcademicTermId.Value);
+        if (query.CourseId.HasValue)
+            source = source.Where(x => x.CourseSelectionOffering!.TeachingTask!.CourseId ==
+                query.CourseId.Value);
+        if (query.CollegeId.HasValue)
+            source = source.Where(x => x.CourseSelectionOffering!.TeachingTask!.Course!.CollegeId ==
+                query.CollegeId.Value);
+        if (query.Status.HasValue)
+            source = source.Where(x => x.Status == query.Status.Value);
+        if (!string.IsNullOrWhiteSpace(query.Keyword))
+        {
+            var keyword = query.Keyword.Trim();
+            source = source.Where(x =>
+                x.Student!.StudentNumber.Contains(keyword) ||
+                x.Student.Name.Contains(keyword) ||
+                x.CourseSelectionOffering!.TeachingTask!.Course!.Code.Contains(keyword) ||
+                x.CourseSelectionOffering.TeachingTask.Course.Name.Contains(keyword) ||
+                x.CourseSelectionOffering.TeachingTask.TaskNumber.Contains(keyword));
+        }
+        return source;
+    }
+
+    private IQueryable<CourseEnrollmentListItem> ProjectEnrollments(
+        IQueryable<CourseEnrollment> source) => source.Select(x => new CourseEnrollmentListItem(
+            x.Id,
+            x.CourseSelectionOfferingId,
+            x.CourseSelectionOffering!.CourseSelectionRound!.AcademicTerm!.Name,
+            x.CourseSelectionOffering.CourseSelectionRound.AcademicTerm.StartDate,
+            x.CourseSelectionOffering.TeachingTask!.Course!.College!.Name,
+            x.CourseSelectionOffering.TeachingTask.Course.Code,
+            x.CourseSelectionOffering.TeachingTask.Course.Name,
+            x.CourseSelectionOffering.TeachingTask.TaskNumber,
+            x.Student!.StudentNumber,
+            x.Student.Name,
+            x.Student.AdministrativeClass!.Major!.Name,
+            x.Student.AdministrativeClass.Name,
+            x.Student.AdministrativeClass.Grade,
+            x.Status,
+            x.EnrollmentType,
+            x.EnrolledAt,
+            x.WithdrawnAt,
+            db.CourseExemptions
+                .Where(exemption => exemption.StudentId == x.StudentId &&
+                    exemption.TeachingTaskId == x.CourseSelectionOffering.TeachingTaskId)
+                .OrderByDescending(exemption => exemption.CreatedAt)
+                .Select(exemption => (ApprovalStatus?)exemption.Status)
+                .FirstOrDefault()));
+
     private ActionResult ProfileNotFound() =>
         ConflictProblem("当前账号未关联有效学生档案，请联系教务管理员。");
 
@@ -2294,6 +2405,35 @@ public sealed record AdminEnrollmentRequest(
 public sealed record ForceEnrollmentRequest(
     [MinLength(1)] IReadOnlyCollection<Guid> StudentIds);
 
+public sealed record CourseEnrollmentQuery(
+    Guid? AcademicTermId,
+    Guid? CourseId,
+    Guid? CollegeId,
+    CourseEnrollmentStatus? Status,
+    string? Keyword,
+    int Page = 1,
+    int PageSize = 20);
+
+public sealed record CourseEnrollmentListItem(
+    Guid Id,
+    Guid CourseSelectionOfferingId,
+    string TermName,
+    DateOnly TermStartDate,
+    string CollegeName,
+    string CourseCode,
+    string CourseName,
+    string TaskNumber,
+    string StudentNumber,
+    string StudentName,
+    string MajorName,
+    string ClassName,
+    int Grade,
+    CourseEnrollmentStatus Status,
+    EnrollmentType EnrollmentType,
+    DateTime? EnrolledAt,
+    DateTime? WithdrawnAt,
+    ApprovalStatus? ExemptionStatus);
+
 public sealed record StudentOfferingDto(
     Guid Id,
     Guid TeachingTaskId,
diff --git a/web/src/layouts/AdminLayout.vue b/web/src/layouts/AdminLayout.vue
index 0699910..ee6e64c 100644
--- a/web/src/layouts/AdminLayout.vue
+++ b/web/src/layouts/AdminLayout.vue
@@ -167,6 +167,10 @@ const navigationGroups = computed<NavigationGroup[]>(() => [
           label: isTeachingAdmin.value ? '选课管理' : '学生选课',
         },
       ),
+      ...whenVisible(
+        hasAnyRole(['SuperAdmin', 'AcademicAdmin', 'CollegeAdmin']),
+        { path: '/course-enrollments', label: '修读课程管理' },
+      ),
       ...whenVisible(
         hasAnyRole(['SuperAdmin', 'AcademicAdmin', 'CollegeAdmin', 'Teacher']),
         {
diff --git a/web/src/router/index.ts b/web/src/router/index.ts
index 1df6bd9..57eef46 100644
--- a/web/src/router/index.ts
+++ b/web/src/router/index.ts
@@ -251,6 +251,12 @@ const router = createRouter({
             roles: ['SuperAdmin', 'AcademicAdmin', 'CollegeAdmin', 'Student'],
           },
         },
+        {
+          path: 'course-enrollments',
+          name: 'course-enrollments',
+          component: () => import('../views/CourseEnrollmentManagementView.vue'),
+          meta: { roles: ['SuperAdmin', 'AcademicAdmin', 'CollegeAdmin'] },
+        },
         {
           path: 'grades',
           name: 'grades',
diff --git a/web/src/views/CourseEnrollmentManagementView.vue b/web/src/views/CourseEnrollmentManagementView.vue
new file mode 100644
index 0000000..7fb2b8b
--- /dev/null
+++ b/web/src/views/CourseEnrollmentManagementView.vue
@@ -0,0 +1,150 @@
+<script setup lang="ts">
+import { computed, onMounted, reactive, ref } from 'vue'
+import { Download, Refresh, Search } from '@element-plus/icons-vue'
+import { ElMessage, ElMessageBox } from 'element-plus'
+import { useRouter } from 'vue-router'
+import http, { apiErrorMessage } from '../api/http'
+import { downloadApiFile } from '../api/excel'
+import { useAuthStore } from '../stores/auth'
+
+const auth = useAuthStore()
+const router = useRouter()
+const rows = ref<any[]>([])
+const total = ref(0)
+const terms = ref<any[]>([])
+const courses = ref<any[]>([])
+const loading = ref(false)
+const query = reactive({
+  academicTermId: undefined as string | undefined,
+  courseId: undefined as string | undefined,
+  status: undefined as string | undefined,
+  keyword: '',
+  page: 1,
+  pageSize: 20,
+})
+const canAdjust = computed(() => auth.user?.roles.some((role) =>
+  ['SuperAdmin', 'AcademicAdmin'].includes(role)) ?? false)
+const statusLabels: Record<string, string> = {
+  Enrolled: '已修读', Waitlisted: '候补中', Withdrawn: '已退选',
+  Cancelled: '已取消', Expired: '已失效',
+}
+const exemptionLabels: Record<string, string> = {
+  Submitted: '审核中', Approved: '已批准', Rejected: '已驳回',
+}
+
+function params() {
+  return {
+    ...query,
+    keyword: query.keyword.trim() || undefined,
+  }
+}
+
+async function load(page = query.page) {
+  query.page = page
+  loading.value = true
+  try {
+    const { data } = await http.get('/course-selections/enrollments', { params: params() })
+    rows.value = data.items
+    total.value = data.total
+  } catch (error) {
+    ElMessage.error(apiErrorMessage(error))
+  } finally {
+    loading.value = false
+  }
+}
+
+async function exportRows() {
+  try {
+    await downloadApiFile('/course-selections/enrollments/export.xlsx', '修读课程名单.xlsx', {
+      params: params(),
+    })
+    ElMessage.success(`已导出符合条件的全部 ${total.value} 条修读记录`)
+  } catch (error) {
+    ElMessage.error(apiErrorMessage(error))
+  }
+}
+
+async function withdraw(row: any) {
+  try {
+    await ElMessageBox.confirm(
+      `确认将 ${row.studentNumber} ${row.studentName} 从《${row.courseName}》移出吗？系统会按原有规则处理候补递补。`,
+      '退选处理', { type: 'warning', confirmButtonText: '确认退选', cancelButtonText: '取消' },
+    )
+    await http.delete(`/course-selections/offerings/${row.courseSelectionOfferingId}/admin-enrollments/${row.id}`)
+    ElMessage.success('已完成退选处理')
+    await load()
+  } catch (error: any) {
+    if (error !== 'cancel' && error !== 'close') ElMessage.error(apiErrorMessage(error))
+  }
+}
+
+onMounted(async () => {
+  try {
+    const [termResponse, courseResponse] = await Promise.all([
+      http.get('/base-data/terms'), http.get('/courses/options'),
+    ])
+    terms.value = termResponse.data
+    courses.value = courseResponse.data
+    await load(1)
+  } catch (error) {
+    ElMessage.error(apiErrorMessage(error))
+  }
+})
+</script>
+
+<template>
+  <div class="page-container enrollment-management">
+    <section class="page-intro">
+      <div>
+        <span class="section-kicker">ENROLLMENT LEDGER</span>
+        <h2>修读课程管理</h2>
+        <p>集中查询跨学期修读记录、批量导出课程名单；免修仍通过审批中心按既有流程办理。</p>
+      </div>
+      <div class="intro-actions">
+        <el-button :icon="Refresh" @click="load(1)">刷新</el-button>
+        <el-button plain @click="router.push('/approvals')">处理免修审批</el-button>
+        <el-button type="primary" :icon="Download" @click="exportRows">导出全部结果</el-button>
+      </div>
+    </section>
+
+    <section class="data-card">
+      <div class="filter-bar">
+        <el-select v-model="query.academicTermId" clearable filterable placeholder="全部学期" @change="load(1)">
+          <el-option v-for="term in terms" :key="term.id" :label="term.name" :value="term.id" />
+        </el-select>
+        <el-select v-model="query.courseId" clearable filterable placeholder="全部课程" @change="load(1)">
+          <el-option v-for="course in courses" :key="course.id" :label="`${course.code} · ${course.name}`" :value="course.id" />
+        </el-select>
+        <el-select v-model="query.status" clearable placeholder="全部状态" @change="load(1)">
+          <el-option v-for="(label, value) in statusLabels" :key="value" :label="label" :value="value" />
+        </el-select>
+        <el-input v-model="query.keyword" clearable placeholder="课程、教学班、学号或姓名" @keyup.enter="load(1)" @clear="load(1)" />
+        <el-button type="primary" :icon="Search" @click="load(1)">查询</el-button>
+      </div>
+      <p class="result-note">导出不受当前页限制，将按上述条件导出全部 {{ total }} 条记录。</p>
+      <el-table v-loading="loading" :data="rows" row-key="id">
+        <el-table-column prop="termName" label="学期" width="120" />
+        <el-table-column label="课程 / 教学班" min-width="230">
+          <template #default="{ row }"><b>{{ row.courseName }}</b><small>{{ row.courseCode }} · {{ row.taskNumber }}</small></template>
+        </el-table-column>
+        <el-table-column label="学生" min-width="150"><template #default="{ row }">{{ row.studentNumber }}<small>{{ row.studentName }} · {{ row.className }}</small></template></el-table-column>
+        <el-table-column prop="collegeName" label="开课院系" min-width="120" />
+        <el-table-column label="修读状态" width="105"><template #default="{ row }"><el-tag size="small" :type="row.status === 'Enrolled' ? 'success' : 'info'">{{ statusLabels[row.status] ?? row.status }}</el-tag></template></el-table-column>
+        <el-table-column label="免修" width="100"><template #default="{ row }"><el-tag v-if="row.exemptionStatus" size="small" :type="row.exemptionStatus === 'Approved' ? 'success' : 'warning'">{{ exemptionLabels[row.exemptionStatus] }}</el-tag><span v-else>—</span></template></el-table-column>
+        <el-table-column v-if="canAdjust" label="操作" width="90" fixed="right"><template #default="{ row }"><el-button v-if="row.status === 'Enrolled'" link type="danger" @click="withdraw(row)">退选</el-button></template></el-table-column>
+        <template #empty><el-empty description="没有符合条件的修读记录" /></template>
+      </el-table>
+      <el-pagination v-if="total" background layout="total, sizes, prev, pager, next" :current-page="query.page" :page-size="query.pageSize" :page-sizes="[20, 50, 100]" :total="total" @current-change="load" @size-change="(size: number) => { query.pageSize = size; load(1) }" />
+    </section>
+  </div>
+</template>
+
+<style scoped>
+.intro-actions,.filter-bar { display:flex; flex-wrap:wrap; gap:8px; }
+.filter-bar { margin-bottom:10px; }
+.filter-bar .el-select { width:180px; }.filter-bar .el-input { width:240px; }
+.result-note { margin:0 0 14px; color:var(--muted); font-size:13px; }
+small { display:block; margin-top:3px; color:var(--muted); }
+:deep(.el-pagination) { justify-content:flex-end; margin-top:16px; }
+@media (max-width:640px) { .intro-actions,.filter-bar { align-items:stretch; flex-direction:column; }.filter-bar .el-select,.filter-bar .el-input { width:100%; } }
+</style>
diff --git a/web/src/views/PersonnelView.vue b/web/src/views/PersonnelView.vue
index d1b3991..b65a521 100644
--- a/web/src/views/PersonnelView.vue
+++ b/web/src/views/PersonnelView.vue
@@ -25,7 +25,6 @@ const importing = ref(false)
 const fileInput = ref<HTMLInputElement>()
 const rows = ref<any[]>([])
 const total = ref(0)
-const selectedRows = ref<any[]>([])
 const dialogVisible = ref(false)
 const activationDialog = ref(false)
 const activationLoading = ref(false)
@@ -185,17 +184,6 @@ async function load() {
     const { data } = await http.get<PageResult>(`/personnel/${active.value}`, { params })
     rows.value = data.items
     total.value = data.total
-    selectedRows.value = []
-    if (active.value === 'students' && rows.value.length) {
-      const ids = rows.value.map((row) => row.id)
-      const { data: summaries } = await http.get('/personnel/students/current-courses', {
-        params: { studentIds: ids },
-      })
-      const byId = new Map(summaries.map((item: any) => [item.id, item]))
-      rows.value = rows.value.map((row) => ({ ...row, ...(byId.get(row.id) ?? {
-        currentCourses: [], totalCredits: 0,
-      }) }))
-    }
   } catch (error) {
     ElMessage.error(apiErrorMessage(error))
   } finally {
@@ -269,28 +257,6 @@ async function exportRows() {
   }
 }
 
-async function exportStudentCurrentCourses(selectedOnly = false) {
-  if (selectedOnly && selectedRows.value.length === 0) {
-    ElMessage.warning('请先勾选需要导出的学生。')
-    return
-  }
-  try {
-    await downloadApiFile(
-      '/personnel/students/current-courses/export',
-      '学生正在修读课程.xlsx',
-      { params: { ...exportParams(), studentIds: selectedOnly
-        ? selectedRows.value.map((row) => row.id) : undefined } },
-    )
-    ElMessage.success(selectedOnly ? `已导出所选 ${selectedRows.value.length} 名学生` : '已导出筛选学生的修读课程')
-  } catch (error) {
-    ElMessage.error(apiErrorMessage(error))
-  }
-}
-
-function onSelectionChange(selection: any[]) {
-  selectedRows.value = selection
-}
-
 function chooseImportFile() {
   fileInput.value?.click()
 }
@@ -491,14 +457,9 @@ watch(active, async () => {
           />
         </template>
         <el-button v-if="canExport" :icon="Download" @click="exportRows">导出结果</el-button>
-        <template v-if="active === 'students' && canExport">
-          <el-button :icon="Download" type="primary" @click="exportStudentCurrentCourses()">导出修读课程</el-button>
-          <el-button :icon="Download" :disabled="selectedRows.length === 0" @click="exportStudentCurrentCourses(true)">导出所选（{{ selectedRows.length }}）</el-button>
-        </template>
       </div>
 
-      <el-table v-loading="loading" :data="rows" class="data-table registry-table" @selection-change="onSelectionChange">
-        <el-table-column v-if="active === 'students'" type="selection" width="48" />
+      <el-table v-loading="loading" :data="rows" class="data-table registry-table">
         <el-table-column :label="numberLabel" width="135">
           <template #default="{ row }"><span class="registry-number">{{ active === 'teachers' ? row.teacherNumber : row.studentNumber }}</span></template>
         </el-table-column>
@@ -520,12 +481,6 @@ watch(active, async () => {
         <el-table-column v-if="active === 'students'" prop="className" label="行政班" min-width="155" />
         <el-table-column v-if="active === 'students'" prop="majorName" label="专业" min-width="170" />
         <el-table-column v-if="active === 'students'" prop="enrollmentYear" label="入学年级" width="105" />
-        <el-table-column v-if="active === 'students'" label="正在修读课程 / 学分" min-width="240">
-          <template #default="{ row }">
-            <span v-if="row.currentCourses?.length">{{ row.currentCourses.map((course: any) => `${course.courseName}（${course.credits}学分）`).join('；') }}</span>
-            <span v-else>—</span>
-          </template>
-        </el-table-column>
         <el-table-column v-if="active === 'students'" label="总学分" width="95">
           <template #default="{ row }">{{ row.totalCredits ?? 0 }}</template>
         </el-table-column>