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

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

Made-with: Cursor

soul-api/cmd/server/main.go

@@ -12,6 +12,7 @@ import (
 	"soul-api/internal/config"
 	"soul-api/internal/database"
 	"soul-api/internal/handler"
+	"soul-api/internal/redis"
 	"soul-api/internal/router"
 	"soul-api/internal/wechat"
 )
@@ -31,6 +32,13 @@ func main() {
 	if err := wechat.InitTransfer(cfg); err != nil {
 		log.Fatal("wechat transfer: ", err)
 	}
+	if cfg.RedisURL != "" && cfg.RedisURL != "disable" {
+		if err := redis.Init(cfg.RedisURL); err != nil {
+			log.Printf("redis: 连接失败，跳过（%v）", err)
+		} else {
+			defer redis.Close()
+		}
+	}
 
 	r := router.Setup(cfg)
 	srv := &http.Server{
@@ -38,9 +46,19 @@ func main() {
 		Handler: r,
 	}
 
+	// 预热 all-chapters、book/parts 缓存，避免首请求冷启动 502
+	go func() {
+		time.Sleep(2 * time.Second) // 等 DB 完全就绪
+		handler.WarmAllChaptersCache()
+		handler.WarmBookPartsCache()
+	}()
+
 	go func() {
 		log.Printf("soul-api listen on :%s (mode=%s)", cfg.Port, cfg.Mode)
 		log.Printf("  -> 访问地址: http://localhost:%s  (健康检查: http://localhost:%s/health)", cfg.Port, cfg.Port)
+		if cfg.UploadDir != "" {
+			log.Printf("  -> 上传目录: %s", cfg.UploadDir)
+		}
 		if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
 			log.Fatal("listen: ", err)
 		}