feat: 第五轮开发 - 14项未来路线图功能完整实现

W1-W14 全部完成: - W1: 消息搜索 (ILIKE全文检索 + SearchModal) - W2: 对话导出 (JSON/Markdown/TXT三格式) - W3: 记忆时间线 DevTools 可视化 - W4: 通知推送系统 (WebSocket + Browser Notification API) - W5: 定时提醒 (30s轮询 + 重复提醒 + WebSocket推送) - W6: 每日简报 (08:00自动生成: 天气+新闻+提醒+AI摘要) - W7: IoT场景自动化 (规则引擎 10s轮询 + 条件评估 + 场景执行) - W8: 语音输入 (浏览器 Speech Recognition API) - W9: STT服务 (voice-service + whisper.cpp) - W10: TTS服务 (浏览器 Speech Synthesis + edge-tts三档回退) - W11: 文件管理 (上传/下载/缩略图/纯Go bilinear缩放) - W12: 知识库RAG (PostgreSQL tsvector + 文档分块 + 检索) - W13: 多模态 (图片上传+分析: Vision API + 本地Go分析回退) - W14: PWA (Service Worker + 离线页 + install prompt) 总计: 6个Go微服务 + 10+前端组件 + 10+ PostgreSQL表 + 4个后台调度器
2026-05-19 12:01:09 +08:00
parent 78e3f450c2
commit bcf4d4e621
69 changed files with 14599 additions and 150 deletions
@@ -0,0 +1,340 @@
+package handler
+
+import (
+	"encoding/json"
+	"log"
+	"net/http"
+	"strconv"
+	"time"
+
+	"github.com/gin-gonic/gin"
+
+	"github.com/yourname/cyrene-ai/gateway/internal/middleware"
+	"github.com/yourname/cyrene-ai/gateway/internal/store"
+	"github.com/yourname/cyrene-ai/gateway/internal/ws"
+)
+
+// ReminderHandler 提醒处理器
+type ReminderHandler struct {
+	store *store.ReminderStore
+	hub   *ws.Hub
+}
+
+// NewReminderHandler 创建提醒处理器
+func NewReminderHandler(s *store.ReminderStore, hub *ws.Hub) *ReminderHandler {
+	return &ReminderHandler{store: s, hub: hub}
+}
+
+// CreateReminderRequest 创建提醒请求体
+type CreateReminderRequest struct {
+	Title       string `json:"title" binding:"required"`
+	Description string `json:"description"`
+	RemindAt    string `json:"remind_at" binding:"required"` // ISO 8601 格式
+	RepeatType  string `json:"repeat_type"`                  // none, daily, weekly, monthly
+	SessionID   string `json:"session_id"`
+}
+
+// UpdateReminderRequest 更新提醒请求体
+type UpdateReminderRequest struct {
+	Title       string `json:"title"`
+	Description string `json:"description"`
+	RemindAt    string `json:"remind_at"`
+	Status      string `json:"status"`      // pending, completed, cancelled
+	RepeatType  string `json:"repeat_type"` // none, daily, weekly, monthly
+	SessionID   string `json:"session_id"`
+}
+
+// List 获取提醒列表
+// GET /api/v1/reminders?user_id=xxx&status=pending&limit=50&offset=0
+func (h *ReminderHandler) List(c *gin.Context) {
+	userID := c.Query("user_id")
+	if userID == "" {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "缺少 user_id 参数"})
+		return
+	}
+
+	status := c.Query("status")
+	limit := 50
+	offset := 0
+
+	if l, ok := c.GetQuery("limit"); ok {
+		if v, err := strconv.Atoi(l); err == nil && v > 0 {
+			limit = v
+		}
+	}
+	if o, ok := c.GetQuery("offset"); ok {
+		if v, err := strconv.Atoi(o); err == nil && v >= 0 {
+			offset = v
+		}
+	}
+
+	reminders, err := h.store.GetRemindersByUser(userID, status, limit, offset)
+	if err != nil {
+		log.Printf("[reminder] 获取提醒列表失败: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "获取提醒列表失败"})
+		return
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"reminders": reminders,
+		"count":     len(reminders),
+	})
+}
+
+// Create 创建新提醒
+// POST /api/v1/reminders
+func (h *ReminderHandler) Create(c *gin.Context) {
+	var req CreateReminderRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "请求参数无效: " + err.Error()})
+		return
+	}
+
+	// 从 JWT 获取 userID
+	userID := middleware.GetUserID(c)
+	if userID == "" {
+		c.JSON(http.StatusUnauthorized, gin.H{"error": "未认证"})
+		return
+	}
+
+	// 解析时间
+	remindAt, err := time.Parse(time.RFC3339, req.RemindAt)
+	if err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "时间格式无效，请使用 ISO 8601 格式 (例如 2024-01-01T15:00:00Z)"})
+		return
+	}
+
+	// 默认值
+	repeatType := req.RepeatType
+	if repeatType == "" {
+		repeatType = "none"
+	}
+
+	reminder := &store.Reminder{
+		ID:          generateID(),
+		UserID:      userID,
+		Title:       req.Title,
+		Description: req.Description,
+		RemindAt:    remindAt,
+		Status:      "pending",
+		RepeatType:  repeatType,
+		SessionID:   req.SessionID,
+		Notified:    false,
+	}
+
+	if err := h.store.CreateReminder(reminder); err != nil {
+		log.Printf("[reminder] 创建提醒失败: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "创建提醒失败"})
+		return
+	}
+
+	log.Printf("[reminder] 提醒已创建: id=%s user=%s title=%s remind_at=%s repeat=%s",
+		reminder.ID, userID, reminder.Title, remindAt.Format(time.RFC3339), repeatType)
+
+	c.JSON(http.StatusCreated, gin.H{
+		"success":  true,
+		"reminder": reminder,
+	})
+}
+
+// Update 更新提醒
+// PUT /api/v1/reminders/:id
+func (h *ReminderHandler) Update(c *gin.Context) {
+	id := c.Param("id")
+	if id == "" {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "缺少提醒 ID"})
+		return
+	}
+
+	userID := middleware.GetUserID(c)
+
+	var req UpdateReminderRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "请求参数无效: " + err.Error()})
+		return
+	}
+
+	// 先获取已有提醒
+	reminders, err := h.store.GetRemindersByUser(userID, "", 100, 0)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "获取提醒失败"})
+		return
+	}
+
+	var existing *store.Reminder
+	for i := range reminders {
+		if reminders[i].ID == id {
+			existing = &reminders[i]
+			break
+		}
+	}
+	if existing == nil {
+		c.JSON(http.StatusNotFound, gin.H{"error": "提醒不存在"})
+		return
+	}
+
+	// 更新字段
+	if req.Title != "" {
+		existing.Title = req.Title
+	}
+	if req.Description != "" {
+		existing.Description = req.Description
+	}
+	if req.RemindAt != "" {
+		remindAt, err := time.Parse(time.RFC3339, req.RemindAt)
+		if err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": "时间格式无效"})
+			return
+		}
+		existing.RemindAt = remindAt
+	}
+	if req.Status != "" {
+		existing.Status = req.Status
+		if req.Status == "completed" || req.Status == "cancelled" {
+			now := time.Now()
+			existing.CompletedAt = &now
+		}
+	}
+	if req.RepeatType != "" {
+		existing.RepeatType = req.RepeatType
+	}
+	if req.SessionID != "" {
+		existing.SessionID = req.SessionID
+	}
+
+	if err := h.store.UpdateReminder(id, existing); err != nil {
+		log.Printf("[reminder] 更新提醒失败: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "更新提醒失败"})
+		return
+	}
+
+	log.Printf("[reminder] 提醒已更新: id=%s", id)
+
+	c.JSON(http.StatusOK, gin.H{
+		"success":  true,
+		"reminder": existing,
+	})
+}
+
+// Delete 删除提醒
+// DELETE /api/v1/reminders/:id
+func (h *ReminderHandler) Delete(c *gin.Context) {
+	id := c.Param("id")
+	if id == "" {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "缺少提醒 ID"})
+		return
+	}
+
+	if err := h.store.DeleteReminder(id); err != nil {
+		log.Printf("[reminder] 删除提醒失败: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{"error": "删除提醒失败"})
+		return
+	}
+
+	log.Printf("[reminder] 提醒已删除: id=%s", id)
+
+	c.JSON(http.StatusOK, gin.H{
+		"success": true,
+	})
+}
+
+// ========== 提醒调度器 ==========
+
+// StartReminderScheduler 启动提醒调度器，每 30 秒检查一次到期提醒
+func StartReminderScheduler(s *store.ReminderStore, hub *ws.Hub) {
+	go func() {
+		ticker := time.NewTicker(30 * time.Second)
+		defer ticker.Stop()
+
+		log.Println("[ReminderScheduler] 提醒调度器已启动 (检查间隔: 30秒)")
+
+		for range ticker.C {
+			checkAndNotify(s, hub)
+		}
+	}()
+}
+
+// checkAndNotify 检查到期提醒并推送通知
+func checkAndNotify(s *store.ReminderStore, hub *ws.Hub) {
+	reminders, err := s.GetDueReminders()
+	if err != nil {
+		log.Printf("[ReminderScheduler] 获取到期提醒失败: %v", err)
+		return
+	}
+
+	if len(reminders) == 0 {
+		return
+	}
+
+	for _, r := range reminders {
+		// 1. 构建 WebSocket 通知消息
+		notif := &ws.NotificationInfo{
+			ID:        "reminder_" + r.ID,
+			Type:      "reminder",
+			Title:     r.Title,
+			Body:      r.Description,
+			Timestamp: time.Now().UTC().Format(time.RFC3339),
+			Data: map[string]interface{}{
+				"reminder_id": r.ID,
+				"session_id":  r.SessionID,
+			},
+		}
+
+		msg := ws.ServerMessage{
+			Type:         "notification",
+			MessageID:    "reminder_" + r.ID,
+			Timestamp:    time.Now().UnixMilli(),
+			Notification: notif,
+		}
+
+		data, err := json.Marshal(msg)
+		if err != nil {
+			log.Printf("[ReminderScheduler] 序列化通知失败: %v", err)
+			continue
+		}
+
+		// 2. 通过 Hub 向用户推送
+		hub.SendToUser(r.UserID, data)
+
+		// 3. 标记为已通知
+		if err := s.MarkNotified(r.ID); err != nil {
+			log.Printf("[ReminderScheduler] 标记已通知失败: id=%s err=%v", r.ID, err)
+		}
+
+		// 4. 处理重复提醒
+		if r.RepeatType != "" && r.RepeatType != "none" {
+			nextTime := calculateNextRemindAt(r.RemindAt, r.RepeatType)
+			r.RemindAt = nextTime
+			r.Notified = false
+			if err := s.UpdateReminder(r.ID, &r); err != nil {
+				log.Printf("[ReminderScheduler] 更新重复提醒失败: id=%s err=%v", r.ID, err)
+			} else {
+				log.Printf("[ReminderScheduler] 重复提醒已更新: id=%s next=%s", r.ID, nextTime.Format(time.RFC3339))
+			}
+		} else {
+			// 非重复提醒：标记为已完成
+			now := time.Now()
+			r.Status = "completed"
+			r.CompletedAt = &now
+			if err := s.UpdateReminder(r.ID, &r); err != nil {
+				log.Printf("[ReminderScheduler] 标记提醒完成失败: id=%s err=%v", r.ID, err)
+			}
+		}
+
+		log.Printf("[ReminderScheduler] 提醒已推送: user=%s title=%s id=%s", r.UserID, r.Title, r.ID)
+	}
+}
+
+// calculateNextRemindAt 计算下一次提醒时间
+func calculateNextRemindAt(current time.Time, repeatType string) time.Time {
+	switch repeatType {
+	case "daily":
+		return current.Add(24 * time.Hour)
+	case "weekly":
+		return current.Add(7 * 24 * time.Hour)
+	case "monthly":
+		return current.AddDate(0, 1, 0)
+	default:
+		return current
+	}
+}