小程序一些功能更新

api/user/v1/message.go

@@ -0,0 +1,47 @@
+package v1
+
+import "github.com/gogf/gf/v2/frame/g"
+
+// ============================================================================
+// C 端站内信契约（迭代-2026-09-30）
+//
+// 写入点（后端业务事件统一落 user_messages，见 logic/message.go PushMessage）：
+//   会员开通/次数包到账（发货成功）、报价申请回执、报价处理结果、反馈官方回复。
+// C 端只读：列表 / 未读数 / 标记已读（单条或全部）。
+// ============================================================================
+
+// MessageItem 站内信条目
+type MessageItem struct {
+	Id        int64  `json:"id"`
+	Type      string `json:"type"` // order_delivered/quote_submitted/quote_handled/feedback_replied/system
+	Title     string `json:"title"`
+	Content   string `json:"content"`
+	Link      string `json:"link"` // 小程序内跳转路由，空=不跳转
+	IsRead    int    `json:"is_read"`
+	CreatedAt string `json:"created_at"`
+}
+
+// MessageListReq 我的消息（最近 N 条 + 未读数；不自动置已读，已读走 /message/read）
+type MessageListReq struct {
+	g.Meta `path:"/message/list" method:"get" tags:"message" summary:"我的站内信"`
+	Limit  int `json:"limit"`
+}
+type MessageListRes struct {
+	List   []MessageItem `json:"list"`
+	Unread int           `json:"unread"`
+}
+
+// MessageUnreadReq 未读消息数（首页 / 我的页徽标）
+type MessageUnreadReq struct {
+	g.Meta `path:"/message/unread" method:"get" tags:"message" summary:"未读站内信数"`
+}
+type MessageUnreadRes struct {
+	Count int `json:"count"`
+}
+
+// MessageReadReq 标记已读：Id>0 单条；Id=0 全部
+type MessageReadReq struct {
+	g.Meta `path:"/message/read" method:"post" tags:"message" summary:"站内信标记已读"`
+	Id     int64 `json:"id"`
+}
+type MessageReadRes struct{}