Enhance AI and Redis integration for smoke logging features

- Added AI configuration options to .env.example and config.go for OpenAI integration.
- Implemented Redis caching for session management in main.go and auth middleware.
- Updated smoke logging service to support real smoking time (`smoke_at`) and AI advice retrieval.
- Enhanced API routes to include endpoints for AI advice and unlock functionality for non-members.
- Improved database schema with new tables for AI advice and unlock records.
- Expanded documentation to cover new AI features and Redis caching implementation.

internal/smoke/model/smoke_ai.go

@@ -0,0 +1,49 @@
+package model
+
+import "time"
+
+// SmokeAIAdvice 对应表 fa_smoke_ai_advice（每日 AI 戒烟建议缓存）。
+//
+// 注意：沿用旧系统字段（createtime/updatetime/deletetime 为秒级时间戳），不使用 gorm.Model。
+type SmokeAIAdvice struct {
+	ID  uint `gorm:"primaryKey;autoIncrement" json:"id"`
+	UID int `gorm:"column:uid;index:idx_smoke_ai_advice_uid_date,priority:1;uniqueIndex:uniq_smoke_ai_advice,priority:1" json:"-"`
+
+	AdviceDate    time.Time `gorm:"column:advice_date;type:date;index:idx_smoke_ai_advice_uid_date,priority:2;uniqueIndex:uniq_smoke_ai_advice,priority:2" json:"advice_date"`
+	PromptVersion string    `gorm:"column:prompt_version;size:30;default:v1;uniqueIndex:uniq_smoke_ai_advice,priority:3" json:"prompt_version"`
+
+	Provider string `gorm:"column:provider;size:30" json:"provider,omitempty"`
+	Model    string `gorm:"column:model;size:60" json:"model,omitempty"`
+
+	InputSnapshot []byte `gorm:"column:input_snapshot;type:json" json:"input_snapshot,omitempty"`
+	Advice        string `gorm:"column:advice;type:mediumtext" json:"advice"`
+
+	TokensIn  *int `gorm:"column:tokens_in" json:"tokens_in,omitempty"`
+	TokensOut *int `gorm:"column:tokens_out" json:"tokens_out,omitempty"`
+	CostCent  *int `gorm:"column:cost_cent" json:"cost_cent,omitempty"`
+
+	CreateTime *int64 `gorm:"column:createtime" json:"createtime,omitempty"`
+	UpdateTime *int64 `gorm:"column:updatetime" json:"updatetime,omitempty"`
+	DeleteTime *int64 `gorm:"column:deletetime" json:"deletetime,omitempty"`
+}
+
+func (SmokeAIAdvice) TableName() string {
+	return "fa_smoke_ai_advice"
+}
+
+// SmokeAIAdviceUnlock 对应表 fa_smoke_ai_advice_unlocks（非会员用户的每日广告解锁记录）。
+type SmokeAIAdviceUnlock struct {
+	ID  uint `gorm:"primaryKey;autoIncrement" json:"id"`
+	UID int `gorm:"column:uid;index:idx_smoke_ai_unlock_uid_date,priority:1;uniqueIndex:uniq_smoke_ai_unlock,priority:1" json:"-"`
+
+	UnlockDate  time.Time `gorm:"column:unlock_date;type:date;index:idx_smoke_ai_unlock_uid_date,priority:2;uniqueIndex:uniq_smoke_ai_unlock,priority:2" json:"unlock_date"`
+	AdWatchedAt time.Time `gorm:"column:ad_watched_at" json:"ad_watched_at"`
+
+	CreateTime *int64 `gorm:"column:createtime" json:"createtime,omitempty"`
+	UpdateTime *int64 `gorm:"column:updatetime" json:"updatetime,omitempty"`
+	DeleteTime *int64 `gorm:"column:deletetime" json:"deletetime,omitempty"`
+}
+
+func (SmokeAIAdviceUnlock) TableName() string {
+	return "fa_smoke_ai_advice_unlocks"
+}

internal/smoke/model/smoke_log.go

@@ -13,6 +13,8 @@ type SmokeLog struct {
 
 	// smoke_time 在库里是 date 类型（只包含日期，不包含时分秒）。
 	SmokeTime *time.Time `gorm:"column:smoke_time;type:date" json:"smoke_time,omitempty"`
+	// smoke_at：真实抽烟时间（可补录，精确到时分秒）
+	SmokeAt *time.Time `gorm:"column:smoke_at;type:datetime" json:"smoke_at,omitempty"`
 
 	Remark string `gorm:"column:remark;type:text" json:"remark,omitempty"`