init

serve/internal/interfaces/vocabulary_service_interface.go

@@ -0,0 +1,36 @@
+package interfaces
+
+import (
+    "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common"
+    "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models"
+)
+
+// VocabularyServiceInterface 定义词汇服务接口，需与 VocabularyService 保持一致
+type VocabularyServiceInterface interface {
+    // 分类管理
+    GetCategories(page, pageSize int, level string) (*common.PaginationData, error)
+    CreateCategory(name, description, level string) (*models.VocabularyCategory, error)
+    UpdateCategory(categoryID string, updates map[string]interface{}) (*models.VocabularyCategory, error)
+    DeleteCategory(categoryID string) error
+
+    // 词汇管理
+    GetVocabulariesByCategory(categoryID string, page, pageSize int, level string) (*common.PaginationData, error)
+    GetVocabularyByID(vocabularyID string) (*models.Vocabulary, error)
+    CreateVocabulary(word, phonetic, level string, frequency int, categoryID string, definitions, examples, images []string) (*models.Vocabulary, error)
+    UpdateVocabulary(id string, vocabulary *models.Vocabulary) error
+    DeleteVocabulary(id string) error
+
+    // 学习进度与统计
+    GetUserVocabularyProgress(userID int64, vocabularyID string) (*models.UserVocabularyProgress, error)
+    UpdateUserVocabularyProgress(userID int64, vocabularyID string, updates map[string]interface{}) (*models.UserVocabularyProgress, error)
+    GetUserVocabularyStats(userID int64) (map[string]interface{}, error)
+
+    // 测试相关
+    GetVocabularyTest(testID string) (*models.VocabularyTest, error)
+    CreateVocabularyTest(userID int64, testType, level string, totalWords int) (*models.VocabularyTest, error)
+    UpdateVocabularyTestResult(testID string, correctWords int, score float64, duration int) error
+
+    // 搜索与每日统计
+    SearchVocabularies(keyword string, level string, page, pageSize int) (*common.PaginationData, error)
+    GetDailyStats(userID string) (map[string]interface{}, error)
+}

serve/internal/interfaces/writing_service_interface.go

@@ -0,0 +1,23 @@
+package interfaces
+
+import "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models"
+
+// WritingServiceInterface 定义写作服务接口
+// 包含 WritingService 的所有方法
+type WritingServiceInterface interface {
+	GetWritingPrompts(level string, category string, page int, pageSize int) ([]models.WritingPrompt, error)
+	GetWritingPrompt(id string) (*models.WritingPrompt, error)
+	CreateWritingPrompt(prompt *models.WritingPrompt) error
+	UpdateWritingPrompt(id string, prompt *models.WritingPrompt) error
+	DeleteWritingPrompt(id string) error
+	SearchWritingPrompts(keyword string, level string, category string, page int, pageSize int) ([]models.WritingPrompt, error)
+	GetRecommendedPrompts(userID string) ([]models.WritingPrompt, error)
+	CreateWritingSubmission(submission *models.WritingSubmission) error
+	UpdateWritingSubmission(id string, submission *models.WritingSubmission) error
+	GetWritingSubmission(id string) (*models.WritingSubmission, error)
+	GetUserWritingSubmissions(userID string, page int, pageSize int) ([]models.WritingSubmission, error)
+	SubmitWriting(submission *models.WritingSubmission) error
+	GradeWriting(submissionID string, score float64, grammarScore float64, vocabularyScore float64, coherenceScore float64, feedback string, suggestions string) error
+	GetUserWritingStats(userID string) (map[string]interface{}, error)
+	GetWritingProgress(userID string, promptID string) (*models.WritingSubmission, error)
+}