feat(课程分组): 实现课程分组功能并支持前端展示

添加课程分组列表接口及相关服务逻辑
在前端课程、听书和电子书页面增加分组展示和导航功能
支持分组内课程列表展示和返回上级操作

Author: yann0917

backend/app/course.go

@@ -18,6 +18,14 @@ func CourseList(category, order string, page, limit int) (list *services.CourseL
 	return
 }
 
+func CourseGroupList(category, order string, groupID, page, limit int) (list *services.CourseList, err error) {
+	list, err = getService().CourseGroupList(category, order, groupID, page, limit)
+	if err != nil {
+		return
+	}
+	return
+}
+
 // CourseDetail 已购课程详情
 func CourseDetail(category string, id int) (detail *services.Course, err error) {
 	detail, err = getService().CourseDetail(category, id)

backend/course.go

@@ -24,6 +24,14 @@ func (a *App) CourseList(category, order string, page, limit int) (list *service
 	return
 }
 
+func (a *App) CourseGroupList(category, order string, groupID, page, limit int) (list *services.CourseList, err error) {
+	list, err = app.CourseGroupList(category, order, groupID, page, limit)
+	if err != nil {
+		return
+	}
+	return
+}
+
 func (a *App) CourseInfo(enid string) (info *services.CourseInfo, err error) {
 	info, err = app.CourseInfoByEnid(enid)
 	return

backend/services/course.go

@@ -624,6 +624,62 @@ func (s *Service) CourseDetail(category string, id int) (detail *Course, err err
 	return
 }
 
+// CourseGroupList fetches a single page of items within a specific group.
+// 获取分组内的课程列表（单页）
+func (s *Service) CourseGroupList(category, order string, groupID, page, limit int) (response *CourseList, err error) {
+	body, err := s.reqCourseGroupList(category, order, groupID, page, limit)
+	if err != nil {
+		return
+	}
+	defer body.Close()
+	if err = handleJSONParse(body, &response); err != nil {
+		return
+	}
+	return
+}
+
+// CourseGroupListAll fetches all items within a specific group across all pages.
+// It handles pagination automatically and aggregates results.
+// 获取分组内的所有课程列表（自动处理分页）
+func (s *Service) CourseGroupListAll(category, order string, groupID int) (data *CourseList, err error) {
+	resp, err := s.CourseGroupList(category, order, groupID, 1, 18)
+	if err != nil {
+		return
+	}
+
+	if resp.Total == 0 {
+		data = resp
+		return
+	}
+
+	total := resp.Total
+	limit := 18
+	totalPages := int(math.Ceil(float64(total) / float64(limit)))
+
+	// 已经获取第一页数据
+	var allCourses []Course
+	allCourses = append(allCourses, resp.List...)
+
+	// 获取剩余页面数据
+	for page := 2; page <= totalPages; page++ {
+		pageResp, err := s.CourseGroupList(category, order, groupID, page, limit)
+		if err != nil {
+			return data, err
+		}
+		allCourses = append(allCourses, pageResp.List...)
+	}
+
+	// 构建完整结果
+	data = &CourseList{
+		List:          allCourses,
+		Total:         total,
+		IsMore:        0, // 已获取全部，没有更多
+		HasSingleBook: resp.HasSingleBook,
+	}
+
+	return
+}
+
 // CourseInfo get course info
 func (s *Service) CourseInfo(enid string) (info *CourseInfo, err error) {
 

backend/services/requester.go

@@ -97,6 +97,24 @@ func (s *Service) reqCourseList(category, order string, page, limit int) (io.Rea
 	return handleHTTPResponse(resp, err)
 }
 
+// reqCourseGroupList makes an HTTP request to fetch items within a specific group.
+// It uses the /api/hades/v2/product/group/list endpoint with display_group=false to prevent nesting.
+// 请求分组内的课程列表
+func (s *Service) reqCourseGroupList(category, order string, groupID, page, limit int) (io.ReadCloser, error) {
+	resp, err := s.client.R().SetBody(map[string]interface{}{
+		"category":        category,
+		"display_group":   false, // Prevent nested groups
+		"filter":          "group",
+		"group_id":        groupID,
+		"order":           order,
+		"filter_complete": 0,
+		"page":            page,
+		"page_size":       limit,
+		"sort_type":       "desc",
+	}).Post("/api/hades/v2/product/group/list")
+	return handleHTTPResponse(resp, err)
+}
+
 // reqOutsideDetail 请求名家讲书课程详情
 func (s *Service) reqOutsideDetail(enid string) (io.ReadCloser, error) {
 	resp, err := s.client.R().SetBody(map[string]interface{}{

frontend/src/views/Course.vue

@@ -1,18 +1,34 @@
 <template>
+    <div v-if="groupMode.active" style="display:flex; align-items:center; justify-content:space-between; margin-bottom: 8px;">
+        <div style="display:flex; align-items:center; gap: 8px;">
+            <el-button type="primary" link @click="exitGroup">返回</el-button>
+            <span>{{ groupMode.title }}</span>
+        </div>
+    </div>
     <el-table :data="tableData.list" v-loading="loading" height="97%" style="width: 100%"
         :cell-style="{ textAlign: 'left' }" :header-cell-style="{ textAlign: 'left' }"
         table-layout="auto">
         <!-- <el-table-column prop="class_id" label="ID" width="80" /> -->
-        <el-table-column prop="title" label="标题" width="280" />
+        <el-table-column prop="title" label="标题" width="280">
+            <template #default="scope">
+                <div style="display:flex; align-items:center; gap: 8px;">
+                    <span>{{ scope.row.title }}</span>
+                    <el-tag v-if="scope.row.is_group" type="info" size="small">分组</el-tag>
+                    <span v-if="scope.row.is_group">共{{ scope.row.course_num || 0 }}本</span>
+                    <el-button v-if="scope.row.is_group" type="primary" link @click.stop="enterGroup(scope.row)">进入</el-button>
+                </div>
+            </template>
+        </el-table-column>
         <el-table-column prop="icon" label="封面" width="80">
             <template #default="scope">
-                <el-image 
-                    :src="scope.row.icon" 
+                <el-image
+                    v-if="scope.row.icon"
+                    :src="scope.row.icon"
                     :preview-teleported="true"
-                    :preview-src-list="[scope.row.icon]" 
+                    :preview-src-list="[scope.row.icon]"
                     style="width: 32px;"
-                >
-                </el-image>
+                />
+                <span v-else>-</span>
             </template>
         </el-table-column>
         <el-table-column prop="intro" label="简介" width="280" />
@@ -21,24 +37,27 @@
 
         <el-table-column prop="publish_num" label="已更新" width="100" >
             <template #default="scope">
-                <span>{{ scope.row.publish_num }}/{{scope.row.course_num}}</span>
+                <span v-if="!scope.row.is_group">{{ scope.row.publish_num || 0 }}/{{ scope.row.course_num || 0 }}</span>
+                <span v-else>-</span>
             </template>
         </el-table-column>
         <el-table-column prop="progress" label="已学%" width="80" />
         <el-table-column fixed="right" label="操作" width="240">
             <template #default="scope">
-                <el-button icon="list" size="small" type="primary" link @click="gotoArticleList(scope.row)">章节列表
-                </el-button>
-                <el-button icon="view" size="small" type="primary" link @click="handleProd(scope.row.enid)">详情
-                </el-button>
-                <el-button icon="download" size="small" type="primary" link @click="openDownloadDialog(scope.row)">下载
-                </el-button>
+                <template v-if="!scope.row.is_group">
+                    <el-button icon="list" size="small" type="primary" link @click="gotoArticleList(scope.row)">章节列表
+                    </el-button>
+                    <el-button icon="view" size="small" type="primary" link @click="handleProd(scope.row.enid)">详情
+                    </el-button>
+                    <el-button icon="download" size="small" type="primary" link @click="openDownloadDialog(scope.row)">下载
+                    </el-button>
+                </template>
 
             </template>
         </el-table-column>
     </el-table>
 
-    <pagination :total="total" @pageChange="handleChangePage"></pagination>
+    <pagination :key="paginationKey" :total="total" @pageChange="handleChangePage"></pagination>
     <course-info v-if="dialogVisible" :enid= "prodEnid" :dialog-visible="dialogVisible" @close="closeDialog"></course-info>
     <download-dialog
         v-if="dialogDownloadVisible"
@@ -54,7 +73,7 @@
 <script lang="ts" setup>
 import { ref, reactive, onMounted } from 'vue'
 import { ElTable, ElMessage } from 'element-plus'
-import {CourseList, CourseCategory, SetDir} from '../../wailsjs/go/backend/App'
+import {CourseList, CourseCategory, CourseGroupList, SetDir} from '../../wailsjs/go/backend/App'
 import { services } from '../../wailsjs/go/models'
 import { userStore } from '../stores/user';
 import { settingStore } from '../stores/setting';
@@ -71,10 +90,17 @@ const { pushLogin, pushCourseDetail, pushSetting } = useAppRouter()
 const loading = ref(true)
 const page = ref(1)
 const total = ref(0)
+const outerTotal = ref(0)
 const pageSize = ref(15)
+const paginationKey = ref(0)
 const dialogVisible = ref(false)
 const prodEnid = ref("")
 
+const groupMode = reactive({
+    active: false,
+    groupId: 0,
+    title: '',
+})
 
 const dialogDownloadVisible = ref(false)
 const downloadType = ref(1)
@@ -93,7 +119,8 @@ onMounted(() => {
     CourseCategory().then(result => {
         result.forEach((item, key) => {
             if (item.category == "bauhinia") {
-                total.value = item.count
+                outerTotal.value = item.count
+                if (!groupMode.active) total.value = item.count
             }
         })
     }).catch((error) => {
@@ -115,10 +142,15 @@ const handleChangePage = (item: any) => {
 
 
 const getTableData = async () => {
-    await CourseList("bauhinia", "study", page.value, pageSize.value).then((table) => {
+    loading.value = true
+    const fetcher = groupMode.active
+        ? CourseGroupList("bauhinia", "study", groupMode.groupId, page.value, pageSize.value)
+        : CourseList("bauhinia", "study", page.value, pageSize.value)
+
+    await fetcher.then((table) => {
         loading.value = false
         Object.assign(tableData, table)
-        // console.log(tableData)
+        total.value = groupMode.active ? (table.total || 0) : outerTotal.value
     }).catch((error) => {
         loading.value = false
         ElMessage({
@@ -143,6 +175,27 @@ const gotoArticleList = (row: any) => {
     })
 }
 
+const enterGroup = (row: any) => {
+    const groupId = Number(row?.group_id || 0)
+    if (!groupId) return
+    groupMode.active = true
+    groupMode.groupId = groupId
+    groupMode.title = String(row?.title || '')
+    page.value = 1
+    paginationKey.value += 1
+    getTableData()
+}
+
+const exitGroup = () => {
+    groupMode.active = false
+    groupMode.groupId = 0
+    groupMode.title = ''
+    page.value = 1
+    total.value = outerTotal.value
+    paginationKey.value += 1
+    getTableData()
+}
+
 const openDialog = () => {
     dialogVisible.value = true
 }
@@ -201,4 +254,4 @@ const closeDownloadDialog = () => {
     /* height: auto; */
   text-align: center;
 }
-</style>
+</style>