chore: 清理敏感与开发文档，仅同步代码

- 永久忽略并从仓库移除 开发文档/
- 移除并忽略 .env 与小程序私有配置
- 同步小程序/管理端/API与脚本改动

Made-with: Cursor

soul-api/internal/handler/admin_chapters.go

@@ -2,7 +2,9 @@ package handler
 
 import (
 	"net/http"
+	"strconv"
 
+	"soul-api/internal/cache"
 	"soul-api/internal/database"
 	"soul-api/internal/model"
 
@@ -11,9 +13,29 @@ import (
 
 // AdminChaptersList GET /api/admin/chapters 从 chapters 表组树：part -> chapters -> sections
 func AdminChaptersList(c *gin.Context) {
+	page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
+	if page < 1 {
+		page = 1
+	}
+	pageSize, _ := strconv.Atoi(c.DefaultQuery("pageSize", "20"))
+	if pageSize < 1 {
+		pageSize = 20
+	}
+	if pageSize > 200 {
+		pageSize = 200
+	}
+
 	var list []model.Chapter
 	if err := database.DB().Order("sort_order ASC, id ASC").Find(&list).Error; err != nil {
-		c.JSON(http.StatusOK, gin.H{"success": true, "data": gin.H{"structure": []interface{}{}, "stats": nil}})
+		c.JSON(http.StatusOK, gin.H{"success": true, "data": gin.H{
+			"structure":   []interface{}{},
+			"records":     []interface{}{},
+			"stats":       nil,
+			"page":        page,
+			"pageSize":    pageSize,
+			"totalPages":  0,
+			"total":       0,
+		}})
 		return
 	}
 	type section struct {
@@ -25,6 +47,19 @@ func AdminChaptersList(c *gin.Context) {
 		EditionStandard *bool   `json:"editionStandard,omitempty"`
 		EditionPremium  *bool   `json:"editionPremium,omitempty"`
 	}
+	type sectionRecord struct {
+		ID              string  `json:"id"`
+		PartID          string  `json:"partId"`
+		PartTitle       string  `json:"partTitle"`
+		ChapterID       string  `json:"chapterId"`
+		ChapterTitle    string  `json:"chapterTitle"`
+		Title           string  `json:"title"`
+		Price           float64 `json:"price"`
+		IsFree          bool    `json:"isFree"`
+		Status          string  `json:"status"`
+		EditionStandard *bool   `json:"editionStandard,omitempty"`
+		EditionPremium  *bool   `json:"editionPremium,omitempty"`
+	}
 	type chapter struct {
 		ID       string    `json:"id"`
 		Title    string    `json:"title"`
@@ -38,6 +73,7 @@ func AdminChaptersList(c *gin.Context) {
 	}
 	partMap := make(map[string]*part)
 	chapterMap := make(map[string]map[string]*chapter)
+	records := make([]sectionRecord, 0, len(list))
 	for _, row := range list {
 		if partMap[row.PartID] == nil {
 			partMap[row.PartID] = &part{ID: row.PartID, Title: row.PartTitle, Type: "part", Chapters: []chapter{}}
@@ -66,6 +102,19 @@ func AdminChaptersList(c *gin.Context) {
 			ID: row.ID, Title: row.SectionTitle, Price: price, IsFree: isFree, Status: st,
 			EditionStandard: row.EditionStandard, EditionPremium: row.EditionPremium,
 		})
+		records = append(records, sectionRecord{
+			ID:              row.ID,
+			PartID:          row.PartID,
+			PartTitle:       row.PartTitle,
+			ChapterID:       row.ChapterID,
+			ChapterTitle:    row.ChapterTitle,
+			Title:           row.SectionTitle,
+			Price:           price,
+			IsFree:          isFree,
+			Status:          st,
+			EditionStandard: row.EditionStandard,
+			EditionPremium:  row.EditionPremium,
+		})
 	}
 	structure := make([]part, 0, len(partMap))
 	for _, p := range partMap {
@@ -73,9 +122,29 @@ func AdminChaptersList(c *gin.Context) {
 	}
 	var total int64
 	database.DB().Model(&model.Chapter{}).Count(&total)
+	totalPages := 0
+	if pageSize > 0 {
+		totalPages = (int(total) + pageSize - 1) / pageSize
+	}
+	start := (page - 1) * pageSize
+	if start > len(records) {
+		start = len(records)
+	}
+	end := start + pageSize
+	if end > len(records) {
+		end = len(records)
+	}
 	c.JSON(http.StatusOK, gin.H{
 		"success": true,
-		"data":    gin.H{"structure": structure, "stats": gin.H{"totalSections": total}},
+		"data": gin.H{
+			"structure":  structure,
+			"records":    records[start:end],
+			"stats":      gin.H{"totalSections": total},
+			"page":       page,
+			"pageSize":   pageSize,
+			"totalPages": totalPages,
+			"total":      total,
+		},
 	})
 }
 
@@ -131,6 +200,7 @@ func AdminChaptersAction(c *gin.Context) {
 	if body.Action == "delete" {
 		id := resolveID()
 		if id != "" {
+			cache.InvalidateChapterContentByID(id)
 			db.Where("id = ?", id).Delete(&model.Chapter{})
 		}
 	}
@@ -156,5 +226,7 @@ func AdminChaptersAction(c *gin.Context) {
 			}
 		}
 	}
+	cache.InvalidateBookParts()
+	cache.InvalidateBookCache()
 	c.JSON(http.StatusOK, gin.H{"success": true})
 }